자식 리소스에 대한 이름 및 형식 설정

아티클
02/13/2024

자식 리소스는 다른 리소스의 컨텍스트 내에만 존재하는 리소스입니다. 예를 들어 가상 머신 없이는 가상 머신 확장이 존재할 수 없습니다. 확장 리소스는 가상 머신의 자식입니다.

각 부모 리소스는 특정 리소스 종류만 자식 리소스로 허용합니다. 자식 리소스의 리소스 종류는 부모 리소스에 대한 리소스 종류를 포함합니다. 예를 들어 Microsoft.Web/sites/config와 Microsoft.Web/sites/extensions는 둘 다 Microsoft.Web/sites의 자식 리소스입니다. 허용되는 리소스 종류는 부모 리소스의 템플릿 스키마에서 지정됩니다.

ARM 템플릿(Azure Resource Manager 템플릿)에서 부모 리소스 내에서 또는 부모 리소스 외부에서 자식 리소스를 지정할 수 있습니다. 리소스 이름 및 리소스 종류에 대해 제공하는 값은 자식 리소스가 부모 리소스의 내부에 정의되는지 아니면 외부에 정의되는지에 따라 달라집니다.

팁

ARM 템플릿과 동일한 기능을 제공하고 구문이 사용하기 더 쉽기 때문에 Bicep를 권장합니다. 자세한 내용은 자식 리소스를 참조하세요.

부모 리소스 내에서

다음 예에서는 부모 리소스의 리소스 속성 내에 포함된 자식 리소스를 보여 줍니다.

"resources": [
  {
    <parent-resource>
    "resources": [
      <child-resource>
    ]
  }
]

자식 리소스는 5개 수준 깊이까지만 정의할 있습니다.

부모 리소스 종류 내에서 정의된 경우 유형 및 이름 값을 슬래시 없이 단일 세그먼트로 서식을 지정합니다.

"type": "{child-resource-type}",
"name": "{child-resource-name}",

다음 예는 가상 네트워크와 서브넷을 보여 줍니다. 서브넷은 가상 네트워크에 대한 리소스 배열에 포함되어 있습니다. 이름은 Subnet1로 지정되며 유형은 서브넷으로 설정됩니다. 부모 리소스는 자식 리소스를 배포하기 전에 존재해야 하므로 자식 리소스가 부모 리소스에 종속된 것으로 표시되어 있습니다.

"resources": [
  {
    "type": "Microsoft.Network/virtualNetworks",
    "apiVersion": "2022-11-01",
    "name": "VNet1",
    "location": "[parameters('location')]",
    "properties": {
      "addressSpace": {
        "addressPrefixes": [
          "10.0.0.0/16"
        ]
      }
    },
    "resources": [
      {
        "type": "subnets",
        "apiVersion": "2022-11-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": "2022-11-01",
    "name": "VNet1",
    "location": "[parameters('location')]",
    "properties": {
      "addressSpace": {
        "addressPrefixes": [
          "10.0.0.0/16"
        ]
      }
    }
  },
  {
    "type": "Microsoft.Network/virtualNetworks/subnets",
    "apiVersion": "2022-11-01",
    "name": "VNet1/Subnet1",
    "dependsOn": [
      "VNet1"
    ],
    "properties": {
      "addressPrefix": "10.0.0.0/24"
    }
  }
]

다음 단계

ARM 템플릿을 만드는 방법에 대한 자세한 내용은 ARM 템플릿의 구조 및 구문 이해를 참조하세요.
리소스를 참조할 때 리소스 이름 형식에 대한 자세한 내용은 참조 함수를 참조하세요.

자식 리소스에 대한 이름 및 형식 설정

부모 리소스 내에서

부모 리소스 외부에

다음 단계

추가 리소스