Erweiterung abrufen

Erweiterung abrufen

 

Die Get Extension Vorgang ruft Informationen zu einer angegebenen Erweiterung, die einen Cloud-Dienst hinzugefügt wurde.

Die Get Extension -Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID <cloudservice-name> mit dem Namen des Cloud-Diensts und <extensionId> mit der ID, die die Erweiterung zugewiesen wurde, als er zum Cloud-Dienst hinzugefügt wurde. Sie finden die Id einer Erweiterung mithilfe von Erweiterungen auflisten.

Methode

Anforderungs-URI

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions/<extensionId>

Sie müssen sicherstellen, dass die an den Verwaltungsdienst gestellte Anforderung sicher ist. Weitere Informationen finden Sie unter Authentifizieren von Dienstverwaltungsanforderungen.

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader

Beschreibung

x-ms-version

Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header muss festgelegt werden, um 2013-03-01 oder höher. Weitere Informationen zu versionsverwaltungsheadern finden Sie unter Service-Versionsverwaltung.

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

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben. Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes der Dienstverwaltung.

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader

Beschreibung

x-ms-request-id

Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Das folgende Beispiel zeigt das Format des Antworttexts:


<?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> <Version>version-of-extension</Version> <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint> <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm> <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration> <IsJsonExtension>indicator-of-json-support</IsJsonExtension> <DisallowMajorVersionUpgrade>indicator-of-allowed-version-upgrades</DisallowMajorVersionUpgrade> </Extension>

In der folgenden Tabelle sind die Elemente des Antworttexts beschrieben:

Elementname

Beschreibung

ProviderNameSpace

Der Anbieternamespace der Erweiterung. Der Anbieternamespace für Microsoft Azure-Erweiterungen lautet Microsoft.Windows.Azure.Extensions.

Typ

Erforderlich. Der Typ der Erweiterung.

ID

Der Bezeichner der Erweiterung.

Version

Die Version der Erweiterung.

Fingerabdruck

Der Fingerabdruck des Zertifikats, das zum Verschlüsseln der Konfigurations, die im angegebenen PrivateConfiguration. Wenn dieses Element nicht angegeben wird, wird u. U. automatisch ein Zertifikat generiert und dem Cloud-Dienst hinzugefügt.

ThumbprintAlgorithm

Der fingerabdruckalgorithmus des Zertifikats, das zum Verschlüsseln der Konfigurations, die im angegebenen PrivateConfiguration.

PublicConfiguration

Die öffentliche Konfiguration, die mit dem zurückgegebene Schema definiert ist die Verfügbare Erweiterungen auflisten Vorgang.

IsJsonExtension

Gibt an, ob die Erweiterungskonfiguration JSON unterstützt.

Folgende Werte sind möglich:

  • true

  • false

Das IsJsonExtension -Element ist nur bei Verwendung von Version 2014-06-01 oder höher verfügbar.

DisallowMajorVersionUpgrade

Gibt an, ob die Erweiterung automatische Upgrades auf neue Hauptversionen unterstützt.

Das DisallowMajorVersionUpgrade -Element ist nur bei Verwendung von Version 2014-06-01 oder höher verfügbar.

Anzeigen:
© 2016 Microsoft