Shared Gallery Image Versions - Get

Dienst:

Compute

API-Version:

2024-03-03

Rufen Sie eine freigegebene Katalogimageversion nach Abonnement-ID oder Mandanten-ID ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions/{galleryImageVersionName}?api-version=2024-03-03

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
galleryImageName	path	True	string	Der Name der Shared Gallery-Image-Definition, aus der die Image-Versionen aufgelistet werden sollen.
galleryImageVersionName	path	True	string	Der Name der Version des Galeriebildes, das erstellt werden soll. Muss dem Namensmuster der semantischen Version folgen: Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen innerhalb des Bereichs einer 32-Bit-Ganzzahl liegen. Format: <MajorVersion>.<MinorVersion>.<Flicken>
galleryUniqueName	path	True	string	Der eindeutige Name der freigegebenen Galerie.
location	path	True	string minLength: 1	Der Name der Azure-Region.
subscriptionId	path	True	string minLength: 1	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	SharedGalleryImageVersion	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

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

Get a shared gallery image version.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName/versions/myGalleryImageVersionName?api-version=2024-03-03

Beispiel für eine Antwort

Statuscode:

200

{
  "properties": {
    "publishedDate": "2018-03-20T09:12:28Z",
    "endOfLifeDate": "2022-03-20T09:12:28Z",
    "excludeFromLatest": false,
    "storageProfile": {
      "osDiskImage": {
        "diskSizeGB": 29,
        "hostCaching": "None"
      }
    },
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageVersionName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName/Versions/myGalleryImageVersionName"
  }
}

Definitionen

Name	Beschreibung
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
CloudError	Eine Fehlerantwort vom Compute-Dienst.
InnerError	Innere Fehlerdetails.
SharedGalleryDataDiskImage	Dies ist das Datenträger-Image.
SharedGalleryHostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"
SharedGalleryImageVersion	Gibt Informationen zur Katalogbildversion an, die Sie erstellen oder aktualisieren möchten.
SharedGalleryImageVersionStorageProfile	Dies ist das Speicherprofil einer Katalogbildversion.
SharedGalleryOSDiskImage	Dies ist das Betriebssystemdatenträgerimage.

ApiError

Objekt

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Die Details zum API-Fehler
innererror	InnerError	Der innere API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

InnerError

Objekt

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype	string	Der Ausnahmetyp.

SharedGalleryDataDiskImage

Objekt

Dies ist das Datenträger-Image.

Name	Typ	Beschreibung
diskSizeGB	integer (int32)	Diese Eigenschaft gibt die Größe der zu erstellenden VHD an.
hostCaching	SharedGalleryHostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"
lun	integer (int32)	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 eindeutig sein, der an den virtuellen Computer angefügt ist.

SharedGalleryHostCaching

Enumeration

Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"

Wert	Beschreibung
None
ReadOnly
ReadWrite

SharedGalleryImageVersion

Objekt

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

Name	Typ	Beschreibung
identifier.uniqueId	string	Die eindeutige ID dieser freigegebenen Galerie.
location	string	Ressourcenspeicherort
name	string	Ressourcenname
properties.artifactTags	object	Die Artefakt-Tags einer freigegebenen Katalogressource.
properties.endOfLifeDate	string (date-time)	Das End-of-Life-Datum der Definitionsversion des Katalogbildes. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.
properties.excludeFromLatest	boolean	Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht.
properties.publishedDate	string (date-time)	Das Veröffentlichungsdatum der Galeriebildversion Definition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.
properties.storageProfile	SharedGalleryImageVersionStorageProfile	Beschreibt das Speicherprofil der Image-Version.

SharedGalleryImageVersionStorageProfile

Objekt

Dies ist das Speicherprofil einer Katalogbildversion.

Name	Typ	Beschreibung
dataDiskImages	SharedGalleryDataDiskImage[]	Eine Liste der Datenträgerimages.
osDiskImage	SharedGalleryOSDiskImage	Dies ist das Betriebssystemdatenträgerimage.

SharedGalleryOSDiskImage

Objekt

Dies ist das Betriebssystemdatenträgerimage.

Name	Typ	Beschreibung
diskSizeGB	integer (int32)	Diese Eigenschaft gibt die Größe der zu erstellenden VHD an.
hostCaching	SharedGalleryHostCaching	Die Hostzwischenspeicherung des Datenträgers. Gültige Werte sind "None", "ReadOnly" und "ReadWrite"