다음을 통해 공유

Microsoft.Compute 갤러리/애플리케이션/버전

  • 아티클

Bicep 리소스 정의

갤러리/애플리케이션/버전 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2023-07-03' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    publishingProfile: {
      advancedSettings: {
        {customized property}: 'string'
      }
      customActions: [
        {
          description: 'string'
          name: 'string'
          parameters: [
            {
              defaultValue: 'string'
              description: 'string'
              name: 'string'
              required: bool
              type: 'string'
            }
          ]
          script: 'string'
        }
      ]
      enableHealthCheck: bool
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      manageActions: {
        install: 'string'
        remove: 'string'
        update: 'string'
      }
      replicaCount: int
      replicationMode: 'string'
      settings: {
        configFileName: 'string'
        packageFileName: 'string'
      }
      source: {
        defaultConfigurationLink: 'string'
        mediaLink: 'string'
      }
      storageAccountType: 'string'
      targetExtendedLocations: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          extendedLocation: {
            name: 'string'
            type: 'string'
          }
          extendedLocationReplicaCount: int
          name: 'string'
          storageAccountType: 'string'
        }
      ]
      targetRegions: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          excludeFromLatest: bool
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    safetyProfile: {
      allowDeletionOfReplicatedLocations: bool
    }
  }
}

속성 값

gallerys/applications/versions

Name Description 값
name 리소스 이름

Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.		 string(필수)

문자 제한: 32비트 정수

유효한 문자:
숫자 및 마침표
(각 세그먼트는 int32로 변환됩니다. 따라서 각 세그먼트의 최대 값은 2,147,483,647입니다.)
위치 리소스 위치 string(필수)
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
부모(parent) Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다.

자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요.		 형식의 리소스에 대한 기호화된 이름: 애플리케이션
properties 갤러리 이미지 버전의 속성을 설명합니다. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name Description 값
publishingProfile 갤러리 이미지 버전의 게시 프로필입니다. GalleryApplicationVersionPublishingProfile (필수)
safetyProfile 갤러리 애플리케이션 버전의 안전 프로필입니다. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name Description 값
advancedSettings 선택 사항입니다. vm-application-manager 확장에 전달할 추가 설정입니다. 고급 전용입니다. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions 이 갤러리 애플리케이션 버전으로 수행할 수 있는 사용자 지정 작업 목록입니다. GalleryApplicationCustomAction[]
enableHealthCheck 선택 사항입니다. 이 애플리케이션이 상태를 보고하는지 여부입니다. bool
endOfLifeDate 갤러리 이미지 버전의 수명 종료 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다. string
excludeFromLatest true로 설정하면 최신 버전의 이미지 정의에서 배포된 Virtual Machines 이 이미지 버전을 사용하지 않습니다. bool
manageActions UserArtifactManage
replicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 regionReplicaCount가 지정되지 않은 지역에 적용됩니다. 이 속성은 업데이트할 수 있습니다. int
replicationMode 복제에 사용할 모드를 지정하는 선택적 매개 변수입니다. 이 속성은 업데이트할 수 없습니다. 'Full'
'얕은'
설정 대상 VM 또는 VM 확장 집합에 배포될 때 대상 패키지 및 구성 파일 이름을 포함하는 VM 앱에 대한 추가 설정입니다. UserArtifactSettings
source 이미지 버전을 만들 원본 이미지입니다. UserArtifactSource (필수)
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations 이미지 버전이 복제될 대상 확장 위치입니다. 이 속성은 업데이트할 수 있습니다. GalleryTargetExtendedLocation[]
targetRegions 이미지 버전이 복제될 대상 지역입니다. 이 속성은 업데이트할 수 있습니다. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name Description 값
{customized property} 문자열

GalleryApplicationCustomAction

Name Description 값
description 사용자가 이 사용자 지정 작업이 수행하는 작업을 이해하는 데 도움이 되는 설명입니다. 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
매개 변수 이 사용자 지정 작업에서 사용하는 매개 변수 GalleryApplicationCustomActionParameter[]
스크립트 이 사용자 지정 작업을 실행할 때 실행할 스크립트입니다. string(필수)

GalleryApplicationCustomActionParameter

Name Description 값
defaultValue 매개 변수의 기본값입니다. 문자열 형식에만 적용됩니다. 문자열
description 사용자가 이 매개 변수의 의미를 이해하는 데 도움이 되는 설명 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
필수 사용자 지정 작업을 실행할 때 이 매개 변수를 전달해야 하는지 여부를 나타냅니다. bool
형식 사용자 지정 작업 매개 변수의 형식을 지정합니다. 가능한 값은 String, ConfigurationDataBlob 또는 LogOutputBlob입니다. 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

UserArtifactManage

Name Description 값
설치 필수 사항입니다. 갤러리 애플리케이션을 설치할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
remove 필수 사항입니다. 갤러리 애플리케이션을 제거할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
update 선택 사항입니다. 갤러리 애플리케이션을 업데이트할 경로 및 인수입니다. 없는 경우 업데이트 작업은 이전 버전에서 remove 명령을 호출하고 현재 버전의 갤러리 애플리케이션에 명령을 설치합니다. 4096자로 제한됩니다. 문자열

UserArtifactSettings

Name Description 값
configFileName 선택 사항입니다. VM에서 다운로드한 구성 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 구성 파일의 이름이 "_config"가 추가된 갤러리 애플리케이션 이름으로 지정됩니다. 문자열
packageFileName 선택 사항입니다. VM에서 다운로드한 패키지 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 패키지 파일의 이름은 갤러리 애플리케이션 이름과 동일합니다. 문자열

UserArtifactSource

Name Description 값
defaultConfigurationLink 선택 사항입니다. 아티팩트 의 defaultConfigurationLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. 문자열
mediaLink 필수 사항입니다. 아티팩트 mediaLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. string(필수)

GalleryTargetExtendedLocation

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
extendedLocation 확장된 위치의 이름입니다. GalleryExtendedLocation
extendedLocationReplicaCount 확장된 위치당 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
name 영역의 이름입니다. string
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Name Description 값
dataDiskImages 데이터 디스크 이미지에 대한 암호화 사양 목록입니다. DataDiskImageEncryption[]
osDiskImage OS 디스크 이미지에 대한 암호화 설정을 포함합니다. OSDiskImageEncryption

DataDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. 문자열
lun 이 속성은 데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 Virtual Machine 내에서 데이터 디스크를 식별하는 데 사용되므로 Virtual Machine에 연결된 각 데이터 디스크에 대해 고유해야 합니다. int(필수)

OSDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. 문자열
securityProfile 이 속성은 OS 디스크 이미지의 보안 프로필을 지정합니다. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name Description 값
confidentialVMEncryptionType 기밀 VM 암호화 유형 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId 보안 VM 디스크 암호화 집합 ID string

GalleryExtendedLocation

Name Description 값
name 문자열
type 확장된 위치의 형식입니다. 'EdgeZone'
'알 수 없음'

TargetRegion

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
excludeFromLatest 사용자가 version='latest'를 지정할 때 이미지를 숨기는 플래그 설정을 포함합니다. bool
name 영역의 이름입니다. string(필수)
regionalReplicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryApplicationVersionSafetyProfile

Name Description 값
allowDeletionOfReplicatedLocations 복제된 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다. bool

ARM 템플릿 리소스 정의

갤러리/애플리케이션/버전 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

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

리소스 형식

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

{
  "type": "Microsoft.Compute/galleries/applications/versions",
  "apiVersion": "2023-07-03",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "publishingProfile": {
      "advancedSettings": {
        "{customized property}": "string"
      },
      "customActions": [
        {
          "description": "string",
          "name": "string",
          "parameters": [
            {
              "defaultValue": "string",
              "description": "string",
              "name": "string",
              "required": "bool",
              "type": "string"
            }
          ],
          "script": "string"
        }
      ],
      "enableHealthCheck": "bool",
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "manageActions": {
        "install": "string",
        "remove": "string",
        "update": "string"
      },
      "replicaCount": "int",
      "replicationMode": "string",
      "settings": {
        "configFileName": "string",
        "packageFileName": "string"
      },
      "source": {
        "defaultConfigurationLink": "string",
        "mediaLink": "string"
      },
      "storageAccountType": "string",
      "targetExtendedLocations": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "extendedLocation": {
            "name": "string",
            "type": "string"
          },
          "extendedLocationReplicaCount": "int",
          "name": "string",
          "storageAccountType": "string"
        }
      ],
      "targetRegions": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "excludeFromLatest": "bool",
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": "bool"
    }
  }
}

속성 값

gallerys/applications/versions

Name Description 값
형식 리소스 종류 'Microsoft.Compute/gallerys/applications/versions'
apiVersion 리소스 api 버전 '2023-07-03'
name 리소스 이름

JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요.		 string(필수)

문자 제한: 32비트 정수

유효한 문자:
숫자 및 마침표
(각 세그먼트는 int32로 변환됩니다. 따라서 각 세그먼트의 최대 값은 2,147,483,647입니다.)
위치 리소스 위치 string(필수)
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
properties 갤러리 이미지 버전의 속성을 설명합니다. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name Description 값
publishingProfile 갤러리 이미지 버전의 게시 프로필입니다. GalleryApplicationVersionPublishingProfile (필수)
safetyProfile 갤러리 애플리케이션 버전의 안전 프로필입니다. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name Description 값
advancedSettings 선택 사항입니다. vm-application-manager 확장에 전달할 추가 설정입니다. 고급 용도로만 사용할 수 있습니다. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions 이 갤러리 애플리케이션 버전으로 수행할 수 있는 사용자 지정 작업 목록입니다. GalleryApplicationCustomAction[]
enableHealthCheck 선택 사항입니다. 이 애플리케이션이 상태를 보고하는지 여부입니다. bool
endOfLifeDate 갤러리 이미지 버전의 수명 종료 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다. string
excludeFromLatest true로 설정하면 최신 버전의 이미지 정의에서 배포된 Virtual Machines 이 이미지 버전을 사용하지 않습니다. bool
manageActions UserArtifactManage
replicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 regionReplicaCount가 지정되지 않은 지역에 적용됩니다. 이 속성은 업데이트할 수 있습니다. int
replicationMode 복제에 사용할 모드를 지정하는 선택적 매개 변수입니다. 이 속성은 업데이트할 수 없습니다. 'Full'
'얕은'
설정 대상 VM 또는 VM 확장 집합에 배포될 때 대상 패키지 및 구성 파일 이름이 포함된 VM 앱에 대한 추가 설정입니다. UserArtifactSettings
source 이미지 버전을 만들 원본 이미지입니다. UserArtifactSource (필수)
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations 이미지 버전이 복제될 대상 확장 위치입니다. 이 속성은 업데이트할 수 있습니다. GalleryTargetExtendedLocation[]
targetRegions 이미지 버전이 복제될 대상 지역입니다. 이 속성은 업데이트할 수 있습니다. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name Description 값
{customized property} 문자열

GalleryApplicationCustomAction

Name Description 값
description 사용자가 이 사용자 지정 작업이 수행하는 작업을 이해하는 데 도움이 되는 설명입니다. 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
매개 변수 이 사용자 지정 작업에서 사용하는 매개 변수 GalleryApplicationCustomActionParameter[]
스크립트 이 사용자 지정 작업을 실행할 때 실행할 스크립트입니다. string(필수)

GalleryApplicationCustomActionParameter

Name Description 값
defaultValue 매개 변수의 기본값입니다. 문자열 형식에만 적용됩니다. 문자열
description 사용자가 이 매개 변수의 의미를 이해하는 데 도움이 되는 설명 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
필수 사용자 지정 작업을 실행할 때 이 매개 변수를 전달해야 하는지 여부를 나타냅니다. bool
형식 사용자 지정 작업 매개 변수의 형식을 지정합니다. 가능한 값은 String, ConfigurationDataBlob 또는 LogOutputBlob입니다. 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

UserArtifactManage

Name Description 값
설치 필수 사항입니다. 갤러리 애플리케이션을 설치할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
remove 필수 사항입니다. 갤러리 애플리케이션을 제거할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
update 선택 사항입니다. 갤러리 애플리케이션을 업데이트할 경로 및 인수입니다. 없는 경우 업데이트 작업은 이전 버전에서 remove 명령을 호출하고 현재 버전의 갤러리 애플리케이션에 명령을 설치합니다. 4096자로 제한됩니다. 문자열

UserArtifactSettings

Name Description 값
configFileName 선택 사항입니다. VM에서 다운로드한 구성 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 구성 파일의 이름이 "_config"가 추가된 갤러리 애플리케이션 이름으로 지정됩니다. 문자열
packageFileName 선택 사항입니다. VM에서 다운로드한 패키지 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 패키지 파일의 이름은 갤러리 애플리케이션 이름과 동일합니다. 문자열

UserArtifactSource

Name Description 값
defaultConfigurationLink 선택 사항입니다. 아티팩트 의 defaultConfigurationLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. 문자열
mediaLink 필수 사항입니다. 아티팩트 mediaLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. string(필수)

GalleryTargetExtendedLocation

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
extendedLocation 확장된 위치의 이름입니다. GalleryExtendedLocation
extendedLocationReplicaCount 확장된 위치당 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
name 영역의 이름입니다. string
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Name Description 값
dataDiskImages 데이터 디스크 이미지에 대한 암호화 사양 목록입니다. DataDiskImageEncryption[]
osDiskImage OS 디스크 이미지에 대한 암호화 설정을 포함합니다. OSDiskImageEncryption

DataDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. string
lun 이 속성은 데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 Virtual Machine 내에서 데이터 디스크를 식별하는 데 사용되므로 Virtual Machine에 연결된 각 데이터 디스크에 대해 고유해야 합니다. int(필수)

OSDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. string
securityProfile 이 속성은 OS 디스크 이미지의 보안 프로필을 지정합니다. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name Description 값
confidentialVMEncryptionType 기밀 VM 암호화 유형 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId 보안 VM 디스크 암호화 집합 ID string

GalleryExtendedLocation

Name Description 값
name 문자열
type 확장된 위치의 형식입니다. 'EdgeZone'
'알 수 없음'

TargetRegion

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
excludeFromLatest 사용자가 version='latest'를 지정할 때 이미지를 숨기는 플래그 설정을 포함합니다. bool
name 영역의 이름입니다. string(필수)
regionalReplicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryApplicationVersionSafetyProfile

Name Description 값
allowDeletionOfReplicatedLocations 복제된 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다. bool

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

갤러리/애플리케이션/버전 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

  • 리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/applications/versions@2023-07-03"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        advancedSettings = {
          {customized property} = "string"
        }
        customActions = [
          {
            description = "string"
            name = "string"
            parameters = [
              {
                defaultValue = "string"
                description = "string"
                name = "string"
                required = bool
                type = "string"
              }
            ]
            script = "string"
          }
        ]
        enableHealthCheck = bool
        endOfLifeDate = "string"
        excludeFromLatest = bool
        manageActions = {
          install = "string"
          remove = "string"
          update = "string"
        }
        replicaCount = int
        replicationMode = "string"
        settings = {
          configFileName = "string"
          packageFileName = "string"
        }
        source = {
          defaultConfigurationLink = "string"
          mediaLink = "string"
        }
        storageAccountType = "string"
        targetExtendedLocations = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            extendedLocation = {
              name = "string"
              type = "string"
            }
            extendedLocationReplicaCount = int
            name = "string"
            storageAccountType = "string"
          }
        ]
        targetRegions = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            excludeFromLatest = bool
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      safetyProfile = {
        allowDeletionOfReplicatedLocations = bool
      }
    }
  })
}

속성 값

gallerys/applications/versions

Name Description 값
형식 리소스 종류 "Microsoft.Compute/gallerys/applications/versions@2023-07-03"
name 리소스 이름 string(필수)

문자 제한: 32비트 정수

유효한 문자:
숫자 및 마침표
(각 세그먼트는 int32로 변환됩니다. 따라서 각 세그먼트의 최대 값은 2,147,483,647입니다.)
위치 리소스 위치 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 유형의 리소스에 대한 ID: 애플리케이션
tags 리소스 태그 태그 이름 및 값의 사전입니다.
properties 갤러리 이미지 버전의 속성을 설명합니다. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name Description 값
publishingProfile 갤러리 이미지 버전의 게시 프로필입니다. GalleryApplicationVersionPublishingProfile (필수)
safetyProfile 갤러리 애플리케이션 버전의 안전 프로필입니다. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name Description 값
advancedSettings 선택 사항입니다. vm-application-manager 확장에 전달할 추가 설정입니다. 고급 전용입니다. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions 이 갤러리 애플리케이션 버전으로 수행할 수 있는 사용자 지정 작업 목록입니다. GalleryApplicationCustomAction[]
enableHealthCheck 선택 사항입니다. 이 애플리케이션이 상태를 보고하는지 여부입니다. bool
endOfLifeDate 갤러리 이미지 버전의 수명 종료 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다. 문자열
excludeFromLatest true로 설정하면 최신 버전의 이미지 정의에서 배포된 Virtual Machines 이 이미지 버전을 사용하지 않습니다. bool
manageActions UserArtifactManage
replicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 regionReplicaCount가 지정되지 않은 지역에 적용됩니다. 이 속성은 업데이트할 수 있습니다. int
replicationMode 복제에 사용할 모드를 지정하는 선택적 매개 변수입니다. 이 속성은 업데이트할 수 없습니다. "Full"
"얕은"
설정 대상 VM 또는 VM 확장 집합에 배포될 때 대상 패키지 및 구성 파일 이름을 포함하는 VM 앱에 대한 추가 설정입니다. UserArtifactSettings
source 이미지 버전을 만들 원본 이미지입니다. UserArtifactSource (필수)
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations 이미지 버전이 복제될 대상 확장 위치입니다. 이 속성은 업데이트할 수 있습니다. GalleryTargetExtendedLocation[]
targetRegions 이미지 버전이 복제될 대상 지역입니다. 이 속성은 업데이트할 수 있습니다. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name Description 값
{customized property} 문자열

GalleryApplicationCustomAction

Name Description 값
description 사용자가 이 사용자 지정 작업이 수행하는 작업을 이해하는 데 도움이 되는 설명입니다. 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
매개 변수 이 사용자 지정 작업에서 사용하는 매개 변수 GalleryApplicationCustomActionParameter[]
스크립트 이 사용자 지정 작업을 실행할 때 실행할 스크립트입니다. string(필수)

GalleryApplicationCustomActionParameter

Name Description 값
defaultValue 매개 변수의 기본값입니다. 문자열 형식에만 적용됩니다. 문자열
description 사용자가 이 매개 변수의 의미를 이해하는 데 도움이 되는 설명 문자열
name 사용자 지정 작업의 이름입니다. 갤러리 애플리케이션 버전 내에서 고유해야 합니다. string(필수)
필수 사용자 지정 작업을 실행할 때 이 매개 변수를 전달해야 하는지 여부를 나타냅니다. bool
형식 사용자 지정 작업 매개 변수의 형식을 지정합니다. 가능한 값은 String, ConfigurationDataBlob 또는 LogOutputBlob입니다. "ConfigurationDataBlob"
"LogOutputBlob"
"String"

UserArtifactManage

Name Description 값
설치 필수 사항입니다. 갤러리 애플리케이션을 설치할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
remove 필수 사항입니다. 갤러리 애플리케이션을 제거할 경로 및 인수입니다. 4096자로 제한됩니다. string(필수)
update 선택 사항입니다. 갤러리 애플리케이션을 업데이트할 경로 및 인수입니다. 없는 경우 업데이트 작업은 이전 버전에서 remove 명령을 호출하고 현재 버전의 갤러리 애플리케이션에 명령을 설치합니다. 4096자로 제한됩니다. 문자열

UserArtifactSettings

Name Description 값
configFileName 선택 사항입니다. VM에서 다운로드한 구성 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 구성 파일의 이름이 "_config"가 추가된 갤러리 애플리케이션 이름으로 지정됩니다. 문자열
packageFileName 선택 사항입니다. VM에서 다운로드한 패키지 파일을 할당할 이름입니다. 4096자로 제한됩니다. 지정하지 않으면 패키지 파일의 이름은 갤러리 애플리케이션 이름과 동일합니다. 문자열

UserArtifactSource

Name Description 값
defaultConfigurationLink 선택 사항입니다. 아티팩트 의 defaultConfigurationLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. 문자열
mediaLink 필수 사항입니다. 아티팩트 mediaLink는 읽을 수 있는 스토리지 페이지 Blob이어야 합니다. string(필수)

GalleryTargetExtendedLocation

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
extendedLocation 확장된 위치의 이름입니다. GalleryExtendedLocation
extendedLocationReplicaCount 확장된 위치당 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
name 영역의 이름입니다. string
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Name Description 값
dataDiskImages 데이터 디스크 이미지에 대한 암호화 사양 목록입니다. DataDiskImageEncryption[]
osDiskImage OS 디스크 이미지에 대한 암호화 설정을 포함합니다. OSDiskImageEncryption

DataDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. 문자열
lun 이 속성은 데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 Virtual Machine 내에서 데이터 디스크를 식별하는 데 사용되므로 Virtual Machine에 연결된 각 데이터 디스크에 대해 고유해야 합니다. int(필수)

OSDiskImageEncryption

Name Description 값
diskEncryptionSetId 디스크 암호화 집합의 리소스 ID를 포함하는 상대 URI입니다. 문자열
securityProfile 이 속성은 OS 디스크 이미지의 보안 프로필을 지정합니다. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name Description 값
confidentialVMEncryptionType 기밀 VM 암호화 유형 "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId 보안 VM 디스크 암호화 집합 ID 문자열

GalleryExtendedLocation

Name Description 값
name 문자열
type 확장된 위치의 형식입니다. "EdgeZone"
"알 수 없음"

TargetRegion

Name Description 값
암호화 선택 사항입니다. 사용자가 갤러리 아티팩트에서 OS 및 데이터 디스크를 암호화하기 위한 고객 관리형 키를 제공할 수 있습니다. EncryptionImages
excludeFromLatest 사용자가 version='latest'를 지정할 때 이미지를 숨기는 플래그 설정을 포함합니다. bool
name 영역의 이름입니다. string(필수)
regionalReplicaCount 지역별로 만들 이미지 버전의 복제본 수입니다. 이 속성은 업데이트할 수 있습니다. int
storageAccountType 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 이 속성은 업데이트할 수 없습니다. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Name Description 값
allowDeletionOfReplicatedLocations 복제된 지역에서 이 갤러리 이미지 버전을 제거할 수 있는지 여부를 나타냅니다. bool