Bicep 中的数据类型

本文介绍 Bicep 中支持的数据类型。 若要定义自定义数据类型，请参阅 用户定义的数据类型。

支持的类型

在 Bicep 中，可使用以下数据类型：

• array
• bool
• int
• 对象
• secureObject - 在 Bicep 中用修饰器指示
• secureString - 在 Bicep 中用修饰器指示
• string

数组

数组以左中括号 ([) 开头，以右中括号 (]) 结尾。 在 Bicep 中，可以在一行中或多行中声明数组。 在单行声明的值之间使用逗号 (,)，但在多行声明中不使用，可以混合和匹配单行声明和多行声明。 多行声明需要 Bicep CLI 版本 0.7.X 或更高版本。

var multiLineArray = [
  'abc'
  'def'
  'ghi'
]

var singleLineArray = ['abc', 'def', 'ghi']

var mixedArray = ['abc', 'def'
    'ghi']

在数组中，每个项都由任意类型表示。 可具有其每个项的数据类型都相同的数组，也可具有包含不同数据类型的数组。

下面的示例演示一个整数数组和一个不同类型的数组。

var integerArray = [
  1
  2
  3
]

var mixedArray = [
  resourceGroup().name
  1
  true
  'example string'
]

Bicep 中的数组的下标从零开始。 在下面的示例中，表达式 exampleArray[0] 的计算结果为 1，exampleArray[2] 的计算结果为 3。 索引器的索引本身可能是另一个表达式。 表达式 exampleArray[index] 的计算结果为 2。 只允许对数组类型的表达式使用整数索引器。

var index = 1

var exampleArray = [
  1
  2
  3
]

当索引超出范围时，会出现以下错误：

The language expression property array index 'x' is out of bounds

若要避免此异常，可以使用 Or 逻辑运算符，如下例所示：

param emptyArray array = []
param numberArray array = [1, 2, 3]

output foo bool = empty(emptyArray) || emptyArray[0] == 'bar'
output bar bool = length(numberArray) >= 3 || numberArray[3] == 4

布尔型

指定布尔值时，请使用 true 或 false。 不要将值用引号括起。

param exampleBool bool = true

整数

指定整数值时，请勿使用引号。

param exampleInt int = 1

在 Bicep 中，整数为 64 位整数。 作为内联参数传递时，值的范围可能受用于部署的 SDK 或命令行工具的限制。 例如，使用 PowerShell 部署 Bicep 时，整数类型的范围可能为 -2147483648 到 2147483647。 为了避免此限制，请在参数文件中指定大的整数值。 资源类型会针对整数属性应用其自己的限制。

目前不支持浮点、十进制或二进制格式。

对象

对象以左大括号 ({) 开头，以右大括号 (}) 结尾。 在 Bicep 中，可以在单行中或多行中声明对象。 对象中的每个属性都包含键和值。 键和值用冒号 (:) 分隔。 对象允许任何类型的任何属性。 在单行声明的属性之间使用逗号 (,)，但在多行声明的属性之间不使用。 可以混合和匹配单行和多行声明。 多行声明需要 Bicep CLI 版本 0.7.X 或更高版本。

param singleLineObject object = {name: 'test name', id: '123-abc', isCurrent: true, tier: 1}

param multiLineObject object = {
  name: 'test name'
  id: '123-abc'
  isCurrent: true
  tier: 1
}

param mixedObject object = {name: 'test name', id: '123-abc', isCurrent: true
    tier: 1}

在 Bicep 中，对象属性键可以有选择地使用引号：

var test = {
  'my - special. key': 'value'
}

在上一示例中，当对象属性键包含特殊字符时，使用了引号。 例如空格、'-' 或 '.'。 以下示例演示了如何在对象属性键中使用内插。

var stringVar = 'example value'
var objectVar = {
  '${stringVar}': 'this value'
}

属性访问器用于访问对象的属性。 它们是使用 . 运算符构造的。

var a = {
  b: 'Dev'
  c: 42
  d: {
    e: true
  }
}

output result1 string = a.b // returns 'Dev'
output result2 int = a.c // returns 42
output result3 bool = a.d.e // returns true

属性访问器可用于任何对象，包括对象类型和对象文字的参数和变量。 对非对象类型的表达式使用属性访问器是错误的。

还可以使用 [] 语法来访问属性。 下面的示例将返回 Development。

var environmentSettings = {
  dev: {
    name: 'Development'
  }
  prod: {
    name: 'Production'
  }
}

output accessorResult string = environmentSettings['dev'].name

在 JSON 中，对象是零个或更多键/值对的无序集合。 排序可能会根据实现而有所不同。 例如，Bicep items() 函数按字母顺序对对象进行排序。 在其他位置，可以保留原始排序。 由于这种非确定性，在编写代码时应避免对对象键的排序做出任何假设，因为这会与部署参数和输出交互。

当访问对象的不存在属性时，将出现以下错误：

The language expression property 'foo' doesn't exist

若要避免此异常，可以使用 And 逻辑运算符，如下例所示：

param objectToTest object = {
  one: 1
  two: 2
  three: 3
}

output bar bool = contains(objectToTest, 'four') && objectToTest.four == 4

字符串

在 Bicep 中，字符串用单引号标记，并且必须在单行中声明。 允许使用码位在 0 到 10FFFF 之间的所有 Unicode 字符。

param exampleString string = 'test value'

下表列出了一组必须由反斜杠 (\) 字符转义的保留字符：

转义序列	表示的值	注释
\\	\
\'	'
\n	换行 (LF)
\r	匹配回车符 (CR)
\t	制表符
\u{x}	Unicode 码位 x	x 表示 0（含）到 10FFFF（含）之间的十六进制码位值。 允许前导零。 高于 FFFF 的码位以代理项对的形式发出。
\$	$	仅在后跟 { 时进行转义。

// evaluates to "what's up?"
var myVar = 'what\'s up?'

Bicep 中的所有字符串都支持内插。 若要注入表达式，请将其括在 ${ 和 } 中。 引用的表达式不能跨多行显示。

var storageName = 'storage${uniqueString(resourceGroup().id)}'

多行字符串

在 Bicep 中定义多行字符串时，开头使用三个单引号字符 (''')，并且可以选择在其后跟随一个换行符（开始序列），结尾使用三个单引号字符（''' - 结束序列）。 在开始序列和结束序列之间输入的字符是逐字读取的，无需或不可能进行转义。

// evaluates to "hello!"
var myVar = '''hello!'''

// evaluates to "hello!" because the first newline is skipped
var myVar2 = '''
hello!'''

// evaluates to "hello!\n" because the final newline is included
var myVar3 = '''
hello!
'''

// evaluates to "  this\n    is\n      indented\n"
var myVar4 = '''
  this
    is
      indented
'''

// evaluates to "comments // are included\n/* because everything is read as-is */\n"
var myVar5 = '''
comments // are included
/* because everything is read as-is */
'''

// evaluates to "interpolation\nis ${blocked}"
// note ${blocked} is part of the string, and is not evaluated as an expression
var myVar6 = '''interpolation
is ${blocked}'''

安全字符串和对象

安全字符串使用与字符串相同的格式，安全对象使用与对象相同的格式。 在使用 Bicep 时，请将 @secure()decorator 添加到字符串或对象。

将参数设置为安全字符串或安全对象时，参数的值不会保存到部署历史记录中，也不会记入日志。 但是，如果将该安全值设置为不应为安全值的属性，则该值不会受到保护。 例如，如果将安全字符串设置为标记，则该值将以纯文本的形式存储。 使用安全字符串作为密码和机密。

以下示例显示了两个安全参数：

@secure()
param password string

@secure()
param configValues object

数据类型可分配性

在 Bicep 中，可以将一个类型（源类型）的值分配给另一个类型（目标类型）。 下表显示哪个源类型（水平列出）可以或不可以分配给哪个目标类型（垂直列出）。 在表中，X 表示可分配，空白表示不可分配，? 表示仅当其类型兼容时才可分配。

类型	any	error	string	number	int	bool	null	object	array	命名资源	命名模块	scope
any	X		X	X	X	X	X	X	X	X	X	X
error
string	X		X
number	X			X	X
int	X				X
bool	X					X
null	X						X
object	X							X
array	X								X
resource	X									X
module	X										X
scope												？
命名资源	X							？		？
命名模块	X							？			？

后续步骤

若要了解 Bicep 的结构和语法，请参阅 Bicep 文件结构。