다음을 통해 공유


Microsoft.Compute cloudServices 2022-09-04

Bicep 리소스 정의

cloudServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Compute/cloudServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Compute/cloudServices@2022-09-04' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    allowModelOverride: bool
    configuration: 'string'
    configurationUrl: 'string'
    extensionProfile: {
      extensions: [
        {
          name: 'string'
          properties: {
            autoUpgradeMinorVersion: bool
            forceUpdateTag: 'string'
            protectedSettings: any()
            protectedSettingsFromKeyVault: {
              secretUrl: 'string'
              sourceVault: {
                id: 'string'
              }
            }
            publisher: 'string'
            rolesAppliedTo: [
              'string'
            ]
            settings: any()
            type: 'string'
            typeHandlerVersion: 'string'
          }
        }
      ]
    }
    networkProfile: {
      loadBalancerConfigurations: [
        {
          id: 'string'
          name: 'string'
          properties: {
            frontendIpConfigurations: [
              {
                name: 'string'
                properties: {
                  privateIPAddress: 'string'
                  publicIPAddress: {
                    id: 'string'
                  }
                  subnet: {
                    id: 'string'
                  }
                }
              }
            ]
          }
        }
      ]
      slotType: 'string'
      swappableCloudService: {
        id: 'string'
      }
    }
    osProfile: {
      secrets: [
        {
          sourceVault: {
            id: 'string'
          }
          vaultCertificates: [
            {
              certificateUrl: 'string'
            }
          ]
        }
      ]
    }
    packageUrl: 'string'
    roleProfile: {
      roles: [
        {
          name: 'string'
          sku: {
            capacity: int
            name: 'string'
            tier: 'string'
          }
        }
      ]
    }
    startCloudService: bool
    upgradeMode: 'string'
  }
  systemData: {}
  zones: [
    'string' or int
  ]
}

속성 값

cloudServices

이름 묘사
이름 리소스 이름 string(필수)

문자 제한: 1-15



유효한 문자:
공백, 컨트롤 문자 또는 다음 문자를 사용할 수 없습니다.
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

밑줄로 시작할 수 없습니다. 마침표나 하이픈으로 끝날 수 없습니다.
위치 리소스 위치입니다. string(필수)
태그 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
속성 클라우드 서비스 속성 cloudServiceProperties
systemData 이 리소스와 관련된 시스템 메타 데이터입니다. systemData
영역 리소스의 논리적 가용성 영역 목록입니다. 목록에는 클라우드 서비스를 프로비전해야 하는 영역이 1개만 포함되어야 합니다. 이 필드는 선택 사항입니다. 가용성 영역의 배열을 문자열 또는 int로 지정합니다.

CloudServiceProperties

이름 묘사
allowModelOverride (선택 사항) 모델/템플릿에 지정된 역할 sku 속성(roleProfile.roles.sku)이 .cscfg 및 .csdef에 지정된 역할 인스턴스 수 및 vm 크기를 각각 재정의해야 하는지 여부를 나타냅니다.
기본값은 false.
bool
구성 클라우드 서비스에 대한 XML 서비스 구성(.cscfg)을 지정합니다. 문자열
configurationUrl Blob 서비스에서 서비스 구성의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
extensionProfile 클라우드 서비스 확장 프로필을 설명합니다. cloudServiceExtensionProfile
networkProfile 클라우드 서비스에 대한 네트워크 프로필입니다. cloudServiceNetworkProfile
osProfile 클라우드 서비스에 대한 OS 프로필을 설명합니다. CloudServiceOsProfile
packageUrl Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
roleProfile 클라우드 서비스의 역할 프로필에 대해 설명합니다. CloudServiceRoleProfile
startCloudService (선택 사항) 클라우드 서비스를 만든 직후 시작할지 여부를 나타냅니다. 기본값은 true.
false이면 서비스 모델은 여전히 배포되지만 코드는 즉시 실행되지 않습니다. 대신 서비스를 시작할 때 Start를 호출할 때까지 서비스가 PoweredOff입니다. 배포된 서비스는 전원이 공급되더라도 여전히 요금이 발생합니다.
bool
upgradeMode 클라우드 서비스의 업데이트 모드입니다. 역할 인스턴스는 서비스가 배포될 때 도메인을 업데이트하기 위해 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작하거나 모든 업데이트 도메인에서 자동으로 시작할 수 있습니다.
가능한 값은 다음과 같습니다.

자동

수동

동시


지정하지 않으면 기본값은 Auto입니다. 수동으로 설정하면 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.
'Auto'
'수동'
'동시'

CloudServiceExtensionProfile

이름 묘사
확장 클라우드 서비스에 대한 확장 목록입니다. 확장[]

확장

이름 묘사
이름 확장의 이름입니다. 문자열
속성 확장 속성입니다. cloudServiceExtensionProperties

CloudServiceExtensionProperties

이름 묘사
autoUpgradeMinorVersion 플랫폼이 사용 가능해지면 typeHandlerVersion을 상위 부 버전으로 자동으로 업그레이드할 수 있는지 여부를 명시적으로 지정합니다. bool
forceUpdateTag 제공된 공용 및 보호된 설정을 강제로 적용하는 태그입니다.
태그 값을 변경하면 공용 또는 보호된 설정을 변경하지 않고 확장을 다시 실행할 수 있습니다.
forceUpdateTag가 변경되지 않으면 공용 또는 보호된 설정에 대한 업데이트가 처리기에서 계속 적용됩니다.
forceUpdateTag나 공용 또는 보호된 설정이 모두 변경되지 않으면 확장은 동일한 시퀀스 번호가 있는 역할 인스턴스로 이동하며,
다시 실행할지 여부는 처리기 구현에 달려 있습니다.
문자열
protectedSettings 역할 인스턴스로 전송되기 전에 암호화된 확장에 대한 보호된 설정입니다. Bicep의 경우 any() 함수를 사용할 수 있습니다.
protectedSettingsFromKeyVault 역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다. cloudServiceVaultAndSecretReference
게시자 확장 처리기 게시자의 이름입니다. 문자열
rolesAppliedTo 이 확장을 적용할 역할의 선택적 목록입니다. 속성을 지정하지 않거나 '*'를 지정하면 클라우드 서비스의 모든 역할에 확장이 적용됩니다. string[]
설정 확장에 대한 공용 설정입니다. JSON 확장의 경우 확장에 대한 JSON 설정입니다. XML 확장(예: RDP)의 경우 확장에 대한 XML 설정입니다. Bicep의 경우 any() 함수를 사용할 수 있습니다.
확장의 형식을 지정합니다. 문자열
typeHandlerVersion 확장의 버전을 지정합니다. 확장의 버전을 지정합니다. 이 요소를 지정하지 않았거나 별표(*)를 값으로 사용하는 경우 최신 버전의 확장이 사용됩니다. 값이 주 버전 번호와 별표로 부 버전 번호(X.)로 지정된 경우 지정된 주 버전의 최신 부 버전이 선택됩니다. 주 버전 번호와 부 버전 번호(X.Y)가 지정된 경우 특정 확장 버전이 선택됩니다. 버전을 지정하면 역할 인스턴스에서 자동 업그레이드가 수행됩니다. 문자열

CloudServiceVaultAndSecretReference

이름 묘사
secretUrl 확장의 보호된 설정을 포함하는 비밀 URL 문자열
sourceVault Key Vault의 ARM 리소스 ID SubResource

SubResource

이름 묘사
아이디 리소스 ID 문자열

CloudServiceNetworkProfile

이름 묘사
loadBalancerConfigurations 부하 분산 장치 구성 목록입니다. 클라우드 서비스에는 공용 Load Balancer 및 내부 Load Balancer에 해당하는 최대 2개의 부하 분산 장치 구성이 있을 수 있습니다. LoadBalancerConfiguration[]
slotType 클라우드 서비스의 슬롯 유형입니다.
가능한 값은 다음과 같습니다.

프로덕션

스테이징


지정하지 않으면 기본값은 Production입니다.
'Production'
'스테이징'
swappableCloudService 주체 클라우드 서비스가 교환을 수행할 수 있는 대상 IP를 포함하는 클라우드 서비스의 ID 참조입니다. 이 속성은 설정된 후에는 업데이트할 수 없습니다. 이 ID에서 참조하는 교환 가능한 클라우드 서비스가 있어야 합니다. 그렇지 않으면 오류가 throw됩니다. SubResource

LoadBalancerConfiguration

이름 묘사
아이디 리소스 ID 문자열
이름 부하 분산 장치의 이름 string(필수)
속성 부하 분산 장치 구성의 속성입니다. loadBalancerConfigurationProperties (필수)

LoadBalancerConfigurationProperties

이름 묘사
frontendIpConfigurations 부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다. LoadBalancerFrontendIpConfiguration[] (필수)

LoadBalancerFrontendIpConfiguration

이름 묘사
이름 부하 분산 장치에서 사용하는 프런트 엔드 IP 구성 집합 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다. string(필수)
속성 부하 분산 장치 프런트 엔드 IP 구성의 속성입니다. LoadBalancerFrontendIpConfigurationProperties(필수)

LoadBalancerFrontendIpConfigurationProperties

이름 묘사
privateIPAddress IP 구성의 가상 네트워크 개인 IP 주소입니다. 문자열
publicIPAddress 공용 IP 주소 리소스에 대한 참조입니다. SubResource
서브넷 가상 네트워크 서브넷 리소스에 대한 참조입니다. SubResource

CloudServiceOsProfile

이름 묘사
비밀 역할 인스턴스에 설치해야 하는 인증서 집합을 지정합니다. cloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

이름 묘사
sourceVault VaultCertificates의 모든 인증서를 포함하는 Key Vault의 상대 URL입니다. SubResource
vaultCertificates 인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다. cloudServiceVaultCertificate[]

CloudServiceVaultCertificate

이름 묘사
certificateUrl Key Vault에 비밀로 업로드된 인증서의 URL입니다. 문자열

CloudServiceRoleProfile

이름 묘사
역할 클라우드 서비스에 대한 역할 목록입니다. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

이름 묘사
이름 리소스 이름입니다. 문자열
sku 클라우드 서비스 역할 sku에 대해 설명합니다. cloudServiceRoleSku

CloudServiceRoleSku

이름 묘사
용량 클라우드 서비스의 역할 인스턴스 수를 지정합니다. int
이름 sku 이름입니다. 참고: 클라우드 서비스가 현재 있는 하드웨어에서 새 SKU가 지원되지 않는 경우 클라우드 서비스를 삭제하고 다시 만들거나 이전 sku로 다시 이동해야 합니다. 문자열
계층 클라우드 서비스의 계층을 지정합니다. 가능한 값은 다음과 같습니다.

표준

기본
문자열

SystemData

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

ARM 템플릿 리소스 정의

cloudServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Compute/cloudServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Compute/cloudServices",
  "apiVersion": "2022-09-04",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "allowModelOverride": "bool",
    "configuration": "string",
    "configurationUrl": "string",
    "extensionProfile": {
      "extensions": [
        {
          "name": "string",
          "properties": {
            "autoUpgradeMinorVersion": "bool",
            "forceUpdateTag": "string",
            "protectedSettings": {},
            "protectedSettingsFromKeyVault": {
              "secretUrl": "string",
              "sourceVault": {
                "id": "string"
              }
            },
            "publisher": "string",
            "rolesAppliedTo": [ "string" ],
            "settings": {},
            "type": "string",
            "typeHandlerVersion": "string"
          }
        }
      ]
    },
    "networkProfile": {
      "loadBalancerConfigurations": [
        {
          "id": "string",
          "name": "string",
          "properties": {
            "frontendIpConfigurations": [
              {
                "name": "string",
                "properties": {
                  "privateIPAddress": "string",
                  "publicIPAddress": {
                    "id": "string"
                  },
                  "subnet": {
                    "id": "string"
                  }
                }
              }
            ]
          }
        }
      ],
      "slotType": "string",
      "swappableCloudService": {
        "id": "string"
      }
    },
    "osProfile": {
      "secrets": [
        {
          "sourceVault": {
            "id": "string"
          },
          "vaultCertificates": [
            {
              "certificateUrl": "string"
            }
          ]
        }
      ]
    },
    "packageUrl": "string",
    "roleProfile": {
      "roles": [
        {
          "name": "string",
          "sku": {
            "capacity": "int",
            "name": "string",
            "tier": "string"
          }
        }
      ]
    },
    "startCloudService": "bool",
    "upgradeMode": "string"
  },
  "systemData": {},
  "zones": [ "string" or int ]
}

속성 값

cloudServices

이름 묘사
리소스 종류 'Microsoft.Compute/cloudServices'
apiVersion 리소스 api 버전 '2022-09-04'
이름 리소스 이름 string(필수)

문자 제한: 1-15



유효한 문자:
공백, 컨트롤 문자 또는 다음 문자를 사용할 수 없습니다.
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

밑줄로 시작할 수 없습니다. 마침표나 하이픈으로 끝날 수 없습니다.
위치 리소스 위치입니다. string(필수)
태그 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
속성 클라우드 서비스 속성 cloudServiceProperties
systemData 이 리소스와 관련된 시스템 메타 데이터입니다. systemData
영역 리소스의 논리적 가용성 영역 목록입니다. 목록에는 클라우드 서비스를 프로비전해야 하는 영역이 1개만 포함되어야 합니다. 이 필드는 선택 사항입니다. 가용성 영역의 배열을 문자열 또는 int로 지정합니다.

CloudServiceProperties

이름 묘사
allowModelOverride (선택 사항) 모델/템플릿에 지정된 역할 sku 속성(roleProfile.roles.sku)이 .cscfg 및 .csdef에 지정된 역할 인스턴스 수 및 vm 크기를 각각 재정의해야 하는지 여부를 나타냅니다.
기본값은 false.
bool
구성 클라우드 서비스에 대한 XML 서비스 구성(.cscfg)을 지정합니다. 문자열
configurationUrl Blob 서비스에서 서비스 구성의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
extensionProfile 클라우드 서비스 확장 프로필을 설명합니다. cloudServiceExtensionProfile
networkProfile 클라우드 서비스에 대한 네트워크 프로필입니다. cloudServiceNetworkProfile
osProfile 클라우드 서비스에 대한 OS 프로필을 설명합니다. CloudServiceOsProfile
packageUrl Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
roleProfile 클라우드 서비스의 역할 프로필에 대해 설명합니다. CloudServiceRoleProfile
startCloudService (선택 사항) 클라우드 서비스를 만든 직후 시작할지 여부를 나타냅니다. 기본값은 true.
false이면 서비스 모델은 여전히 배포되지만 코드는 즉시 실행되지 않습니다. 대신 서비스를 시작할 때 Start를 호출할 때까지 서비스가 PoweredOff입니다. 배포된 서비스는 전원이 공급되더라도 여전히 요금이 발생합니다.
bool
upgradeMode 클라우드 서비스의 업데이트 모드입니다. 역할 인스턴스는 서비스가 배포될 때 도메인을 업데이트하기 위해 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작하거나 모든 업데이트 도메인에서 자동으로 시작할 수 있습니다.
가능한 값은 다음과 같습니다.

자동

수동

동시


지정하지 않으면 기본값은 Auto입니다. 수동으로 설정하면 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.
'Auto'
'수동'
'동시'

CloudServiceExtensionProfile

이름 묘사
확장 클라우드 서비스에 대한 확장 목록입니다. 확장[]

확장

이름 묘사
이름 확장의 이름입니다. 문자열
속성 확장 속성입니다. cloudServiceExtensionProperties

CloudServiceExtensionProperties

이름 묘사
autoUpgradeMinorVersion 플랫폼이 사용 가능해지면 typeHandlerVersion을 상위 부 버전으로 자동으로 업그레이드할 수 있는지 여부를 명시적으로 지정합니다. bool
forceUpdateTag 제공된 공용 및 보호된 설정을 강제로 적용하는 태그입니다.
태그 값을 변경하면 공용 또는 보호된 설정을 변경하지 않고 확장을 다시 실행할 수 있습니다.
forceUpdateTag가 변경되지 않으면 공용 또는 보호된 설정에 대한 업데이트가 처리기에서 계속 적용됩니다.
forceUpdateTag나 공용 또는 보호된 설정이 모두 변경되지 않으면 확장은 동일한 시퀀스 번호가 있는 역할 인스턴스로 이동하며,
다시 실행할지 여부는 처리기 구현에 달려 있습니다.
문자열
protectedSettings 역할 인스턴스로 전송되기 전에 암호화된 확장에 대한 보호된 설정입니다.
protectedSettingsFromKeyVault 역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다. cloudServiceVaultAndSecretReference
게시자 확장 처리기 게시자의 이름입니다. 문자열
rolesAppliedTo 이 확장을 적용할 역할의 선택적 목록입니다. 속성을 지정하지 않거나 '*'를 지정하면 클라우드 서비스의 모든 역할에 확장이 적용됩니다. string[]
설정 확장에 대한 공용 설정입니다. JSON 확장의 경우 확장에 대한 JSON 설정입니다. XML 확장(예: RDP)의 경우 확장에 대한 XML 설정입니다.
확장의 형식을 지정합니다. 문자열
typeHandlerVersion 확장의 버전을 지정합니다. 확장의 버전을 지정합니다. 이 요소를 지정하지 않았거나 별표(*)를 값으로 사용하는 경우 최신 버전의 확장이 사용됩니다. 값이 주 버전 번호와 별표로 부 버전 번호(X.)로 지정된 경우 지정된 주 버전의 최신 부 버전이 선택됩니다. 주 버전 번호와 부 버전 번호(X.Y)가 지정된 경우 특정 확장 버전이 선택됩니다. 버전을 지정하면 역할 인스턴스에서 자동 업그레이드가 수행됩니다. 문자열

CloudServiceVaultAndSecretReference

이름 묘사
secretUrl 확장의 보호된 설정을 포함하는 비밀 URL 문자열
sourceVault Key Vault의 ARM 리소스 ID SubResource

SubResource

이름 묘사
아이디 리소스 ID 문자열

CloudServiceNetworkProfile

이름 묘사
loadBalancerConfigurations 부하 분산 장치 구성 목록입니다. 클라우드 서비스에는 공용 Load Balancer 및 내부 Load Balancer에 해당하는 최대 2개의 부하 분산 장치 구성이 있을 수 있습니다. LoadBalancerConfiguration[]
slotType 클라우드 서비스의 슬롯 유형입니다.
가능한 값은 다음과 같습니다.

프로덕션

스테이징


지정하지 않으면 기본값은 Production입니다.
'Production'
'스테이징'
swappableCloudService 주체 클라우드 서비스가 교환을 수행할 수 있는 대상 IP를 포함하는 클라우드 서비스의 ID 참조입니다. 이 속성은 설정된 후에는 업데이트할 수 없습니다. 이 ID에서 참조하는 교환 가능한 클라우드 서비스가 있어야 합니다. 그렇지 않으면 오류가 throw됩니다. SubResource

LoadBalancerConfiguration

이름 묘사
아이디 리소스 ID 문자열
이름 부하 분산 장치의 이름 string(필수)
속성 부하 분산 장치 구성의 속성입니다. loadBalancerConfigurationProperties (필수)

LoadBalancerConfigurationProperties

이름 묘사
frontendIpConfigurations 부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다. LoadBalancerFrontendIpConfiguration[] (필수)

LoadBalancerFrontendIpConfiguration

이름 묘사
이름 부하 분산 장치에서 사용하는 프런트 엔드 IP 구성 집합 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다. string(필수)
속성 부하 분산 장치 프런트 엔드 IP 구성의 속성입니다. LoadBalancerFrontendIpConfigurationProperties(필수)

LoadBalancerFrontendIpConfigurationProperties

이름 묘사
privateIPAddress IP 구성의 가상 네트워크 개인 IP 주소입니다. 문자열
publicIPAddress 공용 IP 주소 리소스에 대한 참조입니다. SubResource
서브넷 가상 네트워크 서브넷 리소스에 대한 참조입니다. SubResource

CloudServiceOsProfile

이름 묘사
비밀 역할 인스턴스에 설치해야 하는 인증서 집합을 지정합니다. cloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

이름 묘사
sourceVault VaultCertificates의 모든 인증서를 포함하는 Key Vault의 상대 URL입니다. SubResource
vaultCertificates 인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다. cloudServiceVaultCertificate[]

CloudServiceVaultCertificate

이름 묘사
certificateUrl Key Vault에 비밀로 업로드된 인증서의 URL입니다. 문자열

CloudServiceRoleProfile

이름 묘사
역할 클라우드 서비스에 대한 역할 목록입니다. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

이름 묘사
이름 리소스 이름입니다. 문자열
sku 클라우드 서비스 역할 sku에 대해 설명합니다. cloudServiceRoleSku

CloudServiceRoleSku

이름 묘사
용량 클라우드 서비스의 역할 인스턴스 수를 지정합니다. int
이름 sku 이름입니다. 참고: 클라우드 서비스가 현재 있는 하드웨어에서 새 SKU가 지원되지 않는 경우 클라우드 서비스를 삭제하고 다시 만들거나 이전 sku로 다시 이동해야 합니다. 문자열
계층 클라우드 서비스의 계층을 지정합니다. 가능한 값은 다음과 같습니다.

표준

기본
문자열

SystemData

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

Terraform(AzAPI 공급자) 리소스 정의

cloudServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Compute/cloudServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/cloudServices@2022-09-04"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allowModelOverride = bool
      configuration = "string"
      configurationUrl = "string"
      extensionProfile = {
        extensions = [
          {
            name = "string"
            properties = {
              autoUpgradeMinorVersion = bool
              forceUpdateTag = "string"
              protectedSettingsFromKeyVault = {
                secretUrl = "string"
                sourceVault = {
                  id = "string"
                }
              }
              publisher = "string"
              rolesAppliedTo = [
                "string"
              ]
              type = "string"
              typeHandlerVersion = "string"
            }
          }
        ]
      }
      networkProfile = {
        loadBalancerConfigurations = [
          {
            id = "string"
            name = "string"
            properties = {
              frontendIpConfigurations = [
                {
                  name = "string"
                  properties = {
                    privateIPAddress = "string"
                    publicIPAddress = {
                      id = "string"
                    }
                    subnet = {
                      id = "string"
                    }
                  }
                }
              ]
            }
          }
        ]
        slotType = "string"
        swappableCloudService = {
          id = "string"
        }
      }
      osProfile = {
        secrets = [
          {
            sourceVault = {
              id = "string"
            }
            vaultCertificates = [
              {
                certificateUrl = "string"
              }
            ]
          }
        ]
      }
      packageUrl = "string"
      roleProfile = {
        roles = [
          {
            name = "string"
            sku = {
              capacity = int
              name = "string"
              tier = "string"
            }
          }
        ]
      }
      startCloudService = bool
      upgradeMode = "string"
    }
    systemData = {}
    zones = [
      "string" or int
    ]
  })
}

속성 값

cloudServices

이름 묘사
리소스 종류 "Microsoft.Compute/cloudServices@2022-09-04"
이름 리소스 이름 string(필수)

문자 제한: 1-15



유효한 문자:
공백, 컨트롤 문자 또는 다음 문자를 사용할 수 없습니다.
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

밑줄로 시작할 수 없습니다. 마침표나 하이픈으로 끝날 수 없습니다.
위치 리소스 위치입니다. string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
태그 리소스 태그. 태그 이름 및 값의 사전입니다.
속성 클라우드 서비스 속성 cloudServiceProperties
systemData 이 리소스와 관련된 시스템 메타 데이터입니다. systemData
영역 리소스의 논리적 가용성 영역 목록입니다. 목록에는 클라우드 서비스를 프로비전해야 하는 영역이 1개만 포함되어야 합니다. 이 필드는 선택 사항입니다. 가용성 영역의 배열을 문자열 또는 int로 지정합니다.

CloudServiceProperties

이름 묘사
allowModelOverride (선택 사항) 모델/템플릿에 지정된 역할 sku 속성(roleProfile.roles.sku)이 .cscfg 및 .csdef에 지정된 역할 인스턴스 수 및 vm 크기를 각각 재정의해야 하는지 여부를 나타냅니다.
기본값은 false.
bool
구성 클라우드 서비스에 대한 XML 서비스 구성(.cscfg)을 지정합니다. 문자열
configurationUrl Blob 서비스에서 서비스 구성의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
extensionProfile 클라우드 서비스 확장 프로필을 설명합니다. cloudServiceExtensionProfile
networkProfile 클라우드 서비스에 대한 네트워크 프로필입니다. cloudServiceNetworkProfile
osProfile 클라우드 서비스에 대한 OS 프로필을 설명합니다. CloudServiceOsProfile
packageUrl Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다.
이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.
문자열
roleProfile 클라우드 서비스의 역할 프로필에 대해 설명합니다. CloudServiceRoleProfile
startCloudService (선택 사항) 클라우드 서비스를 만든 직후 시작할지 여부를 나타냅니다. 기본값은 true.
false이면 서비스 모델은 여전히 배포되지만 코드는 즉시 실행되지 않습니다. 대신 서비스를 시작할 때 Start를 호출할 때까지 서비스가 PoweredOff입니다. 배포된 서비스는 전원이 공급되더라도 여전히 요금이 발생합니다.
bool
upgradeMode 클라우드 서비스의 업데이트 모드입니다. 역할 인스턴스는 서비스가 배포될 때 도메인을 업데이트하기 위해 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작하거나 모든 업데이트 도메인에서 자동으로 시작할 수 있습니다.
가능한 값은 다음과 같습니다.

자동

수동

동시


지정하지 않으면 기본값은 Auto입니다. 수동으로 설정하면 업데이트를 적용하려면 PUT UpdateDomain을 호출해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.
"Auto"
"수동"
"동시"

CloudServiceExtensionProfile

이름 묘사
확장 클라우드 서비스에 대한 확장 목록입니다. 확장[]

확장

이름 묘사
이름 확장의 이름입니다. 문자열
속성 확장 속성입니다. cloudServiceExtensionProperties

CloudServiceExtensionProperties

이름 묘사
autoUpgradeMinorVersion 플랫폼이 사용 가능해지면 typeHandlerVersion을 상위 부 버전으로 자동으로 업그레이드할 수 있는지 여부를 명시적으로 지정합니다. bool
forceUpdateTag 제공된 공용 및 보호된 설정을 강제로 적용하는 태그입니다.
태그 값을 변경하면 공용 또는 보호된 설정을 변경하지 않고 확장을 다시 실행할 수 있습니다.
forceUpdateTag가 변경되지 않으면 공용 또는 보호된 설정에 대한 업데이트가 처리기에서 계속 적용됩니다.
forceUpdateTag나 공용 또는 보호된 설정이 모두 변경되지 않으면 확장은 동일한 시퀀스 번호가 있는 역할 인스턴스로 이동하며,
다시 실행할지 여부는 처리기 구현에 달려 있습니다.
문자열
protectedSettings 역할 인스턴스로 전송되기 전에 암호화된 확장에 대한 보호된 설정입니다.
protectedSettingsFromKeyVault 역할 인스턴스로 전송되기 전에 암호화된 KeyVault를 사용하여 참조되는 확장에 대한 보호된 설정입니다. cloudServiceVaultAndSecretReference
게시자 확장 처리기 게시자의 이름입니다. 문자열
rolesAppliedTo 이 확장을 적용할 역할의 선택적 목록입니다. 속성을 지정하지 않거나 '*'를 지정하면 클라우드 서비스의 모든 역할에 확장이 적용됩니다. string[]
설정 확장에 대한 공용 설정입니다. JSON 확장의 경우 확장에 대한 JSON 설정입니다. XML 확장(예: RDP)의 경우 확장에 대한 XML 설정입니다.
확장의 형식을 지정합니다. 문자열
typeHandlerVersion 확장의 버전을 지정합니다. 확장의 버전을 지정합니다. 이 요소를 지정하지 않았거나 별표(*)를 값으로 사용하는 경우 최신 버전의 확장이 사용됩니다. 값이 주 버전 번호와 별표로 부 버전 번호(X.)로 지정된 경우 지정된 주 버전의 최신 부 버전이 선택됩니다. 주 버전 번호와 부 버전 번호(X.Y)가 지정된 경우 특정 확장 버전이 선택됩니다. 버전을 지정하면 역할 인스턴스에서 자동 업그레이드가 수행됩니다. 문자열

CloudServiceVaultAndSecretReference

이름 묘사
secretUrl 확장의 보호된 설정을 포함하는 비밀 URL 문자열
sourceVault Key Vault의 ARM 리소스 ID SubResource

SubResource

이름 묘사
아이디 리소스 ID 문자열

CloudServiceNetworkProfile

이름 묘사
loadBalancerConfigurations 부하 분산 장치 구성 목록입니다. 클라우드 서비스에는 공용 Load Balancer 및 내부 Load Balancer에 해당하는 최대 2개의 부하 분산 장치 구성이 있을 수 있습니다. LoadBalancerConfiguration[]
slotType 클라우드 서비스의 슬롯 유형입니다.
가능한 값은 다음과 같습니다.

프로덕션

스테이징


지정하지 않으면 기본값은 Production입니다.
"프로덕션"
"스테이징"
swappableCloudService 주체 클라우드 서비스가 교환을 수행할 수 있는 대상 IP를 포함하는 클라우드 서비스의 ID 참조입니다. 이 속성은 설정된 후에는 업데이트할 수 없습니다. 이 ID에서 참조하는 교환 가능한 클라우드 서비스가 있어야 합니다. 그렇지 않으면 오류가 throw됩니다. SubResource

LoadBalancerConfiguration

이름 묘사
아이디 리소스 ID 문자열
이름 부하 분산 장치의 이름 string(필수)
속성 부하 분산 장치 구성의 속성입니다. loadBalancerConfigurationProperties (필수)

LoadBalancerConfigurationProperties

이름 묘사
frontendIpConfigurations 부하 분산 장치에 사용할 프런트 엔드 IP를 지정합니다. IPv4 프런트 엔드 IP 주소만 지원됩니다. 각 부하 분산 장치 구성에는 정확히 하나의 프런트 엔드 IP 구성이 있어야 합니다. LoadBalancerFrontendIpConfiguration[] (필수)

LoadBalancerFrontendIpConfiguration

이름 묘사
이름 부하 분산 장치에서 사용하는 프런트 엔드 IP 구성 집합 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다. string(필수)
속성 부하 분산 장치 프런트 엔드 IP 구성의 속성입니다. LoadBalancerFrontendIpConfigurationProperties(필수)

LoadBalancerFrontendIpConfigurationProperties

이름 묘사
privateIPAddress IP 구성의 가상 네트워크 개인 IP 주소입니다. 문자열
publicIPAddress 공용 IP 주소 리소스에 대한 참조입니다. SubResource
서브넷 가상 네트워크 서브넷 리소스에 대한 참조입니다. SubResource

CloudServiceOsProfile

이름 묘사
비밀 역할 인스턴스에 설치해야 하는 인증서 집합을 지정합니다. cloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

이름 묘사
sourceVault VaultCertificates의 모든 인증서를 포함하는 Key Vault의 상대 URL입니다. SubResource
vaultCertificates 인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다. cloudServiceVaultCertificate[]

CloudServiceVaultCertificate

이름 묘사
certificateUrl Key Vault에 비밀로 업로드된 인증서의 URL입니다. 문자열

CloudServiceRoleProfile

이름 묘사
역할 클라우드 서비스에 대한 역할 목록입니다. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

이름 묘사
이름 리소스 이름입니다. 문자열
sku 클라우드 서비스 역할 sku에 대해 설명합니다. cloudServiceRoleSku

CloudServiceRoleSku

이름 묘사
용량 클라우드 서비스의 역할 인스턴스 수를 지정합니다. int
이름 sku 이름입니다. 참고: 클라우드 서비스가 현재 있는 하드웨어에서 새 SKU가 지원되지 않는 경우 클라우드 서비스를 삭제하고 다시 만들거나 이전 sku로 다시 이동해야 합니다. 문자열
계층 클라우드 서비스의 계층을 지정합니다. 가능한 값은 다음과 같습니다.

표준

기본
문자열

SystemData

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.