Microsoft.Compute galleries/images/versions

Artikel
03/09/2024

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

Microsoft.Compute galleries/images/versions

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

galleries/images/versions

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryTargetExtendedLocation

EncryptionImages

DataDiskImageEncryption

OSDiskImageEncryption

OSDiskImageSecurityProfile

GalleryExtendedLocation

TargetRegion

GalleryImageVersionSafetyProfile

ImageVersionSecurityProfile

GalleryImageVersionUefiSettings

UefiKeySignatures

UefiKey

GalleryImageVersionStorageProfile

GalleryDataDiskImage

GalleryDiskImageSource

GalleryOSDiskImage

GalleryArtifactVersionFullSource

Schnellstartvorlagen

Ressourcendefinition mit einer ARM-Vorlage

Ressourcenformat

Eigenschaftswerte

galleries/images/versions

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryTargetExtendedLocation

EncryptionImages

DataDiskImageEncryption

OSDiskImageEncryption

OSDiskImageSecurityProfile

GalleryExtendedLocation

TargetRegion

GalleryImageVersionSafetyProfile

ImageVersionSecurityProfile

GalleryImageVersionUefiSettings

UefiKeySignatures

UefiKey

GalleryImageVersionStorageProfile

GalleryDataDiskImage

GalleryDiskImageSource

GalleryOSDiskImage

GalleryArtifactVersionFullSource

Schnellstartvorlagen

Terraform (AzAPI-Anbieter) Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

galleries/images/versions

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryTargetExtendedLocation

EncryptionImages

DataDiskImageEncryption

OSDiskImageEncryption

OSDiskImageSecurityProfile

GalleryExtendedLocation

TargetRegion

GalleryImageVersionSafetyProfile

ImageVersionSecurityProfile

GalleryImageVersionUefiSettings

UefiKeySignatures

UefiKey

GalleryImageVersionStorageProfile

GalleryDataDiskImage

GalleryDiskImageSource

GalleryOSDiskImage

GalleryArtifactVersionFullSource

Feedback

Feedback

Zusätzliche Ressourcen