Virtual Machine Image Templates - Get

서비스:: Image Builder

API 버전:: 2022-07-01

가상 머신 이미지 템플릿에 대한 정보 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}?api-version=2022-07-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
imageTemplateName	path	True	string pattern: ^[A-Za-z0-9-_.]{1,64}$	이미지 템플릿의 이름
resourceGroupName	path	True	string	리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.
api-version	query	True	string	클라이언트 API 버전입니다.

응답

Name	형식	Description
200 OK	ImageTemplate	그래
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Retrieve an Image Template.

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate?api-version=2022-07-01

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
  "name": "myImageTemplate",
  "location": "westus",
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
        "clientId": "00000000-0000-0000-0000-000000000000",
        "principalId": "00000000-0000-0000-0000-000000000000"
      }
    }
  },
  "properties": {
    "source": {
      "type": "ManagedImage",
      "imageId": "/subscriptions/{subscription-id}/resourceGroups/source_rg/providers/Microsoft.Compute/images/source_image"
    },
    "customize": [
      {
        "type": "Shell",
        "name": "Shell Customizer Example",
        "scriptUri": "https://example.com/path/to/script.sh"
      }
    ],
    "distribute": [
      {
        "type": "ManagedImage",
        "location": "1_location",
        "runOutputName": "image_it_pir_1",
        "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
        "artifactTags": {
          "tagName": "value"
        }
      }
    ],
    "vmProfile": {
      "vmSize": "Standard_D2s_v3",
      "osDiskSizeGB": 64
    }
  }
}

정의

Name	Description
CloudError	Azure VM Image Builder 서비스의 오류 응답입니다.
CloudErrorBody	Azure VM Image Builder 서비스의 오류 응답입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DistributeVersionerLatest	기존 버전 번호를 기반으로 최신 버전 번호를 생성합니다.
DistributeVersionerSource	원본 이미지의 버전 번호를 기반으로 버전 번호를 생성합니다.
ImageTemplate	이미지 템플릿은 Microsoft.VirtualMachineImages 공급자가 관리하는 ARM 리소스입니다.
ImageTemplateFileCustomizer	VM(Linux, Windows)에 파일을 업로드합니다. Packer 파일 프로비저닝자에 해당
ImageTemplateFileValidator	유효성 검사에 필요한 파일을 VM(Linux, Windows)에 업로드합니다. Packer 파일 프로비저닝자에 해당
ImageTemplateIdentity	이미지 템플릿의 ID입니다.
ImageTemplateLastRunStatus	이미지 템플릿 실행의 최신 상태를 설명합니다.
ImageTemplateManagedImageDistributor	Managed Disk 이미지로 배포합니다.
ImageTemplateManagedImageSource	고객 구독에서 관리되는 이미지인 이미지 원본에 대해 설명합니다. 이 이미지는 Image Builder 템플릿과 동일한 구독 및 지역에 있어야 합니다.
ImageTemplatePlatformImageSource	Azure 갤러리 이미지 이미지 원본에 대해 설명합니다.
ImageTemplatePowerShellCustomizer	VM(Windows)에서 지정된 PowerShell을 실행합니다. Packer PowerShell 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.
ImageTemplatePowerShellValidator	유효성 검사 단계(Windows)에서 지정된 PowerShell 스크립트를 실행합니다. Packer PowerShell 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.
ImageTemplateRestartCustomizer	VM을 다시 부팅하고 다시 온라인 상태가 될 때까지 기다립니다(Windows). Packer windows-restart 프로비저닝에 해당
ImageTemplateSharedImageDistributor	Azure Compute 갤러리를 통해 배포합니다.
ImageTemplateSharedImageVersionSource	Azure Compute 갤러리 또는 직접 공유 갤러리의 이미지 버전인 이미지 원본에 대해 설명합니다.
ImageTemplateShellCustomizer	사용자 지정 단계(Linux) 중에 셸 스크립트를 실행합니다. Packer 셸 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.
ImageTemplateShellValidator	유효성 검사 단계(Linux)에서 지정된 셸 스크립트를 실행합니다. Packer 셸 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.
ImageTemplateVhdDistributor	스토리지 계정에서 VHD를 통해 배포합니다.
ImageTemplateVmProfile	이미지를 빌드하고 유효성을 검사하는 데 사용되는 가상 머신에 대해 설명합니다.
ImageTemplateWindowsUpdateCustomizer	Windows 업데이트를 설치합니다. Packer Windows 업데이트 프로비저닝기(https://github.com/rgl/packer-provisioner-windows-update)에 해당합니다.
Optimize	이미지에서 수행할 최적화를 지정합니다.
PlatformImagePurchasePlan	플랫폼 이미지에 대한 구매 계획 구성입니다.
ProvisioningError	이미지 템플릿을 만들거나 업데이트할 때 발생한 오류에 대해 설명합니다.
ProvisioningErrorCode	프로비저닝 실패의 오류 코드
ProvisioningState	리소스의 프로비전 상태
ResourceIdentityType	이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.
RunState	마지막 실행의 상태
RunSubState	마지막 실행의 하위 상태
SharedImageStorageAccountType	Azure Compute 갤러리 이미지 버전을 저장하는 데 사용할 스토리지 계정 유형을 지정합니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TargetRegion	대상 지역 정보를 설명합니다.
UserAssignedIdentity	사용자 할당 ID 속성
Validate	결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.
VirtualNetworkConfig	Virtual Network 구성.
VmBoot	더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.
VMBootOptimizationState	이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.

CloudError

Object

Azure VM Image Builder 서비스의 오류 응답입니다.

Name	형식	Description
error	CloudErrorBody	오류에 대한 세부 정보입니다.

CloudErrorBody

Object

Azure VM Image Builder 서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DistributeVersionerLatest

Object

기존 버전 번호를 기반으로 최신 버전 번호를 생성합니다.

Name	형식	Default value	Description
major	integer (int32) minimum: -1	-1	생성된 버전 번호의 주 버전입니다. 이 값을 주 버전으로 사용하는 버전에 따라 "최신"이 무엇인지 확인합니다. -1은 설정되지 않은 상태로 두는 것과 같습니다.
scheme	string: Latest		사용할 버전 번호 매기기 체계입니다.

DistributeVersionerSource

Object

원본 이미지의 버전 번호를 기반으로 버전 번호를 생성합니다.

Name	형식	Description
scheme	string: Source	사용할 버전 번호 매기기 체계입니다.

ImageTemplate

Object

이미지 템플릿은 Microsoft.VirtualMachineImages 공급자가 관리하는 ARM 리소스입니다.

Name	형식	Default value	Description
id	string		리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ImageTemplateIdentity		구성된 경우 이미지 템플릿의 ID입니다.
location	string		리소스가 있는 지리적 위치
name	string		리소스의 이름
properties.buildTimeoutInMinutes	integer (int32) minimum: 0 maximum: 960	0	이미지 템플릿을 빌드하는 동안 대기할 최대 기간(모든 사용자 지정, 최적화, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다.
properties.customize	ImageTemplateCustomizer[]: ImageTemplateFileCustomizer[] ImageTemplatePowerShellCustomizer[] ImageTemplateRestartCustomizer[] ImageTemplateShellCustomizer[] ImageTemplateWindowsUpdateCustomizer[]		이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다.
properties.distribute	ImageTemplateDistributor[]: ImageTemplateManagedImageDistributor[] ImageTemplateSharedImageDistributor[] ImageTemplateVhdDistributor[]		이미지 출력을 이동해야 하는 배포 대상입니다.
properties.exactStagingResourceGroup	string		이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 읽기 전용 필드는 'stagingResourceGroup' 필드에 지정된 값이 비어 있는 경우에만 'stagingResourceGroup'와 다릅니다.
properties.lastRunStatus	ImageTemplateLastRunStatus		현재 실행 중이거나 마지막으로 실행된 'run' 상태입니다.
properties.optimize	Optimize		이미지에서 수행할 최적화를 지정합니다.
properties.provisioningError	ProvisioningError		프로비전 오류(있는 경우)
properties.provisioningState	ProvisioningState		리소스의 프로비전 상태
properties.source	ImageTemplateSource: ImageTemplateManagedImageSource ImageTemplatePlatformImageSource ImageTemplateSharedImageVersionSource		원본 이미지를 설명하는 데 사용되는 속성을 지정합니다.
properties.stagingResourceGroup	string		이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 생성됩니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿 삭제 중에 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체는 유지됩니다.
properties.validate	Validate		결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.
properties.vmProfile	ImageTemplateVmProfile		가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다.
systemData	systemData		createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object		리소스 태그.
type	string		리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ImageTemplateFileCustomizer

Object

VM(Linux, Windows)에 파일을 업로드합니다. Packer 파일 프로비저닝자에 해당

Name	형식	Description
destination	string	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)
name	string	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
sha256Checksum	string	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬
sourceUri	string	VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.
type	string: File	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.

ImageTemplateFileValidator

Object

유효성 검사에 필요한 파일을 VM(Linux, Windows)에 업로드합니다. Packer 파일 프로비저닝자에 해당

Name	형식	Description
destination	string	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)
name	string	이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
sha256Checksum	string	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬
sourceUri	string	유효성 검사를 위해 VM에 업로드할 파일의 URI입니다. Github 링크, Azure Storage URI(권한 있는 또는 SAS) 등일 수 있습니다.
type	string: File	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.

ImageTemplateIdentity

Object

이미지 템플릿의 ID입니다.

Name	형식	Description
type	ResourceIdentityType	이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ImageTemplateLastRunStatus

Object

이미지 템플릿 실행의 최신 상태를 설명합니다.

Name	형식	Description
endTime	string (date-time)	마지막 실행의 종료 시간(UTC)
message	string	마지막 실행 상태에 대한 자세한 정보
runState	RunState	마지막 실행의 상태
runSubState	RunSubState	마지막 실행의 하위 상태
startTime	string (date-time)	마지막 실행의 시작 시간(UTC)

ImageTemplateManagedImageDistributor

Object

Managed Disk 이미지로 배포합니다.

Name	형식	Description
artifactTags	object	배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.
imageId	string	Managed Disk 이미지의 리소스 ID
location	string	이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다.
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$	연결된 RunOutput에 사용할 이름입니다.
type	string: ManagedImage	배포 유형입니다.

ImageTemplateManagedImageSource

Object

고객 구독에서 관리되는 이미지인 이미지 원본에 대해 설명합니다. 이 이미지는 Image Builder 템플릿과 동일한 구독 및 지역에 있어야 합니다.

Name	형식	Description
imageId	string	고객 구독에서 관리되는 이미지의 ARM 리소스 ID
type	string: ManagedImage	시작하려는 원본 이미지의 형식을 지정합니다.

ImageTemplatePlatformImageSource

Object

Azure 갤러리 이미지 이미지 원본에 대해 설명합니다.

Name	형식	Description
exactVersion	string	Azure Gallery 이미지이미지 버전입니다. 이 읽기 전용 필드는 'version' 필드에 지정된 값이 'latest'인 경우에만 'version'와 다릅니다.
offer	string	Azure Gallery 이미지이미지 제품.
planInfo	PlatformImagePurchasePlan	플랫폼 이미지에 대한 구매 계획의 선택적 구성입니다.
publisher	string	Azure Gallery 이미지이미지 게시자.
sku	string	Azure Gallery 이미지이미지 sku.
type	string: PlatformImage	시작하려는 원본 이미지의 형식을 지정합니다.
version	string	Azure Gallery 이미지이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다.

ImageTemplatePowerShellCustomizer

Object

VM(Windows)에서 지정된 PowerShell을 실행합니다. Packer PowerShell 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.

Name	형식	Default value	Description
inline	string[]		실행할 PowerShell 명령 배열
name	string		이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
runAsSystem	boolean	False	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.
runElevated	boolean	False	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.
scriptUri	string		사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.
sha256Checksum	string		위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬
type	string: PowerShell		이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.
validExitCodes	integer[] (int32)		PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]

ImageTemplatePowerShellValidator

Object

유효성 검사 단계(Windows)에서 지정된 PowerShell 스크립트를 실행합니다. Packer PowerShell 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.

Name	형식	Default value	Description
inline	string[]		실행할 PowerShell 명령 배열
name	string		이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
runAsSystem	boolean	False	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.
runElevated	boolean	False	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.
scriptUri	string		유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.
sha256Checksum	string		위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬
type	string: PowerShell		이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.
validExitCodes	integer[] (int32)		PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]

ImageTemplateRestartCustomizer

Object

VM을 다시 부팅하고 다시 온라인 상태가 될 때까지 기다립니다(Windows). Packer windows-restart 프로비저닝에 해당

Name	형식	Description
name	string	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
restartCheckCommand	string	다시 시작이 성공했는지 확인하는 명령 [기본값: '']
restartCommand	string	다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"']
restartTimeout	string	크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m']
type	string: WindowsRestart	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.

ImageTemplateSharedImageDistributor

Object

Azure Compute 갤러리를 통해 배포합니다.

Name	형식	Default value	Description
artifactTags	object		배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.
excludeFromLatest	boolean	False	만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다.
galleryImageId	string		Azure Compute 갤러리 이미지의 리소스 ID
replicationRegions	string[]		[사용되지 않음] 이미지가 복제될 지역 목록입니다. targetRegions를 지정하지 않은 경우에만 이 목록을 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$		연결된 RunOutput에 사용할 이름입니다.
storageAccountType	SharedImageStorageAccountType		[사용되지 않음] 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 이 필드는 replicationRegions가 지정된 경우에만 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.
targetRegions	TargetRegion[]		분산 이미지 버전이 복제될 대상 지역입니다. 이 개체는 replicationRegions를 대체하며 replicationRegions를 지정하지 않은 경우에만 지정할 수 있습니다.
type	string: SharedImage		배포 유형입니다.
versioning	DistributeVersioner: DistributeVersionerLatest DistributeVersionerSource		배포를 위해 새 x.y.z 버전 번호를 생성하는 방법을 설명합니다.

ImageTemplateSharedImageVersionSource

Object

Azure Compute 갤러리 또는 직접 공유 갤러리의 이미지 버전인 이미지 원본에 대해 설명합니다.

Name	형식	Description
exactVersion	string	이미지 버전의 정확한 ARM 리소스 ID입니다. 이 읽기 전용 필드는 'imageVersionId' 필드에 지정된 버전 이름이 'latest'인 경우에만 'imageVersionId'의 이미지 버전 ID와 다릅니다.
imageVersionId	string	이미지 버전의 ARM 리소스 ID입니다. 이미지 버전 이름이 '최신'인 경우 이미지 빌드가 발생할 때 버전이 평가됩니다.
type	string: SharedImageVersion	시작하려는 원본 이미지의 형식을 지정합니다.

ImageTemplateShellCustomizer

Object

사용자 지정 단계(Linux) 중에 셸 스크립트를 실행합니다. Packer 셸 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.

Name	형식	Description
inline	string[]	실행할 셸 명령 배열
name	string	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
scriptUri	string	사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.
sha256Checksum	string	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬
type	string: Shell	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.

ImageTemplateShellValidator

Object

유효성 검사 단계(Linux)에서 지정된 셸 스크립트를 실행합니다. Packer 셸 프로비저닝자에 해당합니다. 정확히 'scriptUri' 또는 'inline' 중 하나를 지정할 수 있습니다.

Name	형식	Description
inline	string[]	실행할 셸 명령 배열
name	string	이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
scriptUri	string	유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.
sha256Checksum	string	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬
type	string: Shell	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.

ImageTemplateVhdDistributor

Object

스토리지 계정에서 VHD를 통해 배포합니다.

Name	형식	Description
artifactTags	object	배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.
runOutputName	string pattern: ^[A-Za-z0-9-_.]{1,64}$	연결된 RunOutput에 사용할 이름입니다.
type	string: VHD	배포 유형입니다.
uri	string	분산 VHD Blob에 대한 선택적 Azure Storage URI입니다. 기본값(빈 문자열)을 사용하지 않습니다. 이 경우 VHD는 준비 리소스 그룹의 스토리지 계정에 게시됩니다.

ImageTemplateVmProfile

Object

이미지를 빌드하고 유효성을 검사하는 데 사용되는 가상 머신에 대해 설명합니다.

Name	형식	Default value	Description
osDiskSizeGB	integer (int32) minimum: 0	0	OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다.
userAssignedIdentities	string[]		빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다.
vmSize	string		이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4).
vnetConfig	VirtualNetworkConfig		빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다.

ImageTemplateWindowsUpdateCustomizer

Object

Windows 업데이트를 설치합니다. Packer Windows 업데이트 프로비저닝기(https://github.com/rgl/packer-provisioner-windows-update)에 해당합니다.

Name	형식	Default value	Description
filters	string[]		적용할 업데이트를 선택할 필터 배열입니다. 기본값을 사용하도록 빈 배열을 생략하거나 지정합니다(필터 없음). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.
name	string		이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름
searchCriteria	string		업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.
type	string: WindowsUpdate		이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.
updateLimit	integer (int32) minimum: 0	0	한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000).

Optimize

Object

이미지에서 수행할 최적화를 지정합니다.

Name	형식	Description
vmBoot	VmBoot	더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.

PlatformImagePurchasePlan

Object

플랫폼 이미지에 대한 구매 계획 구성입니다.

Name	형식	Description
planName	string	구매 플랜의 이름입니다.
planProduct	string	구매 플랜의 제품입니다.
planPublisher	string	구매 플랜의 게시자입니다.

ProvisioningError

Object

이미지 템플릿을 만들거나 업데이트할 때 발생한 오류에 대해 설명합니다.

Name	형식	Description
message	string	프로비저닝 실패에 대한 자세한 오류 메시지
provisioningErrorCode	ProvisioningErrorCode	프로비저닝 실패의 오류 코드

ProvisioningErrorCode

열거형

프로비저닝 실패의 오류 코드

값	Description
BadSourceType
BadPIRSource
BadManagedImageSource
BadSharedImageVersionSource
BadCustomizerType
UnsupportedCustomizerType
NoCustomizerScript
BadValidatorType
UnsupportedValidatorType
NoValidatorScript
BadDistributeType
BadSharedImageDistribute
BadStagingResourceGroup
ServerError
Other

ProvisioningState

열거형

리소스의 프로비전 상태

값	Description
Creating
Updating
Succeeded
Failed
Deleting
Canceled

ResourceIdentityType

열거형

이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.

값	Description
UserAssigned
None

RunState

열거형

마지막 실행의 상태

값	Description
Running
Canceling
Succeeded
PartiallySucceeded
Failed
Canceled

RunSubState

열거형

마지막 실행의 하위 상태

값	Description
Queued
Building
Customizing
Optimizing
Validating
Distributing

SharedImageStorageAccountType

열거형

Azure Compute 갤러리 이미지 버전을 저장하는 데 사용할 스토리지 계정 유형을 지정합니다.

값	Description
Standard_LRS
Standard_ZRS
Premium_LRS

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

TargetRegion

Object

대상 지역 정보를 설명합니다.

Name	형식	Default value	Description
name	string		지역 이름입니다.
replicaCount	integer (int32) minimum: 1	1	이 지역에서 만들 이미지 버전의 복제본 수입니다. 기본값(1)을 사용하지 않습니다.
storageAccountType	SharedImageStorageAccountType		이 지역에 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 기본값(Standard_LRS)을 사용하지 않습니다.

UserAssignedIdentity

Object

사용자 할당 ID 속성

Name	형식	Description
clientId	string	할당된 ID의 클라이언트 ID입니다.
principalId	string	할당된 ID의 보안 주체 ID입니다.

Validate

Object

결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.

Name	형식	Default value	Description
continueDistributeOnFailure	boolean	False	유효성 검사가 실패하고 이 필드가 false로 설정되면 출력 이미지가 배포되지 않습니다. 이 옵션은 기본 동작입니다. 유효성 검사가 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 잘못된 이미지가 배포될 수 있으므로 이 옵션을 주의해서 사용하세요. 두 경우 모두(true 또는 false) 엔드 투 엔드 이미지 실행은 유효성 검사 실패 시 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.]
inVMValidations	ImageTemplateInVMValidator[]: ImageTemplateFileValidator[] ImageTemplatePowerShellValidator[] ImageTemplateShellValidator[]		수행할 유효성 검사 목록입니다.
sourceValidationOnly	boolean	False	이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정된 이미지를 생성하고 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다.

VirtualNetworkConfig

Object

Virtual Network 구성.

Name	형식	Description
proxyVmSize	string	빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.
subnetId	string	기존 서브넷의 리소스 ID입니다.

VmBoot

Object

더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.

Name	형식	Description
state	VMBootOptimizationState	이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.

VMBootOptimizationState

열거형

이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.

값	Description
Enabled
Disabled

다음을 통해 공유

Virtual Machine Image Templates - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

Retrieve an Image Template.

샘플 요청

샘플 응답

정의

CloudError

CloudErrorBody

createdByType

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplate

ImageTemplateFileCustomizer

ImageTemplateFileValidator

ImageTemplateIdentity

ImageTemplateLastRunStatus

ImageTemplateManagedImageDistributor

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplatePowerShellCustomizer

ImageTemplatePowerShellValidator

ImageTemplateRestartCustomizer

ImageTemplateSharedImageDistributor

ImageTemplateSharedImageVersionSource

ImageTemplateShellCustomizer

ImageTemplateShellValidator

ImageTemplateVhdDistributor

ImageTemplateVmProfile

ImageTemplateWindowsUpdateCustomizer

Optimize

PlatformImagePurchasePlan

ProvisioningError

ProvisioningErrorCode

ProvisioningState

ResourceIdentityType

RunState

RunSubState

SharedImageStorageAccountType

systemData

TargetRegion

UserAssignedIdentity

Validate

VirtualNetworkConfig

VmBoot

VMBootOptimizationState