Criar Serviço Cloud

Artigo
08/05/2023

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