Microsoft.Compute gallerys/images

  • Artikel

Bicep-Ressourcendefinition

Der Ressourcentyp galleries/images 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-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Compute/galleries/images@2023-07-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

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep.		 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. 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: kataloge
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 unzulässigen Datenträgertypen. Unzulässige
endOfLifeDate Das Datum des Lebenszyklusendes der Katalogimagedefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
eula Die Eula-Vereinbarung für die Katalogimagedefinition. Zeichenfolge
Features Eine Liste der Katalogimagefeatures. GalleryImageFeature[]
hyperVGeneration Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. "V1"
"V2"
Bezeichner Dies ist der Katalogimagedefinitionsbezeichner. GalleryImageIdentifier (erforderlich)
osState Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind. "Generalisiert"
"Spezialisiert" (erforderlich)
osType Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das beim Erstellen eines virtuellen Computers aus einem verwalteten Image auf dem Datenträger enthalten ist. Mögliche Werte sind: Windows,Linux. "Linux"
"Windows" (erforderlich)
privacyStatementUri Die Datenschutzerklärung URI. Zeichenfolge
purchasePlan Beschreibt den Kaufplan für die Katalogimagedefinition. 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 URI der Versionshinweise. Zeichenfolge

Unzulässig

Name BESCHREIBUNG Wert
diskTypes Eine Liste der 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.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp galleries/images 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-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2023-07-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 Der Ressourcentyp "Microsoft.Compute/galleries/images"
apiVersion Die Version der Ressourcen-API '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: 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 sind: 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

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@2023-07-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@2023-07-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 unzulä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 sind: 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