Shared Gallery Images - Get

Obtenez une image de galerie partagée par ID d’abonnement ou ID de locataire.

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

Paramètres URI

Name In Required Type Description
galleryImageName
path True
  • string

Nom de la définition d’image de la galerie partagée à partir de laquelle les versions d’image doivent être répertoriées.

galleryUniqueName
path True
  • string

Nom unique de la galerie partagée.

location
path True
  • string

Emplacement de la ressource.

subscriptionId
path True
  • string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True
  • string

Version de l’API cliente.

Réponses

Name Type Description
200 OK

OK

Other Status Codes

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation emprunt d’identité de votre compte d’utilisateur

Exemples

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

Définitions

ApiError

Erreur d’API.

ApiErrorBase

Base d’erreurs d’API.

Architecture

Architecture de l’image. Applicable uniquement aux disques du système d’exploitation.

CloudError

Réponse d’erreur du service de calcul.

Disallowed

Décrit les types de disques non autorisés.

GalleryImageFeature

Fonctionnalité pour l’image de la galerie.

GalleryImageIdentifier

Il s’agit de l’identificateur de définition d’image de la galerie.

HyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

ImagePurchasePlan

Décrit le plan d’achat de définition d’image de la galerie. Ceci est utilisé par les images de la Place de marché.

InnerError

Détails de l’erreur interne.

OperatingSystemStateTypes

Cette propriété permet à l’utilisateur de spécifier si les machines virtuelles créées sous cette image sont « généralisées » ou « Spécialisées ».

OperatingSystemTypes

Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque lors de la création d’une machine virtuelle à partir d’une image managée.

Les valeurs possibles sont les suivantes :

Windows

Linux

RecommendedMachineConfiguration

Les propriétés décrivent la configuration de l’ordinateur recommandée pour cette définition d’image. Ces propriétés sont modifiables.

ResourceRange

Décrit la plage de ressources.

SharedGalleryImage

Spécifie des informations sur la définition d’image de la galerie que vous souhaitez créer ou mettre à jour.

ApiError

Erreur d’API.

Name Type Description
code
  • string

Code d'erreur.

details

Détails de l’erreur api

innererror

Erreur interne de l’API

message
  • string

Message d’erreur.

target
  • string

Cible de l’erreur particulière.

ApiErrorBase

Base d’erreurs d’API.

Name Type Description
code
  • string

Code d'erreur.

message
  • string

Message d’erreur.

target
  • string

Cible de l’erreur particulière.

Architecture

Architecture de l’image. Applicable uniquement aux disques du système d’exploitation.

Name Type Description
Arm64
  • string
x64
  • string

CloudError

Réponse d’erreur du service de calcul.

Name Type Description
error

Erreur d’API.

Disallowed

Décrit les types de disques non autorisés.

Name Type Description
diskTypes
  • string[]

Liste des types de disque.

GalleryImageFeature

Fonctionnalité pour l’image de la galerie.

Name Type Description
name
  • string

Nom de la fonctionnalité d’image de la galerie.

value
  • string

Valeur de la fonctionnalité d’image de la galerie.

GalleryImageIdentifier

Il s’agit de l’identificateur de définition d’image de la galerie.

Name Type Description
offer
  • string

Nom de l’offre de définition d’image de la galerie.

publisher
  • string

Nom de l’éditeur de définition d’image de la galerie.

sku
  • string

Nom de la référence SKU de définition d’image de la galerie.

HyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

Name Type Description
V1
  • string
V2
  • string

ImagePurchasePlan

Décrit le plan d’achat de définition d’image de la galerie. Ceci est utilisé par les images de la Place de marché.

Name Type Description
name
  • string

ID du plan.

product
  • string

ID de produit.

publisher
  • string

ID de l’éditeur.

InnerError

Détails de l’erreur interne.

Name Type Description
errordetail
  • string

Message d’erreur interne ou vidage d’exception.

exceptiontype
  • string

Type d'exception.

OperatingSystemStateTypes

Cette propriété permet à l’utilisateur de spécifier si les machines virtuelles créées sous cette image sont « généralisées » ou « Spécialisées ».

Name Type Description
Generalized
  • string
Specialized
  • string

OperatingSystemTypes

Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque lors de la création d’une machine virtuelle à partir d’une image managée.

Les valeurs possibles sont les suivantes :

Windows

Linux

Name Type Description
Linux
  • string
Windows
  • string

RecommendedMachineConfiguration

Les propriétés décrivent la configuration de l’ordinateur recommandée pour cette définition d’image. Ces propriétés sont modifiables.

Name Type Description
memory

Décrit la plage de ressources.

vCPUs

Décrit la plage de ressources.

ResourceRange

Décrit la plage de ressources.

Name Type Description
max
  • integer

Nombre maximal de la ressource.

min
  • integer

Nombre minimal de la ressource.

SharedGalleryImage

Spécifie des informations sur la définition d’image de la galerie que vous souhaitez créer ou mettre à jour.

Name Type Description
identifier.uniqueId
  • string

ID unique de cette galerie partagée.

location
  • string

Emplacement de la ressource

name
  • string

Nom de la ressource

properties.architecture

Architecture de l’image. Applicable uniquement aux disques du système d’exploitation.

properties.disallowed

Décrit les types de disques non autorisés.

properties.endOfLifeDate
  • string

Date de fin de vie de la définition de l’image de la galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est modifiable.

properties.features

Liste des fonctionnalités d’image de la galerie.

properties.hyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

properties.identifier

Il s’agit de l’identificateur de définition d’image de la galerie.

properties.osState

Cette propriété permet à l’utilisateur de spécifier si les machines virtuelles créées sous cette image sont « généralisées » ou « Spécialisées ».

properties.osType

Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque lors de la création d’une machine virtuelle à partir d’une image managée.

Les valeurs possibles sont les suivantes :

Windows

Linux

properties.purchasePlan

Décrit le plan d’achat de définition d’image de la galerie. Ceci est utilisé par les images de la Place de marché.

properties.recommended

Les propriétés décrivent la configuration de l’ordinateur recommandée pour cette définition d’image. Ces propriétés sont modifiables.