Dodawanie rozszerzenia

Operacja Add Extension asynchroniczna dodaje dostępne rozszerzenie do usługi w chmurze. Na platformie Microsoft Azure proces może działać jako rozszerzenie usługi w chmurze.

Żądanie

Żądanie Add Extension można określić w następujący sposób. Zastąp <subscription-id> ciąg identyfikatorem subskrypcji i <cloudservice-name> nazwą usługi w chmurze.

Metoda	Identyfikator URI żądania
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

Parametry identyfikatora URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
x-ms-version	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na 2013-03-01 lub nowszą wersję.

Treść żądania

W poniższym przykładzie przedstawiono format treści żądania:

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

W poniższej tabeli opisano elementy treści żądania.

Nazwa elementu	Opis
ProviderNameSpace	Wymagane. Określa przestrzeń nazw dostawcy rozszerzenia. Przestrzeń nazw dostawcy dla rozszerzeń platformy Azure to Microsoft.Windows.Azure.Extensions.
Typ	Wymagane. Określa typ rozszerzenia.
Id	Wymagane. Określa identyfikator rozszerzenia.
Odcisk palca	Opcjonalny. Określa odcisk palca certyfikatu, który jest używany do szyfrowania konfiguracji określonej w pliku PrivateConfiguration. Jeśli ten element nie zostanie określony, certyfikat może zostać wygenerowany automatycznie i dodany do usługi w chmurze.
Odcisk palcaAlgorithm	Opcjonalny. Określa algorytm odcisku palca certyfikatu używanego do szyfrowania konfiguracji określonej w elemecie PrivateConfiguration.
Publiczna konfiguracja	Opcjonalny. Określa konfigurację publiczną zdefiniowaną przy użyciu schematu zwróconego przez operację List Available Extensions (Lista dostępnych rozszerzeń ).
Konfiguracja prywatna	Opcjonalny. Określa konfigurację prywatną zdefiniowaną przy użyciu schematu zwróconego przez operację List Available Extensions (Lista dostępnych rozszerzeń ).
Wersja	Opcjonalny. Określa wersję rozszerzenia. Jeśli ten element nie zostanie określony lub gwiazdka (*) zostanie użyta jako wartość, zostanie użyta najnowsza wersja rozszerzenia. Jeśli wartość jest określona z numerem wersji głównej i gwiazdką jako numer wersji pomocniczej (X.*), zostanie wybrana najnowsza wersja pomocnicza określonej wersji głównej. Jeśli zostanie określony numer wersji głównej i numer wersji pomocniczej (X.Y), wybrana jest określona wersja rozszerzenia. Jeśli określono wersję, automatyczne uaktualnianie jest wykonywane w wystąpieniu roli.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania. W przypadku operacji asynchronicznej można wywołać metodę Get Operation Status z wartością nagłówka, aby określić, czy operacja została ukończona, nie powiodła się, czy nadal trwa.

Treść odpowiedzi

Brak.