Shared Gallery Images - Get

Pobierz obraz galerii udostępnionej według identyfikatora subskrypcji lub identyfikatora dzierżawy.

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

Parametry identyfikatora URI

Name In Required Type Description
galleryImageName
path True
  • string

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

galleryUniqueName
path True
  • string

Unikatowa nazwa galerii udostępnionej.

location
path True
  • string

Lokalizacja zasobu.

subscriptionId
path True
  • string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True
  • string

Wersja interfejsu API klienta.

Odpowiedzi

Name Type Description
200 OK

OK

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

Sample Request

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

Sample Response

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Definicje

ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

Architecture

Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.

CloudError

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

Disallowed

Opisuje niedozwolone typy dysków.

GalleryImageFeature

Funkcja obrazu galerii.

GalleryImageIdentifier

Jest to identyfikator definicji obrazu galerii.

HyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

ImagePurchasePlan

Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.

InnerError

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

OperatingSystemStateTypes

Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".

OperatingSystemTypes

Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego.

Możliwe wartości:

Windows

Linux

RecommendedMachineConfiguration

Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości można aktualizować.

ResourceRange

Opisuje zakres zasobów.

SharedGalleryImage

Określa informacje o definicji obrazu galerii, które chcesz utworzyć lub zaktualizować.

ApiError

Błąd interfejsu API.

Name Type Description
code
  • string

Kod błędu.

details

Szczegóły błędu interfejsu API

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 interfejsu API.

Name Type Description
code
  • string

Kod błędu.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy określonego błędu.

Architecture

Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.

Name Type Description
Arm64
  • string
x64
  • string

CloudError

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

Name Type Description
error

Błąd interfejsu API.

Disallowed

Opisuje niedozwolone typy dysków.

Name Type Description
diskTypes
  • string[]

Lista typów dysków.

GalleryImageFeature

Funkcja obrazu galerii.

Name Type Description
name
  • string

Nazwa funkcji obrazu galerii.

value
  • string

Wartość funkcji obrazu galerii.

GalleryImageIdentifier

Jest to identyfikator definicji obrazu galerii.

Name Type Description
offer
  • string

Nazwa oferty definicji obrazu galerii.

publisher
  • string

Nazwa wydawcy definicji obrazu galerii.

sku
  • string

Nazwa jednostki SKU definicji obrazu galerii.

HyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

Name Type Description
V1
  • string
V2
  • string

ImagePurchasePlan

Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.

Name Type Description
name
  • string

Identyfikator planu.

product
  • string

Identyfikator produktu.

publisher
  • string

Identyfikator wydawcy.

InnerError

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

Name Type Description
errordetail
  • string

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

exceptiontype
  • string

Typ wyjątku.

OperatingSystemStateTypes

Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".

Name Type Description
Generalized
  • string
Specialized
  • string

OperatingSystemTypes

Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego.

Możliwe wartości:

Windows

Linux

Name Type Description
Linux
  • string
Windows
  • string

RecommendedMachineConfiguration

Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości można aktualizować.

Name Type Description
memory

Opisuje zakres zasobów.

vCPUs

Opisuje zakres zasobów.

ResourceRange

Opisuje zakres zasobów.

Name Type Description
max
  • integer

Maksymalna liczba zasobów.

min
  • integer

Minimalna liczba zasobów.

SharedGalleryImage

Określa informacje o definicji obrazu galerii, które chcesz utworzyć lub zaktualizować.

Name Type Description
identifier.uniqueId
  • string

Unikatowy identyfikator tej galerii udostępnionej.

location
  • string

Lokalizacja zasobu

name
  • string

Nazwa zasobu

properties.architecture

Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.

properties.disallowed

Opisuje niedozwolone typy dysków.

properties.endOfLifeDate
  • string

Data zakończenia życia definicji obrazu galerii. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.

properties.features

Lista funkcji obrazów galerii.

properties.hyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.

properties.identifier

Jest to identyfikator definicji obrazu galerii.

properties.osState

Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".

properties.osType

Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego.

Możliwe wartości:

Windows

Linux

properties.purchasePlan

Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.

properties.recommended

Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości można aktualizować.