Microsoft.Compute gallerys/images/versions 2024-03-03

Artikel
12/20/2024

Bicep-Ressourcendefinition

Der Ressourcentyp kataloge/images/versions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Compute/gallerys/images/versions" zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Compute/galleries/images/versions@2024-03-03' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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: [
        {
          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'
        }
      ]
    }
    restore: bool
    safetyProfile: {
      allowDeletionOfReplicatedLocations: bool
      blockDeletionBeforeEndOfLife: 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'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

AdditionalReplicaSet

Name	Beschreibung	Wert
regionalReplicaCount	Die Anzahl der direkten Laufwerkreplikate der zu erstellenden Imageversion. Diese Eigenschaft ist aktualisierbar	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Erstellen der direkten Laufwerkreplikate verwendet werden soll.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

DataDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)

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

GalleryArtifactVersionFullSource

Name	Beschreibung	Wert
communityGalleryImageId	Die Ressourcen-ID des Quell-Communitykatalogbilds. Nur erforderlich, wenn Sie Community Gallery Image als Quelle verwenden.	Schnur
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
virtualMachineId	Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer erfasst wird, um diese Katalogimageversion zu erstellen.	Schnur

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 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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryDiskImageSource

Name	Beschreibung	Wert
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
storageAccountId	Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird.	Schnur
Uri	Der URI der Versionsquelle des Katalogartefaktes. Wird zurzeit verwendet, um vhd/blob-Quelle anzugeben.	Schnur

GalleryExtendedLocation

Name	Beschreibung	Wert
Name		Schnur
Art	Es ist der Typ des erweiterten Speicherorts.	"EdgeZone" "Unbekannt"

GalleryImageVersionProperties

Name	Beschreibung	Wert
publishingProfile	Das Veröffentlichungsprofil einer Katalogbildversion.	GalleryImageVersionPublishingProfile
wiederherstellen	Gibt an, ob es sich um eine Anforderung für die Wiederherstellung von Ressourcen handelt, die vorläufig gelöscht wird.	Bool
safetyProfile	Dies ist das Sicherheitsprofil der Gallery Image Version.	GalleryImageVersionSafetyProfile
securityProfile	Das Sicherheitsprofil einer Katalogbildversion	ImageVersionSecurityProfile-
storageProfile	Dies ist das Speicherprofil einer Katalogbildversion.	GalleryImageVersionStorageProfile- (erforderlich)

GalleryImageVersionPublishingProfile

Name	Beschreibung	Wert
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
excludeFromLatest	Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht.	Bool
replicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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.	"Vollständig" "Flach"
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetExtendedLocations	Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	GalleryTargetExtendedLocation[]
targetRegions	Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	TargetRegion-[]

GalleryImageVersionSafetyProfile

Name	Beschreibung	Wert
allowDeletionOfReplicatedLocations	Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.	Bool
blockDeletionBeforeEndOfLife	Gibt an, ob der Löschvorgang für diese Bildergalerieversion blockiert ist, wenn das Ende der Lebensdauer nicht abgelaufen ist.	Bool

GalleryImageVersionStorageProfile

Name	Beschreibung	Wert
dataDiskImages	Eine Liste der Datenträgerimages.	GalleryDataDiskImage[]
osDiskImage	Dies ist das Betriebssystemdatenträgerimage.	GalleryOSDiskImage-
Quelle	Die Quelle der Katalogartefaktversion.	GalleryArtifactVersionFullSource

GalleryImageVersionUefiSettings

Name	Beschreibung	Wert
additionalSignatures	Zusätzliche UEFI-Schlüsselsignaturen, die zusätzlich zu den Signaturvorlagen dem Bild hinzugefügt werden	UefiKeySignatures
signatureTemplateNames	Der Name der Vorlage(n), die Standardsignaturen für UEFI-Schlüssel enthält, die dem Bild hinzugefügt werden.	Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate'

GalleryOSDiskImage

Name	Beschreibung	Wert
hostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"	'None' 'ReadOnly' 'ReadWrite'
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryTargetExtendedLocation

Name	Beschreibung	Wert
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
Name	Der Name der Region.	Schnur
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS"

ImageVersionSecurityProfile

Name	Beschreibung	Wert
uefiSettings	Enthält UEFI-Einstellungen für die Bildversion.	GalleryImageVersionUefiSettings

Microsoft.Compute/gallerys/images/versions

Name	Beschreibung	Wert
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Elternteil	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: Kataloge/Bilder
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbildversion.	GalleryImageVersionProperties
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

OSDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
securityProfile	Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an.	OSDiskImageSecurityProfile-

OSDiskImageSecurityProfile

Name	Beschreibung	Wert
confidentialVMEncryptionType	Vertrauliche VM-Verschlüsselungstypen	"EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM"
secureVMDiskEncryptionSetId	Verschlüsselungssatz-ID für sichere VM-Datenträger	Schnur

ResourceTags

Name	Beschreibung	Wert

TargetRegion

Name	Beschreibung	Wert
additionalReplicaSets	Liste der Speichersku mit Replikatanzahl zum Erstellen von direkten Laufwerkreplikaten.	AdditionalReplicaSet-[]
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen.	EncryptionImages-
excludeFromLatest	Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben.	Bool
Name	Der Name der Region.	Zeichenfolge (erforderlich)
regionalReplicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

UefiKey

Name	Beschreibung	Wert
Art	Der Typ der Schlüsselsignatur.	'sha256' 'x509'
Wert	Der Wert der Schlüsselsignatur.	string[]

UefiKeySignatures

Name	Beschreibung	Wert
Db	Die Datenbank von UEFI-Schlüsseln für diese Bildversion.	UefiKey-[]
dbx	Die Datenbank mit widerrufenen UEFI-Schlüsseln für diese Imageversion.	UefiKey-[]
kek	Die Schlüsselverschlüsselungsschlüssel dieser Imageversion.	UefiKey-[]
Pk	Der Plattformschlüssel dieser Imageversion.	UefiKey-

ARM-Vorlagenressourcendefinition

Der Ressourcentyp kataloge/images/versions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Compute/gallerys/images/versions" zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Compute/galleries/images/versions",
  "apiVersion": "2024-03-03",
  "name": "string",
  "location": "string",
  "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": [
        {
          "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"
        }
      ]
    },
    "restore": "bool",
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": "bool",
      "blockDeletionBeforeEndOfLife": "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"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

AdditionalReplicaSet

Name	Beschreibung	Wert
regionalReplicaCount	Die Anzahl der direkten Laufwerkreplikate der zu erstellenden Imageversion. Diese Eigenschaft ist aktualisierbar	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Erstellen der direkten Laufwerkreplikate verwendet werden soll.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

DataDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)

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

GalleryArtifactVersionFullSource

Name	Beschreibung	Wert
communityGalleryImageId	Die Ressourcen-ID des Quell-Communitykatalogbilds. Nur erforderlich, wenn Sie Community Gallery Image als Quelle verwenden.	Schnur
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
virtualMachineId	Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer erfasst wird, um diese Katalogimageversion zu erstellen.	Schnur

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 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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryDiskImageSource

Name	Beschreibung	Wert
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
storageAccountId	Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird.	Schnur
Uri	Der URI der Versionsquelle des Katalogartefaktes. Wird zurzeit verwendet, um vhd/blob-Quelle anzugeben.	Schnur

GalleryExtendedLocation

Name	Beschreibung	Wert
Name		Schnur
Art	Es ist der Typ des erweiterten Speicherorts.	"EdgeZone" "Unbekannt"

GalleryImageVersionProperties

Name	Beschreibung	Wert
publishingProfile	Das Veröffentlichungsprofil einer Katalogbildversion.	GalleryImageVersionPublishingProfile
wiederherstellen	Gibt an, ob es sich um eine Anforderung für die Wiederherstellung von Ressourcen handelt, die vorläufig gelöscht wird.	Bool
safetyProfile	Dies ist das Sicherheitsprofil der Gallery Image Version.	GalleryImageVersionSafetyProfile
securityProfile	Das Sicherheitsprofil einer Katalogbildversion	ImageVersionSecurityProfile-
storageProfile	Dies ist das Speicherprofil einer Katalogbildversion.	GalleryImageVersionStorageProfile- (erforderlich)

GalleryImageVersionPublishingProfile

Name	Beschreibung	Wert
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
excludeFromLatest	Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht.	Bool
replicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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.	"Vollständig" "Flach"
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetExtendedLocations	Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	GalleryTargetExtendedLocation[]
targetRegions	Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	TargetRegion-[]

GalleryImageVersionSafetyProfile

Name	Beschreibung	Wert
allowDeletionOfReplicatedLocations	Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.	Bool
blockDeletionBeforeEndOfLife	Gibt an, ob der Löschvorgang für diese Bildergalerieversion blockiert ist, wenn das Ende der Lebensdauer nicht abgelaufen ist.	Bool

GalleryImageVersionStorageProfile

Name	Beschreibung	Wert
dataDiskImages	Eine Liste der Datenträgerimages.	GalleryDataDiskImage[]
osDiskImage	Dies ist das Betriebssystemdatenträgerimage.	GalleryOSDiskImage-
Quelle	Die Quelle der Katalogartefaktversion.	GalleryArtifactVersionFullSource

GalleryImageVersionUefiSettings

Name	Beschreibung	Wert
additionalSignatures	Zusätzliche UEFI-Schlüsselsignaturen, die zusätzlich zu den Signaturvorlagen dem Bild hinzugefügt werden	UefiKeySignatures
signatureTemplateNames	Der Name der Vorlage(n), die Standardsignaturen für UEFI-Schlüssel enthält, die dem Bild hinzugefügt werden.	Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate'

GalleryOSDiskImage

Name	Beschreibung	Wert
hostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"	'None' 'ReadOnly' 'ReadWrite'
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryTargetExtendedLocation

Name	Beschreibung	Wert
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
Name	Der Name der Region.	Schnur
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS"

ImageVersionSecurityProfile

Name	Beschreibung	Wert
uefiSettings	Enthält UEFI-Einstellungen für die Bildversion.	GalleryImageVersionUefiSettings

Microsoft.Compute/gallerys/images/versions

Name	Beschreibung	Wert
apiVersion	Die API-Version	'2024-03-03'
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbildversion.	GalleryImageVersionProperties
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art	Der Ressourcentyp	"Microsoft.Compute/gallerys/images/versions"

OSDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
securityProfile	Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an.	OSDiskImageSecurityProfile-

OSDiskImageSecurityProfile

Name	Beschreibung	Wert
confidentialVMEncryptionType	Vertrauliche VM-Verschlüsselungstypen	"EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM"
secureVMDiskEncryptionSetId	Verschlüsselungssatz-ID für sichere VM-Datenträger	Schnur

ResourceTags

Name	Beschreibung	Wert

TargetRegion

Name	Beschreibung	Wert
additionalReplicaSets	Liste der Speichersku mit Replikatanzahl zum Erstellen von direkten Laufwerkreplikaten.	AdditionalReplicaSet-[]
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen.	EncryptionImages-
excludeFromLatest	Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben.	Bool
Name	Der Name der Region.	Zeichenfolge (erforderlich)
regionalReplicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

UefiKey

Name	Beschreibung	Wert
Art	Der Typ der Schlüsselsignatur.	'sha256' 'x509'
Wert	Der Wert der Schlüsselsignatur.	string[]

UefiKeySignatures

Name	Beschreibung	Wert
Db	Die Datenbank von UEFI-Schlüsseln für diese Bildversion.	UefiKey-[]
dbx	Die Datenbank mit widerrufenen UEFI-Schlüsseln für diese Imageversion.	UefiKey-[]
kek	Die Schlüsselverschlüsselungsschlüssel dieser Imageversion.	UefiKey-[]
Pk	Der Plattformschlüssel dieser Imageversion.	UefiKey-

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
Erstellen einer Imageversion in einem Azure Compute Gallery-	Mit dieser Vorlage können Sie eine einfache Bildversion in einem Azure Compute Gallery erstellen. Stellen Sie sicher, dass Sie die Vorlage "Azure Compute Gallery 101" und die Vorlage "Image Definition 101" ausgeführt haben, bevor Sie dies bereitstellen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp kataloge/images/versions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Compute/gallerys/images/versions" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images/versions@2024-03-03"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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 = [
          {
            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"
          }
        ]
      }
      restore = bool
      safetyProfile = {
        allowDeletionOfReplicatedLocations = bool
        blockDeletionBeforeEndOfLife = 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

AdditionalReplicaSet

Name	Beschreibung	Wert
regionalReplicaCount	Die Anzahl der direkten Laufwerkreplikate der zu erstellenden Imageversion. Diese Eigenschaft ist aktualisierbar	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Erstellen der direkten Laufwerkreplikate verwendet werden soll.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

DataDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)

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

GalleryArtifactVersionFullSource

Name	Beschreibung	Wert
communityGalleryImageId	Die Ressourcen-ID des Quell-Communitykatalogbilds. Nur erforderlich, wenn Sie Community Gallery Image als Quelle verwenden.	Schnur
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
virtualMachineId	Die Ressourcen-ID des virtuellen Quellcomputers. Nur erforderlich, wenn ein virtueller Computer erfasst wird, um diese Katalogimageversion zu erstellen.	Schnur

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 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 eindeutig sein, der an den virtuellen Computer angefügt ist.	int (erforderlich)
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryDiskImageSource

Name	Beschreibung	Wert
id	Die ID der Versionsquelle des Katalogartefaktes.	Schnur
storageAccountId	Die Speicherkonto-ID, die das vhd-Blob enthält, das als Quelle für diese Artefaktversion verwendet wird.	Schnur
Uri	Der URI der Versionsquelle des Katalogartefaktes. Wird zurzeit verwendet, um vhd/blob-Quelle anzugeben.	Schnur

GalleryExtendedLocation

Name	Beschreibung	Wert
Name		Schnur
Art	Es ist der Typ des erweiterten Speicherorts.	"EdgeZone" "Unbekannt"

GalleryImageVersionProperties

Name	Beschreibung	Wert
publishingProfile	Das Veröffentlichungsprofil einer Katalogbildversion.	GalleryImageVersionPublishingProfile
wiederherstellen	Gibt an, ob es sich um eine Anforderung für die Wiederherstellung von Ressourcen handelt, die vorläufig gelöscht wird.	Bool
safetyProfile	Dies ist das Sicherheitsprofil der Gallery Image Version.	GalleryImageVersionSafetyProfile
securityProfile	Das Sicherheitsprofil einer Katalogbildversion	ImageVersionSecurityProfile-
storageProfile	Dies ist das Speicherprofil einer Katalogbildversion.	GalleryImageVersionStorageProfile- (erforderlich)

GalleryImageVersionPublishingProfile

Name	Beschreibung	Wert
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
excludeFromLatest	Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht.	Bool
replicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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.	"Vollständig" "Flach"
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetExtendedLocations	Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	GalleryTargetExtendedLocation[]
targetRegions	Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar.	TargetRegion-[]

GalleryImageVersionSafetyProfile

Name	Beschreibung	Wert
allowDeletionOfReplicatedLocations	Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.	Bool
blockDeletionBeforeEndOfLife	Gibt an, ob der Löschvorgang für diese Bildergalerieversion blockiert ist, wenn das Ende der Lebensdauer nicht abgelaufen ist.	Bool

GalleryImageVersionStorageProfile

Name	Beschreibung	Wert
dataDiskImages	Eine Liste der Datenträgerimages.	GalleryDataDiskImage[]
osDiskImage	Dies ist das Betriebssystemdatenträgerimage.	GalleryOSDiskImage-
Quelle	Die Quelle der Katalogartefaktversion.	GalleryArtifactVersionFullSource

GalleryImageVersionUefiSettings

Name	Beschreibung	Wert
additionalSignatures	Zusätzliche UEFI-Schlüsselsignaturen, die zusätzlich zu den Signaturvorlagen dem Bild hinzugefügt werden	UefiKeySignatures
signatureTemplateNames	Der Name der Vorlage(n), die Standardsignaturen für UEFI-Schlüssel enthält, die dem Bild hinzugefügt werden.	Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate'

GalleryOSDiskImage

Name	Beschreibung	Wert
hostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"	'None' 'ReadOnly' 'ReadWrite'
Quelle	Die Quelle für das Datenträgerimage.	GalleryDiskImageSource-

GalleryTargetExtendedLocation

Name	Beschreibung	Wert
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
Name	Der Name der Region.	Schnur
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS"

ImageVersionSecurityProfile

Name	Beschreibung	Wert
uefiSettings	Enthält UEFI-Einstellungen für die Bildversion.	GalleryImageVersionUefiSettings

Microsoft.Compute/gallerys/images/versions

Name	Beschreibung	Wert
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
parent_id	Die ID der Ressource, die das übergeordnete Element für diese Ressource ist.	ID für Ressource vom Typ: Kataloge/Bilder
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbildversion.	GalleryImageVersionProperties
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte.
Art	Der Ressourcentyp	"Microsoft.Compute/gallerys/images/versions@2024-03-03"

OSDiskImageEncryption

Name	Beschreibung	Wert
diskEncryptionSetId	Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält.	Schnur
securityProfile	Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an.	OSDiskImageSecurityProfile-

OSDiskImageSecurityProfile

Name	Beschreibung	Wert
confidentialVMEncryptionType	Vertrauliche VM-Verschlüsselungstypen	"EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM"
secureVMDiskEncryptionSetId	Verschlüsselungssatz-ID für sichere VM-Datenträger	Schnur

ResourceTags

Name	Beschreibung	Wert

TargetRegion

Name	Beschreibung	Wert
additionalReplicaSets	Liste der Speichersku mit Replikatanzahl zum Erstellen von direkten Laufwerkreplikaten.	AdditionalReplicaSet-[]
Verschlüsselung	Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen.	EncryptionImages-
excludeFromLatest	Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben.	Bool
Name	Der Name der Region.	Zeichenfolge (erforderlich)
regionalReplicaCount	Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar.	Int
storageAccountType	Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar.	"PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS"

UefiKey

Name	Beschreibung	Wert
Art	Der Typ der Schlüsselsignatur.	'sha256' 'x509'
Wert	Der Wert der Schlüsselsignatur.	string[]

UefiKeySignatures

Name	Beschreibung	Wert
Db	Die Datenbank von UEFI-Schlüsseln für diese Bildversion.	UefiKey-[]
dbx	Die Datenbank mit widerrufenen UEFI-Schlüsseln für diese Imageversion.	UefiKey-[]
kek	Die Schlüsselverschlüsselungsschlüssel dieser Imageversion.	UefiKey-[]
Pk	Der Plattformschlüssel dieser Imageversion.	UefiKey-

Freigeben über

Microsoft.Compute gallerys/images/versions 2024-03-03

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

AdditionalReplicaSet

DataDiskImageEncryption

EncryptionImages

GalleryArtifactVersionFullSource

GalleryDataDiskImage

GalleryDiskImageSource

GalleryExtendedLocation

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryImageVersionSafetyProfile

GalleryImageVersionStorageProfile

GalleryImageVersionUefiSettings

GalleryOSDiskImage

GalleryTargetExtendedLocation

ImageVersionSecurityProfile

Microsoft.Compute/gallerys/images/versions

OSDiskImageEncryption

OSDiskImageSecurityProfile

ResourceTags

TargetRegion

UefiKey

UefiKeySignatures

ARM-Vorlagenressourcendefinition

Ressourcenformat

Eigenschaftswerte

AdditionalReplicaSet

DataDiskImageEncryption

EncryptionImages

GalleryArtifactVersionFullSource

GalleryDataDiskImage

GalleryDiskImageSource

GalleryExtendedLocation

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryImageVersionSafetyProfile

GalleryImageVersionStorageProfile

GalleryImageVersionUefiSettings

GalleryOSDiskImage

GalleryTargetExtendedLocation

ImageVersionSecurityProfile

Microsoft.Compute/gallerys/images/versions

OSDiskImageEncryption

OSDiskImageSecurityProfile

ResourceTags

TargetRegion

UefiKey

UefiKeySignatures

Schnellstartvorlagen

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

AdditionalReplicaSet

DataDiskImageEncryption

EncryptionImages

GalleryArtifactVersionFullSource

GalleryDataDiskImage

GalleryDiskImageSource

GalleryExtendedLocation

GalleryImageVersionProperties

GalleryImageVersionPublishingProfile

GalleryImageVersionSafetyProfile

GalleryImageVersionStorageProfile

GalleryImageVersionUefiSettings

GalleryOSDiskImage

GalleryTargetExtendedLocation

ImageVersionSecurityProfile

Microsoft.Compute/gallerys/images/versions

OSDiskImageEncryption

OSDiskImageSecurityProfile

ResourceTags

TargetRegion

UefiKey

UefiKeySignatures

Feedback

Zusätzliche Ressourcen