Delen via


Shared Gallery Images - Get

Haal een installatiekopieën van een gedeelde galerie op op abonnements-id of tenant-id.

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

URI-parameters

Name In Vereist Type Description
galleryImageName
path True

string

De naam van de definitie van de shared gallery-installatiekopieën waaruit de versies van de installatiekopieën moeten worden vermeld.

galleryUniqueName
path True

string

De unieke naam van de gedeelde galerie.

location
path True

string

Resourcelocatie.

subscriptionId
path True

string

Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

SharedGalleryImage

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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 installatiekopieën. Alleen van toepassing op besturingssysteemschijven.

CloudError

Een foutreactie van de Compute-service.

Disallowed

Beschrijft de niet-toegestane schijftypen.

GalleryImageFeature

Een functie voor galerieafbeeldingen.

GalleryImageIdentifier

Dit is de definitie-id van de galerieafbeelding.

HyperVGeneration

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

ImagePurchasePlan

Beschrijft het aankoopplan voor de definitie van de galerieafbeelding. Dit wordt gebruikt door Marketplace-installatiekopieën.

InnerError

Details van interne fout.

OperatingSystemStateTypes

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

OperatingSystemTypes

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

RecommendedMachineConfiguration

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

ResourceRange

Beschrijft het resourcebereik.

SharedGalleryImage

Hiermee geeft u informatie op over de definitie van de galerieafbeelding die u wilt maken of bijwerken.

ApiError

API-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

De API-foutdetails

innererror

InnerError

De interne api-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

API-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

Architecture

De architectuur van de installatiekopieën. Alleen van toepassing op besturingssysteemschijven.

Name Type Description
Arm64

string

x64

string

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

API-fout.

Disallowed

Beschrijft de niet-toegestane schijftypen.

Name Type Description
diskTypes

string[]

Een lijst met schijftypen.

GalleryImageFeature

Een functie voor galerieafbeeldingen.

Name Type Description
name

string

De naam van de galerieafbeeldingsfunctie.

value

string

De waarde van de galerieafbeeldingsfunctie.

GalleryImageIdentifier

Dit is de definitie-id van de galerieafbeelding.

Name Type Description
offer

string

De naam van de definitie-aanbieding voor de galerieinstallatiekopieën.

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

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

Name Type Description
V1

string

V2

string

ImagePurchasePlan

Beschrijft het aankoopplan voor de definitie van de galerieafbeelding. 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

Details van interne fout.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

OperatingSystemStateTypes

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

Name Type Description
Generalized

string

Specialized

string

OperatingSystemTypes

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

Name Type Description
Linux

string

Windows

string

RecommendedMachineConfiguration

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

Name Type Description
memory

ResourceRange

Beschrijft het resourcebereik.

vCPUs

ResourceRange

Beschrijft het resourcebereik.

ResourceRange

Beschrijft het resourcebereik.

Name Type Description
max

integer

Het maximumaantal van de resource.

min

integer

Het minimumaantal van de resource.

SharedGalleryImage

Hiermee geeft u informatie op over de definitie van de galerieafbeelding die u wilt maken of bijwerken.

Name Type Description
identifier.uniqueId

string

De unieke id van deze gedeelde galerie.

location

string

Resourcelocatie

name

string

Resourcenaam

properties.architecture

Architecture

De architectuur van de installatiekopieën. Alleen van toepassing op besturingssysteemschijven.

properties.artifactTags

object

De artefacttags van een gedeelde galerieresource.

properties.disallowed

Disallowed

Beschrijft de niet-toegestane schijftypen.

properties.endOfLifeDate

string

De einddatum van de definitie van de galerieafbeelding. Deze eigenschap kan worden gebruikt voor buitengebruikstelling. Deze eigenschap kan worden bijgewerkt.

properties.eula

string

Gebruiksrechtovereenkomst voor de huidige communitygalerie-installatiekopieën.

properties.features

GalleryImageFeature[]

Een lijst met functies voor galerieafbeeldingen.

properties.hyperVGeneration

HyperVGeneration

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

properties.identifier

GalleryImageIdentifier

Dit is de definitie-id van de galerieafbeelding.

properties.osState

OperatingSystemStateTypes

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

properties.osType

OperatingSystemTypes

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

properties.privacyStatementUri

string

Privacyverklaring-URI voor de huidige afbeelding van de communitygalerie.

properties.purchasePlan

ImagePurchasePlan

Beschrijft het aankoopplan voor de definitie van de galerieafbeelding. Dit wordt gebruikt door Marketplace-installatiekopieën.

properties.recommended

RecommendedMachineConfiguration

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