Atualizar Serviço Cloud

A Update Cloud Service operação atualiza a etiqueta ou descrição de um serviço cloud.

Pedir

O Update Cloud Service pedido pode ser especificado da seguinte forma. Substitua pelo <subscription-id> seu ID de subscrição e <cloudservice-name> pelo nome do serviço cloud.

Método URI do pedido
PUT https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>

Parâmetros do URI

Nenhum.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Description
Content-Type Obrigatório. Defina este cabeçalho como application/xml.
x-ms-version Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como 2010-10-28 ou superior.

Corpo do Pedido

O formato do corpo do pedido é o seguinte:

<?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>  

A tabela seguinte descreve os elementos do corpo do pedido.

Nome do Elemento Descrição
Etiqueta Opcional se a Descrição for especificada. Especifica o identificador codificado com base 64 para o serviço cloud. O identificador pode ter até 100 carateres de comprimento. Recomenda-se que a etiqueta seja exclusiva na subscrição. A etiqueta pode ser utilizada para fins de controlo.
Description Opcional se a Etiqueta for especificada. Especifica a descrição do serviço cloud. A descrição pode ter até 1024 carateres.
Name Opcional. Especifica o nome de uma propriedade de serviço cloud expandida. Tem de fornecer um nome e um valor para cada propriedade. É permitido um máximo de 50 propriedades expandidas. O nome pode ter até 64 carateres. Apenas carateres alfanuméricos e carateres de sublinhado são válidos no nome e têm de começar com uma letra.

O Name elemento só está disponível através da versão 2012-03-01 ou superior.
Valor Opcional. Especifica o valor de uma propriedade de serviço cloud expandida. Cada propriedade expandida tem de ter um nome e um valor definidos. O valor pode ter até 255 carateres de comprimento. Pode eliminar uma propriedade existente ao definir o valor como NULL.

O Value elemento só está disponível através da versão 2012-03-01 ou superior.
ReverseDnsFqdn Opcional. Especifica o endereço DNS para o qual o endereço IP do serviço cloud é resolvido quando consultado com uma consulta DNS inversa.

O ReverseDnsFqdn elemento só está disponível através da versão 2014-06-01 ou superior.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais.

Cabeçalho de Resposta Description
x-ms-request-id Um valor que identifica exclusivamente um pedido feito relativamente ao serviço de Gestão.

Corpo da Resposta

Nenhum.