Erweiterung hinzufügen

Der asynchrone Vorgang Add Extension fügt Ihrem Cloud-Dienst eine verfügbare Erweiterung hinzu. In Microsoft Azure kann ein Prozess als Erweiterung eines Cloud-Diensts ausgeführt werden.

Anforderung

Die Add Extension-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID und <cloudservice-name> durch den Namen des Cloud-Diensts.

Methode	Anforderungs-URI
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions`

URI-Parameter

Keine.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`x-ms-version`	Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf `2013-03-01` oder eine höhere Version festgelegt werden.

Anforderungstext

Das folgende Beispiel zeigt das Format des Anforderungstexts:

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

In der folgenden Tabelle werden die Elemente des Anforderungstexts beschrieben.

Elementname	BESCHREIBUNG
ProviderNameSpace	Erforderlich. Gibt den Anbieternamespace der Erweiterung an. Der Anbieternamespace für Azure-Erweiterungen lautet `Microsoft.Windows.Azure.Extensions`.
type	Erforderlich. Gibt den Typ der Erweiterung an.
Id	Erforderlich. Gibt den Bezeichner der Erweiterung an.
Fingerabdruck	Optional. Gibt den Fingerabdruck des Zertifikats an, das zum Verschlüsseln der in `PrivateConfiguration` angegebenen Konfiguration verwendet wird. Wenn dieses Element nicht angegeben wird, wird u. U. automatisch ein Zertifikat generiert und dem Cloud-Dienst hinzugefügt.
ThumbprintAlgorithm	Optional. Gibt den Fingerabdruckalgorithmus des Zertifikats an, das zum Verschlüsseln der in `PrivateConfiguration` angegebenen Konfiguration verwendet wird.
PublicConfiguration	Optional. Gibt die öffentliche Konfiguration an, die mithilfe des Schemas definiert wird, das vom Vorgang Verfügbare Erweiterungen auflisten zurückgegeben wird.
PrivateConfiguration	Optional. Gibt die private Konfiguration an, die mithilfe des Schemas definiert wird, das vom Vorgang Verfügbare Erweiterungen auflisten zurückgegeben wird.
Version	Optional. Gibt die Version der Erweiterung an. Wenn dieses Element nicht angegeben ist oder ein Sternchen (``) als Wert verwendet wird, wird die neueste Version der Erweiterung verwendet. Wenn der Wert mit einer Hauptversionsnummer angegeben wird und die Nebenversionsnummer als Sternchen dargestellt ist (`X.`), wird die neueste Nebenversion der angegebenen Hauptversion ausgewählt. Wenn eine Hauptversionsnummer und eine Nebenversionsnummer angegeben sind (`X.Y`), wird diese spezifische Erweiterungsversion ausgewählt. Wenn eine Version angegeben wird, wird ein automatisches Upgrade für die Rolleninstanz durchgeführt.

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader	BESCHREIBUNG
`x-ms-request-id`	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert. Bei einem asynchronen Vorgang können Sie Vorgangsstatus abrufen mit dem Wert des Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, fehlgeschlagen ist oder noch ausgeführt wird.

Antworttext