Exporter (0) Imprimer
Développer tout

Liste des images de système d'exploitation

Mis à jour: avril 2014

L'opération List OS Images récupère une liste d'images de système d'exploitation depuis le référentiel d'images.

La demande List OS Images est spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement.

 

Méthode URI de demande Version HTTP

GET

https://management.core.windows.net/<subscription-id>/services/images

HTTP/1.1

Le tableau suivant décrit les en-têtes de la demande.

 

En-tête de demande Description

x-ms-version

Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Actuellement cet en-tête doit être défini à 2013-03-01.

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Une opération ayant réussi retourne le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur de la gestion des services.

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

En-tête de réponse Description

x-ms-request-id

Valeur qui identifie de façon unique une demande effectuée au service de gestion. Pour une opération asynchrone, vous pouvez interroger l'état de l'opération Get avec la valeur de l'en-tête pour déterminer si l'opération est terminée, a échoué, ou est encore en cours. Pour plus d'informations, consultez Suivre les demandes de gestion des services asynchrones.

Le corps de la réponse présente le format suivant :

  
<Images xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <OSImage>
    <AffinityGroup>name-of-the-affinity-group</AffinityGroup>
    <Category>category-of-the-image</Category>
    <Label>image-description</Label>
    <Location>geo-location-of-the-stored-image</Location>
    <LogicalSizeInGB>size-of-the-image</LogicalSizeInGB>
    <MediaLink>url-of-the-containing-blob</MediaLink>
    <Name>image-name</Name>
    <OS>operating-system-of-the-image</OS>
    <Eula>image-eula</Eula>
    <Description>image-description</Description>
    <ImageFamily>image-family</ImageFamily>
    <ShowInGui>true|false</ShowInGui>
    <PublishedDate>published-date</PublishedDate>
    <IsPremium>true|false</IsPremium>
    <PrivacyUri>uri-of-privacy-policy</PrivacyUri>
    <RecommendedVMSize>size-of-the-virtual-machine</RecommendedVMSize>
    <PublisherName>publisher-identifier</PublisherName>
    <PricingDetailLink>pricing-details</PricingDetailLink>
    <SmallIconUri>uri-of-icon</SmallIconUri>
    <Language>language-of-image</Language>
  </OSImage>
  …
</Images>

Le tableau suivant décrit les éléments clés du corps de la réponse :

 

Nom de l'élément Description

AffinityGroup

Groupe d'affinités dans lequel le support se trouve. La valeur AffinityGroup est dérivée du compte de stockage qui contient l'objet blob dans lequel le support se trouve. Si le compte de stockage n'appartient pas à un groupe d'affinités, la valeur est NULL et l'élément n'est pas affiché dans la réponse.

Cette valeur est NULL pour les images de plateforme.

Catégorie

Classification du référentiel de l'image. Toutes les images d'utilisateur ont la catégorie User. Si la version est définie à 2013-10-01 ou une version ultérieure, les valeurs suivantes sont également possibles :

  • Public – Une image de plateforme disponible à tous.

  • Private – Une image de plateforme disponible en privé.

  • MSDN – Une image de plateforme disponible via MSDN.

Étiquette

Identificateur pour l'image.

Emplacement

Emplacement géographique dans lequel ce support se trouve. La valeur Location est dérivée du compte de stockage qui contient l'objet blob dans lequel le support se trouve. Si le compte de stockage appartient à un groupe d'affinités, la valeur est NULL.

Si la version est définie sur 2012-08-01 ou sur une version ultérieure, les emplacements sont retournés pour les images de plateforme ; sinon, cette valeur est NULL pour les images de plateforme.

LogicalSizeInGB

Taille, en Go, de l'image.

MediaLink

Emplacement de l'objet blob dans le stockage Windows Azure. L'emplacement de l'objet blob appartient à un compte de stockage dans l'abonnement spécifié par la valeur <subscription-id> dans l'appel d'opération.

Exemple :

http://example.blob.core.windows.net/disks/myimage.vhd

Nom

Nom de l'image de système d'exploitation. Il s'agit du nom utilisé lors de la création d'une ou plusieurs machines virtuelles à l'aide de l'image.

Système d'exploitation

Type de l'image de système d'exploitation.

Les valeurs possibles sont les suivantes :

  • Linux

  • Windows

Cluf

Spécifie le Contrat de Licence Utilisateur Final associé à l'image. La valeur de cet élément est une chaîne, mais il est recommandé d'utiliser une URL qui indique le CLUF.

Description

Spécifie la description de l'image.

ImageFamily

Spécifie une valeur qui peut être utilisée pour grouper des images.

PublishedDate

Spécifie la date à laquelle l'image a été ajoutée au référentiel d'images.

IsPremium

Indique si l'image contient des logiciels ou des services associés qui occasionnent des frais dépassant le prix de base de la machine virtuelle. Pour plus de détails, consultez l'élément PricingDetailLink.

PrivacyUri

Spécifie l'URI qui pointe sur un document contenant la politique de confidentialité associée à l'image.

RecommendedVMSize

Spécifie la taille de la machine virtuelle créée à partir de l'image.

PublisherName

Nom du serveur de publication de l'image. Toutes les images d'utilisateur possèdent un nom de serveur de publication User.

PricingDetailLink

Spécifie l'URL d'une image avec IsPremium défini sur true, qui contient les détails de la tarification d'une machine virtuelle créée à partir de l'image.

L'élément PricingDetailLink est uniquement disponible si vous utilisez la version 2012-12-01 ou une version ultérieure.

SmallIconUri

Spécifie l'URI sur la petite icône qui s'affiche lorsque l'image est présentée dans le Portail de gestion Windows Azure.

L'élément SmallIconUri est uniquement disponible si vous utilisez la version 2013-03-01 ou une version ultérieure.

Langue

Spécifie la langue de l'image.

L'élément Language est uniquement disponible si vous utilisez la version 2013-03-01 ou une version ultérieure.

Seul le propriétaire du compte peut appeler cette opération.

Afficher:
© 2014 Microsoft