设置子资源的名称和类型
子资源是只存在于另一资源的上下文内的资源。 例如,如果没有虚拟机,则虚拟机扩展不能存在。 扩展资源是虚拟机的子项。
每个父资源仅接受特定的资源类型作为子资源。 子资源的资源类型包括父资源的资源类型。 例如,Microsoft.Web/sites/config
和 Microsoft.Web/sites/extensions
都是 Microsoft.Web/sites
的子资源 。 可接受的资源类型在父资源的 模板架构 中指定。
在 Azure 资源管理器模板(ARM 模板)中,可以在父资源内部或外部指定子资源。 你为资源名称和资源类型提供的值取决于是在父资源内部还是在外部定义子资源。
在父资源内部
以下示例显示子资源包括在父资源的资源属性中。
"resources": [
{
<parent-resource>
"resources": [
<child-resource>
]
}
]
子资源总共只能定义五级。
在父资源类型内部定义时,可以将类型和名称值的格式设置为不带斜杠的单个段。
"type": "{child-resource-type}",
"name": "{child-resource-name}",
以下示例显示一个虚拟网络,有一个子网。 请注意,子网包含在虚拟网络的资源数组中。 名称设置为 Subnet1,类型设置为 subnets。 子资源被标记为依赖父资源,因为在部署子资源之前,必须存在父资源。
"resources": [
{
"type": "Microsoft.Network/virtualNetworks",
"apiVersion": "2018-10-01",
"name": "VNet1",
"location": "[parameters('location')]",
"properties": {
"addressSpace": {
"addressPrefixes": [
"10.0.0.0/16"
]
}
},
"resources": [
{
"type": "subnets",
"apiVersion": "2018-10-01",
"name": "Subnet1",
"dependsOn": [
"VNet1"
],
"properties": {
"addressPrefix": "10.0.0.0/24"
}
}
]
}
]
完整的资源类型仍然为 Microsoft.Network/virtualNetworks/subnets
。 可不提供 Microsoft.Network/virtualNetworks/
,因为假设它继承父资源类型。
子资源名称设置为 Subnet1,但完整名称包含父名称。 可不提供 VNet1,因为假设它继承父资源。
父资源外部
以下示例显示了父资源外部的子资源。 如果父资源未部署在同一模板中,或者想要使用 copy 创建多个子资源,可以使用此方法。
"resources": [
{
<parent-resource>
},
{
<child-resource>
}
]
在父资源外部定义时,请使用斜杠来格式化类型和名称值,使其包含父类型和名称。
"type": "{resource-provider-namespace}/{parent-resource-type}/{child-resource-type}",
"name": "{parent-resource-name}/{child-resource-name}",
以下示例显示一个虚拟网络和子网,二者都在根级别进行定义。 请注意,子网不包含在虚拟网络的资源数组中。 名称设置为 VNet1/Subnet1,类型设置为 Microsoft.Network/virtualNetworks/subnets
。 子资源被标记为依赖父资源,因为在部署子资源之前,必须存在父资源。
"resources": [
{
"type": "Microsoft.Network/virtualNetworks",
"apiVersion": "2018-10-01",
"name": "VNet1",
"location": "[parameters('location')]",
"properties": {
"addressSpace": {
"addressPrefixes": [
"10.0.0.0/16"
]
}
}
},
{
"type": "Microsoft.Network/virtualNetworks/subnets",
"apiVersion": "2018-10-01",
"name": "VNet1/Subnet1",
"dependsOn": [
"VNet1"
],
"properties": {
"addressPrefix": "10.0.0.0/24"
}
}
]
后续步骤
- 若要了解如何创建 ARM 模板,请参阅了解 ARM 模板的结构和语法。
- 若要了解引用资源时的资源名称格式,请参阅引用函数。