Přidat rozšíření

Článek
08/05/2023

Asynchronní Add Extension operace přidá do cloudové služby dostupné rozšíření. V Microsoft Azure může proces běžet jako rozšíření cloudové služby.

Žádost

Žádost Add Extension může být zadána následujícím způsobem. Nahraďte <subscription-id> ID vašeho předplatného a <cloudservice-name> názvem cloudové služby.

Metoda	Identifikátor URI žádosti
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions`

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

Následující tabulka popisuje hlavičky požadavku.

Hlavička požadavku	Description
`x-ms-version`	Povinná hodnota. Určuje verzi operace, která se má pro tento požadavek použít. Tato hlavička by měla být nastavená na `2013-03-01` nebo novější verzi.

Text požadavku

Následující příklad ukazuje formát textu požadavku:

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

Následující tabulka popisuje prvky textu požadavku.

Název elementu	Popis
ProviderNameSpace	Povinná hodnota. Určuje obor názvů zprostředkovatele rozšíření. Obor názvů poskytovatele pro rozšíření Azure je `Microsoft.Windows.Azure.Extensions`.
Typ	Povinná hodnota. Určuje typ rozšíření.
Id	Povinná hodnota. Určuje identifikátor rozšíření.
Kryptografický otisk	Nepovinný parametr. Určuje kryptografický otisk certifikátu, který se používá k šifrování konfigurace zadané v `PrivateConfiguration`. Pokud tento prvek není zadaný, certifikát se může automaticky vygenerovat a přidat do cloudové služby.
Kryptografický otiskAlgorithm	Nepovinný parametr. Určuje algoritmus kryptografického otisku certifikátu, který se použije k šifrování konfigurace zadané v `PrivateConfiguration`.
PublicConfiguration	Nepovinný parametr. Určuje veřejnou konfiguraci, která je definována pomocí schématu vráceného operací List Available Extensions (Vypsat dostupná rozšíření ).
PrivateConfiguration	Nepovinný parametr. Určuje privátní konfiguraci, která je definována pomocí schématu vráceného operací List Available Extensions (Vypsat dostupná rozšíření ).
Verze	Nepovinný parametr. Určuje verzi rozšíření. Pokud tento prvek není zadán nebo je jako hodnota použita hvězdička (``), použije se nejnovější verze rozšíření. Pokud je hodnota zadána číslem hlavní verze a hvězdičkou jako číslem podverze (`X.`), je vybrána nejnovější podverze zadané hlavní verze. Pokud je zadáno číslo hlavní verze a číslo podverze (`X.Y`), vybere se konkrétní verze rozšíření. Pokud je zadaná verze, provede se automatický upgrade instance role.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP.

Hlavička odpovědi	Description
`x-ms-request-id`	Hodnota, která jednoznačně identifikuje požadavek provedený na službu správy. U asynchronní operace můžete voláním funkce Get Operation Status (Získat stav operace ) s hodnotou hlavičky zjistit, jestli je operace dokončená, selhala nebo stále probíhá.

Text odpovědi