Ajouter une extension

L'opération Add Extension asynchrone ajoute une extension disponible à votre service cloud. Dans Microsoft Azure, un processus peut fonctionner comme une extension d'un service cloud.

Requête

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

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

Paramètres URI

Aucun.

En-têtes de requête

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

En-tête de requête	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.

Corps de la requête

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

  
<?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>  
  <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 de 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	Optionnel. 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	Optionnel. Spécifie l'algorithme d'empreinte numérique du certificat utilisé pour chiffrer la configuration spécifiée dans PrivateConfiguration.
PublicConfiguration	Optionnel. Spécifie la configuration publique définie à l’aide du schéma retourné par l’opération Répertorier les extensions disponibles .
PrivateConfiguration	Optionnel. Spécifie la configuration privée qui est définie à l’aide du schéma retourné par l’opération Répertorier les extensions disponibles .
Version	Optionnel. Spécifie la version de l'extension. Si cet élément n'est pas spécifié ou si un astérisque (*) est utilisé comme valeur, la version la plus récente 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 secondaire 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 spécifiée est sélectionnée. Si une version est spécifiée, une mise à niveau automatique est effectuée sur l'instance de rôle.

response

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).

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.

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.