Verfügbare Erweiterungen auflisten

Artikel
07/19/2023

Der Vorgang List Available Extensions listet die Erweiterungen, die dem Cloud-Dienst hinzugefügt werden können. In Microsoft Azure kann ein Prozess als Erweiterung eines Cloud-Diensts ausgeführt werden.

Anforderung

Die List Available Extensions-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID.

Methode	Anforderungs-URI
GET	`https://management.core.windows.net/<subscription-id>/services/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 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 Antworttexts:

  
<?xml version="1.0" encoding="utf-8"?>  
<ExtensionImages xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ExtensionImage>  
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
    <Type>type-of-extension</Type>      
    <Version>version-of-extension</Version>  
    <Label>label-of-extension</Label>  
    <Description>description-of-extension</Description>  
    <HostingResources>role-type</HostingResources>  
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
    <PublicConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PublicConfigurationSchema>  
    <PrivateConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PrivateConfigurationSchema>  
    <SampleConfig>base-64-encoded-sample-XML-for-extension</SampleConfig>  
    <ReplicationCompleted>indicator-of-replication-status</ReplicationCompleted>  
    <Eula> HYPERLINK "http://www.contoso.com/42588280809/eula%3c/Eula" eula-of-extension</Eula>  
    <PrivacyUri>privacy-policy-of-extension</PrivacyUri>  
    <HomepageUri>homepage-of-extension</HomepageUri>  
    <IsJsonExtension>indicator-of-JSON-support</IsJsonExtension>  
    <CompanyName>name-of-publishing-company</CompanyName>  
    <SupportedOS>supported-operating-system</SupportedOS>  
    <PublishedDate>publish-date-of-extension</PublishedDate>  
  </ExtensionImage>  
</ExtensionImages>

In der folgenden Tabelle sind die Elemente des Antworttexts beschrieben:

Elementname	BESCHREIBUNG
ProviderNameSpace	Gibt den Anbieternamespace der Erweiterung an. Der Anbieternamespace für Azure-Erweiterungen lautet `Microsoft.WindowsAzure.Extensions`.
type	Gibt den Typ der Erweiterung an.
Version	Gibt die Version der Erweiterung an.
Bezeichnung	Gibt die Bezeichnung an, die zur Identifizierung der Erweiterung verwendet wird.
BESCHREIBUNG	Gibt die Beschreibung der Erweiterung an.
HostingResources	Gibt den Typ der Ressource an, die die Erweiterung unterstützt. Dieser Wert kann `WebRole`, `WorkerRole` oder `WebRole\|WorkerRole` sein.
ThumbprintAlgorithm	Gibt den Fingerabdruckalgorithmus des Zertifikats an, das zum Verschlüsseln verwendet wird.
PublicConfigurationSchema	Gibt das Base-64-codierte Schema der öffentlichen Konfiguration an.
PrivateConfigurationSchema	Gibt das Base-64-codierte Schema der privaten Konfiguration an.
SampleConfig	Gibt eine Beispielkonfigurationsdatei für die Ressourcenerweiterung an. Das SampleConfig-Element ist nur bei Verwendung von Version 2013-11-01 oder höher verfügbar.
ReplicationCompleted	Zeigt an, ob die Version der Erweiterung in alle Regionen repliziert wurde. Mögliche Werte: - `true` - `false` `true`, wenn die Erweiterungsversion zum Erstellen oder Aktualisieren einer Bereitstellung verwendet werden kann, andernfalls `false`, was anzeigt, dass die Version der Erweiterung nicht für die Verwendung in allen Regionen bereit ist. Das `ReplicationCompleted` Element ist nur mit Version 2014-04-01 oder höher verfügbar.
Eula	Gibt einen URI an, der auf die Lizenzbedingungen für die Version der Erweiterung verweist. Das `Eula` Element ist nur mit Version 2014-04-01 oder höher verfügbar.
PrivacyUri	Gibt einen URI an, der auf die Datenschutzbestimmungen für die Version der Erweiterung verweist. Das `PrivacyUri` Element ist nur mit Version 2014-04-01 oder höher verfügbar.
HomepageUri	Gibt einen URI an, der auf die Startseite für die Version der Erweiterung verweist. Das `HomepageUri` Element ist nur mit Version 2014-04-01 oder höher verfügbar.
IsJsonExtension	Zeigt an, ob die Version der Erweiterung eine JSON-basierte Konfiguration akzeptiert. Mögliche Werte: - `true` - `false` `true`, wenn die Erweiterung eine JSON-basierte Konfiguration akzeptiert, andernfalls `false`, und die Erweiterung akzeptiert dann eine XML-basierte Konfiguration. Das `IsJsonExtension` Element ist nur mit Version 2014-04-01 oder höher verfügbar.
CompanyName	Gibt den Namen der Firma an, die die Erweiterung herausgegeben hat. Das `CompanyName` Element ist nur mit Version 2014-06-01 oder höher verfügbar.
SupportedOS	Gibt das Betriebssystem an, in dem die Erweiterung ausgeführt wird. Das `SupportedOS` Element ist nur mit Version 2014-06-01 oder höher verfügbar.
PublishedDate	Gibt das Veröffentlichungsdatum der Erweiterung an. Das `PublishedDate` Element ist nur mit Version 2014-06-01 oder höher verfügbar.

Freigeben über