Freigeben über


Microsoft.Compute galleries/images/versions 2021-07-01

Bicep-Ressourcendefinition

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

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

Ressourcenformat

Um eine Microsoft.Compute/galleries/images/versions-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep-Ressource hinzu.

resource symbolicname 'Microsoft.Compute/galleries/images/versions@2021-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    publishingProfile: {
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      replicaCount: int
      replicationMode: 'string'
      storageAccountType: 'string'
      targetRegions: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
            }
          }
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    storageProfile: {
      dataDiskImages: [
        {
          hostCaching: 'string'
          lun: int
          source: {
            id: 'string'
            uri: 'string'
          }
        }
      ]
      osDiskImage: {
        hostCaching: 'string'
        source: {
          id: 'string'
          uri: 'string'
        }
      }
      source: {
        id: 'string'
        uri: 'string'
      }
    }
  }
}

Eigenschaftswerte

galleries/images/versions

Name BESCHREIBUNG Wert
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep.
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. Weitere Informationen finden Sie unter 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
storageProfile Dies ist das Speicherprofil einer Katalogimageversion. GalleryImageVersionStorageProfile (erforderlich)

GalleryImageVersionPublishingProfile

Name BESCHREIBUNG Wert
endOfLifeDate Das Enddatum der Version des Katalogimages. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn dieser Wert auf 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 soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben ist. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den für die Replikation zu verwendenden Modus angibt. 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"
targetRegions Die Zielregionen, in die die Imageversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

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
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"

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

GalleryImageVersionStorageProfile

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste von Datenträgerimages. GalleryDataDiskImage[]
osDiskImage Dies ist das Betriebssystemdatenträgerimage. GalleryOSDiskImage
source Die Quelle der Katalogartefaktversion. GalleryArtifactVersionSource

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 der Katalogartefaktversion. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Name BESCHREIBUNG Wert
id Die ID der Artefaktversionsquelle des Katalogs. Kann einen Datenträger-URI, Momentaufnahme URI, ein Benutzerimage oder eine Speicherkontoressource angeben. 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 der Katalogartefaktversion. GalleryArtifactVersionSource

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage BESCHREIBUNG
Erstellen einer Imageversion in einem Azure Compute-Katalog

Bereitstellen in Azure
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 auf Folgendes abzielen:

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

Ressourcenformat

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

{
  "type": "Microsoft.Compute/galleries/images/versions",
  "apiVersion": "2021-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "publishingProfile": {
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "replicaCount": "int",
      "replicationMode": "string",
      "storageAccountType": "string",
      "targetRegions": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string"
            }
          },
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "storageProfile": {
      "dataDiskImages": [
        {
          "hostCaching": "string",
          "lun": "int",
          "source": {
            "id": "string",
            "uri": "string"
          }
        }
      ],
      "osDiskImage": {
        "hostCaching": "string",
        "source": {
          "id": "string",
          "uri": "string"
        }
      },
      "source": {
        "id": "string",
        "uri": "string"
      }
    }
  }
}

Eigenschaftswerte

galleries/images/versions

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Compute/galleries/images/versions"
apiVersion Die Version der Ressourcen-API '2021-07-01'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.
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. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties Beschreibt die Eigenschaften einer Katalogimageversion. GalleryImageVersionProperties

GalleryImageVersionProperties

Name BESCHREIBUNG Wert
publishingProfile Das Veröffentlichungsprofil eines Katalogimages Version. GalleryImageVersionPublishingProfile
storageProfile Dies ist das Speicherprofil einer Katalogimageversion. GalleryImageVersionStorageProfile (erforderlich)

GalleryImageVersionPublishingProfile

Name BESCHREIBUNG Wert
endOfLifeDate Das Enddatum der Version des Katalogimages. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn dieser Wert auf 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 soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben ist. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den für die Replikation zu verwendenden Modus angibt. 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"
targetRegions Die Zielregionen, in die die Imageversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

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
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"

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

GalleryImageVersionStorageProfile

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste von Datenträgerimages. GalleryDataDiskImage[]
osDiskImage Dies ist das Betriebssystemdatenträgerimage. GalleryOSDiskImage
source Die Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource

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 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 Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Name BESCHREIBUNG Wert
id Die ID der Artefaktversionsquelle des Katalogs. Kann einen Datenträger-URI, Momentaufnahme URI, ein Benutzerimage oder eine Speicherkontoressource angeben. 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". "Keine"
"ReadOnly"
"ReadWrite"
source Die Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Erstellen einer Imageversion in einem Azure Compute Gallery

Bereitstellen in Azure
Mit dieser Vorlage können Sie eine einfache Imageversion in einer Azure Compute Gallery erstellen. Stellen Sie sicher, dass Sie die Azure Compute Gallery 101-Vorlage und die Imagedefinition 101-Vorlage ausgeführt haben, bevor Sie diese bereitstellen.

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp galleries/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 im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Compute/galleries/images/versions-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images/versions@2021-07-01"
  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"
        targetRegions = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
              }
            }
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      storageProfile = {
        dataDiskImages = [
          {
            hostCaching = "string"
            lun = int
            source = {
              id = "string"
              uri = "string"
            }
          }
        ]
        osDiskImage = {
          hostCaching = "string"
          source = {
            id = "string"
            uri = "string"
          }
        }
        source = {
          id = "string"
          uri = "string"
        }
      }
    }
  })
}

Eigenschaftswerte

galleries/images/versions

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Compute/galleries/images/versions@2021-07-01"
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 das übergeordnete Element 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
storageProfile Dies ist das Speicherprofil einer Katalogimageversion. GalleryImageVersionStorageProfile (erforderlich)

GalleryImageVersionPublishingProfile

Name BESCHREIBUNG Wert
endOfLifeDate Das Enddatum der Version des Katalogimages. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn dieser Wert auf 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 soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben ist. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den für die Replikation zu verwendenden Modus angibt. Diese Eigenschaft ist nicht aktualisierbar. "Vollständig"
"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“
targetRegions Die Zielregionen, in die die Imageversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

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
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“

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

GalleryImageVersionStorageProfile

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste von Datenträgerimages. GalleryDataDiskImage[]
osDiskImage Dies ist das Betriebssystemdatenträgerimage. GalleryOSDiskImage
source Die Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource

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 Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Name BESCHREIBUNG Wert
id Die ID der Artefaktversionsquelle des Katalogs. Kann einen Datenträger-URI, Momentaufnahme URI, ein Benutzerimage oder eine Speicherkontoressource angeben. 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 Artefaktversionsquelle des Katalogs. GalleryArtifactVersionSource