Aggiungere un'estensione

L'operazione asincrona Add Extension aggiunge un'estensione disponibile al servizio cloud. In Microsoft Azure un processo può essere eseguito come estensione di un servizio cloud.

Richiesta

La richiesta di Add Extension può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione e <cloudservice-name> con il nome del servizio cloud.

Metodo	URI richiesta
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/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 una versione successiva.

Corpo della richiesta

Nell'esempio seguente viene mostrato il formato del corpo della richiesta:

  
<?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>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>  
  <Version>version-of-extension</Version>  
</Extension>  

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

Nome dell'elemento	Descrizione
ProviderNameSpace	Obbligatorio. Specifica lo spazio dei nomi del provider dell'estensione. Lo spazio dei nomi del provider per le estensioni di Azure è Microsoft.Windows.Azure.Extensions.
Tipo	Obbligatorio. Specifica il tipo dell'estensione.
ID	Obbligatorio. Specifica l'identificatore dell'estensione.
Identificazione personale	Facoltativa. Specifica l'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	Facoltativa. Specifica l'algoritmo di identificazione digitale del certificato utilizzato per crittografare la configurazione specificata in PrivateConfiguration.
PublicConfiguration	Facoltativa. Specifica la configurazione pubblica definita usando lo schema restituito dall'operazione List Available Extensions .
PrivateConfiguration	Facoltativa. Specifica la configurazione privata definita usando lo schema restituito dall'operazione List Available Extensions .
Versione	Facoltativa. Specifica la versione dell'estensione. Se questo elemento non è specificato o viene utilizzato un asterisco (*) come valore, è in uso la versione più recente dell'estensione. Se è specificato un valore con un numero di versione principale e un asterisco come numero di versione secondaria (X.*), è selezionata la versione secondaria più recente della versione principale specificata. Se sono specificati un numero di versione principale e un numero di versione secondaria (X.Y), è selezionata la versione dell'estensione specifica. Se è specificata una versione, viene eseguito un aggiornamento automatico sull'istanza del ruolo.

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 effettuata nel servizio di gestione. Per un'operazione asincrona, è possibile chiamare Recupera stato operazione con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta

Nessuno.