Obtenir une Extension

 

Le Get Extension opération récupère des informations sur une extension spécifiée qui a été ajoutée à un service cloud.

Le Get Extension demande peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement <cloudservice-name> avec le nom du service cloud, et <extensionId> avec l'identificateur qui a été attribué à l'extension lorsqu'il a été ajouté au service cloud. Vous pouvez trouver l'Id d'une extension à l'aide de List Extensions.

MéthodeURI de demande
GEThttps://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions/<extensionId>

Vous devez vous assurer que la demande adressée au service de gestion est sécurisée. Pour plus d'informations, consultez authentification des demandes de Service de gestion.

Paramètres URI

Aucun.

En-têtes de demande

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de demandeDescription
x-ms-versionObligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur 2013-03-01 ou une version ultérieure. Pour plus d'informations sur les en-têtes de contrôle de version, consultez Versioning de gestion de Service.

Corps de la demande

Aucun.

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

Code d'état

Une opération réussie envoie le code d'état 200 (OK). Pour plus d'informations sur les codes d'état, consultez état de gestion de Service et les Codes d'erreur.

En-têtes de réponse

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éponseDescription
x-ms-request-idValeur qui identifie de façon unique une demande effectuée au service de gestion.

Corps de la réponse

L'exemple suivant illustre le format du corps de la réponse :

  
<?xml version="1.0" encoding="utf-8"?> <Extension xmlns=”http://schemas.microsoft.com/windowsazure”> <ProviderNameSpace>namespace-of-extension</ProviderNameSpace> <Type>type-of-extension</Type> <Id>identifier-of-extension</Id> <Version>version-of-extension</Version> <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint> <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm> <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration> <IsJsonExtension>indicator-of-json-support</IsJsonExtension> <DisallowMajorVersionUpgrade>indicator-of-allowed-version-upgrades</DisallowMajorVersionUpgrade> </Extension>  
  

Le tableau suivant décrit les éléments du corps de la réponse.

Nom de l'élémentDescription
ProviderNameSpaceEspace de noms de fournisseur de l'extension. L'espace de noms du fournisseur des extensions Microsoft Azure est Microsoft.Windows.Azure.Extensions.
TypeObligatoire. Type de l'extension.
IdIdentificateur de l'extension.
VersionVersion de l'extension.
Empreinte numériqueL'empreinte numérique du certificat utilisé pour chiffrer la configuration spécifiée dans PrivateConfiguration. Si cet élément n'est pas spécifié, un certificat peut être automatiquement généré et ajouté au service cloud.
ThumbprintAlgorithmL'algorithme d'empreinte numérique du certificat utilisé pour chiffrer la configuration spécifiée dans PrivateConfiguration.
PublicConfigurationLa configuration publique qui est définie en utilisant le schéma retourné par la Liste des Extensions disponibles opération.
IsJsonExtensionIndique si la configuration de l'extension prend en charge JSON.

Les valeurs possibles sont les suivantes :

- true
- false

Le IsJsonExtension élément est uniquement disponible si vous utilisez la version 2014-06-01 ou une version ultérieure.
DisallowMajorVersionUpgradeIndique si l'extension prend automatiquement en charge la mise à niveau vers les nouvelles versions majeures.

Le DisallowMajorVersionUpgrade élément est uniquement disponible si vous utilisez la version 2014-06-01 ou une version ultérieure.
Afficher: