Microsoft.Compute ギャラリー/アプリケーション/バージョン 2024-03-03
Bicep リソース定義
ギャラリー/アプリケーション/バージョンのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Compute/galleries/applications/versions リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2024-03-03' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
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'
scriptBehaviorAfterReboot: '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: [
{
additionalReplicaSets: [
{
regionalReplicaCount: int
storageAccountType: 'string'
}
]
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
}
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
AdditionalReplicaSet
名前 | 形容 | 価値 |
---|---|---|
regionalReplicaCount | 作成するイメージ バージョンのダイレクト ドライブ レプリカの数。このプロパティは更新可能です | int |
storageAccountType | ダイレクト ドライブ レプリカの作成に使用するストレージ アカウントの種類を指定します | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
EncryptionImages
名前 | 形容 | 価値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれています。 | OSDiskImageEncryption の |
GalleryApplicationCustomAction
名前 | 形容 | 価値 |
---|---|---|
形容 | このカスタム アクションの動作をユーザーが理解するのに役立つ説明。 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
パラメーター | このカスタム アクションで使用されるパラメーター | GalleryApplicationCustomActionParameter[] |
スクリプト | このカスタム アクションの実行時に実行するスクリプト。 | string (必須) |
GalleryApplicationCustomActionParameter
名前 | 形容 | 価値 |
---|---|---|
defaultValue | パラメーターの既定値。 文字列型にのみ適用されます | 糸 |
形容 | ユーザーがこのパラメーターの意味を理解するのに役立つ説明 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
必須 | カスタム アクションの実行時にこのパラメーターを渡す必要があるかどうかを示します。 | bool |
種類 | カスタム アクション パラメーターの種類を指定します。 指定できる値は、String、ConfigurationDataBlob、LogOutputBlob です。 | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
名前 | 形容 | 価値 |
---|---|---|
publishingProfile | ギャラリー イメージ バージョンの発行プロファイル。 | GalleryApplicationVersionPublishingProfile (必須) |
safetyProfile | ギャラリー アプリケーション バージョンの安全性プロファイル。 | GalleryApplicationVersionSafetyProfile の |
GalleryApplicationVersionPublishingProfile
名前 | 形容 | 価値 |
---|---|---|
advancedSettings | 随意。 vm-application-manager 拡張機能に渡す追加の設定。 高度な使用のみ。 | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | このギャラリー アプリケーション バージョンで実行できるカスタム アクションの一覧。 | GalleryApplicationCustomAction[] |
enableHealthCheck | 随意。 このアプリケーションが正常性を報告するかどうか。 | bool |
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | 糸 |
excludeFromLatest | true に設定すると、イメージ定義の最新バージョンからデプロイされた Virtual Machines では、このイメージ バージョンは使用されません。 | bool |
manageActions | UserArtifactManage | |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | int |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | 'Full' 'Shallow' |
設定 | ターゲット VM または VM スケール セットにデプロイされるときに、ターゲット パッケージと構成ファイル名を含む VM アプリの追加設定。 | UserArtifactSettings の |
源 | イメージ バージョンの作成元となるソース イメージ。 | UserArtifactSource (必須) |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲットの拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
名前 | 形容 | 価値 |
---|
GalleryApplicationVersionSafetyProfile
名前 | 形容 | 価値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | bool |
GalleryExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
名前 | 糸 | |
種類 | これは拡張された場所の型です。 | 'EdgeZone' 'Unknown' |
GalleryTargetExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
extendedLocation | 拡張された場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
名前 | リージョンの名前。 | 糸 |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
Microsoft.Compute/galleries/applications/versions
名前 | 形容 | 価値 |
---|---|---|
場所 | リソースの場所 | string (必須) |
名前 | リソース名 | string (必須) |
親 | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 |
種類のリソースのシンボリック名: ギャラリー/アプリケーション |
プロパティ | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryApplicationVersionProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
OSDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile を |
OSDiskImageSecurityProfile
名前 | 形容 | 価値 |
---|---|---|
confidentialVMEncryptionType | 機密性の高い VM 暗号化の種類 | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | 糸 |
ResourceTags
名前 | 形容 | 価値 |
---|
TargetRegion
名前 | 形容 | 価値 |
---|---|---|
additionalReplicaSets | ダイレクト ドライブ レプリカを作成するためのレプリカ数を含むストレージ SKU の一覧。 | AdditionalReplicaSet[] |
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | bool |
名前 | リージョンの名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
名前 | 形容 | 価値 |
---|---|---|
取り付ける | 必須。 ギャラリー アプリケーションをインストールするパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
取り去る | 必須。 ギャラリー アプリケーションを削除するパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
更新 | 随意。 ギャラリー アプリケーションを更新するためのパスと引数。 存在しない場合、更新操作は以前のバージョンで remove コマンドを呼び出し、ギャラリー アプリケーションの現在のバージョンでコマンドをインストールします。 これは 4096 文字に制限されています。 | 糸 |
UserArtifactSettings
名前 | 形容 | 価値 |
---|---|---|
configFileName | 随意。 VM でダウンロードした構成ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、構成ファイルにはギャラリー アプリケーション名に "_config" が付加されます。 | 糸 |
packageFileName | 随意。 VM でダウンロードしたパッケージ ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、パッケージ ファイルにはギャラリー アプリケーション名と同じ名前が付けられます。 | 糸 |
scriptBehaviorAfterReboot | 随意。 再起動が発生した場合のギャラリー アプリケーションのインストール/更新/削除に関して実行するアクション。 | 'None' '再実行' |
UserArtifactSource
名前 | 形容 | 価値 |
---|---|---|
defaultConfigurationLink | 随意。 成果物の defaultConfigurationLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | 糸 |
mediaLink | 必須。 成果物の mediaLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | string (必須) |
ARM テンプレート リソース定義
ギャラリー/アプリケーション/バージョンのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Compute/galleries/applications/versions リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Compute/galleries/applications/versions",
"apiVersion": "2024-03-03",
"name": "string",
"location": "string",
"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",
"scriptBehaviorAfterReboot": "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": [
{
"additionalReplicaSets": [
{
"regionalReplicaCount": "int",
"storageAccountType": "string"
}
],
"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"
}
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
AdditionalReplicaSet
名前 | 形容 | 価値 |
---|---|---|
regionalReplicaCount | 作成するイメージ バージョンのダイレクト ドライブ レプリカの数。このプロパティは更新可能です | int |
storageAccountType | ダイレクト ドライブ レプリカの作成に使用するストレージ アカウントの種類を指定します | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
EncryptionImages
名前 | 形容 | 価値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれています。 | OSDiskImageEncryption の |
GalleryApplicationCustomAction
名前 | 形容 | 価値 |
---|---|---|
形容 | このカスタム アクションの動作をユーザーが理解するのに役立つ説明。 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
パラメーター | このカスタム アクションで使用されるパラメーター | GalleryApplicationCustomActionParameter[] |
スクリプト | このカスタム アクションの実行時に実行するスクリプト。 | string (必須) |
GalleryApplicationCustomActionParameter
名前 | 形容 | 価値 |
---|---|---|
defaultValue | パラメーターの既定値。 文字列型にのみ適用されます | 糸 |
形容 | ユーザーがこのパラメーターの意味を理解するのに役立つ説明 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
必須 | カスタム アクションの実行時にこのパラメーターを渡す必要があるかどうかを示します。 | bool |
種類 | カスタム アクション パラメーターの種類を指定します。 指定できる値は、String、ConfigurationDataBlob、LogOutputBlob です。 | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
名前 | 形容 | 価値 |
---|---|---|
publishingProfile | ギャラリー イメージ バージョンの発行プロファイル。 | GalleryApplicationVersionPublishingProfile (必須) |
safetyProfile | ギャラリー アプリケーション バージョンの安全性プロファイル。 | GalleryApplicationVersionSafetyProfile の |
GalleryApplicationVersionPublishingProfile
名前 | 形容 | 価値 |
---|---|---|
advancedSettings | 随意。 vm-application-manager 拡張機能に渡す追加の設定。 高度な使用のみ。 | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | このギャラリー アプリケーション バージョンで実行できるカスタム アクションの一覧。 | GalleryApplicationCustomAction[] |
enableHealthCheck | 随意。 このアプリケーションが正常性を報告するかどうか。 | bool |
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | 糸 |
excludeFromLatest | true に設定すると、イメージ定義の最新バージョンからデプロイされた Virtual Machines では、このイメージ バージョンは使用されません。 | bool |
manageActions | UserArtifactManage | |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | int |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | 'Full' 'Shallow' |
設定 | ターゲット VM または VM スケール セットにデプロイされるときに、ターゲット パッケージと構成ファイル名を含む VM アプリの追加設定。 | UserArtifactSettings の |
源 | イメージ バージョンの作成元となるソース イメージ。 | UserArtifactSource (必須) |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲットの拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
名前 | 形容 | 価値 |
---|
GalleryApplicationVersionSafetyProfile
名前 | 形容 | 価値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | bool |
GalleryExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
名前 | 糸 | |
種類 | これは拡張された場所の型です。 | 'EdgeZone' 'Unknown' |
GalleryTargetExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
extendedLocation | 拡張された場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
名前 | リージョンの名前。 | 糸 |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
Microsoft.Compute/galleries/applications/versions
名前 | 形容 | 価値 |
---|---|---|
apiVersion | API のバージョン | '2024-03-03' |
場所 | リソースの場所 | string (必須) |
名前 | リソース名 | string (必須) |
プロパティ | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryApplicationVersionProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
種類 | リソースの種類 | 'Microsoft.Compute/galleries/applications/versions' |
OSDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile を |
OSDiskImageSecurityProfile
名前 | 形容 | 価値 |
---|---|---|
confidentialVMEncryptionType | 機密性の高い VM 暗号化の種類 | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | 糸 |
ResourceTags
名前 | 形容 | 価値 |
---|
TargetRegion
名前 | 形容 | 価値 |
---|---|---|
additionalReplicaSets | ダイレクト ドライブ レプリカを作成するためのレプリカ数を含むストレージ SKU の一覧。 | AdditionalReplicaSet[] |
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | bool |
名前 | リージョンの名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
名前 | 形容 | 価値 |
---|---|---|
取り付ける | 必須。 ギャラリー アプリケーションをインストールするパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
取り去る | 必須。 ギャラリー アプリケーションを削除するパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
更新 | 随意。 ギャラリー アプリケーションを更新するためのパスと引数。 存在しない場合、更新操作は以前のバージョンで remove コマンドを呼び出し、ギャラリー アプリケーションの現在のバージョンでコマンドをインストールします。 これは 4096 文字に制限されています。 | 糸 |
UserArtifactSettings
名前 | 形容 | 価値 |
---|---|---|
configFileName | 随意。 VM でダウンロードした構成ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、構成ファイルにはギャラリー アプリケーション名に "_config" が付加されます。 | 糸 |
packageFileName | 随意。 VM でダウンロードしたパッケージ ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、パッケージ ファイルにはギャラリー アプリケーション名と同じ名前が付けられます。 | 糸 |
scriptBehaviorAfterReboot | 随意。 再起動が発生した場合のギャラリー アプリケーションのインストール/更新/削除に関して実行するアクション。 | 'None' '再実行' |
UserArtifactSource
名前 | 形容 | 価値 |
---|---|---|
defaultConfigurationLink | 随意。 成果物の defaultConfigurationLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | 糸 |
mediaLink | 必須。 成果物の mediaLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | string (必須) |
Terraform (AzAPI プロバイダー) リソース定義
ギャラリー/アプリケーション/バージョンのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Compute/galleries/applications/versions リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/applications/versions@2024-03-03"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
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"
scriptBehaviorAfterReboot = "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 = [
{
additionalReplicaSets = [
{
regionalReplicaCount = int
storageAccountType = "string"
}
]
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
}
}
})
}
プロパティ値
AdditionalReplicaSet
名前 | 形容 | 価値 |
---|---|---|
regionalReplicaCount | 作成するイメージ バージョンのダイレクト ドライブ レプリカの数。このプロパティは更新可能です | int |
storageAccountType | ダイレクト ドライブ レプリカの作成に使用するストレージ アカウントの種類を指定します | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
lun | このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。 | int (必須) |
EncryptionImages
名前 | 形容 | 価値 |
---|---|---|
dataDiskImages | データ ディスク イメージの暗号化仕様の一覧。 | DataDiskImageEncryption[] |
osDiskImage | OS ディスク イメージの暗号化設定が含まれています。 | OSDiskImageEncryption の |
GalleryApplicationCustomAction
名前 | 形容 | 価値 |
---|---|---|
形容 | このカスタム アクションの動作をユーザーが理解するのに役立つ説明。 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
パラメーター | このカスタム アクションで使用されるパラメーター | GalleryApplicationCustomActionParameter[] |
スクリプト | このカスタム アクションの実行時に実行するスクリプト。 | string (必須) |
GalleryApplicationCustomActionParameter
名前 | 形容 | 価値 |
---|---|---|
defaultValue | パラメーターの既定値。 文字列型にのみ適用されます | 糸 |
形容 | ユーザーがこのパラメーターの意味を理解するのに役立つ説明 | 糸 |
名前 | カスタム アクションの名前。 ギャラリー アプリケーションのバージョン内で一意である必要があります。 | string (必須) |
必須 | カスタム アクションの実行時にこのパラメーターを渡す必要があるかどうかを示します。 | bool |
種類 | カスタム アクション パラメーターの種類を指定します。 指定できる値は、String、ConfigurationDataBlob、LogOutputBlob です。 | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
名前 | 形容 | 価値 |
---|---|---|
publishingProfile | ギャラリー イメージ バージョンの発行プロファイル。 | GalleryApplicationVersionPublishingProfile (必須) |
safetyProfile | ギャラリー アプリケーション バージョンの安全性プロファイル。 | GalleryApplicationVersionSafetyProfile の |
GalleryApplicationVersionPublishingProfile
名前 | 形容 | 価値 |
---|---|---|
advancedSettings | 随意。 vm-application-manager 拡張機能に渡す追加の設定。 高度な使用のみ。 | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | このギャラリー アプリケーション バージョンで実行できるカスタム アクションの一覧。 | GalleryApplicationCustomAction[] |
enableHealthCheck | 随意。 このアプリケーションが正常性を報告するかどうか。 | bool |
endOfLifeDate | ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。 | 糸 |
excludeFromLatest | true に設定すると、イメージ定義の最新バージョンからデプロイされた Virtual Machines では、このイメージ バージョンは使用されません。 | bool |
manageActions | UserArtifactManage | |
replicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。 | int |
replicationMode | レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。 | 'Full' 'Shallow' |
設定 | ターゲット VM または VM スケール セットにデプロイされるときに、ターゲット パッケージと構成ファイル名を含む VM アプリの追加設定。 | UserArtifactSettings の |
源 | イメージ バージョンの作成元となるソース イメージ。 | UserArtifactSource (必須) |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
targetExtendedLocations | イメージ バージョンがレプリケートされるターゲットの拡張場所。 このプロパティは更新可能です。 | GalleryTargetExtendedLocation[] |
targetRegions | イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
名前 | 形容 | 価値 |
---|
GalleryApplicationVersionSafetyProfile
名前 | 形容 | 価値 |
---|---|---|
allowDeletionOfReplicatedLocations | レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。 | bool |
GalleryExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
名前 | 糸 | |
種類 | これは拡張された場所の型です。 | 'EdgeZone' 'Unknown' |
GalleryTargetExtendedLocation
名前 | 形容 | 価値 |
---|---|---|
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
extendedLocation | 拡張された場所の名前。 | GalleryExtendedLocation |
extendedLocationReplicaCount | 拡張された場所ごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
名前 | リージョンの名前。 | 糸 |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
Microsoft.Compute/galleries/applications/versions
名前 | 形容 | 価値 |
---|---|---|
場所 | リソースの場所 | string (必須) |
名前 | リソース名 | string (必須) |
parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: ギャラリー/アプリケーション |
プロパティ | ギャラリー イメージ バージョンのプロパティについて説明します。 | GalleryApplicationVersionProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 |
種類 | リソースの種類 | "Microsoft.Compute/galleries/applications/versions@2024-03-03" |
OSDiskImageEncryption
名前 | 形容 | 価値 |
---|---|---|
diskEncryptionSetId | ディスク暗号化セットのリソース ID を含む相対 URI。 | 糸 |
securityProfile | このプロパティは、OS ディスク イメージのセキュリティ プロファイルを指定します。 | OSDiskImageSecurityProfile を |
OSDiskImageSecurityProfile
名前 | 形容 | 価値 |
---|---|---|
confidentialVMEncryptionType | 機密性の高い VM 暗号化の種類 | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
secureVMDiskEncryptionSetId | セキュリティで保護された VM ディスク暗号化セット ID | 糸 |
ResourceTags
名前 | 形容 | 価値 |
---|
TargetRegion
名前 | 形容 | 価値 |
---|---|---|
additionalReplicaSets | ダイレクト ドライブ レプリカを作成するためのレプリカ数を含むストレージ SKU の一覧。 | AdditionalReplicaSet[] |
暗号化 | 随意。 ユーザーは、ギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーを提供できます。 | EncryptionImages |
excludeFromLatest | ユーザーが version='latest' を指定したときにイメージを非表示にするフラグ設定が含まれています | bool |
名前 | リージョンの名前。 | string (必須) |
regionalReplicaCount | リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。 | int |
storageAccountType | イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。 | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
名前 | 形容 | 価値 |
---|---|---|
取り付ける | 必須。 ギャラリー アプリケーションをインストールするパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
取り去る | 必須。 ギャラリー アプリケーションを削除するパスと引数。 これは 4096 文字に制限されています。 | string (必須) |
更新 | 随意。 ギャラリー アプリケーションを更新するためのパスと引数。 存在しない場合、更新操作は以前のバージョンで remove コマンドを呼び出し、ギャラリー アプリケーションの現在のバージョンでコマンドをインストールします。 これは 4096 文字に制限されています。 | 糸 |
UserArtifactSettings
名前 | 形容 | 価値 |
---|---|---|
configFileName | 随意。 VM でダウンロードした構成ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、構成ファイルにはギャラリー アプリケーション名に "_config" が付加されます。 | 糸 |
packageFileName | 随意。 VM でダウンロードしたパッケージ ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、パッケージ ファイルにはギャラリー アプリケーション名と同じ名前が付けられます。 | 糸 |
scriptBehaviorAfterReboot | 随意。 再起動が発生した場合のギャラリー アプリケーションのインストール/更新/削除に関して実行するアクション。 | 'None' '再実行' |
UserArtifactSource
名前 | 形容 | 価値 |
---|---|---|
defaultConfigurationLink | 随意。 成果物の defaultConfigurationLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | 糸 |
mediaLink | 必須。 成果物の mediaLink は、読み取り可能なストレージ ページ BLOB である必要があります。 | string (必須) |