Criar Serviço de Nuvem

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

Solicitação

A Create Cloud Service solicitação é especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura.

Método	URI da solicitação
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho da solicitação	Descrição
Content-Type	Obrigatórios. Defina este cabeçalho como application/xml.
x-ms-version	Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. O valor desse cabeçalho deve ser definido como 2010-10-28 ou superior.

Corpo da solicitação

Formato do corpo da solicitação:

<?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 a seguir descreve os elementos do corpo da solicitação.

Nome do elemento	Descrição
ServiceName	Obrigatórios. Especifica o nome para o serviço de nuvem. Esse nome deve ser exclusivo no Azure. Esse nome é o nome do prefixo DNS que é usado para acessar o serviço. Para verificar a disponibilidade de um nome, você pode usar Verificar Disponibilidade do Nome do Serviço de Nuvem.
Rótulo	Obrigatórios. Especifica o identificador codificado em base 64 do serviço de nuvem. O identificador pode ter até 100 caracteres. O rótulo pode ser usado para suas finalidades de acompanhamento.
Descrição	Opcional. Especifica a descrição do serviço de nuvem. A descrição pode ter até 1.024 caracteres.
Location	Obrigatório se AffinityGroup não for especificado. Especifica o local em que o serviço de nuvem é criado. Você deve especificar Location ou AffinityGroup, mas não ambos. Para ver os locais disponíveis, você pode usar Locais de Lista.
AffinityGroup	Obrigatório se Location não for especificado. Especifica o nome de um grupo de afinidade existente associado a essa assinatura. Você deve especificar Location ou AffinityGroup, mas não ambos. Para ver os grupos de afinidade disponíveis, você pode usar Listar Grupos de Afinidades.
Nome	Opcional. Especifica o nome de uma propriedade estendida do serviço de nuvem. O nome pode ter até 64 caracteres, somente os caracteres alfanuméricos e sublinhados são válidos no nome, e ele deve começar com uma letra. Cada propriedade estendida deve ter um nome e um valor definido. Você pode definir um máximo de 50 propriedades estendidas. O Name elemento só está disponível usando a versão 2012-03-01 ou superior.
Valor	Opcional. Especifica o valor de uma propriedade estendida do serviço de nuvem. O valor da propriedade estendida pode ter até 255 caracteres. O Value elemento só está disponível usando a versão 2012-03-01 ou superior.
ReverseDnsFqdn	Opcional. Especifica o endereço de DNS para o qual o endereço IP do serviço em nuvem resolve quando consultado usando uma consulta de DNS reversa. O ReverseDnsFqdn elemento só está disponível usando a versão 2014-06-01 ou superior.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Código de status

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

Cabeçalhos de resposta

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

Cabeçalho de Resposta	Descrição
x-ms-request-id	Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento. Para uma operação assíncrona, você pode chamar Obter Status da Operação com o valor do cabeçalho para determinar se a operação foi concluída, falhou ou ainda está em andamento.

Corpo da resposta

Nenhum.