Microsoft.Compute galleries/images/versions
Bicep-Ressourcendefinition
Der Ressourcentyp galleries/images/versions kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/galleries/images/versions-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.
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'
}
}
}
}
Eigenschaftswerte
galleries/images/versions
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen. |
Zeichenfolge (erforderlich) Zeichenlimit: 32-Bit-Ganzzahl Gültige Zeichen: Zahlen und Punkte. (Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
parent | In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource vom Typ: Images |
properties | Beschreibt die Eigenschaften einer Katalogimageversion. | GalleryImageVersionProperties |
GalleryImageVersionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
publishingProfile | Das Veröffentlichungsprofil eines Katalogimages Version. | GalleryImageVersionPublishingProfile |
safetyProfile | Dies ist das Sicherheitsprofil der Katalogimageversion. | GalleryImageVersionSafetyProfile |
securityProfile | Das Sicherheitsprofil einer Katalogimageversion | ImageVersionSecurityProfile |
storageProfile | Dies ist das Speicherprofil einer Katalogimageversion. | GalleryImageVersionStorageProfile (erforderlich) |
GalleryImageVersionPublishingProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
endOfLifeDate | Das Datum des Lebenszyklusendes der Katalogimageversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. | Zeichenfolge |
excludeFromLatest | Wenn true festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. | bool |
replicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft wird für eine Region wirksam, wenn regionalReplicaCount nicht angegeben wird. Diese Eigenschaft ist aktualisierbar. | INT |
replicationMode | Optionaler Parameter, der den modus angibt, der für die Replikation verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | 'Full' "Flach" |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | Die erweiterten Zielspeicherorte, an denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | GalleryTargetExtendedLocation[] |
targetRegions | Die Zielregionen, in denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | TargetRegion[] |
GalleryTargetExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. | EncryptionImages |
extendedLocation | Der Name des erweiterten Speicherorts. | GalleryExtendedLocation |
extendedLocationReplicaCount | Die Anzahl der Replikate der Imageversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. | INT |
name | Der Name der Region. | Zeichenfolge |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
EncryptionImages
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. | DataDiskImageEncryption[] |
osDiskImage | Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. | OSDiskImageEncryption |
DataDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
lun | Diese Eigenschaft gibt die Nummer der logischen Einheit des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
OSDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
securityProfile | Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
confidentialVMEncryptionType | Verschlüsselungstypen vertraulicher VIRTUELLER Computer | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | Verschlüsselungsgruppen-ID für sichere VM-Datenträger | Zeichenfolge |
GalleryExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Zeichenfolge | |
type | Dabei handelt es sich um den Typ des erweiterten Standorts. | "EdgeZone" "Unbekannt" |
TargetRegion
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. | EncryptionImages |
excludeFromLatest | Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. | bool |
name | Der Name der Region. | Zeichenfolge (erforderlich) |
regionalReplicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. | INT |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
GalleryImageVersionSafetyProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
allowDeletionOfReplicatedLocations | Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. | bool |
ImageVersionSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
uefiSettings | Enthält UEFI-Einstellungen für die Imageversion. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
Name | BESCHREIBUNG | Wert |
---|---|---|
additionalSignatures | Zusätzliche UEFI-Schlüsselsignaturen, die dem Image zusätzlich zu den Signaturvorlagen hinzugefügt werden | UefiKeySignatures |
signatureTemplateNames | Der Name der Vorlage(en), die UEFI-Standardschlüsselsignaturen enthält, die dem Image hinzugefügt werden. | Zeichenfolgenarray, das folgendes enthält: "MicrosoftUefiCertificateAuthorityTemplate" "MicrosoftWindowsTemplate" 'NoSignatureTemplate' |
UefiKeySignatures
Name | BESCHREIBUNG | Wert |
---|---|---|
db | Die Datenbank der UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
dbx | Die Datenbank der widerrufenen UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
Kek | Die Schlüsselverschlüsselungsschlüssel dieser Imageversion. | UefiKey[] |
pk | Der Plattformschlüssel dieser Imageversion. | UefiKey |
UefiKey
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Typ der Schlüsselsignatur. | 'sha256' 'x509' |
value | Der Wert der Schlüsselsignatur. | string[] |
GalleryImageVersionStorageProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste von Datenträgerimages. | GalleryDataDiskImage[] |
osDiskImage | Dies ist das Betriebssystemdatenträgerimage. | GalleryOSDiskImage |
source | Die Quelle der Artefaktversion des Katalogs. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "Keine" 'ReadOnly' "ReadWrite" |
lun | Diese Eigenschaft gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryDiskImageSource
Name | BESCHREIBUNG | Wert |
---|---|---|
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
storageAccountId | Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird. | Zeichenfolge |
uri | Der URI der Artefaktversionsquelle des Katalogs. Wird derzeit verwendet, um die vhd/blob-Quelle anzugeben. | Zeichenfolge |
GalleryOSDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "Keine" 'ReadOnly' "ReadWrite" |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
Name | BESCHREIBUNG | Wert |
---|---|---|
communityGalleryImageId | Die Ressourcen-ID des Quell-Communitykatalogimages. Nur erforderlich, wenn Das Community Gallery Image als Quelle verwendet wird. | Zeichenfolge |
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
virtualMachineId | Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer erfasst wird, um diese Katalogimageversion zu beziehen. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen einer Imageversion in einem Azure Compute-Katalog |
Mit dieser Vorlage können Sie eine einfache Imageversion in einem Azure Compute-Katalog erstellen. Stellen Sie sicher, dass Sie die Azure Compute Gallery 101-Vorlage und die Image Definition 101-Vorlage ausgeführt haben, bevor Sie diese bereitstellen. |
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp galleries/images/versions kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/galleries/images/versions-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"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"
}
}
}
}
Eigenschaftswerte
galleries/images/versions
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Ressourcentyp | "Microsoft.Compute/galleries/images/versions" |
apiVersion | Die Ressourcen-API-Version | '2023-07-03' |
name | Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen. |
Zeichenfolge (erforderlich) Zeichenlimit: 32-Bit-Ganzzahl Gültige Zeichen: Zahlen und Punkte. (Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
properties | Beschreibt die Eigenschaften einer Katalogimageversion. | GalleryImageVersionProperties |
GalleryImageVersionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
publishingProfile | Das Veröffentlichungsprofil eines Katalogimages Version. | GalleryImageVersionPublishingProfile |
safetyProfile | Dies ist das Sicherheitsprofil der Katalogimageversion. | GalleryImageVersionSafetyProfile |
securityProfile | Das Sicherheitsprofil einer Katalogimageversion | ImageVersionSecurityProfile |
storageProfile | Dies ist das Speicherprofil einer Katalogimageversion. | GalleryImageVersionStorageProfile (erforderlich) |
GalleryImageVersionPublishingProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
endOfLifeDate | Das Datum des Lebenszyklusendes der Katalogimageversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. | Zeichenfolge |
excludeFromLatest | Wenn true festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. | bool |
replicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft wird für eine Region wirksam, wenn regionalReplicaCount nicht angegeben wird. Diese Eigenschaft ist aktualisierbar. | INT |
replicationMode | Optionaler Parameter, der den modus angibt, der für die Replikation verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | 'Full' "Flach" |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | Die erweiterten Zielspeicherorte, an denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | GalleryTargetExtendedLocation[] |
targetRegions | Die Zielregionen, in denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | TargetRegion[] |
GalleryTargetExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern, kundenseitig verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. | EncryptionImages |
extendedLocation | Der Name des erweiterten Speicherorts. | GalleryExtendedLocation |
extendedLocationReplicaCount | Die Anzahl der Replikate der Imageversion, die pro erweitertem Speicherort erstellt werden sollen. Diese Eigenschaft ist aktualisierbar. | INT |
name | Der Name der Region. | Zeichenfolge |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
EncryptionImages
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. | DataDiskImageEncryption[] |
osDiskImage | Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. | OSDiskImageEncryption |
DataDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
lun | Diese Eigenschaft gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
OSDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
securityProfile | Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
confidentialVMEncryptionType | Verschlüsselungstypen vertraulicher VM | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | Verschlüsselungssatz-ID für sichere VM-Datenträger | Zeichenfolge |
GalleryExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Zeichenfolge | |
type | Dabei handelt es sich um den Typ des erweiterten Speicherorts. | "EdgeZone" "Unbekannt" |
TargetRegion
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern, kundenseitig verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. | EncryptionImages |
excludeFromLatest | Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. | bool |
name | Der Name der Region. | Zeichenfolge (erforderlich) |
regionalReplicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft ist aktualisierbar. | INT |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
GalleryImageVersionSafetyProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
allowDeletionOfReplicatedLocations | Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. | bool |
ImageVersionSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
uefiSettings | Enthält UEFI-Einstellungen für die Imageversion. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
Name | BESCHREIBUNG | Wert |
---|---|---|
additionalSignatures | Zusätzliche UEFI-Schlüsselsignaturen, die dem Image zusätzlich zu den Signaturvorlagen hinzugefügt werden | UefiKeySignatures |
signatureTemplateNames | Der Name der Vorlage(en), die UEFI-Standardschlüsselsignaturen enthält, die dem Image hinzugefügt werden. | Zeichenfolgenarray, das folgendes enthält: "MicrosoftUefiCertificateAuthorityTemplate" "MicrosoftWindowsTemplate" 'NoSignatureTemplate' |
UefiKeySignatures
Name | BESCHREIBUNG | Wert |
---|---|---|
db | Die Datenbank der UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
dbx | Die Datenbank der widerrufenen UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
Kek | Die Schlüsselverschlüsselungsschlüssel dieser Imageversion. | UefiKey[] |
pk | Der Plattformschlüssel dieser Imageversion. | UefiKey |
UefiKey
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Typ der Schlüsselsignatur. | 'sha256' 'x509' |
value | Der Wert der Schlüsselsignatur. | string[] |
GalleryImageVersionStorageProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste von Datenträgerimages. | GalleryDataDiskImage[] |
osDiskImage | Dies ist das Betriebssystemdatenträgerimage. | GalleryOSDiskImage |
source | Die Quelle der Artefaktversion des Katalogs. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "Keine" 'ReadOnly' "ReadWrite" |
lun | Diese Eigenschaft gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryDiskImageSource
Name | BESCHREIBUNG | Wert |
---|---|---|
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
storageAccountId | Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird. | Zeichenfolge |
uri | Der URI der Artefaktversionsquelle des Katalogs. Wird derzeit verwendet, um die vhd/blob-Quelle anzugeben. | Zeichenfolge |
GalleryOSDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "Keine" 'ReadOnly' "ReadWrite" |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
Name | BESCHREIBUNG | Wert |
---|---|---|
communityGalleryImageId | Die Ressourcen-ID des Quell-Communitykatalogimages. Nur erforderlich, wenn Das Community Gallery Image als Quelle verwendet wird. | Zeichenfolge |
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
virtualMachineId | Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer erfasst wird, um diese Katalogimageversion zu beziehen. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen einer Imageversion in einem Azure Compute-Katalog |
Mit dieser Vorlage können Sie eine einfache Imageversion in einem Azure Compute-Katalog erstellen. Stellen Sie sicher, dass Sie die Azure Compute Gallery 101-Vorlage und die Image Definition 101-Vorlage ausgeführt haben, bevor Sie diese bereitstellen. |
Terraform (AzAPI-Anbieter) Ressourcendefinition
Der Ressourcentyp galleries/images/versions kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/galleries/images/versions-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.
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"
}
}
}
})
}
Eigenschaftswerte
galleries/images/versions
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Ressourcentyp | "Microsoft.Compute/galleries/images/versions@2023-07-03" |
name | Der Ressourcenname | Zeichenfolge (erforderlich) Zeichenlimit: 32-Bit-Ganzzahl Gültige Zeichen: Zahlen und Punkte. (Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
parent_id | Die ID der Ressource, die die übergeordnete Ressource für diese Ressource ist. | ID für Ressource vom Typ: Images |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
properties | Beschreibt die Eigenschaften einer Katalogimageversion. | GalleryImageVersionProperties |
GalleryImageVersionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
publishingProfile | Das Veröffentlichungsprofil eines Katalogimages Version. | GalleryImageVersionPublishingProfile |
safetyProfile | Dies ist das Sicherheitsprofil der Katalogimageversion. | GalleryImageVersionSafetyProfile |
securityProfile | Das Sicherheitsprofil einer Katalogimageversion | ImageVersionSecurityProfile |
storageProfile | Dies ist das Speicherprofil einer Katalogimageversion. | GalleryImageVersionStorageProfile (erforderlich) |
GalleryImageVersionPublishingProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
endOfLifeDate | Das Datum des Lebenszyklusendes der Katalogimageversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. | Zeichenfolge |
excludeFromLatest | Wenn true festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. | bool |
replicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft wird für eine Region wirksam, wenn regionalReplicaCount nicht angegeben wird. Diese Eigenschaft ist aktualisierbar. | INT |
replicationMode | Optionaler Parameter, der den modus angibt, der für die Replikation verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | "Voll" "Flach" |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | „Premium_LRS“ „Standard_LRS“ „Standard_ZRS“ |
targetExtendedLocations | Die erweiterten Zielspeicherorte, an denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | GalleryTargetExtendedLocation[] |
targetRegions | Die Zielregionen, in denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. | TargetRegion[] |
GalleryTargetExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern, kundenseitig verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. | EncryptionImages |
extendedLocation | Der Name des erweiterten Speicherorts. | GalleryExtendedLocation |
extendedLocationReplicaCount | Die Anzahl der Replikate der Imageversion, die pro erweitertem Speicherort erstellt werden sollen. Diese Eigenschaft ist aktualisierbar. | INT |
name | Der Name der Region. | Zeichenfolge |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | „Premium_LRS“ „StandardSSD_LRS“ „Standard_LRS“ „Standard_ZRS“ |
EncryptionImages
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. | DataDiskImageEncryption[] |
osDiskImage | Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. | OSDiskImageEncryption |
DataDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
lun | Diese Eigenschaft gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
OSDiskImageEncryption
Name | BESCHREIBUNG | Wert |
---|---|---|
diskEncryptionSetId | Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. | Zeichenfolge |
securityProfile | Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
confidentialVMEncryptionType | Verschlüsselungstypen vertraulicher VM | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | Verschlüsselungssatz-ID für sichere VM-Datenträger | Zeichenfolge |
GalleryExtendedLocation
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Zeichenfolge | |
type | Dabei handelt es sich um den Typ des erweiterten Speicherorts. | "EdgeZone" "Unbekannt" |
TargetRegion
Name | BESCHREIBUNG | Wert |
---|---|---|
Verschlüsselung | Optional. Ermöglicht Benutzern, kundenseitig verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. | EncryptionImages |
excludeFromLatest | Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. | bool |
name | Der Name der Region. | Zeichenfolge (erforderlich) |
regionalReplicaCount | Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft ist aktualisierbar. | INT |
storageAccountType | Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. | „Premium_LRS“ „Standard_LRS“ „Standard_ZRS“ |
GalleryImageVersionSafetyProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
allowDeletionOfReplicatedLocations | Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. | bool |
ImageVersionSecurityProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
uefiSettings | Enthält UEFI-Einstellungen für die Imageversion. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
Name | BESCHREIBUNG | Wert |
---|---|---|
additionalSignatures | Zusätzliche UEFI-Schlüsselsignaturen, die dem Image zusätzlich zu den Signaturvorlagen hinzugefügt werden | UefiKeySignatures |
signatureTemplateNames | Der Name der Vorlage(en), die UEFI-Standardschlüsselsignaturen enthält, die dem Image hinzugefügt werden. | Zeichenfolgenarray, das folgendes enthält: "MicrosoftUefiCertificateAuthorityTemplate" "MicrosoftWindowsTemplate" "NoSignatureTemplate" |
UefiKeySignatures
Name | BESCHREIBUNG | Wert |
---|---|---|
db | Die Datenbank der UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
dbx | Die Datenbank der widerrufenen UEFI-Schlüssel für diese Imageversion. | UefiKey[] |
Kek | Die Schlüsselverschlüsselungsschlüssel dieser Imageversion. | UefiKey[] |
pk | Der Plattformschlüssel dieser Imageversion. | UefiKey |
UefiKey
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Typ der Schlüsselsignatur. | "sha256" "x509" |
value | Der Wert der Schlüsselsignatur. | string[] |
GalleryImageVersionStorageProfile
Name | BESCHREIBUNG | Wert |
---|---|---|
dataDiskImages | Eine Liste von Datenträgerimages. | GalleryDataDiskImage[] |
osDiskImage | Dies ist das Betriebssystemdatenträgerimage. | GalleryOSDiskImage |
source | Die Quelle der Artefaktversion des Katalogs. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "None" "ReadOnly" "ReadWrite" |
lun | Diese Eigenschaft gibt die Nummer der logischen Einheit des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. | int (erforderlich) |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryDiskImageSource
Name | BESCHREIBUNG | Wert |
---|---|---|
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
storageAccountId | Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird. | Zeichenfolge |
uri | Der URI der Artefaktversionsquelle des Katalogs. Wird derzeit verwendet, um vhd/blob source anzugeben. | Zeichenfolge |
GalleryOSDiskImage
Name | BESCHREIBUNG | Wert |
---|---|---|
hostCaching | Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite". | "None" "ReadOnly" "ReadWrite" |
source | Die Quelle für das Datenträgerimage. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
Name | BESCHREIBUNG | Wert |
---|---|---|
communityGalleryImageId | Die Ressourcen-ID des Community Gallery-Quellimages. Nur erforderlich, wenn Community Gallery Image als Quelle verwendet wird. | Zeichenfolge |
id | Die ID der Artefaktversionsquelle des Katalogs. | Zeichenfolge |
virtualMachineId | Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer als Quelle für diese Version des Katalogimages erfasst wird. | Zeichenfolge |