Microsoft.Compute/gallerys/images 2021-10-01 - Bicep, ARM template & Terraform AzAPI reference

Bicep-Ressourcendefinition

Der Ressourcentyp "Kataloge/Images" 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" zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Compute/galleries/images@2021-10-01' = {
  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

Kataloge/Bilder

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: Alphanumerisch, Unterstriche, Bindestriche und Punkte. Beginnen und enden Sie mit alphanumerisch.
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
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 des Typs: Kataloge
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbilddefinition.	GalleryImageProperties

GalleryImageProperties

Name	Beschreibung	Wert
Architektur	Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.	"Arm64" 'x64'
Beschreibung	Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar.	Schnur
Unzulässige	Beschreibt die unzulässigen Datenträgertypen.	unzulässige
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
Eula	Der Eula-Vertrag für die Katalogbilddefinition.	Schnur
Funktionen	Eine Liste der Katalogbildfeatures.	GalleryImageFeature[]
hyperVGeneration	Die Hypervisorgenerierung 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 "Generalisiert" oder "Spezialisiert" sind.	"Generalisiert" "Specialized" (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	Der Datenschutzbestimmungen-URI.	Schnur
purchasePlan	Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 Versionshinweise-URI.	Schnur

Unzulässige

Name	Beschreibung	Wert
diskTypes	Eine Liste der Datenträgertypen.	string[]

GalleryImageFeature

Name	Beschreibung	Wert
Name	Der Name des Katalogbildfeatures.	Schnur
Wert	Der Wert des Katalogbildfeatures.	Schnur

GalleryImageIdentifier

Name	Beschreibung	Wert
Angebot	Der Name des Katalogbilddefinitionsangebots.	Zeichenfolge (erforderlich)
Verlag	Der Name des Herausgebers der Katalogbilddefinition.	Zeichenfolge (erforderlich)
Sku	Der Name der SKU der Katalogbilddefinition.	Zeichenfolge (erforderlich)

ImagePurchasePlan

Name	Beschreibung	Wert
Name	Die Plan-ID.	Schnur
Produkt	Die Produkt-ID.	Schnur
Verlag	Die Herausgeber-ID.	Schnur

RecommendedMachineConfiguration

Name	Beschreibung	Wert
Gedächtnis	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

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
Azure Image Builder mit Azure Windows Baseline	Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit den neuesten Angewendeten Windows-Updates und Azure Windows Baseline.
Erstellen einer Bilddefinition in einem Azure Compute Gallery-	Mit dieser Vorlage können Sie eine einfache Bilddefinition in einem Azure Compute Gallery erstellen. Stellen Sie sicher, dass Sie die Vorlage "Freigegebene Bildergalerie 101" ausgeführt haben, bevor Sie dies bereitstellen.
Konfigurieren des Dev Box-Diensts	Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß Dev Box-Schnellstarthandbuch (https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Kataloge/Images" 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 Microsoft.Compute/gallerys/images-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2021-10-01",
  "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

Kataloge/Bilder

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Compute/gallerys/images"
apiVersion	Die Ressourcen-API-Version	'2021-10-01'
Name	Der Ressourcenname Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON ARM-Vorlagenfestlegen.	Zeichenfolge (erforderlich) Zeichenlimit: 1-80 Gültige Zeichen: Alphanumerisch, Unterstriche, Bindestriche und Punkte. Beginnen und enden Sie mit alphanumerisch.
Ort	Ressourcenspeicherort	Zeichenfolge (erforderlich)
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbilddefinition.	GalleryImageProperties

GalleryImageProperties

Name	Beschreibung	Wert
Architektur	Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.	"Arm64" 'x64'
Beschreibung	Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar.	Schnur
Unzulässige	Beschreibt die unzulässigen Datenträgertypen.	unzulässige
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
Eula	Der Eula-Vertrag für die Katalogbilddefinition.	Schnur
Funktionen	Eine Liste der Katalogbildfeatures.	GalleryImageFeature[]
hyperVGeneration	Die Hypervisorgenerierung 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 "Generalisiert" oder "Spezialisiert" sind.	"Generalisiert" "Specialized" (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	Der Datenschutzbestimmungen-URI.	Schnur
purchasePlan	Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 Versionshinweise-URI.	Schnur

Unzulässige

Name	Beschreibung	Wert
diskTypes	Eine Liste der Datenträgertypen.	string[]

GalleryImageFeature

Name	Beschreibung	Wert
Name	Der Name des Katalogbildfeatures.	Schnur
Wert	Der Wert des Katalogbildfeatures.	Schnur

GalleryImageIdentifier

Name	Beschreibung	Wert
Angebot	Der Name des Katalogbilddefinitionsangebots.	Zeichenfolge (erforderlich)
Verlag	Der Name des Herausgebers der Katalogbilddefinition.	Zeichenfolge (erforderlich)
Sku	Der Name der SKU der Katalogbilddefinition.	Zeichenfolge (erforderlich)

ImagePurchasePlan

Name	Beschreibung	Wert
Name	Die Plan-ID.	Schnur
Produkt	Die Produkt-ID.	Schnur
Verlag	Die Herausgeber-ID.	Schnur

RecommendedMachineConfiguration

Name	Beschreibung	Wert
Gedächtnis	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

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
Azure Image Builder mit Azure Windows Baseline	Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit den neuesten Angewendeten Windows-Updates und Azure Windows Baseline.
Erstellen einer Bilddefinition in einem Azure Compute Gallery-	Mit dieser Vorlage können Sie eine einfache Bilddefinition in einem Azure Compute Gallery erstellen. Stellen Sie sicher, dass Sie die Vorlage "Freigegebene Bildergalerie 101" ausgeführt haben, bevor Sie dies bereitstellen.
Konfigurieren des Dev Box-Diensts	Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß Dev Box-Schnellstarthandbuch (https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Kataloge/Images" 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" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images@2021-10-01"
  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

Kataloge/Bilder

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Compute/gallerys/images@2021-10-01"
Name	Der Ressourcenname	Zeichenfolge (erforderlich) Zeichenlimit: 1-80 Gültige Zeichen: Alphanumerisch, Unterstriche, Bindestriche und Punkte. Beginnen und enden Sie mit alphanumerisch.
Ort	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
Schilder	Ressourcentags	Wörterbuch der Tagnamen und -werte.
Eigenschaften	Beschreibt die Eigenschaften einer Katalogbilddefinition.	GalleryImageProperties

GalleryImageProperties

Name	Beschreibung	Wert
Architektur	Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.	"Arm64" "x64"
Beschreibung	Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar.	Schnur
Unzulässige	Beschreibt die unzulässigen Datenträgertypen.	unzulässige
endOfLifeDate	Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.	Schnur
Eula	Der Eula-Vertrag für die Katalogbilddefinition.	Schnur
Funktionen	Eine Liste der Katalogbildfeatures.	GalleryImageFeature[]
hyperVGeneration	Die Hypervisorgenerierung 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 "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	Der Datenschutzbestimmungen-URI.	Schnur
purchasePlan	Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 Versionshinweise-URI.	Schnur

Unzulässige

Name	Beschreibung	Wert
diskTypes	Eine Liste der Datenträgertypen.	string[]

GalleryImageFeature

Name	Beschreibung	Wert
Name	Der Name des Katalogbildfeatures.	Schnur
Wert	Der Wert des Katalogbildfeatures.	Schnur

GalleryImageIdentifier

Name	Beschreibung	Wert
Angebot	Der Name des Katalogbilddefinitionsangebots.	Zeichenfolge (erforderlich)
Verlag	Der Name des Herausgebers der Katalogbilddefinition.	Zeichenfolge (erforderlich)
Sku	Der Name der SKU der Katalogbilddefinition.	Zeichenfolge (erforderlich)

ImagePurchasePlan

Name	Beschreibung	Wert
Name	Die Plan-ID.	Schnur
Produkt	Die Produkt-ID.	Schnur
Verlag	Die Herausgeber-ID.	Schnur

RecommendedMachineConfiguration

Name	Beschreibung	Wert
Gedächtnis	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

Freigeben über

Microsoft.Compute-Kataloge/Bilder 2021-10-01

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

Kataloge/Bilder

GalleryImageProperties

Unzulässige

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

RecommendedMachineConfiguration

ResourceRange

Schnellstartvorlagen

ARM-Vorlagenressourcendefinition

Ressourcenformat

Eigenschaftswerte

Kataloge/Bilder

GalleryImageProperties

Unzulässige

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

RecommendedMachineConfiguration

ResourceRange

Schnellstartvorlagen

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

Kataloge/Bilder

GalleryImageProperties

Unzulässige

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

RecommendedMachineConfiguration

ResourceRange

Feedback

Zusätzliche Ressourcen