Elencare le estensioni disponibili

Articolo
07/19/2023

L'operazione List Available Extensions elenca le estensioni disponibili che è possibile aggiungere al servizio cloud. In Microsoft Azure un processo può essere eseguito come estensione di un servizio cloud.

Richiesta

La richiesta di List Available Extensions 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/extensions`

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 `2013-03-01` o versione successiva.

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`	Valore che identifica in modo univoco una richiesta eseguita nel servizio di gestione.

Corpo della risposta

Nell'esempio seguente viene illustrato il formato del corpo della risposta:

  
<?xml version="1.0" encoding="utf-8"?>  
<ExtensionImages xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ExtensionImage>  
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
    <Type>type-of-extension</Type>      
    <Version>version-of-extension</Version>  
    <Label>label-of-extension</Label>  
    <Description>description-of-extension</Description>  
    <HostingResources>role-type</HostingResources>  
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
    <PublicConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PublicConfigurationSchema>  
    <PrivateConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PrivateConfigurationSchema>  
    <SampleConfig>base-64-encoded-sample-XML-for-extension</SampleConfig>  
    <ReplicationCompleted>indicator-of-replication-status</ReplicationCompleted>  
    <Eula> HYPERLINK "http://www.contoso.com/42588280809/eula%3c/Eula" eula-of-extension</Eula>  
    <PrivacyUri>privacy-policy-of-extension</PrivacyUri>  
    <HomepageUri>homepage-of-extension</HomepageUri>  
    <IsJsonExtension>indicator-of-JSON-support</IsJsonExtension>  
    <CompanyName>name-of-publishing-company</CompanyName>  
    <SupportedOS>supported-operating-system</SupportedOS>  
    <PublishedDate>publish-date-of-extension</PublishedDate>  
  </ExtensionImage>  
</ExtensionImages>

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

Nome dell'elemento	Descrizione
ProviderNameSpace	Specifica lo spazio dei nomi del provider dell'estensione. Lo spazio dei nomi del provider per le estensioni di Azure è `Microsoft.WindowsAzure.Extensions`.
Tipo	Specifica il tipo dell'estensione.
Versione	Specifica la versione dell'estensione.
Etichetta	Specifica l'etichetta utilizzata per identificare l'estensione.
Descrizione	Specifica la descrizione dell'estensione.
HostingResources	Specifica il tipo di risorsa che supporta l'estensione. Questo valore può essere `WebRole`, `WorkerRole` o `WebRole\|WorkerRole`.
ThumbprintAlgorithm	Specifica l'algoritmo di identificazione personale del certificato usato per la crittografia.
PublicConfigurationSchema	Specifica lo schema con codifica Base64 della configurazione pubblica.
PrivateConfigurationSchema	Specifica lo schema con codifica Base64 della configurazione privata.
SampleConfig	Specifica un file di configurazione di esempio per l'estensione di risorsa. L'elemento SampleConfig è disponibile solo nella versione 2013-11-01 o successiva.
ReplicationCompleted	Indica se la versione dell'estensione è stata replicata in tutte le aree. I valori possibili sono: - `true` - `false` `true` se la versione dell'estensione può essere utilizzata per creare o aggiornare una distribuzione, altrimenti `false` per indicare che la versione dell'estensione non è pronta per essere utilizzata in tutte le aree. L'elemento `ReplicationCompleted` è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva.
Eula	Specifica un URI che punta al Contratto di licenza con l'utente finale per la versione dell'estensione. L'elemento `Eula` è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva.
PrivacyUri	Specifica un URI che punta all'informativa sulla privacy per la versione dell'estensione. L'elemento `PrivacyUri` è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva.
HomepageUri	Specifica l'URI che punta alla home page per la versione dell'estensione. L'elemento `HomepageUri` è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva.
IsJsonExtension	Indica se la versione dell'estensione accetta una configurazione basata su JSON. I valori possibili sono: - `true` - `false` `true` se l'estensione accetta una configurazione basata su JSON, altrimenti `false` e l'estensione accetta una configurazione basata su XML. L'elemento `IsJsonExtension` è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva.
CompanyName	Specifica il nome della società che ha pubblicato l'estensione. L'elemento `CompanyName` è disponibile solo con la versione 2014-06-01 o successiva.
SupportedOS	Specifica il sistema operativo su cui l'estensione è in esecuzione. L'elemento `SupportedOS` è disponibile solo con la versione 2014-06-01 o successiva.
PublishedDate	Specifica la data di pubblicazione dell'estensione. L'elemento `PublishedDate` è disponibile solo con la versione 2014-06-01 o successiva.