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 |
|---|---|---|---|---|
|
gallery
|
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. |
|
gallery
|
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> |
|
gallery
|
path | True |
string |
Nom unique de la galerie partagée. |
|
location
|
path | True |
string minLength: 1 |
Nom de la région Azure. |
|
subscription
|
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 |
L’opération Azure s’est terminée avec succès. |
|
| Other Status Codes |
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
Get a shared gallery image version.
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 |
|---|---|
|
Api |
Erreur d’API. |
|
Api |
Base d’erreur de l’API. |
|
Cloud |
Réponse d’erreur du service de calcul. |
|
Inner |
Détails de l’erreur interne. |
|
Shared |
Il s’agit de l’image du disque de données. |
|
Shared |
Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » |
|
Shared |
Spécifie des informations sur la version d’image de la galerie que vous souhaitez créer ou mettre à jour. |
|
Shared |
Il s’agit du profil de stockage d’une version d’image de galerie. |
|
Shared |
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 |
Les détails de l’erreur Api |
|
| 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 |
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 |
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 |
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 |
Liste des images de disque de données. |
|
| osDiskImage |
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 |
Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » |