Erweiterungen auflisten

Artikel
07/19/2023

Der List Extensions-Vorgang listet alle Erweiterungen auf, die einem Cloud-Dienst hinzugefügt wurden.

Anforderung

Die List Extensions-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
GET	`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. Der Wert dieses Headers muss auf `2013-03-01` oder höher festgelegt werden.

Anforderungstext

Keine.

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.

Antworttext

Das folgende Beispiel zeigt das Format des Anforderungstexts:

  
<?xml version="1.0" encoding="utf-8"?>  
<Extensions xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Extension>  
    <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>  
</Extensions>

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`.
type	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 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	Der Fingerabdruckalgorithmus des Zertifikats, das zum Verschlüsseln der in `PrivateConfiguration` angegebenen Konfiguration verwendet wird.
PublicConfiguration	Die öffentliche Konfiguration, die mithilfe des Schemas definiert wird, das vom Vorgang Verfügbare Erweiterungen auflisten zurückgegeben wird.
IsJsonExtension	Gibt an, ob die Erweiterungskonfiguration JSON unterstützt. Mögliche Werte: - `true` - `false` Das `IsJsonExtension` Element ist nur mit 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 mit Version 2014-06-01 oder höher verfügbar.

Freigeben über