Exporter (0) Imprimer
Développer tout

Mettre à jour un service cloud

Mis à jour: août 2014

L'opération Update Cloud Service met à jour l'étiquette ou la description d'un service cloud.

La requête Update Cloud Service 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

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>

Vous devez vous assurer que la demande adressée au service de gestion est sécurisée. Pour plus de détails, consultez Authentification des demandes de gestion des services.

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

 

En-tête de demande Description

Content-Type

Obligatoire. Définissez cet en-tête avec application/xml.

x-ms-version

Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête devrait être défini sur 28/10/2010 ou une version ultérieure. Pour plus d'informations sur les en-têtes du suivi de version, consultez Contrôle de version du service de gestion.

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

<?xml version="1.0" encoding="utf-8"?>
<UpdateHostedService xmlns="http://schemas.microsoft.com/windowsazure">
  <Label>base64-encoded-label-of-cloud-service</Label>
  <Description>description-of-cloud-service</Description>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>name-of-property</Name>
      <Value>value-of-property</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <GuestAgentType>type-of-guest-agent</GuestAgentType
</UpdateHostedService>

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

 

Nom de l'élément Description

Label

Facultative si la description est spécifiée. Spécifie l'identificateur encodé en base 64 du service cloud. L'identificateur peut contenir jusqu'à 100 caractères. Il est recommandé que l'étiquette soit unique au sein de l'abonnement. L'étiquette peut être utilisée pour le suivi.

Description

Facultative si l'étiquette est spécifiée. Spécifie la description du service cloud. La description peut comporter jusqu'à 1024 caractères.

Nom

Facultatif. Spécifie le nom d'une propriété étendue du service cloud. Vous devez fournir un nom et une valeur pour chaque propriété. 50 propriétés étendues au maximum sont autorisées. Le nom peut comporter jusqu'à 64 caractères. Seuls les caractères alphanumériques et les tirets sont autorisés dans le nom, et le nom doit commencer par une lettre.

L'élément Name est uniquement disponible si vous utilisez la version 01/03/2012 ou une version ultérieure.

Valeur

Facultatif. 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. La valeur peut contenir jusqu'à 255 caractères. Vous pouvez supprimer une propriété existante en définissant la valeur NULL.

L'élément Value est uniquement disponible si vous utilisez la version 01/03/2012 ou une version ultérieure.

GuestAgentType

Facultatif. Spécifie le type de l'agent invité installé sur les déploiements des rôles Web et des rôles de travail.

Les valeurs possibles sont les suivantes :

  • ProdGA

  • TestGA

GuestAgentType est un élément à utilisation restreinte, utilisé uniquement par les abonnements autorisés qui sont configurés pour l'accès anticipé aux futures versions de l'agent invité. Lorsque GuestAgentType a la valeur ProdGA, le dernier agent invité publiquement disponible est installé sur les instances des rôles Web et des rôles de travail dans un service cloud. Lorsque GuestAgentType a la valeur TestGA, la toute dernière version de l'agent invité est installée.

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

Une opération ayant réussi retourne le code d'état 200 (OK). Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur de la gestion des services.

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.

Afficher:
© 2014 Microsoft