Listar serviços de nuvem

Listar serviços de nuvem

 

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

O List Cloud Services solicitação pode ser especificada da seguinte maneira. Substitua <subscription-id> pela sua ID de 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 solicitações de gerenciamento de serviço de autenticação.

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

Cabeçalho de solicitação

Descrição

x-ms-version

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

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

Descrição

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

O Description elemento só está disponível com 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 um grupo de afinidade, o Location elemento não é retornado.

O AffinityGroup elemento só está disponível com a versão 2012-03-01 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 AffinityGroup elemento não é retornado.

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

Status

Especifica o status do serviço de nuvem. Os possíveis valores 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 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 pela DateCreated ou DateLastModified elementos.

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 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 pela DateCreated ou DateLastModified elementos

O DateLastModified elemento só está disponível com 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 com 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 com 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 com 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áquinas virtuais 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 Máquina Virtual e tamanhos de serviço de nuvem para o Azure do Windows.

O ComputeCapabilities elemento só está disponível com a versão 2014-05-01 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 o x-ms-version é mais antigo que 2012-03-01, os serviços de nuvem que contêm máquinas virtuais implantações não serão retornadas.

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 Get-AzureService cmdlet.

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:
© 2016 Microsoft