Microsoft.Compute 스냅샷 2024-03-02

아티클
08/17/2024

Bicep 리소스 정의

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

리소스 그룹 - 리소스 그룹 배포 명령 참조

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/snapshots@2024-03-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'CopySourceNotFound'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      elasticSanResourceId: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      performancePlus: bool
      provisionedBandwidthCopySpeed: 'string'
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    diskAccessId: 'string'
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    networkAccessPolicy: 'string'
    osType: 'string'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
      diskControllerTypes: 'string'
    }
    supportsHibernation: bool
  }
}

속성 값

스냅샷

이름	묘사	값
이름	리소스 이름	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자부터 시작합니다. 영숫자 또는 밑줄로 끝납니다.
위치	리소스 위치	string(필수)
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
sku	스냅샷 sku 이름입니다. Standard_LRS, Premium_LRS 또는 Standard_ZRS 수 있습니다. 증분 스냅샷에 대한 선택적 매개 변수이며 기본 동작은 SKU가 이전 스냅샷과 동일한 sku로 설정됨입니다.	SnapshotSku
extendedLocation	스냅샷을 만들 확장된 위치입니다. 확장된 위치는 변경할 수 없습니다.	ExtendedLocation
속성	스냅샷 리소스 속성입니다.	snapshotProperties

ExtendedLocation

이름	묘사	값
이름	확장된 위치의 이름입니다.	문자열
형	확장된 위치의 형식입니다.	'EdgeZone'

SnapshotProperties

이름	묘사	값
completionPercent	CopyStart 작업을 통해 리소스를 만들 때 백그라운드 복사에 대한 완료율입니다.	int
copyCompletionError	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 세부 정보를 나타냅니다.	copyCompletionError
creationData	디스크 원본 정보입니다. 디스크를 만든 후에는 CreationData 정보를 변경할 수 없습니다.	CreationData(필수)
dataAccessAuthMode	디스크 또는 스냅샷을 내보내거나 업로드할 때 추가 인증 요구 사항입니다.	'AzureActiveDirectory' 'None'
diskAccessId	디스크에서 프라이빗 엔드포인트를 사용하기 위한 DiskAccess 리소스의 ARM ID입니다.	문자열
diskSizeGB	creationData.createOption이 비어 있는 경우 이 필드는 필수이며 만들 디스크의 크기를 나타냅니다. 이 필드가 다른 옵션을 사용하여 업데이트 또는 만들기에 있는 경우 크기 조정을 나타냅니다. 크기 조정은 디스크가 실행 중인 VM에 연결되지 않은 경우에만 허용되며 디스크의 크기만 늘릴 수 있습니다.	int
암호화	암호화 속성을 사용하여 고객 관리형 키 또는 플랫폼 관리 키를 사용하여 미사용 데이터를 암호화할 수 있습니다.	암호화
encryptionSettingsCollection	Azure Disk Encryption으로 사용되는 암호화 설정 컬렉션은 디스크 또는 스냅샷당 여러 암호화 설정을 포함할 수 있습니다.	EncryptionSettingsCollection
hyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.	'V1' 'V2'
증분	스냅샷이 증분인지 여부입니다. 동일한 디스크의 증분 스냅샷은 전체 스냅샷보다 적은 공간을 차지하며 확산될 수 있습니다.	bool
networkAccessPolicy	네트워크를 통해 디스크에 액세스하기 위한 정책입니다.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	운영 체제 유형입니다.	'Linux' 'Windows'
publicNetworkAccess	디스크에서 내보내기를 제어하는 정책입니다.	'사용 안 함' 'Enabled'
purchasePlan	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대한 구매 계획 정보입니다.	PurchasePlan
securityProfile	리소스에 대한 보안 관련 정보를 포함합니다.	DiskSecurityProfile
supportedCapabilities	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대해 지원되는 기능 목록입니다.	SupportedCapabilities
supportsHibernation	스냅샷의 OS가 최대 절전 모드를 지원했음을 나타냅니다.	bool

CopyCompletionError

이름	묘사	값
errorCode	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 코드를 나타냅니다.	'CopySourceNotFound'(필수)
errorMessage	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하면 오류 메시지를 나타냅니다.	string(필수)

CreationData

이름	묘사	값
createOption	이렇게 하면 디스크 생성의 가능한 원본이 열거됩니다.	'Attach' 'Copy' 'CopyFromSanSnapshot' 'CopyStart' 'Empty' 'FromImage' 'Import' 'ImportSecure' '복원' '업로드' 'UploadPreparedSecure'(필수)
elasticSanResourceId	createOption이 CopyFromSanSnapshot인 경우 필요합니다. 원본 탄력적 san 볼륨 스냅샷의 ARM ID입니다.	문자열
galleryImageReference	갤러리 이미지에서 만드는 경우 필수입니다. ImageDiskReference의 id/sharedGalleryImageId/communityGalleryImageId는 디스크를 만들 공유 갤리 이미지 버전의 ARM ID입니다.	imageDiskReference
imageReference	PIR 또는 사용자 이미지에 대한 디스크 원본 정보입니다.	imageDiskReference
logicalSectorSize	Ultra 디스크의 논리적 섹터 크기(바이트)입니다. 지원되는 값은 512 광고 4096입니다. 4096이 기본값입니다.	int
performancePlus	배포된 디스크의 성능 목표를 향상시키려면 이 플래그를 true로 설정합니다. 각 성능 대상은 여기를 참조하세요. 이 플래그는 디스크 생성 시간에만 설정할 수 있으며 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.	bool
provisionedBandwidthCopySpeed	이 필드가 스냅샷에 설정되어 있고 createOption이 CopyStart이면 스냅샷이 더 빠른 속도로 복사됩니다.	'고급' 'None'
securityDataUri	createOption이 ImportSecure인 경우 VM 게스트 상태로 가져올 Blob의 URI입니다.	문자열
sourceResourceId	createOption이 Copy이면 원본 스냅샷 또는 디스크의 ARM ID입니다.	문자열
sourceUri	createOption이 가져오기인 경우 관리 디스크로 가져올 Blob의 URI입니다.	문자열
storageAccountId	createOption이 Import인 경우 필수입니다. 디스크로 가져올 Blob을 포함하는 스토리지 계정의 Azure Resource Manager 식별자입니다.	문자열
uploadSizeBytes	createOption이 업로드인 경우 VHD 바닥글을 포함하여 업로드 내용의 크기입니다. 이 값은 20972032(VHD 바닥글의 경우 20MiB + 512바이트) 및 35183298347520 바이트(VHD 바닥글의 경우 32TiB + 512바이트) 사이여야 합니다.	int

ImageDiskReference

이름	묘사	값
communityGalleryImageId	커뮤니티 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
아이디	플랫폼 이미지 리포지토리, 사용자 이미지 또는 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
lun	디스크가 이미지의 데이터 디스크에서 만들어진 경우 이 인덱스는 이미지에서 사용할 데이터 디스크를 나타내는 인덱스입니다. OS 디스크의 경우 이 필드는 null입니다.	int
sharedGalleryImageId	직접 공유 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열

암호화

이름	묘사	값
diskEncryptionSetId	미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 ResourceId입니다.	문자열
형	디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

이름	묘사	값
사용	이 플래그를 true로 설정하고 DiskEncryptionKey 및 선택적 KeyEncryptionKey를 제공하여 암호화를 사용하도록 설정합니다. 이 플래그를 false로 설정하고 DiskEncryptionKey 및 KeyEncryptionKey를 제거하여 암호화를 사용하지 않도록 설정합니다. 요청 개체에서 EncryptionSettings가 null이면 기존 설정은 변경되지 않은 상태로 유지됩니다.	bool(필수)
encryptionSettings	각 디스크 볼륨에 대해 하나씩 암호화 설정의 컬렉션입니다.	EncryptionSettingsElement[]
encryptionSettingsVersion	디스크에 사용되는 암호화 유형을 설명합니다. 이 필드가 설정되면 덮어쓸 수 없습니다. '1.0'은 AAD 앱을 사용하는 Azure Disk Encryption에 해당합니다.'1.1'은 Azure Disk Encryption에 해당합니다.	문자열

EncryptionSettingsElement

이름	묘사	값
diskEncryptionKey	디스크 암호화 키의 Key Vault 비밀 URL 및 자격 증명 모음 ID	KeyVaultAndSecretReference
keyEncryptionKey	키 암호화 키의 Key Vault 키 URL 및 자격 증명 모음 ID입니다. KeyEncryptionKey는 선택 사항이며 제공된 경우 디스크 암호화 키를 래프 해제하는 데 사용됩니다.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

이름	묘사	값
secretUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

SourceVault

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

KeyVaultAndKeyReference

이름	묘사	값
keyUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

PurchasePlan

이름	묘사	값
이름	계획 ID입니다.	string(필수)
제품	마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다.	string(필수)
promotionCode	제품 프로모션 코드입니다.	문자열
게시자	게시자 ID입니다.	string(필수)

DiskSecurityProfile

이름	묘사	값
secureVMDiskEncryptionSetId	고객 관리형 키로 암호화된 기밀 VM 지원 디스크에 연결된 디스크 암호화 집합의 ResourceId	문자열
securityType	VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_NonPersistedTPM' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

SupportedCapabilities

이름	묘사	값
acceleratedNetwork	TRUE이면 OS 디스크를 만든 이미지가 가속화된 네트워킹을 지원합니다.	bool
건축학	OS 디스크에서 지원하는 CPU 아키텍처입니다.	'Arm64' 'x64'
diskControllerTypes	OS 디스크가 지원하는 디스크 컨트롤러입니다. 설정된 경우 SCSI 또는 SCSI, NVME 또는 NVME, SCSI일 수 있습니다.	문자열

SnapshotSku

이름	묘사	값
이름	sku 이름입니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

ARM 템플릿 리소스 정의

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

리소스 그룹 - 리소스 그룹 배포 명령 참조

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

리소스 형식

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

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2024-03-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "CopySourceNotFound",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "elasticSanResourceId": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "performancePlus": "bool",
      "provisionedBandwidthCopySpeed": "string",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "diskAccessId": "string",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "osType": "string",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string",
      "diskControllerTypes": "string"
    },
    "supportsHibernation": "bool"
  }
}

속성 값

스냅샷

이름	묘사	값
형	리소스 종류	'Microsoft.Compute/snapshots'
apiVersion	리소스 api 버전	'2024-03-02'
이름	리소스 이름	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자부터 시작합니다. 영숫자 또는 밑줄로 끝납니다.
위치	리소스 위치	string(필수)
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
sku	스냅샷 sku 이름입니다. Standard_LRS, Premium_LRS 또는 Standard_ZRS 수 있습니다. 증분 스냅샷에 대한 선택적 매개 변수이며 기본 동작은 SKU가 이전 스냅샷과 동일한 sku로 설정됨입니다.	SnapshotSku
extendedLocation	스냅샷을 만들 확장된 위치입니다. 확장된 위치는 변경할 수 없습니다.	ExtendedLocation
속성	스냅샷 리소스 속성입니다.	snapshotProperties

ExtendedLocation

이름	묘사	값
이름	확장된 위치의 이름입니다.	문자열
형	확장된 위치의 형식입니다.	'EdgeZone'

SnapshotProperties

이름	묘사	값
completionPercent	CopyStart 작업을 통해 리소스를 만들 때 백그라운드 복사에 대한 완료율입니다.	int
copyCompletionError	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 세부 정보를 나타냅니다.	copyCompletionError
creationData	디스크 원본 정보입니다. 디스크를 만든 후에는 CreationData 정보를 변경할 수 없습니다.	CreationData(필수)
dataAccessAuthMode	디스크 또는 스냅샷을 내보내거나 업로드할 때 추가 인증 요구 사항입니다.	'AzureActiveDirectory' 'None'
diskAccessId	디스크에서 프라이빗 엔드포인트를 사용하기 위한 DiskAccess 리소스의 ARM ID입니다.	문자열
diskSizeGB	creationData.createOption이 비어 있는 경우 이 필드는 필수이며 만들 디스크의 크기를 나타냅니다. 이 필드가 다른 옵션을 사용하여 업데이트 또는 만들기에 있는 경우 크기 조정을 나타냅니다. 크기 조정은 디스크가 실행 중인 VM에 연결되지 않은 경우에만 허용되며 디스크의 크기만 늘릴 수 있습니다.	int
암호화	암호화 속성을 사용하여 고객 관리형 키 또는 플랫폼 관리 키를 사용하여 미사용 데이터를 암호화할 수 있습니다.	암호화
encryptionSettingsCollection	Azure Disk Encryption으로 사용되는 암호화 설정 컬렉션은 디스크 또는 스냅샷당 여러 암호화 설정을 포함할 수 있습니다.	EncryptionSettingsCollection
hyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.	'V1' 'V2'
증분	스냅샷이 증분인지 여부입니다. 동일한 디스크의 증분 스냅샷은 전체 스냅샷보다 적은 공간을 차지하며 확산될 수 있습니다.	bool
networkAccessPolicy	네트워크를 통해 디스크에 액세스하기 위한 정책입니다.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	운영 체제 유형입니다.	'Linux' 'Windows'
publicNetworkAccess	디스크에서 내보내기를 제어하는 정책입니다.	'사용 안 함' 'Enabled'
purchasePlan	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대한 구매 계획 정보입니다.	PurchasePlan
securityProfile	리소스에 대한 보안 관련 정보를 포함합니다.	DiskSecurityProfile
supportedCapabilities	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대해 지원되는 기능 목록입니다.	SupportedCapabilities
supportsHibernation	스냅샷의 OS가 최대 절전 모드를 지원했음을 나타냅니다.	bool

CopyCompletionError

이름	묘사	값
errorCode	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 코드를 나타냅니다.	'CopySourceNotFound'(필수)
errorMessage	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하면 오류 메시지를 나타냅니다.	string(필수)

CreationData

이름	묘사	값
createOption	이렇게 하면 디스크 생성의 가능한 원본이 열거됩니다.	'Attach' 'Copy' 'CopyFromSanSnapshot' 'CopyStart' 'Empty' 'FromImage' 'Import' 'ImportSecure' '복원' '업로드' 'UploadPreparedSecure'(필수)
elasticSanResourceId	createOption이 CopyFromSanSnapshot인 경우 필요합니다. 원본 탄력적 san 볼륨 스냅샷의 ARM ID입니다.	문자열
galleryImageReference	갤러리 이미지에서 만드는 경우 필수입니다. ImageDiskReference의 id/sharedGalleryImageId/communityGalleryImageId는 디스크를 만들 공유 갤리 이미지 버전의 ARM ID입니다.	imageDiskReference
imageReference	PIR 또는 사용자 이미지에 대한 디스크 원본 정보입니다.	imageDiskReference
logicalSectorSize	Ultra 디스크의 논리적 섹터 크기(바이트)입니다. 지원되는 값은 512 광고 4096입니다. 4096이 기본값입니다.	int
performancePlus	배포된 디스크의 성능 목표를 향상시키려면 이 플래그를 true로 설정합니다. 각 성능 대상은 여기를 참조하세요. 이 플래그는 디스크 생성 시간에만 설정할 수 있으며 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.	bool
provisionedBandwidthCopySpeed	이 필드가 스냅샷에 설정되어 있고 createOption이 CopyStart이면 스냅샷이 더 빠른 속도로 복사됩니다.	'고급' 'None'
securityDataUri	createOption이 ImportSecure인 경우 VM 게스트 상태로 가져올 Blob의 URI입니다.	문자열
sourceResourceId	createOption이 Copy이면 원본 스냅샷 또는 디스크의 ARM ID입니다.	문자열
sourceUri	createOption이 가져오기인 경우 관리 디스크로 가져올 Blob의 URI입니다.	문자열
storageAccountId	createOption이 Import인 경우 필수입니다. 디스크로 가져올 Blob을 포함하는 스토리지 계정의 Azure Resource Manager 식별자입니다.	문자열
uploadSizeBytes	createOption이 업로드인 경우 VHD 바닥글을 포함하여 업로드 내용의 크기입니다. 이 값은 20972032(VHD 바닥글의 경우 20MiB + 512바이트) 및 35183298347520 바이트(VHD 바닥글의 경우 32TiB + 512바이트) 사이여야 합니다.	int

ImageDiskReference

이름	묘사	값
communityGalleryImageId	커뮤니티 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
아이디	플랫폼 이미지 리포지토리, 사용자 이미지 또는 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
lun	디스크가 이미지의 데이터 디스크에서 만들어진 경우 이 인덱스는 이미지에서 사용할 데이터 디스크를 나타내는 인덱스입니다. OS 디스크의 경우 이 필드는 null입니다.	int
sharedGalleryImageId	직접 공유 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열

암호화

이름	묘사	값
diskEncryptionSetId	미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 ResourceId입니다.	문자열
형	디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

이름	묘사	값
사용	이 플래그를 true로 설정하고 DiskEncryptionKey 및 선택적 KeyEncryptionKey를 제공하여 암호화를 사용하도록 설정합니다. 이 플래그를 false로 설정하고 DiskEncryptionKey 및 KeyEncryptionKey를 제거하여 암호화를 사용하지 않도록 설정합니다. 요청 개체에서 EncryptionSettings가 null이면 기존 설정은 변경되지 않은 상태로 유지됩니다.	bool(필수)
encryptionSettings	각 디스크 볼륨에 대해 하나씩 암호화 설정의 컬렉션입니다.	EncryptionSettingsElement[]
encryptionSettingsVersion	디스크에 사용되는 암호화 유형을 설명합니다. 이 필드가 설정되면 덮어쓸 수 없습니다. '1.0'은 AAD 앱을 사용하는 Azure Disk Encryption에 해당합니다.'1.1'은 Azure Disk Encryption에 해당합니다.	문자열

EncryptionSettingsElement

이름	묘사	값
diskEncryptionKey	디스크 암호화 키의 Key Vault 비밀 URL 및 자격 증명 모음 ID	KeyVaultAndSecretReference
keyEncryptionKey	키 암호화 키의 Key Vault 키 URL 및 자격 증명 모음 ID입니다. KeyEncryptionKey는 선택 사항이며 제공된 경우 디스크 암호화 키를 래프 해제하는 데 사용됩니다.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

이름	묘사	값
secretUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

SourceVault

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

KeyVaultAndKeyReference

이름	묘사	값
keyUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

PurchasePlan

이름	묘사	값
이름	계획 ID입니다.	string(필수)
제품	마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다.	string(필수)
promotionCode	제품 프로모션 코드입니다.	문자열
게시자	게시자 ID입니다.	string(필수)

DiskSecurityProfile

이름	묘사	값
secureVMDiskEncryptionSetId	고객 관리형 키로 암호화된 기밀 VM 지원 디스크에 연결된 디스크 암호화 집합의 ResourceId	문자열
securityType	VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_NonPersistedTPM' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

SupportedCapabilities

이름	묘사	값
acceleratedNetwork	TRUE이면 OS 디스크를 만든 이미지가 가속화된 네트워킹을 지원합니다.	bool
건축학	OS 디스크에서 지원하는 CPU 아키텍처입니다.	'Arm64' 'x64'
diskControllerTypes	OS 디스크가 지원하는 디스크 컨트롤러입니다. 설정된 경우 SCSI 또는 SCSI, NVME 또는 NVME, SCSI일 수 있습니다.	문자열

SnapshotSku

이름	묘사	값
이름	sku 이름입니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

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

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

리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2024-03-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "CopySourceNotFound"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        elasticSanResourceId = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        performancePlus = bool
        provisionedBandwidthCopySpeed = "string"
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      diskAccessId = "string"
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      networkAccessPolicy = "string"
      osType = "string"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
        diskControllerTypes = "string"
      }
      supportsHibernation = bool
    }
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

속성 값

스냅샷

이름	묘사	값
형	리소스 종류	"Microsoft.Compute/snapshots@2024-03-02"
이름	리소스 이름	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자부터 시작합니다. 영숫자 또는 밑줄로 끝납니다.
위치	리소스 위치	string(필수)
parent_id	리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다.	string(필수)
태그	리소스 태그	태그 이름 및 값의 사전입니다.
sku	스냅샷 sku 이름입니다. Standard_LRS, Premium_LRS 또는 Standard_ZRS 수 있습니다. 증분 스냅샷에 대한 선택적 매개 변수이며 기본 동작은 SKU가 이전 스냅샷과 동일한 sku로 설정됨입니다.	SnapshotSku
extendedLocation	스냅샷을 만들 확장된 위치입니다. 확장된 위치는 변경할 수 없습니다.	ExtendedLocation
속성	스냅샷 리소스 속성입니다.	snapshotProperties

ExtendedLocation

이름	묘사	값
이름	확장된 위치의 이름입니다.	문자열
형	확장된 위치의 형식입니다.	"EdgeZone"

SnapshotProperties

이름	묘사	값
completionPercent	CopyStart 작업을 통해 리소스를 만들 때 백그라운드 복사에 대한 완료율입니다.	int
copyCompletionError	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 세부 정보를 나타냅니다.	copyCompletionError
creationData	디스크 원본 정보입니다. 디스크를 만든 후에는 CreationData 정보를 변경할 수 없습니다.	CreationData(필수)
dataAccessAuthMode	디스크 또는 스냅샷을 내보내거나 업로드할 때 추가 인증 요구 사항입니다.	"AzureActiveDirectory" "없음"
diskAccessId	디스크에서 프라이빗 엔드포인트를 사용하기 위한 DiskAccess 리소스의 ARM ID입니다.	문자열
diskSizeGB	creationData.createOption이 비어 있는 경우 이 필드는 필수이며 만들 디스크의 크기를 나타냅니다. 이 필드가 다른 옵션을 사용하여 업데이트 또는 만들기에 있는 경우 크기 조정을 나타냅니다. 크기 조정은 디스크가 실행 중인 VM에 연결되지 않은 경우에만 허용되며 디스크의 크기만 늘릴 수 있습니다.	int
암호화	암호화 속성을 사용하여 고객 관리형 키 또는 플랫폼 관리 키를 사용하여 미사용 데이터를 암호화할 수 있습니다.	암호화
encryptionSettingsCollection	Azure Disk Encryption으로 사용되는 암호화 설정 컬렉션은 디스크 또는 스냅샷당 여러 암호화 설정을 포함할 수 있습니다.	EncryptionSettingsCollection
hyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.	"V1" "V2"
증분	스냅샷이 증분인지 여부입니다. 동일한 디스크의 증분 스냅샷은 전체 스냅샷보다 적은 공간을 차지하며 확산될 수 있습니다.	bool
networkAccessPolicy	네트워크를 통해 디스크에 액세스하기 위한 정책입니다.	"AllowAll" "AllowPrivate" "DenyAll"
osType	운영 체제 유형입니다.	"Linux" "Windows"
publicNetworkAccess	디스크에서 내보내기를 제어하는 정책입니다.	"사용 안 함" "사용"
purchasePlan	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대한 구매 계획 정보입니다.	PurchasePlan
securityProfile	리소스에 대한 보안 관련 정보를 포함합니다.	DiskSecurityProfile
supportedCapabilities	스냅샷의 원본 디스크가 원래 만들어진 이미지에 대해 지원되는 기능 목록입니다.	SupportedCapabilities
supportsHibernation	스냅샷의 OS가 최대 절전 모드를 지원했음을 나타냅니다.	bool

CopyCompletionError

이름	묘사	값
errorCode	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하는 경우 오류 코드를 나타냅니다.	"CopySourceNotFound"(필수)
errorMessage	CopyStart 작업을 통해 만든 리소스의 백그라운드 복사본이 실패하면 오류 메시지를 나타냅니다.	string(필수)

CreationData

이름	묘사	값
createOption	이렇게 하면 디스크 생성의 가능한 원본이 열거됩니다.	"연결" "복사" "CopyFromSanSnapshot" "CopyStart" "비어 있음" "FromImage" "가져오기" "ImportSecure" "복원" "업로드" "UploadPreparedSecure"(필수)
elasticSanResourceId	createOption이 CopyFromSanSnapshot인 경우 필요합니다. 원본 탄력적 san 볼륨 스냅샷의 ARM ID입니다.	문자열
galleryImageReference	갤러리 이미지에서 만드는 경우 필수입니다. ImageDiskReference의 id/sharedGalleryImageId/communityGalleryImageId는 디스크를 만들 공유 갤리 이미지 버전의 ARM ID입니다.	imageDiskReference
imageReference	PIR 또는 사용자 이미지에 대한 디스크 원본 정보입니다.	imageDiskReference
logicalSectorSize	Ultra 디스크의 논리적 섹터 크기(바이트)입니다. 지원되는 값은 512 광고 4096입니다. 4096이 기본값입니다.	int
performancePlus	배포된 디스크의 성능 목표를 향상시키려면 이 플래그를 true로 설정합니다. 각 성능 대상은 여기를 참조하세요. 이 플래그는 디스크 생성 시간에만 설정할 수 있으며 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.	bool
provisionedBandwidthCopySpeed	이 필드가 스냅샷에 설정되어 있고 createOption이 CopyStart이면 스냅샷이 더 빠른 속도로 복사됩니다.	"고급" "없음"
securityDataUri	createOption이 ImportSecure인 경우 VM 게스트 상태로 가져올 Blob의 URI입니다.	문자열
sourceResourceId	createOption이 Copy이면 원본 스냅샷 또는 디스크의 ARM ID입니다.	문자열
sourceUri	createOption이 가져오기인 경우 관리 디스크로 가져올 Blob의 URI입니다.	문자열
storageAccountId	createOption이 Import인 경우 필수입니다. 디스크로 가져올 Blob을 포함하는 스토리지 계정의 Azure Resource Manager 식별자입니다.	문자열
uploadSizeBytes	createOption이 업로드인 경우 VHD 바닥글을 포함하여 업로드 내용의 크기입니다. 이 값은 20972032(VHD 바닥글의 경우 20MiB + 512바이트) 및 35183298347520 바이트(VHD 바닥글의 경우 32TiB + 512바이트) 사이여야 합니다.	int

ImageDiskReference

이름	묘사	값
communityGalleryImageId	커뮤니티 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
아이디	플랫폼 이미지 리포지토리, 사용자 이미지 또는 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열
lun	디스크가 이미지의 데이터 디스크에서 만들어진 경우 이 인덱스는 이미지에서 사용할 데이터 디스크를 나타내는 인덱스입니다. OS 디스크의 경우 이 필드는 null입니다.	int
sharedGalleryImageId	직접 공유 Azure Compute 갤러리 이미지 참조를 포함하는 상대 URI입니다.	문자열

암호화

이름	묘사	값
diskEncryptionSetId	미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 ResourceId입니다.	문자열
형	디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다.	"EncryptionAtRestWithCustomerKey" "EncryptionAtRestWithPlatformAndCustomerKeys" "EncryptionAtRestWithPlatformKey"

EncryptionSettingsCollection

이름	묘사	값
사용	이 플래그를 true로 설정하고 DiskEncryptionKey 및 선택적 KeyEncryptionKey를 제공하여 암호화를 사용하도록 설정합니다. 이 플래그를 false로 설정하고 DiskEncryptionKey 및 KeyEncryptionKey를 제거하여 암호화를 사용하지 않도록 설정합니다. 요청 개체에서 EncryptionSettings가 null이면 기존 설정은 변경되지 않은 상태로 유지됩니다.	bool(필수)
encryptionSettings	각 디스크 볼륨에 대해 하나씩 암호화 설정의 컬렉션입니다.	EncryptionSettingsElement[]
encryptionSettingsVersion	디스크에 사용되는 암호화 유형을 설명합니다. 이 필드가 설정되면 덮어쓸 수 없습니다. '1.0'은 AAD 앱을 사용하는 Azure Disk Encryption에 해당합니다.'1.1'은 Azure Disk Encryption에 해당합니다.	문자열

EncryptionSettingsElement

이름	묘사	값
diskEncryptionKey	디스크 암호화 키의 Key Vault 비밀 URL 및 자격 증명 모음 ID	KeyVaultAndSecretReference
keyEncryptionKey	키 암호화 키의 Key Vault 키 URL 및 자격 증명 모음 ID입니다. KeyEncryptionKey는 선택 사항이며 제공된 경우 디스크 암호화 키를 래프 해제하는 데 사용됩니다.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

이름	묘사	값
secretUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

SourceVault

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

KeyVaultAndKeyReference

이름	묘사	값
keyUrl	KeyVault에서 키 또는 비밀을 가리키는 URL	string(필수)
sourceVault	키 또는 비밀을 포함하는 KeyVault의 리소스 ID	SourceVault(필수)

PurchasePlan

이름	묘사	값
이름	계획 ID입니다.	string(필수)
제품	마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다.	string(필수)
promotionCode	제품 프로모션 코드입니다.	문자열
게시자	게시자 ID입니다.	string(필수)

DiskSecurityProfile

이름	묘사	값
secureVMDiskEncryptionSetId	고객 관리형 키로 암호화된 기밀 VM 지원 디스크에 연결된 디스크 암호화 집합의 ResourceId	문자열
securityType	VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_NonPersistedTPM" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

SupportedCapabilities

이름	묘사	값
acceleratedNetwork	TRUE이면 OS 디스크를 만든 이미지가 가속화된 네트워킹을 지원합니다.	bool
건축학	OS 디스크에서 지원하는 CPU 아키텍처입니다.	"Arm64" "x64"
diskControllerTypes	OS 디스크가 지원하는 디스크 컨트롤러입니다. 설정된 경우 SCSI 또는 SCSI, NVME 또는 NVME, SCSI일 수 있습니다.	문자열

SnapshotSku

이름	묘사	값
이름	sku 이름입니다.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

다음을 통해 공유

Microsoft.Compute 스냅샷 2024-03-02

Bicep 리소스 정의

리소스 형식

속성 값

스냅샷

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

암호화

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

ARM 템플릿 리소스 정의

리소스 형식

속성 값

스냅샷

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

암호화

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

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

리소스 형식

속성 값

스냅샷

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

암호화

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

피드백

추가 리소스