Création de déploiement

L'opération Create Deployment asynchrone télécharge un nouveau package de service et crée un déploiement dans l'environnement intermédiaire ou de production.

Avant de pouvoir exécuter cette opération, vous devez effectuer les tâches suivantes :

• Créer un abonnement et obtenir l'identificateur d'abonnement. Vous pouvez récupérer l'identificateur d'abonnement dans la page Paramètres du Portail de gestion.

• Créez et téléchargez un certificat de gestion pour autoriser l'opération.

• Créez un service cloud.

• Décider si l'application doit être déployée dans l'environnement intermédiaire ou de production.

Requête

La demande Create Deployment est spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement, <cloudservice-name> par le nom du service cloud, et <deployment-slot> par staging ou production.

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

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
Content-Type	Obligatoire. Définissez cet en-tête sur la valeur application/xml.
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 2009-10-01 ou une valeur supérieure.

Corps de la requête

Le corps de la demande présente le format suivant :

  
<?xml version="1.0" encoding="utf-8"?>  
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>deployment-name</Name>  
  <PackageUrl>package-url-in-blob-storage</PackageUrl>  
  <Label>base64-encoded-deployment-label</Label>  
  <Configuration>base64-encoded-configuration-file</Configuration>  
  <StartDeployment>start-deployment</StartDeployment>  
  <TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</CreateDeployment>  
  

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

Nom de l'élément	Description
Nom	Obligatoire. Spécifie le nom du déploiement.
PackageUrl	Obligatoire. Spécifie une URL qui fait référence à l'emplacement du package de service dans le service BLOB. Le package de service peut se trouver dans un compte de stockage sous le même abonnement ou dans un URI de signature d'accès partagé (SAS) d'un compte de stockage.
Configuration	Obligatoire. Spécifie le fichier de configuration du service codé en base 64 pour le déploiement.
Étiquette	Obligatoire. Spécifie un identificateur encodé en base 64 du déploiement. L'identificateur peut avoir une longueur de 100 caractères au maximum. Il est recommandé que l'étiquette soit unique au sein de l'abonnement. L'étiquette peut être utilisée pour le suivi.
StartDeployment	Optionnel. Indique si démarrer le déploiement dès qu'il est créé. La valeur par défaut est false. Si false, le modèle de service est toujours déployé, mais le code n'est pas exécuté immédiatement. Au lieu de cela, le service est Suspended jusqu’à ce que vous appeliez Update Deployment Status et définissez le status sur Running, à quel moment le service sera démarré. Un service déployé occasionne toujours des frais, même s'il est suspendu. L’élément StartDeployment est disponible uniquement à l’aide de la version 2010-04-01 ou ultérieure.
TreatWarningsAsError	Optionnel. Indique si traiter les avertissements de validation de package comme des erreurs. La valeur par défaut est false. Si défini sur true, l'opération Created Deployment échoue s'il y a des avertissements de validation sur le package de service. L’élément TreatWarningsAsError est disponible uniquement à l’aide de la version 2011-04-01 ou ultérieure.
Nom	facultatif. Spécifie le nom d'une propriété de déploiement étendue. Chaque propriété étendue doit avoir un nom et une valeur définis. Il peut y avoir un maximum de 25 paires nom/valeur de propriété étendue. La longueur maximale de l'élément Nom est de 64 caractères, seuls les caractères alphanumériques et les traits de soulignement sont valides dans Nom, et le nom doit commencer par une lettre. L’élément Name est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Valeur	Optionnel. Spécifie la valeur d'une propriété étendue du service cloud. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez avoir 25 paires nom/valeur de propriété étendue au maximum, et chaque valeur de propriété étendue doit avoir une taille maximale de 255 caractères. L’élément Value est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
ExtensionConfiguration	Optionnel. Spécifie une extension qui est ajoutée au service cloud. Dans Azure, un processus peut fonctionner comme une extension d'un service cloud. Vous devez ajouter une extension au service cloud à l’aide de l’option Ajouter une extension avant de pouvoir être ajoutée au déploiement. L’élément ExtensionConfiguration est disponible uniquement à l’aide de la version 2013-03-01 ou ultérieure.

ExtensionConfiguration

Spécifie une extension qui est ajoutée au service cloud.

Nom de l'élément	Description
AllRoles	Optionnel. Spécifie une liste d'extensions qui sont appliquées à tous les rôles dans un déploiement.
Extension	Obligatoire. Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.
NamedRoles	Optionnel. Spécifie une liste d'extensions qui sont appliquées aux rôles spécifiques dans un déploiement.

Extension

Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.

Nom de l'élément	Description
Id	Obligatoire. Spécifie l'identificateur de l'extension. L'identificateur est créé lorsque l'extension est ajoutée au service cloud. Vous pouvez trouver l’identificateur d’une extension qui a été ajoutée à un service cloud à l’aide des extensions de liste.
État	Optionnel. Spécifie l'état de l'extension. Cet élément s'applique uniquement aux extensions JSON configurées. Les valeurs possibles sont les suivantes : - Enable - Disable - Uninstall La valeur par défaut est Enable. L’élément State est disponible uniquement à l’aide de la version 2014-06-01 ou ultérieure.

NamedRoles

Spécifie une liste d'extensions qui sont appliquées aux rôles spécifiques dans un déploiement.

Nom de l'élément	Description
Role	Obligatoire. Spécifie un rôle spécifique auquel l'extension est ajoutée.
RoleName	Obligatoire. Indique le nom du rôle.
Extension	Obligatoire. Spécifie une extension qui doit être déployée dans un rôle dans un service cloud.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes 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.