Partager via


Shared Gallery Image Versions - Get

Obtenez une version d’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}/versions/{galleryImageVersionName}?api-version=2024-03-03

Paramètres URI

Nom Dans Obligatoire 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.

galleryImageVersionName
path True

string

Le nom de la version de l’image de la galerie à créer. Doit suivre le modèle de nom de version sémantique : les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits. Format : <MajorVersion>.<MinorVersion>.<Rapiécer>

galleryUniqueName
path True

string

Nom unique de la galerie partagée.

location
path True

string

minLength: 1

Nom de la région Azure.

subscriptionId
path True

string

minLength: 1

ID de l’abonnement cible.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Réponses

Nom Type Description
200 OK

SharedGalleryImageVersion

L’opération Azure s’est terminée avec succès.

Other Status Codes

CloudError

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Exemple de requête

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

Exemple de réponse

{
  "properties": {
    "publishedDate": "2018-03-20T09:12:28Z",
    "endOfLifeDate": "2022-03-20T09:12:28Z",
    "excludeFromLatest": false,
    "storageProfile": {
      "osDiskImage": {
        "diskSizeGB": 29,
        "hostCaching": "None"
      }
    },
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageVersionName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName/Versions/myGalleryImageVersionName"
  }
}

Définitions

Nom Description
ApiError

Erreur d’API.

ApiErrorBase

Base d’erreur de l’API.

CloudError

Réponse d’erreur du service de calcul.

InnerError

Détails de l’erreur interne.

SharedGalleryDataDiskImage

Il s’agit de l’image du disque de données.

SharedGalleryHostCaching

Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite »

SharedGalleryImageVersion

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

SharedGalleryImageVersionStorageProfile

Il s’agit du profil de stockage d’une version d’image de galerie.

SharedGalleryOSDiskImage

Il s’agit de l’image de disque du système d’exploitation.

ApiError

Erreur d’API.

Nom Type Description
code

string

Code d’erreur.

details

ApiErrorBase[]

Les détails de l’erreur Api

innererror

InnerError

L’erreur interne de l’API

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

ApiErrorBase

Base d’erreur de l’API.

Nom Type Description
code

string

Code d’erreur.

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

CloudError

Réponse d’erreur du service de calcul.

Nom Type Description
error

ApiError

Erreur d’API.

InnerError

Détails de l’erreur interne.

Nom Type Description
errordetail

string

Message d’erreur interne ou vidage d’exception.

exceptiontype

string

Type d’exception.

SharedGalleryDataDiskImage

Il s’agit de l’image du disque de données.

Nom Type Description
diskSizeGB

integer (int32)

Cette propriété indique la taille du disque dur virtuel à créer.

hostCaching

SharedGalleryHostCaching

Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite »

lun

integer (int32)

Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle.

SharedGalleryHostCaching

Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite »

Valeur Description
None
ReadOnly
ReadWrite

SharedGalleryImageVersion

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

Nom Type Description
identifier.uniqueId

string

L’identifiant unique de cette galerie partagée.

location

string

Emplacement des ressources

name

string

Nom de la ressource

properties.artifactTags

object

Balises d’artefact d’une ressource de galerie partagée.

properties.endOfLifeDate

string (date-time)

La date de fin de vie de la version de l’image de la galerie Définition. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour.

properties.excludeFromLatest

boolean

Si la valeur est true, les machines virtuelles déployées à partir de la dernière version de la définition d’image n’utilisent pas cette version d’image.

properties.publishedDate

string (date-time)

La date de publication de la version de l’image de la galerie Définition. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour.

properties.storageProfile

SharedGalleryImageVersionStorageProfile

Décrit le profil de stockage de la version de l’image.

SharedGalleryImageVersionStorageProfile

Il s’agit du profil de stockage d’une version d’image de galerie.

Nom Type Description
dataDiskImages

SharedGalleryDataDiskImage[]

Liste des images de disque de données.

osDiskImage

SharedGalleryOSDiskImage

Il s’agit de l’image de disque du système d’exploitation.

SharedGalleryOSDiskImage

Il s’agit de l’image de disque du système d’exploitation.

Nom Type Description
diskSizeGB

integer (int32)

Cette propriété indique la taille du disque dur virtuel à créer.

hostCaching

SharedGalleryHostCaching

Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite »