Udostępnij za pośrednictwem


Shared Gallery Image Versions - Get

Pobierz udostępnioną wersję obrazu galerii według identyfikatora subskrypcji lub identyfikatora dzierżawy.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
galleryImageName
path True

string

Nazwa definicji obrazu z galerii udostępnionej, z której mają być wyświetlane wersje obrazu.

galleryImageVersionName
path True

string

Nazwa wersji obrazu galerii, która ma zostać utworzona. Musi być zgodna ze wzorcem nazwy wersji semantycznej: dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej. Format: <MajorVersion>.<Wersja pomocnicza>.<Łata>

galleryUniqueName
path True

string

Unikatowa nazwa galerii udostępnionej.

location
path True

string

minLength: 1

Nazwa regionu świadczenia usługi Azure.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

SharedGalleryImageVersion

Operacja platformy Azure została zakończona pomyślnie.

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
  }
}

Definicje

Nazwa Opis
ApiError

Błąd API.

ApiErrorBase

Baza błędów API.

CloudError

Odpowiedź na błąd z usługi obliczeniowej.

InnerError

Szczegóły błędu wewnętrznego.

SharedGalleryDataDiskImage

To jest obraz dysku z danymi.

SharedGalleryHostCaching

Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite"

SharedGalleryImageVersion

Określa informacje o wersji obrazu galerii, którą chcesz utworzyć lub zaktualizować.

SharedGalleryImageVersionStorageProfile

Jest to profil magazynu wersji obrazu galerii.

SharedGalleryOSDiskImage

Jest to obraz dysku systemu operacyjnego.

ApiError

Błąd API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Wewnętrzny błąd interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów API.

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

CloudError

Odpowiedź na błąd z usługi obliczeniowej.

Nazwa Typ Opis
error

ApiError

Błąd API.

InnerError

Szczegóły błędu wewnętrznego.

Nazwa Typ Opis
errordetail

string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype

string

Typ wyjątku.

SharedGalleryDataDiskImage

To jest obraz dysku z danymi.

Nazwa Typ Opis
diskSizeGB

integer (int32)

Ta właściwość wskazuje rozmiar wirtualnego dysku twardego, który ma zostać utworzony.

hostCaching

SharedGalleryHostCaching

Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite"

lun

integer (int32)

Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych w ramach maszyny wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej.

SharedGalleryHostCaching

Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite"

Wartość Opis
None
ReadOnly
ReadWrite

SharedGalleryImageVersion

Określa informacje o wersji obrazu galerii, którą chcesz utworzyć lub zaktualizować.

Nazwa Typ Opis
identifier.uniqueId

string

Unikatowy identyfikator tej udostępnionej galerii.

location

string

Lokalizacja zasobu

name

string

Nazwa zasobu

properties.artifactTags

object

Tagi artefaktów udostępnionego zasobu galerii.

properties.endOfLifeDate

string (date-time)

Data końca żywotności wersji obrazu z galerii Definicja. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.

properties.excludeFromLatest

boolean

Jeśli ustawiono wartość true, maszyny wirtualne wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu.

properties.publishedDate

string (date-time)

Data publikacji wersji obrazu z galerii Definicja. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.

properties.storageProfile

SharedGalleryImageVersionStorageProfile

Opisuje profil magazynu wersji obrazu.

SharedGalleryImageVersionStorageProfile

Jest to profil magazynu wersji obrazu galerii.

Nazwa Typ Opis
dataDiskImages

SharedGalleryDataDiskImage[]

Lista obrazów dysków danych.

osDiskImage

SharedGalleryOSDiskImage

Jest to obraz dysku systemu operacyjnego.

SharedGalleryOSDiskImage

Jest to obraz dysku systemu operacyjnego.

Nazwa Typ Opis
diskSizeGB

integer (int32)

Ta właściwość wskazuje rozmiar wirtualnego dysku twardego, który ma zostać utworzony.

hostCaching

SharedGalleryHostCaching

Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite"