Listar serviços de nuvem

A operação List Cloud Services lista os serviços de nuvem que estão disponíveis na assinatura especificada.

Solicitação

A solicitação List Cloud Services pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura.

Método	URI da solicitação
GET	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
x-ms-version	Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. Esse cabeçalho deve ser definido como 2009-10-01 ou superior.
x-ms-continuation-token	Opcional. Especifica um token de continuação que permite obter o restante da resposta quando há mais serviços em nuvem a serem listados do que podem ser retornados no tempo alocado. O valor desse token é retornado no cabeçalho de uma resposta anterior e só será retornado se serviços em nuvem adicionais precisarem ser listados.

Corpo da solicitação

Nenhum.

Resposta

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

Código de status

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

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	Especifica um valor que identifica exclusivamente uma solicitação feita ao serviço de gerenciamento.
x-ms-continuation-token	Especifica um token de continuação que permite obter o restante da resposta quando há mais serviços em nuvem a serem listados do que podem ser retornados no tempo alocado. Se um grande número de serviços em nuvem existir na assinatura, nem todos eles poderão ser listados em uma única resposta. Você pode usar o token nesse cabeçalho em solicitações de operação subsequentes até que todos os serviços em nuvem sejam retornados.

Corpo da resposta

Formato do corpo da resposta:

  
<?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 a seguir descreve os elementos do corpo da resposta.

Nome do elemento	Descrição
Url	Especifica o URI de solicitação que é usado para obter informações sobre o serviço de nuvem.
ServiceName	Especifica o nome do serviço de nuvem. Esse nome é o nome do prefixo DNS e pode ser usado para acessar o serviço. Por exemplo, se o nome do serviço for MeuServiço, você poderia acessá-lo ao chamar: http://MeuServiço.cloudapp.net
Descrição	Especifica a descrição do serviço de nuvem. O Description elemento só está disponível usando a versão 2012-03-01 ou superior.
AffinityGroup	Especifica o grupo de afinidade ao qual esse serviço de nuvem está associado, se houver. Se o serviço estiver associado a um grupo de afinidade, o elemento Location não será retornado. O AffinityGroup elemento só está disponível usando a versão 2012-03-01 ou superior.
Location	Especifica a localização geográfica do serviço de nuvem no Azure, caso o serviço não esteja associado a um grupo de afinidade. Se um local for especificado, o elemento AffinityGroup não será retornado. O Location elemento só está disponível usando a versão 2012-03-01 ou superior.
Rótulo	Especifica o identificador codificado em base 64 do serviço de nuvem. Este identificador pode ser usado para suas finalidades de acompanhamento. O Label elemento só está disponível usando a versão 2012-03-01 ou superior.
Status	Especifica o status do serviço de nuvem. Os valores possíveis são: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns O Status elemento só está disponível usando a versão 2012-03-01 ou superior.
DateCreated	Especifica a data em que o serviço de nuvem foi criado, no formato [AnoDe4Dígitos]-[MêsDe2Dígitos]-[DiaDe2Dígitos]T[HoraDe2Dígitos]:[MinutosDe2Dígitos]:[SegundosDe2Dígitos]Z. A data 2011-05-11T16:15:26Z é um exemplo que pode ser retornado pelos elementos DateCreated ou DateLastModified. O DateCreated elemento só está disponível usando a versão 2012-03-01 ou superior.
DateLastModified	Especifica a data em que o serviço de nuvem foi atualizado pela última vez, no formato [AnoDe4Dígitos]-[MêsDe2Dígitos]-[DiaDe2Dígitos]T[HoraDe2Dígitos]:[MinutosDe2Dígitos]:[SegundosDe2Dígitos]Z. A data 2011-05-11T16:15:26Z é um exemplo que pode ser retornado pelos elementos DateCreated ou DateLastModified O DateLastModified elemento só está disponível usando a versão 2012-03-01 ou superior.
Nome	Especifica o nome de uma propriedade estendida do serviço de nuvem. 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	Representa 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.
DefaultWinRMCertificateThumbprint	Especifica o certificado padrão para uma conexão segura com WinRM. Se um certificado de impressão digital não estiver especificado para WinRM quando uma Máquina Virtual for implantada em um serviço de nuvem, um certificado será criado automaticamente e a impressão digital será listada como o valor desse elemento. Para obter mais informações sobre como definir o WinRM, consulte Criar implantação de máquina virtual ou adicionar função.
ComputeCapabilities	Especifica os tamanhos de função disponíveis para implantações no serviço de nuvem. Os tamanhos de função disponíveis são definidos pelos recursos com suporte no serviço de nuvem. Por exemplo, as implantações de funções Web e funções de trabalho podem ter tamanhos diferentes disponíveis do que as implantações de Máquinas Virtuais. O ComputeCapabilities elemento só está disponível usando a versão 2014-05-01 ou superior.

ComputeCapabilities

Especifica os tamanhos de função disponíveis para implantações no serviço de nuvem.

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 de função disponível para o tipo de implantação.

Comentários

Se x-ms-version for mais antigo do que 2012-03-01, os serviços de nuvem com implantações de máquina virtual não serão retornados.

Você pode ver os serviços em nuvem que existem na sua assinatura examinando a seção Serviços em Nuvem do Portal de Gerenciamento. Você também pode obter uma lista de serviços de nuvem usando o cmdlet Get-AzureService .