Listar extensões disponíveis

Artigo
07/19/2023

A operação List Available Extensions lista as extensões que estão disponíveis para adicionar a seu serviço de nuvem. No Microsoft Azure, um processo pode ser executado como uma extensão de um serviço em nuvem.

Solicitação

A solicitação List Available Extensions pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura.

Método	URI da solicitação
GET	`https://management.core.windows.net/<subscription-id>/services/extensions`

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho da solicitação	Descrição
`x-ms-version`	Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. Esse cabeçalho deve ser definido como `2013-03-01` ou superior.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais.

Cabeçalho de Resposta	Descrição
`x-ms-request-id`	Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Corpo da resposta

O exemplo de código a seguir mostra o formato do corpo da resposta:

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

A tabela a seguir descreve os elementos do corpo da resposta.

Nome do elemento	Descrição
ProviderNameSpace	Especifica o namespace do provedor da extensão. O namespace do provedor para extensões do Azure é `Microsoft.WindowsAzure.Extensions`.
Type	Especifica o tipo da extensão.
Versão	Especifica a versão da extensão.
Rótulo	Especifica o rótulo que é usado para identificar a extensão.
Descrição	Especifica a descrição da extensão.
HostingResources	Especifica o tipo de recurso que dá suporte à extensão. Este valor pode ser `WebRole`, `WorkerRole` ou `WebRole\|WorkerRole`.
ThumbprintAlgorithm	Especifica o algoritmo de impressão digital do certificado que é usado para criptografia.
PublicConfigurationSchema	Especifica o esquema codificado em base 64 da configuração pública.
PrivateConfigurationSchema	Especifica o esquema codificado em base 64 da configuração privada.
SampleConfig	Especifica um arquivo de configuração de exemplo para a extensão do recurso. O elemento SampleConfig só estará disponível com a versão 2013-11-01 ou superior.
ReplicationCompleted	Indica se a versão da extensão foi replicada em todas as regiões. Os valores possíveis são: - `true` - `false` `true` se a versão da extensão puder ser usada para criar ou atualizar uma implantação; caso contrário, `false`, indicando que a versão da extensão não está pronta para ser usada em todas as regiões. O `ReplicationCompleted` elemento só está disponível usando a versão 2014-04-01 ou superior.
Eula	Especifica um URI que aponta para o Contrato de Licença de Usuário Final (EULA) da versão da extensão. O `Eula` elemento só está disponível usando a versão 2014-04-01 ou superior.
PrivacyUri	Especifica um URI que aponta para a declaração de privacidade da versão da extensão. O `PrivacyUri` elemento só está disponível usando a versão 2014-04-01 ou superior.
HomepageUri	Especifica um URI que aponta para a home page da versão da extensão. O `HomepageUri` elemento só está disponível usando a versão 2014-04-01 ou superior.
IsJsonExtension	Indica se a versão da extensão aceita uma configuração baseada em JSON. Os valores possíveis são: - `true` - `false` `true` se a extensão aceita uma configuração baseada em JSON; caso contrário, `false` e a extensão aceita uma configuração baseada em XML. O `IsJsonExtension` elemento só está disponível usando a versão 2014-04-01 ou superior.
CompanyName	Especifica o nome da empresa que publicou a extensão. O `CompanyName` elemento só está disponível usando a versão 2014-06-01 ou superior.
SupportedOS	Especifica o sistema operacional no qual a extensão é executada. O `SupportedOS` elemento só está disponível usando a versão 2014-06-01 ou superior.
PublishedDate	Especifica a data quando a extensão foi publicada. O `PublishedDate` elemento só está disponível usando a versão 2014-06-01 ou superior.

Compartilhar via