Перечисление доступных расширений

Статья
07/19/2023

Операция List Available Extensions перечисляет расширения, доступные для добавления к облачной службе. В Microsoft Azure процесс может выполняться как расширение облачной службы.

Запрос

Запрос List Available Extensions можно указать следующим образом. Замените <subscription-id> идентификатором своей подписки.

Метод	Универсальный код ресурса (URI) запроса
GET	`https://management.core.windows.net/<subscription-id>/services/extensions`

Параметры URI

Нет.

Заголовки запросов

В следующей таблице описаны заголовки запросов.

Заголовок запроса	Описание
`x-ms-version`	Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь значение `2013-03-01` или выше.

Текст запроса

Нет.

Ответ

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Код состояния

Успешная операция возвращает код состояния 200 (ОК).

Заголовки откликов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP.

Заголовок ответа	Описание
`x-ms-request-id`	Значение, которое однозначно определяет запрос к службе управления.

Текст ответа

В следующем примере показан формат текста ответа.

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

В следующей таблице описаны элементы текста ответа.

Имя элемента	Описание
ProviderNameSpace	Указывает пространство имен поставщика расширения. Пространство имен поставщика для расширений Azure —`Microsoft.WindowsAzure.Extensions`.
Тип	Указывает тип расширения.
Версия	Указывает версию расширения.
Метка	Указывает метку, используемую для обозначения расширения.
Описание	Указывает описание расширения.
HostingResources	Указывает тип ресурса, поддерживающего расширение. Это значение может быть `WebRole`, `WorkerRole` или `WebRole\|WorkerRole`.
ThumbprintAlgorithm	Определяет алгоритм отпечатка сертификата, который используется для шифрования.
PublicConfigurationSchema	Указывает схему открытой конфигурации в кодировке base-64.
PrivateConfigurationSchema	Указывает схему закрытой конфигурации в кодировке base-64.
SampleConfig	Указывает образец файла конфигурации для расширения ресурса. Элемент SampleConfig доступен только при использовании версии 2013-11-01 или более поздней версии.
ReplicationCompleted	Указывает, реплицирована ли версия расширения во все регионы. Возможны следующие значения: - `true` - `false` Значение `true`, если версия расширения может использоваться для создания или обновления развертывания; в противном случае — значение `false`, указывающее, что версия расширения не готова для использования во всех регионах. Элемент `ReplicationCompleted` доступен только в версии 2014-04-01 или более поздней.
Eula	Задает URI, который указывает лицензионное соглашение (EULA) для этой версии расширения. Элемент `Eula` доступен только в версии 2014-04-01 или более поздней.
PrivacyUri	Задает URI, который указывает заявление о конфиденциальности для этой версии расширения. Элемент `PrivacyUri` доступен только в версии 2014-04-01 или более поздней.
HomepageUri	Задает URI, который указывает домашнюю страницу для этой версии расширения. Элемент `HomepageUri` доступен только в версии 2014-04-01 или более поздней.
IsJsonExtension	Указывает, принимает ли версия расширения конфигурацию на основе JSON. Возможны следующие значения: - `true` - `false` Значение `true`, если расширение принимает конфигурацию на основе JSON; в противном случае — значение `false`, означающее, что расширение принимает конфигурацию на основе XML. Элемент `IsJsonExtension` доступен только в версии 2014-04-01 или более поздней.
CompanyName	Указывает название компании, опубликовавшей расширение. Элемент `CompanyName` доступен только в версии 2014-06-01 или более поздней.
SupportedOS	Указывает операционную систему, на которой выполняется расширение. Элемент `SupportedOS` доступен только в версии 2014-06-01 или более поздней.
PublishedDate	Указывает дату публикации расширения. Элемент `PublishedDate` доступен только в версии 2014-06-01 или более поздней.

Поделиться через