Ajouter l'Extension

 

Le Add Extension opération asynchrone ajoute une extension disponible à votre service cloud. Dans Microsoft Azure, un processus peut fonctionner comme une extension d'un service cloud. Vous pouvez trouver l'extension disponible à l'aide de la Liste des Extensions disponibles opération.

Demande

Le Add Extension demande peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement et <cloudservice-name> avec le nom du service cloud.

Méthode	URI de demande
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

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 la demande.

En-tête de demande	Description
x-ms-version	Obligatoire. 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

L'exemple suivant illustre le format du corps de demande :

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

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

Nom de l'élément	Description
ProviderNameSpace	Obligatoire. Spécifie l'espace de noms de fournisseur de l'extension. L'espace de noms du fournisseur des extensions Azure est Microsoft.Windows.Azure.Extensions.
Type	Obligatoire. Spécifie le type de l'extension.
Id	Obligatoire. Spécifie l'identificateur de l'extension.
Empreinte numérique	Facultatif. Spécifie l'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.
ThumbprintAlgorithm	Facultatif. Spécifie l'algorithme d'empreinte numérique du certificat utilisé pour chiffrer la configuration spécifiée dans PrivateConfiguration.
PublicConfiguration	Facultatif. Spécifie la configuration publique qui est définie en utilisant le schéma retourné par la Liste des Extensions disponibles opération.
PrivateConfiguration	Facultatif. Spécifie la configuration privée qui est définie en utilisant le schéma retourné par la Liste des Extensions disponibles opération.
Version	Facultatif. Spécifie la version de l'extension. Si cet élément n'est pas spécifié, ou un astérisque (*) est utilisé comme valeur, la dernière version de l'extension est utilisée. Si la valeur est spécifiée avec un numéro de version majeure et un astérisque comme numéro de version secondaire (X.*), la dernière version mineure de la version principale spécifiée est sélectionnée. Si un numéro de version majeure et un numéro de version secondaire sont spécifiés (X.Y), la version d'extension est sélectionnée. Si une version est spécifiée, une mise à niveau automatique est effectuée sur l'instance de rôle.

Réponse

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é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 appeler Obtenir l'état de l'opération avec la valeur de l'en-tête pour déterminer si l'opération est terminée, a échoué ou est toujours en cours.

Corps de la réponse

Aucun.