Listar Serviços Cloud

A List Cloud Services operação lista os serviços cloud que estão disponíveis na subscrição especificada.

Pedir

O List Cloud Services pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo ID da subscrição.

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

Parâmetros do URI

Nenhum.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido	Description
x-ms-version	Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como 2009-10-01 ou superior.
x-ms-continuation-token	Opcional. Especifica um token de continuação que lhe permite obter o resto da resposta quando existem mais serviços cloud para listar do que podem ser devolvidos no tempo atribuído. O valor deste token é devolvido no cabeçalho de uma resposta anterior e só será devolvido se os serviços cloud adicionais precisarem de ser listados.

Corpo do Pedido

Nenhum.

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	Especifica um valor que identifica exclusivamente um pedido feito no serviço de gestão.
x-ms-continuation-token	Especifica um token de continuação que lhe permite obter o resto da resposta quando existem mais serviços cloud para listar do que podem ser devolvidos no tempo atribuído. Se existir um grande número de serviços cloud na subscrição, nem todos podem ser listados numa única resposta. Pode utilizar o token neste cabeçalho em pedidos de operação subsequentes até que todos os serviços cloud sejam devolvidos.

Corpo da Resposta

O formato do corpo de resposta é o seguinte:

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>  
  

A tabela seguinte descreve os elementos do corpo da resposta.

Nome do elemento	Descrição
Url	Especifica o URI do pedido que é utilizado para obter informações sobre o serviço cloud.
ServiceName	Especifica o nome do serviço cloud. Este nome é o nome do prefixo DNS e pode ser utilizado para aceder ao serviço. Por exemplo, se o nome do serviço for MyService, poderá aceder ao serviço ao chamar: http:// MyService.cloudapp.net
Description	Especifica a descrição do serviço cloud. O Description elemento só está disponível com a versão 2012-03-01 ou superior.
AffinityGroup	Especifica o grupo de afinidades ao qual este serviço cloud está associado, se existir. Se o serviço estiver associado a um grupo de afinidades, o Location elemento não será devolvido. O AffinityGroup elemento só está disponível com a versão 2012-03-01 ou superior.
Localização	Especifica a localização geográfica do serviço cloud no Azure, se o serviço não estiver associado a um grupo de afinidades. Se for especificada uma localização, o AffinityGroup elemento não é devolvido. O Location elemento só está disponível com a versão 2012-03-01 ou superior.
Etiqueta	Especifica o identificador codificado base-64 do serviço cloud. Este identificador pode ser utilizado para as suas finalidades de controlo. O Label elemento só está disponível com a versão 2012-03-01 ou superior.
Estado	Especifica o estado do serviço cloud. Os valores possíveis são: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns O Status elemento só está disponível com a versão 2012-03-01 ou superior.
DateCreated	Especifica a data em que o serviço cloud foi criado, em [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z format. A data 2011-05-11T16:15:26Z é um exemplo que pode ser devolvido pelos DateCreated elementos ou DateLastModified . O DateCreated elemento só está disponível com a versão 2012-03-01 ou superior.
DateLastModified	Especifica a data em que o serviço cloud foi atualizado pela última vez, em [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z format. A data 2011-05-11T16:15:26Z é um exemplo que pode ser devolvido pelos DateCreated elementos ou DateLastModified O DateLastModified elemento só está disponível com a versão 2012-03-01 ou superior.
Name	Especifica o nome de uma propriedade de serviço cloud expandida. 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 com a versão 2012-03-01 ou superior.
Valor	Representa 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 com a 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 através de uma consulta DNS inversa. O ReverseDnsFqdn elemento só está disponível com a versão 2014-06-01 ou superior.
DefaultWinRMCertificateThumbprint	Especifica o certificado predefinido para uma ligação segura com o WinRM. Se um thumbprint de certificado não for especificado para o WinRM quando uma Máquina Virtual é implementada num serviço cloud, é criado automaticamente um certificado e o thumbprint é listado como o valor deste elemento. Para obter mais informações sobre como definir o WinRM, veja Criar Implementação de Máquina Virtual ou Adicionar Função.
ComputeCapabilities	Especifica os tamanhos de funções que estão disponíveis para implementações no serviço cloud. Os tamanhos de função disponíveis são definidos pelos recursos suportados pelo serviço cloud. Por exemplo, as implementações de funções Web e funções de trabalho podem ter diferentes tamanhos disponíveis do que as implementações de Máquinas Virtuais. O ComputeCapabilities elemento só está disponível com a versão 2014-05-01 ou superior.

ComputeCapabilities

Especifica os tamanhos de funções que estão disponíveis para implementações no serviço cloud.

Nome do elemento	Descrição
VirtualMachineRoleSizes	Contém uma coleção de elementos RoleSize.
WebWorkerRoleSizes	Contém uma coleção de elementos RoleSize.
RoleSize	Especifica o tamanho da função que está disponível para o tipo de implementação.

Observações

Se for x-ms-version mais antigo do que 2012-03-01, os serviços cloud que contêm implementações de máquinas virtuais não serão devolvidos.

Pode ver os serviços cloud que existem na sua subscrição ao consultar a secção Serviços Cloud do Portal de Gestão. Também pode obter uma lista de serviços cloud com o cmdlet Get-AzureService .