Share via


Microsoft.Compute-Kataloge/Images 2022-01-03

Bicep-Ressourcendefinition

Der Ressourcentyp galleries/images kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

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

Ressourcenformat

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

resource symbolicname 'Microsoft.Compute/galleries/images@2022-01-03' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    architecture: 'string'
    description: 'string'
    disallowed: {
      diskTypes: [
        'string'
      ]
    }
    endOfLifeDate: 'string'
    eula: 'string'
    features: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    hyperVGeneration: 'string'
    identifier: {
      offer: 'string'
      publisher: 'string'
      sku: 'string'
    }
    osState: 'string'
    osType: 'string'
    privacyStatementUri: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      publisher: 'string'
    }
    recommended: {
      memory: {
        max: int
        min: int
      }
      vCPUs: {
        max: int
        min: int
      }
    }
    releaseNoteUri: 'string'
  }
}

Eigenschaftswerte

galleries/images

Name BESCHREIBUNG Wert
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte.

Beginnen und enden Sie mit einem alphanumerischen Zeichen.
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: Galerien
properties Beschreibt die Eigenschaften einer Katalogbilddefinition. GalleryImageProperties

GalleryImageProperties

Name BESCHREIBUNG Wert
Architektur Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. Arm64
'x64'
description Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
Unzulässige Beschreibt die nicht zulässigen Datenträgertypen. Unzulässige
endOfLifeDate Das Datum des Lebenszyklusendes der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
eula Die Eula-Vereinbarung für die Katalogbilddefinition. Zeichenfolge
Features Eine Liste der Features des Katalogimages. GalleryImageFeature[]
hyperVGeneration Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. "V1"
"V2"
Bezeichner Dies ist der Katalogbilddefinitionsbezeichner. GalleryImageIdentifier (erforderlich)
osState Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. "Generalisiert"
"Spezialisiert" (erforderlich)
osType Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem verwalteten Image erstellen.

Mögliche Werte:

Windows

Linux
"Linux"
"Windows" (erforderlich)
privacyStatementUri Die Datenschutzerklärung uri. Zeichenfolge
purchasePlan Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. ImagePurchasePlan
empfohlen Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. RecommendedMachineConfiguration
releaseNoteUri Der Releasenoten-URI. Zeichenfolge

Unzulässig

Name BESCHREIBUNG Wert
diskTypes Eine Liste von Datenträgertypen. string[]

GalleryImageFeature

Name BESCHREIBUNG Wert
name Der Name des Katalogimagefeatures. Zeichenfolge
value Der Wert des Katalogimagefeatures. Zeichenfolge

GalleryImageIdentifier

Name BESCHREIBUNG Wert
offer Der Name des Katalogimagedefinitionsangebots. Zeichenfolge (erforderlich)
publisher Der Name des Katalogimagedefinitionsherausgebers. Zeichenfolge (erforderlich)
sku Der Name der Katalogimagedefinitions-SKU. Zeichenfolge (erforderlich)

ImagePurchasePlan

Name BESCHREIBUNG Wert
name Die Plan-ID. Zeichenfolge
product Die Produkt-ID Zeichenfolge
publisher Die Herausgeber-ID. Zeichenfolge

RecommendedMachineConfiguration

Name BESCHREIBUNG Wert
Arbeitsspeicher Beschreibt den Ressourcenbereich. ResourceRange
vCPUs Beschreibt den Ressourcenbereich. ResourceRange

ResourceRange

Name BESCHREIBUNG Wert
max Die maximale Anzahl der Ressource. INT
Min. Die Mindestanzahl der Ressource. INT

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage BESCHREIBUNG
Azure Image Builder mit Azure Windows-Baseline

Bereitstellen in Azure
Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit dem neuesten Windows Updates und Azure Windows Baseline angewendet.
Erstellen einer Imagedefinition in einem Azure Compute-Katalog

Bereitstellen in Azure
Mit dieser Vorlage können Sie eine einfache Imagedefinition in einem Azure Compute-Katalog erstellen. Stellen Sie sicher, dass Sie die Shared Image Gallery 101-Vorlage ausgeführt haben, bevor Sie diese bereitstellen.
Konfigurieren des Dev Box-Diensts

Bereitstellen in Azure
Mit dieser Vorlage werden alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstartanleitung erstellt. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihre erste Dev Box zu erstellen.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp galleries/images kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

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

Ressourcenformat

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

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2022-01-03",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "architecture": "string",
    "description": "string",
    "disallowed": {
      "diskTypes": [ "string" ]
    },
    "endOfLifeDate": "string",
    "eula": "string",
    "features": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "hyperVGeneration": "string",
    "identifier": {
      "offer": "string",
      "publisher": "string",
      "sku": "string"
    },
    "osState": "string",
    "osType": "string",
    "privacyStatementUri": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "publisher": "string"
    },
    "recommended": {
      "memory": {
        "max": "int",
        "min": "int"
      },
      "vCPUs": {
        "max": "int",
        "min": "int"
      }
    },
    "releaseNoteUri": "string"
  }
}

Eigenschaftswerte

galleries/images

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.Compute/galleries/images"
apiVersion Die Ressourcen-API-Version '2022-01-03'
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte.

Beginnen und enden Sie mit einem alphanumerischen Zeichen.
location Ressourcenspeicherort Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
properties Beschreibt die Eigenschaften einer Katalogbilddefinition. GalleryImageProperties

GalleryImageProperties

Name BESCHREIBUNG Wert
Architektur Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. Arm64
'x64'
description Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
Unzulässige Beschreibt die nicht zulässigen Datenträgertypen. Unzulässige
endOfLifeDate Das Datum des Lebenszyklusendes der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
eula Die Eula-Vereinbarung für die Katalogbilddefinition. Zeichenfolge
Features Eine Liste der Features des Katalogimages. GalleryImageFeature[]
hyperVGeneration Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. "V1"
"V2"
Bezeichner Dies ist der Katalogbilddefinitionsbezeichner. GalleryImageIdentifier (erforderlich)
osState Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. "Generalisiert"
"Spezialisiert" (erforderlich)
osType Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem verwalteten Image erstellen.

Mögliche Werte:

Windows

Linux
"Linux"
"Windows" (erforderlich)
privacyStatementUri Die Datenschutzerklärung uri. Zeichenfolge
purchasePlan Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. ImagePurchasePlan
empfohlen Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. RecommendedMachineConfiguration
releaseNoteUri Der Releasenoten-URI. Zeichenfolge

Unzulässig

Name BESCHREIBUNG Wert
diskTypes Eine Liste von Datenträgertypen. string[]

GalleryImageFeature

Name BESCHREIBUNG Wert
name Der Name des Katalogimagefeatures. Zeichenfolge
value Der Wert des Katalogimagefeatures. Zeichenfolge

GalleryImageIdentifier

Name BESCHREIBUNG Wert
offer Der Name des Katalogimagedefinitionsangebots. Zeichenfolge (erforderlich)
publisher Der Name des Herausgebers der Katalogimagedefinition. Zeichenfolge (erforderlich)
sku Der Name der Katalogimagedefinitions-SKU. Zeichenfolge (erforderlich)

ImagePurchasePlan

Name BESCHREIBUNG Wert
name Die Plan-ID. Zeichenfolge
product Die Produkt-ID Zeichenfolge
publisher Die Herausgeber-ID. Zeichenfolge

RecommendedMachineConfiguration

Name BESCHREIBUNG Wert
Arbeitsspeicher Beschreibt den Ressourcenbereich. ResourceRange
vCPUs Beschreibt den Ressourcenbereich. ResourceRange

ResourceRange

Name BESCHREIBUNG Wert
max Die maximale Anzahl der Ressource. INT
Min. Die Mindestanzahl der Ressource. INT

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Azure Image Builder mit Azure Windows Baseline

Bereitstellen in Azure
Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit dem neuesten Windows Updates und angewendeter Azure Windows-Baseline.
Erstellen einer Imagedefinition in einem Azure Compute Gallery

Bereitstellen in Azure
Mit dieser Vorlage können Sie eine einfache Imagedefinition in einer Azure Compute Gallery erstellen. Stellen Sie sicher, dass Sie die Shared Image Gallery 101-Vorlage ausgeführt haben, bevor Sie diese bereitstellen.
Konfigurieren des Dev Box-Diensts

Bereitstellen in Azure
Mit dieser Vorlage würden alle Dev Box-Administratorressourcen gemäß der Dev Box-Schnellstartanleitung erstellt. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihre erste Dev Box zu erstellen.

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp galleries/images 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-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images@2022-01-03"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      architecture = "string"
      description = "string"
      disallowed = {
        diskTypes = [
          "string"
        ]
      }
      endOfLifeDate = "string"
      eula = "string"
      features = [
        {
          name = "string"
          value = "string"
        }
      ]
      hyperVGeneration = "string"
      identifier = {
        offer = "string"
        publisher = "string"
        sku = "string"
      }
      osState = "string"
      osType = "string"
      privacyStatementUri = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        publisher = "string"
      }
      recommended = {
        memory = {
          max = int
          min = int
        }
        vCPUs = {
          max = int
          min = int
        }
      }
      releaseNoteUri = "string"
    }
  })
}

Eigenschaftswerte

galleries/images

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Compute/galleries/images@2022-01-03"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte.

Beginnen und enden Sie mit einem alphanumerischen Zeichen.
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: Kataloge
tags Ressourcentags Wörterbuch der Tagnamen und -werte.
properties Beschreibt die Eigenschaften einer Katalogimagedefinition. GalleryImageProperties

GalleryImageProperties

Name BESCHREIBUNG Wert
Architektur Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. "Arm64"
"x64"
description Die Beschreibung dieser Imagedefinitionsressource des Katalogs. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
Unzulässige Beschreibt die nicht zulässigen Datenträgertypen. Unzulässige
endOfLifeDate Das Datum des Lebenszyklusendes der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
eula Die Eula-Vereinbarung für die Katalogbilddefinition. Zeichenfolge
Features Eine Liste der Features des Katalogimages. GalleryImageFeature[]
hyperVGeneration Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. „V1“
„V2“
Bezeichner Dies ist der Katalogbilddefinitionsbezeichner. GalleryImageIdentifier (erforderlich)
osState Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. "Generalisiert"
"Spezialisiert" (erforderlich)
osType Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem verwalteten Image erstellen.

Mögliche Werte:

Windows

Linux
"Linux"
"Windows" (erforderlich)
privacyStatementUri Die Datenschutzerklärung uri. Zeichenfolge
purchasePlan Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. ImagePurchasePlan
empfohlen Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. RecommendedMachineConfiguration
releaseNoteUri Der Releasenoten-URI. Zeichenfolge

Unzulässig

Name BESCHREIBUNG Wert
diskTypes Eine Liste von Datenträgertypen. string[]

GalleryImageFeature

Name BESCHREIBUNG Wert
name Der Name des Katalogimagefeatures. Zeichenfolge
value Der Wert des Katalogimagefeatures. Zeichenfolge

GalleryImageIdentifier

Name BESCHREIBUNG Wert
offer Der Name des Katalogimagedefinitionsangebots. Zeichenfolge (erforderlich)
publisher Der Name des Katalogimagedefinitionsherausgebers. Zeichenfolge (erforderlich)
sku Der Name der Katalogimagedefinitions-SKU. Zeichenfolge (erforderlich)

ImagePurchasePlan

Name BESCHREIBUNG Wert
name Die Plan-ID. Zeichenfolge
product Die Produkt-ID Zeichenfolge
publisher Die Herausgeber-ID. Zeichenfolge

RecommendedMachineConfiguration

Name BESCHREIBUNG Wert
Arbeitsspeicher Beschreibt den Ressourcenbereich. ResourceRange
vCPUs Beschreibt den Ressourcenbereich. ResourceRange

ResourceRange

Name BESCHREIBUNG Wert
max Die maximale Anzahl der Ressource. INT
Min. Die Mindestanzahl der Ressource. INT