Freigeben über


Gallery Images - Create Or Update

Erstellen oder Aktualisieren einer Katalogbilddefinition.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2024-03-03

URI-Parameter

Name In Erforderlich Typ Beschreibung
galleryImageName
path True

string

Der Name der Katalogbilddefinition, die erstellt oder aktualisiert werden soll. Die zulässigen Zeichen sind Alphabete und Zahlen mit Punkten, Strichen und Punkten, die in der Mitte zulässig sind. Die maximale Länge beträgt 80 Zeichen.

galleryName
path True

string

Der Name des freigegebenen Bildkatalogs, in dem die Bilddefinition erstellt werden soll.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Ressourcenspeicherort

properties.identifier True

GalleryImageIdentifier

Dies ist der Katalogbilddefinitionsbezeichner.

properties.osState True

OperatingSystemStateTypes

Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind.

properties.osType True

OperatingSystemTypes

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.

properties.allowUpdateImage

boolean

Wahlfrei. Muss auf "true" festgelegt sein, wenn die Katalogbildfeatures aktualisiert werden.

properties.architecture

Architecture

Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.

properties.description

string

Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar.

properties.disallowed

Disallowed

Beschreibt die unzulässigen Datenträgertypen.

properties.endOfLifeDate

string

Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.

properties.eula

string

Der Eula-Vertrag für die Katalogbilddefinition.

properties.features

GalleryImageFeature[]

Eine Liste der Katalogbildfeatures.

properties.hyperVGeneration

HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

properties.privacyStatementUri

string

Der Datenschutzbestimmungen-URI.

properties.purchasePlan

ImagePurchasePlan

Beschreibt den Kaufplan für Katalogbilderdefinitionen. Dies wird von Marketplace-Images verwendet.

properties.recommended

RecommendedMachineConfiguration

Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar.

properties.releaseNoteUri

string

Der Versionshinweise-URI.

tags

object

Ressourcentags

Antworten

Name Typ Beschreibung
200 OK

GalleryImage

OKAY

201 Created

GalleryImage

Erstellt

202 Accepted

GalleryImage

Angenommen

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Beispielanforderung

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    }
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Creating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

Architecture

Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.

CloudError

Eine Fehlerantwort des Computediensts.

Disallowed

Beschreibt die unzulässigen Datenträgertypen.

GalleryImage

Gibt Informationen zur Katalogbilddefinition an, die Sie erstellen oder aktualisieren möchten.

GalleryImageFeature

Ein Feature für das Katalogbild.

GalleryImageIdentifier

Dies ist der Katalogbilddefinitionsbezeichner.

GalleryProvisioningState

Der aktuelle Status des Katalog- oder Katalogartefaktes.

HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

ImagePurchasePlan

Beschreibt den Kaufplan für Katalogbilderdefinitionen. Dies wird von Marketplace-Images verwendet.

InnerError

Innere Fehlerdetails.

OperatingSystemStateTypes

Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind.

OperatingSystemTypes

Mit dieser Eigenschaft können Sie den unterstützten Typ des Betriebssystems angeben, für das die Anwendung erstellt wurde. Mögliche Werte sind: Windows,Linux.

RecommendedMachineConfiguration

Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar.

ResourceRange

Beschreibt den Ressourcenbereich.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Die API-Fehlerdetails

innererror

InnerError

Interner API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

Architecture

Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.

Name Typ Beschreibung
Arm64

string

x64

string

CloudError

Eine Fehlerantwort des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

Disallowed

Beschreibt die unzulässigen Datenträgertypen.

Name Typ Beschreibung
diskTypes

string[]

Eine Liste der Datenträgertypen.

GalleryImage

Gibt Informationen zur Katalogbilddefinition an, die Sie erstellen oder aktualisieren möchten.

Name Typ Beschreibung
id

string

Ressourcen-ID

location

string

Ressourcenspeicherort

name

string

Ressourcenname

properties.allowUpdateImage

boolean

Wahlfrei. Muss auf "true" festgelegt sein, wenn die Katalogbildfeatures aktualisiert werden.

properties.architecture

Architecture

Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.

properties.description

string

Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar.

properties.disallowed

Disallowed

Beschreibt die unzulässigen Datenträgertypen.

properties.endOfLifeDate

string

Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.

properties.eula

string

Der Eula-Vertrag für die Katalogbilddefinition.

properties.features

GalleryImageFeature[]

Eine Liste der Katalogbildfeatures.

properties.hyperVGeneration

HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

properties.identifier

GalleryImageIdentifier

Dies ist der Katalogbilddefinitionsbezeichner.

properties.osState

OperatingSystemStateTypes

Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind.

properties.osType

OperatingSystemTypes

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.

properties.privacyStatementUri

string

Der Datenschutzbestimmungen-URI.

properties.provisioningState

GalleryProvisioningState

Der aktuelle Status des Katalog- oder Katalogartefaktes.
Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

properties.purchasePlan

ImagePurchasePlan

Beschreibt den Kaufplan für Katalogbilderdefinitionen. Dies wird von Marketplace-Images verwendet.

properties.recommended

RecommendedMachineConfiguration

Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar.

properties.releaseNoteUri

string

Der Versionshinweise-URI.

tags

object

Ressourcentags

type

string

Ressourcentyp

GalleryImageFeature

Ein Feature für das Katalogbild.

Name Typ Beschreibung
name

string

Der Name des Katalogbildfeatures.

startsAtVersion

string

Die Mindestbildversion des Katalogs, die dieses Feature unterstützt.

value

string

Der Wert des Katalogbildfeatures.

GalleryImageIdentifier

Dies ist der Katalogbilddefinitionsbezeichner.

Name Typ Beschreibung
offer

string

Der Name des Katalogbilddefinitionsangebots.

publisher

string

Der Name des Herausgebers der Katalogbilddefinition.

sku

string

Der Name der SKU der Katalogbilddefinition.

GalleryProvisioningState

Der aktuelle Status des Katalog- oder Katalogartefaktes.

Name Typ Beschreibung
Creating

string

Deleting

string

Failed

string

Migrating

string

Succeeded

string

Updating

string

HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

Name Typ Beschreibung
V1

string

V2

string

ImagePurchasePlan

Beschreibt den Kaufplan für Katalogbilderdefinitionen. Dies wird von Marketplace-Images verwendet.

Name Typ Beschreibung
name

string

Die Plan-ID.

product

string

Die Produkt-ID.

publisher

string

Die Herausgeber-ID.

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

OperatingSystemStateTypes

Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind.

Name Typ Beschreibung
Generalized

string

Specialized

string

OperatingSystemTypes

Mit dieser Eigenschaft können Sie den unterstützten Typ des Betriebssystems angeben, für das die Anwendung erstellt wurde. Mögliche Werte sind: Windows,Linux.

Name Typ Beschreibung
Linux

string

Windows

string

RecommendedMachineConfiguration

Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar.

Name Typ Beschreibung
memory

ResourceRange

Beschreibt den Ressourcenbereich.

vCPUs

ResourceRange

Beschreibt den Ressourcenbereich.

ResourceRange

Beschreibt den Ressourcenbereich.

Name Typ Beschreibung
max

integer

Die maximale Anzahl der Ressource.

min

integer

Die Mindestanzahl der Ressource.