Elencare i servizi cloud

Articolo
08/05/2023

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.

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 .

Condividi tramite