Elencare i servizi cloud

Tramite l'operazione List Cloud Services vengono elencati i servizi cloud disponibili nella sottoscrizione specificata.

Richiesta

La richiesta di List Cloud Services può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID della sottoscrizione.

Metodo	URI richiesta
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices

Parametri dell'URI

Nessuno.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiesta	Descrizione
x-ms-version	Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2009-10-01 o superiore.
x-ms-continuation-token	Facoltativa. Specifica un token di continuità che consente di ottenere il resto della risposta se sono presenti più servizi cloud da elencare di quanti ne possano essere restituiti nel tempo allocato. Il valore del token viene restituito nell'intestazione di una risposta precedente e verrà restituito solo se devono essere elencati servizi cloud aggiuntivi.

Corpo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice di stato

Un'operazione completata correttamente restituisce 200 (OK).

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive.

Intestazione di risposta	Descrizione
x-ms-request-id	Specifica il valore che identifica in modo univoco una richiesta effettuata per il servizio di gestione.
x-ms-continuation-token	Specifica un token di continuità che consente di ottenere il resto della risposta se sono presenti più servizi cloud da elencare di quanti ne possano essere restituiti nel tempo allocato. Se nella sottoscrizione è contenuto un numero elevato di servizi cloud, non potranno essere elencati tutti in una singola risposta. È possibile usare il token contenuto in questa intestazione in richieste di operazioni successive finché non vengono restituiti tutti i servizi cloud.

Corpo della risposta

Il formato del corpo della risposta è il seguente:

  
<?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>  
  

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della risposta.

Nome dell'elemento	Descrizione
URL	Specifica l'URI della richiesta usato per ottenere le informazioni sul servizio cloud.
ServiceName	Specifica il nome del servizio cloud. Questo nome è il nome del prefisso DNS e può essere usato per accedere al servizio. Ad esempio, se il nome del servizio è MyService, è possibile accedere al servizio chiamando: http://MyService.cloudapp.net
Descrizione	Specifica la descrizione del servizio cloud. L'elemento Description è disponibile solo usando la versione 2012-03-01 o successiva.
AffinityGroup	Specifica il gruppo di affinità a cui è associato il servizio cloud, se disponibile. Se il servizio è associato a un gruppo di affinità, l'elemento Location non viene restituito. L'elemento AffinityGroup è disponibile solo usando la versione 2012-03-01 o successiva.
Posizione	Specifica la posizione geografica del servizio cloud in Azure, se il servizio non è associato a un gruppo di affinità. Se è specificata una posizione, l'elemento AffinityGroup non viene restituito. L'elemento Location è disponibile solo usando la versione 2012-03-01 o successiva.
Etichetta	Specifica l'identificatore con codifica Base 64 del servizio cloud. Questo identificatore può essere usato per motivi di rilevamento. L'elemento Label è disponibile solo usando la versione 2012-03-01 o successiva.
Stato	Specifica lo stato del servizio cloud. I valori possibili sono: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns L'elemento Status è disponibile solo usando la versione 2012-03-01 o successiva.
DateCreated	Specifica la data di creazione del servizio cloud nel formato [anno a 4 cifre]-[mese a 2 cifre]-[giorno a 2 cifre]T[ore a 2 cifre]:[minuti a 2 cifre]:[secondi a 2 cifre]Z. La data 2011-05-11T16:15:26Z è un esempio che può essere restituito dagli elementi DateCreated o DateLastModified. L'elemento DateCreated è disponibile solo usando la versione 2012-03-01 o successiva.
DateLastModified	Specifica la data dell'ultimo aggiornamento del servizio cloud nel formato [anno a 4 cifre]-[mese a 2 cifre]-[giorno a 2 cifre]T[ore a 2 cifre]:[minuti a 2 cifre]:[secondi a 2 cifre]Z. La data 2011-05-11T16:15:26Z è un esempio che può essere restituito dagli elementi DateCreated o DateLastModified. L'elemento DateLastModified è disponibile solo usando la versione 2012-03-01 o successiva.
Nome	Specifica il nome di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile definire un massimo di 50 proprietà estese. L'elemento Name è disponibile solo usando la versione 2012-03-01 o successiva.
Valore	Rappresenta il valore di una proprietà estesa del servizio cloud. Il valore della proprietà estesa può avere una lunghezza massima di 255 caratteri. L'elemento Value è disponibile solo usando la versione 2012-03-01 o successiva.
ReverseDnsFqdn	Facoltativa. Specifica l'indirizzo DNS in cui l'indirizzo IP del servizio viene risolto quando viene sottoposto a query mediante una query DNS inversa. L'elemento ReverseDnsFqdn è disponibile solo usando la versione 2014-06-01 o successiva.
DefaultWinRMCertificateThumbprint	Specifica il certificato predefinito per una connessione sicura con WinRM. Se l'identificazione digitale di un certificato non è specificata per WinRM al momento della distribuzione di una macchina virtuale in un servizio cloud, viene creato automaticamente un certificato e l'identificazione digitale viene elencata come valore di questo elemento. Per altre informazioni sulla definizione di WinRM, vedere Creare la distribuzione di macchine virtuali o aggiungere ruolo.
ComputeCapabilities	Specifica le dimensioni dei ruoli disponibili per le distribuzioni nel servizio cloud. Le dimensioni dei ruoli disponibili sono definite dalle risorse supportate dal servizio cloud. Ad esempio, le distribuzioni dei ruoli Web e dei ruoli di lavoro possono avere dimensioni disponibili diverse rispetto alle distribuzioni delle macchine virtuali. L'elemento ComputeCapabilities è disponibile solo usando la versione 2014-05-01 o successiva.

ComputeCapabilities

Specifica le dimensioni dei ruoli disponibili per le distribuzioni nel servizio cloud.

Nome dell'elemento	Descrizione
VirtualMachineRoleSizes	Contiene una raccolta di elementi RoleSize.
WebWorkerRoleSizes	Contiene una raccolta di elementi RoleSize.
RoleSize	Specifica le dimensioni dei ruoli disponibili per il tipo di distribuzione.

Commenti

Se x-ms-version è precedente alla versione 2012-03-01, non verranno restituiti i servizi cloud che contengono le distribuzioni delle macchine virtuali.

È possibile visualizzare i servizi cloud esistenti nella sottoscrizione esaminando la sezione relativa ai servizi cloud nel portale di gestione. È anche possibile ottenere un elenco di servizi cloud usando il cmdlet Get-AzureService .