Aggiornare il servizio cloud

L'operazione Update Cloud Service aggiorna l'etichetta o la descrizione di un servizio cloud.

Richiesta

La richiesta di Update Cloud Service può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione e <cloudservice-name> con il nome del servizio cloud.

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

Parametri dell'URI

Nessuno.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiesta	Descrizione
Content-Type	Obbligatorio. Impostare questa intestazione su application/xml.
x-ms-version	Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2010-10-28 o versione successiva.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

<?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>    
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</UpdateHostedService>  

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della richiesta.

Nome dell'elemento	Descrizione
Etichetta	Facoltativo se l'elemento Description è specificato. Specifica l'identificatore con codifica Base 64 per il servizio cloud. L'identificatore può essere costituito da un massimo di 100 caratteri. È consigliabile usare un'etichetta univoca all'interno della sottoscrizione. L'etichetta può essere usata per motivi di rilevamento.
Descrizione	Facoltativo se l'elemento Label è specificato. Specifica la descrizione del servizio cloud. La descrizione può contenere fino a 1024 caratteri.
Nome	Facoltativa. Specifica il nome di una proprietà estesa del servizio cloud. È necessario specificare un nome e un valore per ogni proprietà. È consentito un massimo di 50 proprietà estese. Il nome può contenere fino a 64 caratteri. Solo caratteri alfanumerici e di sottolineatura sono validi nel nome; inoltre il nome deve iniziare con una lettera. L'elemento Name è disponibile solo con la versione 2012-03-01 o successiva.
Valore	Facoltativa. Specifica il valore di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. Il valore può essere costituito da un massimo di 255 caratteri. È possibile eliminare una proprietà esistente impostando il valore su NULL. L'elemento Value è disponibile solo con la versione 2012-03-01 o successiva.
ReverseDnsFqdn	Facoltativa. Specifica l'indirizzo DNS in cui l'indirizzo IP del servizio viene risolto quando viene sottoposto a query mediante una query DNS inversa. L'elemento ReverseDnsFqdn è disponibile solo con la versione 2014-06-01 o successiva.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice di stato

Un'operazione completata correttamente restituisce 200 (OK).

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive.

Intestazione di risposta	Descrizione
x-ms-request-id	Valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione.

Corpo della risposta

Nessuno.