Microsoft.Compute gallerys/images/versions
Bicep リソース定義
gallerys/images/versions リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/gallerys/images/versions リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Compute/galleries/images/versions@2023-07-03' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
publishingProfile: {
endOfLifeDate: 'string'
excludeFromLatest: bool
replicaCount: int
replicationMode: '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
}
securityProfile: {
uefiSettings: {
additionalSignatures: {
db: [
{
type: 'string'
value: [
'string'
]
}
]
dbx: [
{
type: 'string'
value: [
'string'
]
}
]
kek: [
{
type: 'string'
value: [
'string'
]
}
]
pk: {
type: 'string'
value: [
'string'
]
}
}
signatureTemplateNames: [
'string'
]
}
}
storageProfile: {
dataDiskImages: [
{
hostCaching: 'string'
lun: int
source: {
id: 'string'
storageAccountId: 'string'
uri: 'string'
}
}
]
osDiskImage: {
hostCaching: 'string'
source: {
id: 'string'
storageAccountId: 'string'
uri: 'string'
}
}
source: {
communityGalleryImageId: 'string'
id: 'string'
virtualMachineId: 'string'
}
}
}
}
プロパティ値
galleries/images/versions
名前 | 説明 | 値 |
---|---|---|
name | リソース名 Bicep で子リソースの名前と型を設定する方法を参照してください。 |
string (必須) 文字制限: 32 ビット整数 有効な文字: 数字とピリオド。 (各セグメントは int32 に変換されます。したがって、各セグメントの最大値は 2,147,483,647 です。) |
location | リソースの場所 | string (必須) |
tags | リソース タグ | タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください |
parent | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「 親リソースの外部にある子リソース」を参照してください。 |
種類のリソースのシンボル名: images |
properties | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryImageVersionProperties |
GalleryImageVersionProperties
名前 | 説明 | 値 |
---|---|---|
publishingProfile | ギャラリー イメージバージョンの発行プロファイル。 | GalleryImageVersionPublishingProfile |
safetyProfile | これは、ギャラリー イメージ バージョンの安全プロファイルです。 | GalleryImageVersionSafetyProfile |
securityProfile | ギャラリー イメージ バージョンのセキュリティ プロファイル | ImageVersionSecurityProfile |
storageProfile | これは、ギャラリー イメージ バージョンのストレージ プロファイルです。 | GalleryImageVersionStorageProfile (必須) |
GalleryImageVersionPublishingProfile
名前 | 説明 | 値 |
---|---|---|
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | string |
excludeFromLatest | true に設定Virtual Machines、イメージ定義の最新バージョンからデプロイされた場合、このイメージ バージョンは使用されません。 | [bool] |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | INT |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | 'Full' 'シャロー' |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲット拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryTargetExtendedLocation
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
extendedLocation | 拡張場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
name | 領域の名前。 | string |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
EncryptionImages
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれます。 | OSDiskImageEncryption |
DataDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
OSDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
名前 | 説明 | 値 |
---|---|---|
confidentialVMEncryptionType | 機密 VM 暗号化の種類 | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | string |
GalleryExtendedLocation
名前 | 説明 | 値 |
---|---|---|
name | string | |
type | これは拡張された場所の種類です。 | 'EdgeZone' '不明' |
TargetRegion
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | [bool] |
name | 領域の名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
GalleryImageVersionSafetyProfile
名前 | 説明 | 値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | [bool] |
ImageVersionSecurityProfile
名前 | 説明 | 値 |
---|---|---|
uefiSettings | イメージ バージョンの UEFI 設定が含まれています。 | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
名前 | 説明 | 値 |
---|---|---|
additionalSignatures | 署名テンプレートに加えてイメージに追加される追加の UEFI キー署名 | UefiKeySignatures |
signatureTemplateNames | イメージに追加される既定の UEFI キー署名を含むテンプレートの名前。 | 次のいずれかを含む文字列配列: 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate' |
UefiKeySignatures
名前 | 説明 | 値 |
---|---|---|
db | このイメージ バージョンの UEFI キーのデータベース。 | UefiKey[] |
dbx | このイメージ バージョンの取り消された UEFI キーのデータベース。 | UefiKey[] |
Kek | このイメージ バージョンのキー暗号化キー。 | UefiKey[] |
pk | このイメージ バージョンのプラットフォーム キー。 | UefiKey |
UefiKey
名前 | 説明 | 値 |
---|---|---|
type | キー署名の種類。 | 'sha256' 'x509' |
value | キー署名の値。 | string[] |
GalleryImageVersionStorageProfile
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの一覧。 | GalleryDataDiskImage[] |
osDiskImage | これは OS ディスク イメージです。 | GalleryOSDiskImage |
source | ギャラリー成果物バージョンのソース。 | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | 'None' 'ReadOnly' 'ReadWrite' |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryDiskImageSource
名前 | 説明 | 値 |
---|---|---|
id | ギャラリー成果物バージョン ソースの ID。 | string |
storageAccountId | この成果物バージョンのソースとして使用されている vhd BLOB を含むストレージ アカウント ID。 | string |
uri | ギャラリー成果物バージョン ソースの URI。 現在、vhd/BLOB ソースを指定するために使用されます。 | string |
GalleryOSDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | 'None' 'ReadOnly' 'ReadWrite' |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
名前 | 説明 | 値 |
---|---|---|
communityGalleryImageId | ソース コミュニティ ギャラリー イメージのリソース ID。 コミュニティ ギャラリー イメージをソースとして使用する場合にのみ必要です。 | string |
id | ギャラリー成果物バージョン ソースの ID。 | string |
virtualMachineId | ソース仮想マシンのリソース ID。 このギャラリー イメージ バージョンをソースとする仮想マシンをキャプチャする場合にのみ必要です。 | string |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
Azure Compute Gallery でイメージ バージョンを作成する |
このテンプレートを使用すると、Azure Compute Gallery で簡単なイメージ バージョンを作成できます。 これをデプロイする前に、Azure Compute Gallery 101 テンプレートとイメージ定義 101 テンプレートを実行していることを確認してください。 |
ARM テンプレート リソース定義
gallerys/images/versions リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/gallerys/images/versions リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Compute/galleries/images/versions",
"apiVersion": "2023-07-03",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"publishingProfile": {
"endOfLifeDate": "string",
"excludeFromLatest": "bool",
"replicaCount": "int",
"replicationMode": "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"
},
"securityProfile": {
"uefiSettings": {
"additionalSignatures": {
"db": [
{
"type": "string",
"value": [ "string" ]
}
],
"dbx": [
{
"type": "string",
"value": [ "string" ]
}
],
"kek": [
{
"type": "string",
"value": [ "string" ]
}
],
"pk": {
"type": "string",
"value": [ "string" ]
}
},
"signatureTemplateNames": [ "string" ]
}
},
"storageProfile": {
"dataDiskImages": [
{
"hostCaching": "string",
"lun": "int",
"source": {
"id": "string",
"storageAccountId": "string",
"uri": "string"
}
}
],
"osDiskImage": {
"hostCaching": "string",
"source": {
"id": "string",
"storageAccountId": "string",
"uri": "string"
}
},
"source": {
"communityGalleryImageId": "string",
"id": "string",
"virtualMachineId": "string"
}
}
}
}
プロパティ値
galleries/images/versions
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.Compute/gallerys/images/versions' |
apiVersion | リソース API のバージョン | '2023-07-03' |
name | リソース名 JSON ARM テンプレートで子リソースの名前と型を設定する方法を参照してください。 |
string (必須) 文字制限: 32 ビット整数 有効な文字: 数字とピリオド。 (各セグメントは int32 に変換されます。したがって、各セグメントの最大値は 2,147,483,647 です。) |
location | リソースの場所 | string (必須) |
tags | リソース タグ | タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください |
properties | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryImageVersionProperties |
GalleryImageVersionProperties
名前 | 説明 | 値 |
---|---|---|
publishingProfile | ギャラリー イメージバージョンの発行プロファイル。 | GalleryImageVersionPublishingProfile |
safetyProfile | これは、ギャラリー イメージ バージョンの安全プロファイルです。 | GalleryImageVersionSafetyProfile |
securityProfile | ギャラリー イメージ バージョンのセキュリティ プロファイル | ImageVersionSecurityProfile |
storageProfile | これは、ギャラリー イメージ バージョンのストレージ プロファイルです。 | GalleryImageVersionStorageProfile (必須) |
GalleryImageVersionPublishingProfile
名前 | 説明 | 値 |
---|---|---|
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | string |
excludeFromLatest | true に設定Virtual Machines、イメージ定義の最新バージョンからデプロイされた場合、このイメージ バージョンは使用されません。 | [bool] |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | INT |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | 'Full' 'シャロー' |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲット拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryTargetExtendedLocation
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS とデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
extendedLocation | 拡張場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
name | 領域の名前。 | string |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
EncryptionImages
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれています。 | OSDiskImageEncryption |
DataDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
OSDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
名前 | 説明 | 値 |
---|---|---|
confidentialVMEncryptionType | 機密 VM 暗号化の種類 | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | string |
GalleryExtendedLocation
名前 | 説明 | 値 |
---|---|---|
name | string | |
type | これは拡張された場所の種類です。 | 'EdgeZone' '不明' |
TargetRegion
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS とデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | [bool] |
name | 領域の名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
GalleryImageVersionSafetyProfile
名前 | 説明 | 値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | [bool] |
ImageVersionSecurityProfile
名前 | 説明 | 値 |
---|---|---|
uefiSettings | イメージ バージョンの UEFI 設定が含まれています。 | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
名前 | 説明 | 値 |
---|---|---|
additionalSignatures | 署名テンプレートに加えてイメージに追加される追加の UEFI キー署名 | UefiKeySignatures |
signatureTemplateNames | イメージに追加される既定の UEFI キー署名を含むテンプレートの名前。 | 次のいずれかを含む文字列配列: 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate' |
UefiKeySignatures
名前 | 説明 | 値 |
---|---|---|
db | このイメージ バージョンの UEFI キーのデータベース。 | UefiKey[] |
dbx | このイメージ バージョンで取り消された UEFI キーのデータベース。 | UefiKey[] |
Kek | このイメージ バージョンのキー暗号化キー。 | UefiKey[] |
pk | このイメージ バージョンのプラットフォーム キー。 | UefiKey |
UefiKey
名前 | 説明 | 値 |
---|---|---|
type | キー署名の種類。 | 'sha256' 'x509' |
value | キー署名の値。 | string[] |
GalleryImageVersionStorageProfile
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの一覧。 | GalleryDataDiskImage[] |
osDiskImage | これは OS ディスク イメージです。 | GalleryOSDiskImage |
source | ギャラリー成果物バージョンのソース。 | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | 'None' 'ReadOnly' 'ReadWrite' |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryDiskImageSource
名前 | 説明 | 値 |
---|---|---|
id | ギャラリー成果物バージョン ソースの ID。 | string |
storageAccountId | この成果物バージョンのソースとして使用されている vhd BLOB を含むストレージ アカウント ID。 | string |
uri | ギャラリー成果物バージョン ソースの URI。 現在、vhd/BLOB ソースを指定するために使用されます。 | string |
GalleryOSDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | 'None' 'ReadOnly' 'ReadWrite' |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
名前 | 説明 | 値 |
---|---|---|
communityGalleryImageId | ソース コミュニティ ギャラリー イメージのリソース ID。 コミュニティ ギャラリー イメージをソースとして使用する場合にのみ必要です。 | string |
id | ギャラリー成果物バージョン ソースの ID。 | string |
virtualMachineId | ソース仮想マシンのリソース ID。 このギャラリー イメージ バージョンをソースとする仮想マシンをキャプチャする場合にのみ必要です。 | string |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
Azure Compute Gallery でイメージ バージョンを作成する |
このテンプレートを使用すると、Azure Compute Gallery で簡単なイメージ バージョンを作成できます。 これをデプロイする前に、Azure Compute Gallery 101 テンプレートとイメージ定義 101 テンプレートを実行していることを確認してください。 |
Terraform (AzAPI プロバイダー) リソース定義
gallerys/images/versions リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/gallerys/images/versions リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/images/versions@2023-07-03"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
publishingProfile = {
endOfLifeDate = "string"
excludeFromLatest = bool
replicaCount = int
replicationMode = "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
}
securityProfile = {
uefiSettings = {
additionalSignatures = {
db = [
{
type = "string"
value = [
"string"
]
}
]
dbx = [
{
type = "string"
value = [
"string"
]
}
]
kek = [
{
type = "string"
value = [
"string"
]
}
]
pk = {
type = "string"
value = [
"string"
]
}
}
signatureTemplateNames = [
"string"
]
}
}
storageProfile = {
dataDiskImages = [
{
hostCaching = "string"
lun = int
source = {
id = "string"
storageAccountId = "string"
uri = "string"
}
}
]
osDiskImage = {
hostCaching = "string"
source = {
id = "string"
storageAccountId = "string"
uri = "string"
}
}
source = {
communityGalleryImageId = "string"
id = "string"
virtualMachineId = "string"
}
}
}
})
}
プロパティ値
galleries/images/versions
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.Compute/gallerys/images/versions@2023-07-03" |
name | リソース名 | string (必須) 文字制限: 32 ビット整数 有効な文字: 数字とピリオド。 (各セグメントは int32 に変換されます。したがって、各セグメントの最大値は 2,147,483,647 です。) |
location | リソースの場所 | string (必須) |
parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: イメージ |
tags | リソース タグ | タグの名前と値のディクショナリ。 |
properties | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryImageVersionProperties |
GalleryImageVersionProperties
名前 | 説明 | 値 |
---|---|---|
publishingProfile | ギャラリー イメージバージョンの発行プロファイル。 | GalleryImageVersionPublishingProfile |
safetyProfile | これは、ギャラリー イメージ バージョンの安全プロファイルです。 | GalleryImageVersionSafetyProfile |
securityProfile | ギャラリー イメージ バージョンのセキュリティ プロファイル | ImageVersionSecurityProfile |
storageProfile | これは、ギャラリー イメージ バージョンのストレージ プロファイルです。 | GalleryImageVersionStorageProfile (必須) |
GalleryImageVersionPublishingProfile
名前 | 説明 | 値 |
---|---|---|
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | string |
excludeFromLatest | true に設定Virtual Machines、イメージ定義の最新バージョンからデプロイされた場合、このイメージ バージョンは使用されません。 | [bool] |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | INT |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | "Full" "シャロー" |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲット拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryTargetExtendedLocation
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS とデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
extendedLocation | 拡張場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
name | 領域の名前。 | string |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
EncryptionImages
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれています。 | OSDiskImageEncryption |
DataDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
OSDiskImageEncryption
名前 | 説明 | 値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | string |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
名前 | 説明 | 値 |
---|---|---|
confidentialVMEncryptionType | 機密 VM 暗号化の種類 | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | string |
GalleryExtendedLocation
名前 | 説明 | 値 |
---|---|---|
name | string | |
type | これは拡張された場所の種類です。 | "EdgeZone" "Unknown" |
TargetRegion
名前 | 説明 | 値 |
---|---|---|
暗号化 (encryption) | 省略可能。 ユーザーがギャラリー成果物の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できるようにします。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | [bool] |
name | 領域の名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | INT |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
GalleryImageVersionSafetyProfile
名前 | 説明 | 値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | [bool] |
ImageVersionSecurityProfile
名前 | 説明 | 値 |
---|---|---|
uefiSettings | イメージ バージョンの UEFI 設定が含まれています。 | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
名前 | 説明 | 値 |
---|---|---|
additionalSignatures | 署名テンプレートに加えてイメージに追加される追加の UEFI キー署名 | UefiKeySignatures |
signatureTemplateNames | イメージに追加される既定の UEFI キー署名を含むテンプレートの名前。 | 次のいずれかを含む文字列配列: "MicrosoftUefiCertificateAuthorityTemplate" "MicrosoftWindowsTemplate" "NoSignatureTemplate" |
UefiKeySignatures
名前 | 説明 | 値 |
---|---|---|
db | このイメージ バージョンの UEFI キーのデータベース。 | UefiKey[] |
dbx | このイメージ バージョンの取り消された UEFI キーのデータベース。 | UefiKey[] |
Kek | このイメージ バージョンのキー暗号化キー。 | UefiKey[] |
pk | このイメージ バージョンのプラットフォーム キー。 | UefiKey |
UefiKey
名前 | 説明 | 値 |
---|---|---|
type | キー署名の種類。 | "sha256" "x509" |
value | キー署名の値。 | string[] |
GalleryImageVersionStorageProfile
名前 | 説明 | 値 |
---|---|---|
dataDiskImages | データ ディスク イメージの一覧。 | GalleryDataDiskImage[] |
osDiskImage | これは OS ディスク イメージです。 | GalleryOSDiskImage |
source | ギャラリー成果物バージョンのソース。 | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | "None" "ReadOnly" "ReadWrite" |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryDiskImageSource
名前 | 説明 | 値 |
---|---|---|
id | ギャラリー成果物バージョン ソースの ID。 | string |
storageAccountId | この成果物バージョンのソースとして使用されている VHD BLOB を含むストレージ アカウント ID。 | string |
uri | ギャラリー成果物バージョン ソースの URI。 現在、vhd/BLOB ソースを指定するために使用されます。 | string |
GalleryOSDiskImage
名前 | 説明 | 値 |
---|---|---|
hostCaching | ディスクのホスト キャッシュ。 有効な値は、'None'、'ReadOnly'、および 'ReadWrite' です | "None" "ReadOnly" "ReadWrite" |
source | ディスク イメージのソース。 | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
名前 | 説明 | 値 |
---|---|---|
communityGalleryImageId | ソース コミュニティ ギャラリー イメージのリソース ID。 コミュニティ ギャラリー イメージをソースとして使用する場合にのみ必要です。 | string |
id | ギャラリー成果物バージョン ソースの ID。 | string |
virtualMachineId | ソース仮想マシンのリソース ID。 このギャラリー イメージ バージョンをソースとする仮想マシンをキャプチャする場合にのみ必要です。 | string |