Partilhar via


Criar Serviço Cloud

A Create Cloud Service operação assíncrona cria um novo serviço cloud no Microsoft Azure.

Pedir

O Create Cloud Service pedido é especificado da seguinte forma. Substitua pelo <subscription-id> seu ID de subscrição.

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

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. O valor deste cabeçalho tem de 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"?>  
<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>  

A tabela seguinte descreve os elementos do corpo do pedido.

Nome do Elemento Description
ServiceName Obrigatório. Especifica o nome do serviço cloud. Este nome tem de ser exclusivo no Azure. Este nome é o nome do prefixo DNS que é utilizado para aceder ao serviço. Para verificar a disponibilidade de um nome, pode utilizar Verificar a Disponibilidade do Nome do Serviço Cloud.
Etiqueta Obrigatório. Especifica o identificador codificado com base 64 do serviço cloud. O identificador pode ter até 100 carateres de comprimento. A etiqueta pode ser utilizada para fins de controlo.
Description Opcional. Especifica a descrição do serviço cloud. A descrição pode ter até 1024 carateres.
Localização Necessário se AffinityGroup não for especificado. Especifica a localização onde o serviço cloud é criado.

Tem de especificar Location ou AffinityGroup, mas não ambos. Para ver as localizações disponíveis, pode utilizar Localizações de Lista.
AffinityGroup Necessário se Location não for especificado. Especifica o nome de um grupo de afinidade existente associado à subscrição. Tem de especificar Location ou AffinityGroup, mas não ambos. Para ver os grupos de afinidade disponíveis, pode utilizar Grupos de Afinidade de Lista.
Name Opcional. Especifica o nome de uma propriedade de serviço cloud expandida. O nome pode ter até 64 carateres de comprimento, apenas carateres alfanuméricos e carateres de sublinhado são válidos no nome e tem de começar com uma letra. Cada propriedade expandida tem de ter um nome e um valor definidos. Pode definir um máximo de 50 propriedades expandidas.

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. O valor da propriedade expandida pode ter até 255 carateres de comprimento.

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 e um conjunto de cabeçalhos de resposta.

Código de Estado

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

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. Para uma operação assíncrona, pode chamar Obter Estado da Operação com o valor do cabeçalho para determinar se a operação está concluída, se falhou ou se ainda está em curso.

Corpo da Resposta

Nenhum.