Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo

Listar serviços de nuvem

Atualizado: junho de 2015

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

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

 

Método URI de solicitação

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Nenhuma.

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

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01/10/2009 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

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.

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

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

 

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.

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 MyService, você poderá acessar o serviço chamando: http:// MyService.cloudapp.net

Descrição

Especifica a descrição do serviço de nuvem.

O elemento Description só estará disponível com a versão 01/03/2012 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 elemento AffinityGroup só estará disponível com a versão 01/03/2012 ou superior.

Local

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 elemento Location só estará disponível com a versão 01/03/2012 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 elemento Label só estará disponível com a versão 01/03/2012 ou superior.

Status

Especifica o status do serviço de nuvem. Os possíveis valores são:

  • Creating

  • Created

  • Deleting

  • Deleted

  • Changing

  • ResolvingDns

O elemento Status só estará disponível com a versão 01/03/2012 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 elemento DateCreated só estará disponível com a versão 01/03/2012 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 elemento DateLastModified só estará disponível com a versão 01/03/2012 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 elemento Name só estará disponível com a versão 01/03/2012 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 elemento Value só estará disponível com a versão 01/03/2012 ou superior.

ReverseDnsFqdn

Opcional. Especifica o endereço de DNS para o qual o endereço IP do serviço de nuvem resolve quando consultado usando uma consulta de DNS reversa.

O elemento ReverseDnsFqdn só estará disponível com a versão 01/06/2014 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. Para obter mais informações sobre tamanhos de função, consulte Tamanhos de Máquina Virtual e Serviços de Nuvem para Windows Azure.

O elemento ComputeCapabilities só estará disponível com a versão 01/05/2014 ou superior.

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.

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. Também é possível obter uma lista de serviços de nuvem usando o cmdlet Get-AzureService.

O seguinte programa de console de exemplo lista os serviços de nuvem que existem em uma assinatura:


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Xml;
using System.Xml.Linq;
using System.Security.Cryptography.X509Certificates;
using System.Net;

namespace ListCloudServices
{
  class Program
  {
    private const string Thumbprint = "thumbprint-of-management-certificate";
    private const string SubscriptionId = "subscription-identifier";
    private const string Version = "API-version-number";

    // Gets or sets the certificate that matches the Thumbprint value.
    private static X509Certificate2 Certificate { get; set; }
        
    static void Main(string[] args)
    {
      Certificate = GetStoreCertificate(Thumbprint);
      
      // Create the URI
      string uriFormat = "https://management.core.windows.net/{0}/services/hostedservices";
      Uri uri = new Uri(String.Format(uriFormat, SubscriptionId));
      
      // Submit the request and get the response
      XDocument responseBody;
      HttpWebResponse response = InvokeRequest(uri, "GET", out responseBody);

      HttpStatusCode statusCode = statusCode = response.StatusCode;
      Console.WriteLine("The status of the operation: {0}\n\n", statusCode.ToString());
      Console.WriteLine(responseBody.ToString(SaveOptions.OmitDuplicateNamespaces));
      Console.Write("Press any key to continue:");
      Console.ReadKey();
    }
    // Process the request
    private static HttpWebResponse InvokeRequest(
      Uri uri,
      string method,
      out XDocument responseBody)
    {
      HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
      request.Method = method;
      request.Headers.Add("x-ms-version", Version);
      request.ClientCertificates.Add(Certificate);
      request.ContentType = "application/xml";

      responseBody = null;
      HttpWebResponse response;
      try
      {
        response = (HttpWebResponse)request.GetResponse();
      }
      catch (WebException ex)
      {
        response = (HttpWebResponse)ex.Response;
      }
      XmlReaderSettings settings = new XmlReaderSettings();
      settings.DtdProcessing = DtdProcessing.Ignore;
      if (response.ContentLength > 0)
      {
        using (XmlReader reader = XmlReader.Create(response.GetResponseStream(), settings))
        {
          try
          {
            responseBody = XDocument.Load(reader);
          }
          catch
          {
            responseBody = null;
          }
        }
      }
      response.Close();
      return response;
    }
    
    // Get the certificate
    private static X509Certificate2 GetStoreCertificate(string thumbprint)
    {
      List<StoreLocation> locations = new List<StoreLocation>
      { 
        StoreLocation.CurrentUser, 
        StoreLocation.LocalMachine
      };

      foreach (var location in locations)
      {
        X509Store store = new X509Store("My", location);
        try
        {
          store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
          X509Certificate2Collection certificates = store.Certificates.Find(
          X509FindType.FindByThumbprint, thumbprint, false);
          if (certificates.Count == 1)
          {
            return certificates[0];
          }
        }
        finally
        {
          store.Close();
        }
      }
      throw new ArgumentException(string.Format(
        "A Certificate with Thumbprint '{0}' could not be located.",
        thumbprint));
    }
  }
}

Mostrar:
© 2015 Microsoft