Créer un service cloud

L'opération Create Cloud Service asynchrone crée un service cloud dans Microsoft Azure.

Requête

La demande Create Cloud Service est spécifiée comme suit. Remplacez <subscription-id> par votre ID d’abonnement.

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

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. La valeur de cet en-tête doit être définie sur 2010-10-28 ou supérieure.

Corps de la requête

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

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>  

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

Nom de l’élément	Description
NomService	Obligatoire. Spécifie le nom du service cloud. Ce nom doit être unique dans Azure. Il s'agit du nom du préfixe DNS qui peut être utilisé pour accéder au service. Pour vérifier la disponibilité d’un nom, vous pouvez utiliser Vérifier la disponibilité du nom du service cloud.
Étiquette	Obligatoire. Spécifie l'identificateur encodé en base 64 du service cloud. L'identificateur peut contenir jusqu'à 100 caractères. L'étiquette peut être utilisée pour le suivi.
Description	facultatif. Spécifie la description du service cloud. La description peut faire jusqu’à 1 024 caractères.
Emplacement	Requis si AffinityGroup n'est pas spécifié. Spécifie l'emplacement où le service cloud est créé. Vous devez spécifier Location ou AffinityGroup, mais pas les deux. Pour afficher les emplacements disponibles, vous pouvez utiliser l’option Emplacements de liste.
AffinityGroup	Requis si Location n'est pas spécifié. Spécifie le nom d'un groupe d'affinités existant associé à l'abonnement. Vous devez spécifier Location ou AffinityGroup, mais pas les deux. Pour afficher les groupes d’affinités disponibles, vous pouvez utiliser Lister les groupes d’affinités.
Nom	facultatif. Spécifie le nom d'une propriété étendue du service cloud. La longueur maximale du nom est de 64 caractères, seuls les caractères alphanumériques et les traits de soulignement sont valides dans le nom, et celui-ci doit commencer par une lettre. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez définir un maximum de 50 propriétés étendues. 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. La valeur de la propriété étendue ne doit pas dépasser 255 caractères. L’élément Value est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
ReverseDnsFqdn	Optionnel. Spécifie l'adresse DNS avec laquelle l'adresse IP du service cloud est résolue lorsqu'il est interrogé à l'aide d'une requête DNS inversée. L’élément ReverseDnsFqdn est disponible uniquement à l’aide de la version 2014-06-01 ou ultérieure.

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 renvoie le code d'état 201 (Créé).

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.