Shared Gallery Images - Get

Ottenere un'immagine della raccolta condivisa in base all'ID sottoscrizione o all'ID tenant.

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

Parametri dell'URI

Name In Required Type Description
galleryImageName
path True
  • string

Nome della definizione dell'immagine della raccolta condivisa da cui devono essere elencate le versioni delle immagini.

galleryUniqueName
path True
  • string

Nome univoco della raccolta condivisa.

location
path True
  • string

Percorso della risorsa.

subscriptionId
path True
  • string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True
  • string

Versione api client.

Risposte

Name Type Description
200 OK

OK

Other Status Codes

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

Architecture

Architettura dell'immagine. Applicabile solo ai dischi del sistema operativo.

CloudError

Risposta di errore dal servizio di calcolo.

Disallowed

Descrive i tipi di disco non consentiti.

GalleryImageFeature

Funzionalità per l'immagine della raccolta.

GalleryImageIdentifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

ImagePurchasePlan

Descrive il piano di acquisto per la definizione dell'immagine della raccolta. Viene usato dalle immagini del marketplace.

InnerError

Dettagli dell'errore interno.

OperatingSystemStateTypes

Questa proprietà consente all'utente di specificare se le macchine virtuali create in questa immagine sono "Generalizzate" o "Specialized".

OperatingSystemTypes

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco durante la creazione di una macchina virtuale da un'immagine gestita.

I valori possibili sono:

Windows

Linux

RecommendedMachineConfiguration

Le proprietà descrivono la configurazione del computer consigliata per questa definizione di immagine. Queste proprietà sono aggiornabili.

ResourceRange

Descrive l'intervallo di risorse.

SharedGalleryImage

Specifica informazioni sulla definizione dell'immagine della raccolta che si desidera creare o aggiornare.

ApiError

Errore dell'API.

Name Type Description
code
  • string

Codice di errore.

details

Dettagli dell'errore dell'API

innererror

Errore interno dell'API

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore specifico.

Architecture

Architettura dell'immagine. Applicabile solo ai dischi del sistema operativo.

Name Type Description
Arm64
  • string
x64
  • string

CloudError

Risposta di errore dal servizio di calcolo.

Name Type Description
error

Errore dell'API.

Disallowed

Descrive i tipi di disco non consentiti.

Name Type Description
diskTypes
  • string[]

Elenco di tipi di disco.

GalleryImageFeature

Funzionalità per l'immagine della raccolta.

Name Type Description
name
  • string

Nome della funzionalità dell'immagine della raccolta.

value
  • string

Valore della funzionalità dell'immagine della raccolta.

GalleryImageIdentifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

Name Type Description
offer
  • string

Nome dell'offerta di definizione dell'immagine della raccolta.

publisher
  • string

Nome dell'autore delle definizioni di immagini della raccolta.

sku
  • string

Nome dello SKU di definizione dell'immagine della raccolta.

HyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

Name Type Description
V1
  • string
V2
  • string

ImagePurchasePlan

Descrive il piano di acquisto per la definizione dell'immagine della raccolta. Viene usato dalle immagini del marketplace.

Name Type Description
name
  • string

ID piano.

product
  • string

ID prodotto.

publisher
  • string

ID editore.

InnerError

Dettagli dell'errore interno.

Name Type Description
errordetail
  • string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype
  • string

Tipo di eccezione.

OperatingSystemStateTypes

Questa proprietà consente all'utente di specificare se le macchine virtuali create in questa immagine sono "Generalizzate" o "Specialized".

Name Type Description
Generalized
  • string
Specialized
  • string

OperatingSystemTypes

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco durante la creazione di una macchina virtuale da un'immagine gestita.

I valori possibili sono:

Windows

Linux

Name Type Description
Linux
  • string
Windows
  • string

RecommendedMachineConfiguration

Le proprietà descrivono la configurazione del computer consigliata per questa definizione di immagine. Queste proprietà sono aggiornabili.

Name Type Description
memory

Descrive l'intervallo di risorse.

vCPUs

Descrive l'intervallo di risorse.

ResourceRange

Descrive l'intervallo di risorse.

Name Type Description
max
  • integer

Numero massimo della risorsa.

min
  • integer

Numero minimo della risorsa.

SharedGalleryImage

Specifica informazioni sulla definizione dell'immagine della raccolta che si desidera creare o aggiornare.

Name Type Description
identifier.uniqueId
  • string

ID univoco di questa raccolta condivisa.

location
  • string

Posizione risorsa

name
  • string

Nome risorsa

properties.architecture

Architettura dell'immagine. Applicabile solo ai dischi del sistema operativo.

properties.disallowed

Descrive i tipi di disco non consentiti.

properties.endOfLifeDate
  • string

Data di fine vita della definizione dell'immagine della raccolta. Questa proprietà può essere utilizzata per scopi di rimozione delle autorizzazioni. Questa proprietà è aggiornabile.

properties.features

Elenco delle funzionalità delle immagini della raccolta.

properties.hyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

properties.identifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

properties.osState

Questa proprietà consente all'utente di specificare se le macchine virtuali create in questa immagine sono "Generalizzate" o "Specialized".

properties.osType

Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco durante la creazione di una macchina virtuale da un'immagine gestita.

I valori possibili sono:

Windows

Linux

properties.purchasePlan

Descrive il piano di acquisto per la definizione dell'immagine della raccolta. Viene usato dalle immagini del marketplace.

properties.recommended

Le proprietà descrivono la configurazione del computer consigliata per questa definizione di immagine. Queste proprietà sono aggiornabili.