Lägg till tillägg

Den Add Extension asynkrona åtgärden lägger till ett tillgängligt tillägg till molntjänsten. I Microsoft Azure kan en process köras som ett tillägg till en molntjänst.

Förfrågan

Begäran Add Extension kan anges på följande sätt. Ersätt <subscription-id> med ditt prenumerations-ID och <cloudservice-name> med namnet på molntjänsten.

Metod	URI för förfrågan
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

URI-parametrar

Inga.

Rubriker för begäran

I följande tabell beskrivs begärandehuvudena.

Begärandehuvud	Description
x-ms-version	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska anges till 2013-03-01 eller en senare version.

Begärandetext

I följande exempel visas formatet för begärandetexten:

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

I följande tabell beskrivs elementen i begärandetexten.

Elementnamn	Beskrivning
ProviderNameSpace	Krävs. Anger providernamnområdet för tillägget. Providernamnområdet för Azure-tillägg är Microsoft.Windows.Azure.Extensions.
Typ	Krävs. Anger filnamnstilläggets typ.
Id	Krävs. Anger tilläggets identifierare.
Stämpel	Valfritt. Anger tumavtrycket för certifikatet som används för att kryptera konfigurationen som anges i PrivateConfiguration. Om det här elementet inte anges kan ett certifikat genereras automatiskt och läggas till i molntjänsten.
TumavtryckAlgoritm	Valfritt. Anger tumavtrycksalgoritmen för certifikatet som används för att kryptera konfigurationen som anges i PrivateConfiguration.
PublicConfiguration	Valfritt. Anger den offentliga konfiguration som definieras med hjälp av schemat som returneras av åtgärden Lista tillgängliga tillägg .
PrivateConfiguration	Valfritt. Anger den privata konfiguration som definieras med hjälp av schemat som returneras av åtgärden List Available Extensions (Lista tillgängliga tillägg ).
Version	Valfritt. Anger versionen av tillägget. Om det här elementet inte har angetts eller om en asterisk (*) används som värde används den senaste versionen av tillägget. Om värdet anges med ett huvudversionsnummer och en asterisk som delversionsnummer (X.*) väljs den senaste delversionen av den angivna huvudversionen. Om ett huvudversionsnummer och ett delversionsnummer anges (X.Y) väljs den specifika tilläggsversionen. Om en version anges utförs en automatisk uppgradering på rollinstansen.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
x-ms-request-id	Ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten. För en asynkron åtgärd kan du anropa Hämta åtgärdsstatus med värdet för huvudet för att avgöra om åtgärden är slutförd, har misslyckats eller fortfarande pågår.

Svarstext

Inga.