Ottenere l'estensione

L'operazione Get Extension recupera le informazioni su un'estensione specificata aggiunta a un servizio cloud.

Richiesta

La richiesta di Get Extension può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud e <extensionId> con l'identificativo assegnato all'estensione al momento dell'aggiunta al servizio cloud.

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

Parametri dell'URI

Nessuno.

Intestazioni richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

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 superiore.

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"?>  
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
  <Type>type-of-extension</Type>  
  <Id>identifier-of-extension</Id>  
  <Version>version-of-extension</Version>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <IsJsonExtension>indicator-of-json-support</IsJsonExtension>  
  <DisallowMajorVersionUpgrade>indicator-of-allowed-version-upgrades</DisallowMajorVersionUpgrade>  
</Extension>  
  

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

Nome dell'elemento	Descrizione
ProviderNameSpace	Spazio dei nomi del provider dell'estensione. Lo spazio dei nomi del provider per le estensioni di Microsoft Azure è Microsoft.Windows.Azure.Extensions.
Tipo	Obbligatorio. Il tipo di estensione.
ID	Identificatore dell'estensione.
Versione	Versione dell'estensione.
Identificazione personale	Identificazione digitale del certificato utilizzato per crittografare la configurazione specificata in PrivateConfiguration. Se questo elemento non è specificato, un certificato potrebbe essere automaticamente generato e aggiunto al servizio cloud.
ThumbprintAlgorithm	Algoritmo di identificazione digitale del certificato utilizzato per crittografare la configurazione specificata in PrivateConfiguration.
PublicConfiguration	Configurazione pubblica definita usando lo schema restituito dall'operazione List Available Extensions .
IsJsonExtension	Indica se la configurazione dell'estensione supporta JSON. I valori possibili sono: - true - false L'elemento IsJsonExtension è disponibile solo usando la versione 2014-06-01 o successiva.
DisallowMajorVersionUpgrade	Indica se l'estensione supporta l'aggiornamento automatico a nuove versioni principali. L'elemento DisallowMajorVersionUpgrade è disponibile solo usando la versione 2014-06-01 o successiva.