Shared Gallery Images - Get

Service:: Compute

API-versie:: 2024-03-03

Haal een gedeelde galerijafbeelding op via abonnements-id of tenant-id.

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

URI-parameters

Name	In	Vereist	Type	Description
galleryImageName	path	True	string	De naam van de afbeeldingsdefinitie in de gedeelde galerij waaruit de afbeeldingsversies moeten worden weergegeven.
galleryUniqueName	path	True	string	De unieke naam van de gedeelde galerij.
location	path	True	string minLength: 1	De naam van de Azure-regio.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	SharedGalleryImage	Azure-bewerking is voltooid.
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get a shared gallery image.

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "eula": "https://www.microsoft.com/en-us/",
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Definities

Name	Description
ApiError	Api-fout.
ApiErrorBase	Api-foutbasis.
Architecture	De architectuur van de afbeelding. Alleen van toepassing op besturingssysteemschijven.
CloudError	Een foutreactie van de Compute-service.
Disallowed	Beschrijft de niet-toegestane schijftypen.
GalleryImageFeature	Een functie voor galerijafbeelding.
GalleryImageIdentifier	Dit is de definitie-id van de galerieafbeelding.
HyperVGeneration	De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven.
ImagePurchasePlan	Hierin wordt het aankoopplan voor de installatiekopieën van de galerie-installatiekopieën beschreven. Dit wordt gebruikt door Marketplace-installatiekopieën.
InnerError	Interne foutdetails.
OperatingSystemStateTypes	Met deze eigenschap kan de gebruiker opgeven of de virtuele machines die zijn gemaakt onder deze installatiekopieën 'Gegeneraliseerd' of 'Gespecialiseerd' zijn.
OperatingSystemTypes	Met deze eigenschap kunt u het type besturingssysteem opgeven dat op de schijf is opgenomen bij het maken van een virtuele machine op basis van een beheerde installatiekopie. Mogelijke waarden zijn: Windows,Linux.
RecommendedMachineConfiguration	De eigenschappen beschrijven de aanbevolen computerconfiguratie voor deze definitie van de installatiekopieën. Deze eigenschappen kunnen worden bijgewerkt.
ResourceRange	Beschrijft het resourcebereik.
SharedGalleryImage	Geeft informatie op over de definitie van de galerijafbeelding die u wilt maken of bijwerken.

ApiError

Object

Api-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	Details van de Api-fout
innererror	InnerError	De innerlijke fout van de Api
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

Object

Api-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

Architecture

Opsomming

De architectuur van de afbeelding. Alleen van toepassing op besturingssysteemschijven.

Waarde	Description
x64
Arm64

CloudError

Object

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	Api-fout.

Disallowed

Object

Beschrijft de niet-toegestane schijftypen.

Name	Type	Description
diskTypes	string[]	Een lijst met schijftypen.

GalleryImageFeature

Object

Een functie voor galerijafbeelding.

Name	Type	Description
name	string	De naam van de afbeeldingsfunctie van de galerie.
startsAtVersion	string	De minimale versie van de galerie-installatiekopieën die deze functie ondersteunt.
value	string	De waarde van de afbeeldingsfunctie van de galerie.

GalleryImageIdentifier

Object

Dit is de definitie-id van de galerieafbeelding.

Name	Type	Description
offer	string	De naam van de afbeeldingsdefinitieaanbieding van de galerie.
publisher	string	De naam van de uitgever van de definitie van de galerieinstallatiekopieën.
sku	string	De naam van de definitie-SKU van de galerie-installatiekopieën.

HyperVGeneration

Opsomming

De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven.

Waarde	Description
V1
V2

ImagePurchasePlan

Object

Hierin wordt het aankoopplan voor de installatiekopieën van de galerie-installatiekopieën beschreven. Dit wordt gebruikt door Marketplace-installatiekopieën.

Name	Type	Description
name	string	De plan-id.
product	string	De product-id.
publisher	string	De uitgever-id.

InnerError

Object

Interne foutdetails.

Name	Type	Description
errordetail	string	De interne foutmelding of uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.

OperatingSystemStateTypes

Opsomming

Met deze eigenschap kan de gebruiker opgeven of de virtuele machines die zijn gemaakt onder deze installatiekopieën 'Gegeneraliseerd' of 'Gespecialiseerd' zijn.

Waarde	Description
Generalized	Gegeneraliseerd beeld. Moet worden ingericht tijdens de implementatietijd.
Specialized	Gespecialiseerd beeld. Bevat een reeds ingerichte besturingssysteemschijf.

OperatingSystemTypes

Opsomming

Met deze eigenschap kunt u het type besturingssysteem opgeven dat op de schijf is opgenomen bij het maken van een virtuele machine op basis van een beheerde installatiekopie. Mogelijke waarden zijn: Windows,Linux.

Waarde	Description
Windows
Linux

RecommendedMachineConfiguration

Object

De eigenschappen beschrijven de aanbevolen computerconfiguratie voor deze definitie van de installatiekopieën. Deze eigenschappen kunnen worden bijgewerkt.

Name	Type	Description
memory	ResourceRange	Beschrijft het resourcebereik.
vCPUs	ResourceRange	Beschrijft het resourcebereik.

ResourceRange

Object

Beschrijft het resourcebereik.

Name	Type	Description
max	integer (int32)	Het maximum aantal resources.
min	integer (int32)	Het minimumaantal van de resource.