Wyświetlanie listy dostępnych rozszerzeń

Artykuł
07/19/2023

Operacja List Available Extensions zawiera listę rozszerzeń dostępnych do dodania do usługi w chmurze. Na platformie Microsoft Azure proces może działać jako rozszerzenie usługi w chmurze.

Żądanie

Żądanie List Available Extensions można określić w następujący sposób. Zastąp ciąg <subscription-id> identyfikatorem subskrypcji.

Metoda	Identyfikator URI żądania
GET	`https://management.core.windows.net/<subscription-id>/services/extensions`

Parametry identyfikatora URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
`x-ms-version`	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na `2013-03-01` lub wyższy.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
`x-ms-request-id`	Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania.

Treść odpowiedzi

W poniższym przykładzie przedstawiono format treści odpowiedzi:

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

W poniższej tabeli opisano elementy treści odpowiedzi.

Nazwa elementu	Opis
ProviderNameSpace	Określa przestrzeń nazw dostawcy rozszerzenia. Przestrzeń nazw dostawcy dla rozszerzeń platformy Azure to `Microsoft.WindowsAzure.Extensions`.
Typ	Określa typ rozszerzenia.
Wersja	Określa wersję rozszerzenia.
Etykieta	Określa etykietę używaną do identyfikowania rozszerzenia.
Opis	Określa opis rozszerzenia.
HostingResources	Określa typ zasobu, który obsługuje rozszerzenie. Ta wartość może mieć `WebRole`wartość , `WorkerRole`lub `WebRole\|WorkerRole`.
Odcisk palcaAlgorithm	Określa algorytm odcisku palca certyfikatu, który jest używany do szyfrowania.
PublicConfigurationSchema	Określa schemat zakodowany w formacie base64 konfiguracji publicznej.
PrivateConfigurationSchema	Określa schemat zakodowany w formacie base64 konfiguracji prywatnej.
SampleConfig	Określa przykładowy plik konfiguracji rozszerzenia zasobu. Element SampleConfig jest dostępny tylko w wersji 2013-11-01 lub nowszej.
ReplikacjaUzupełniona	Wskazuje, czy wersja rozszerzenia została zreplikowana do wszystkich regionów. Możliwe wartości: - `true` - `false` `true` jeśli można użyć wersji rozszerzenia do utworzenia lub zaktualizowania wdrożenia; w przeciwnym razie wskazując, `false` że wersja rozszerzenia nie jest gotowa do użycia we wszystkich regionach. Element `ReplicationCompleted` jest dostępny tylko w wersji 2014-04-01 lub nowszej.
Eula	Określa identyfikator URI wskazujący umowę licencyjną użytkownika końcowego (EULA) dla wersji rozszerzenia. Element `Eula` jest dostępny tylko w wersji 2014-04-01 lub nowszej.
Identyfikator PrivacyUri	Określa identyfikator URI wskazujący zasady zachowania poufności informacji dla wersji rozszerzenia. Element `PrivacyUri` jest dostępny tylko w wersji 2014-04-01 lub nowszej.
Identyfikator uri strony głównej	Określa identyfikator URI wskazujący stronę główną dla wersji rozszerzenia. Element `HomepageUri` jest dostępny tylko w wersji 2014-04-01 lub nowszej.
IsJsonExtension	Wskazuje, czy wersja rozszerzenia akceptuje konfigurację opartą na formacie JSON. Możliwe wartości: - `true` - `false` `true` jeśli rozszerzenie akceptuje konfigurację opartą na formacie JSON; `false` w przeciwnym razie rozszerzenie akceptuje konfigurację opartą na formacie XML. Element `IsJsonExtension` jest dostępny tylko w wersji 2014-04-01 lub nowszej.
CompanyName	Określa nazwę firmy, która opublikowała rozszerzenie. Element `CompanyName` jest dostępny tylko w wersji 2014-06-01 lub nowszej.
Obsługiwany systemOS	Określa system operacyjny, na który działa rozszerzenie. Element `SupportedOS` jest dostępny tylko w wersji 2014-06-01 lub nowszej.
Data publikacji	Określa datę opublikowania rozszerzenia. Element `PublishedDate` jest dostępny tylko w wersji 2014-06-01 lub nowszej.