Listar Extensões Disponíveis

Artigo
08/05/2023

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

Pedir

O List Available Extensions pedido pode ser especificado da seguinte forma. Substitua pelo <subscription-id> seu ID de subscrição.

Método	URI do pedido
GET	`https://management.core.windows.net/<subscription-id>/services/extensions`

Parâmetros do URI

Nenhum.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido	Description
`x-ms-version`	Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como `2013-03-01` ou superior.

Corpo do Pedido

Nenhum.

Resposta

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

Código de Estado

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

Cabeçalhos de Resposta

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

Cabeçalho de Resposta	Description
`x-ms-request-id`	Um valor que identifica exclusivamente um pedido feito relativamente ao serviço de gestão.

Corpo da Resposta

O exemplo seguinte 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 seguinte descreve os elementos do corpo da resposta.

Nome do elemento	Descrição
ProviderNameSpace	Especifica o espaço de nomes do fornecedor da extensão. O espaço de nomes do fornecedor das extensões do Azure é `Microsoft.WindowsAzure.Extensions`.
Tipo	Especifica o tipo da extensão.
Versão	Especifica a versão da extensão.
Etiqueta	Especifica a etiqueta utilizada para identificar a extensão.
Description	Especifica a descrição da extensão.
HostingResources	Especifica o tipo de recurso que suporta a extensão. Este valor pode ser `WebRole`, `WorkerRole`ou `WebRole\|WorkerRole`.
ThumbprintAlgorithm	Especifica o algoritmo thumbprint do certificado que é utilizado para encriptação.
PublicConfigurationSchema	Especifica o esquema codificado em base64 da configuração pública.
PrivateConfigurationSchema	Especifica o esquema codificado em base64 da configuração privada.
SampleConfig	Especifica um ficheiro de configuração de exemplo para a extensão de recurso. O elemento SampleConfig só está disponível com a versão 2013-11-01 ou superior.
ReplicationCompleted	Indica se a versão da extensão foi replicada para todas as regiões. Os valores possíveis são: - `true` - `false` `true` se a versão da extensão puder ser utilizada para criar ou atualizar uma implementação; caso contrário, `false` indica que a versão da extensão não está pronta para ser utilizada em todas as regiões. O `ReplicationCompleted` elemento só está disponível com a versão 2014-04-01 ou superior.
Eula	Especifica um URI que aponta para o Contrato de Licença do Utilizador Final (EULA) para a versão da extensão. O `Eula` elemento só está disponível com a versão 2014-04-01 ou superior.
PrivacyUri	Especifica um URI que aponta para a declaração de privacidade para a versão da extensão. O `PrivacyUri` elemento só está disponível com a versão 2014-04-01 ou superior.
HomepageUri	Especifica o URI que aponta para a home page para a versão da extensão. O `HomepageUri` elemento só está disponível com 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 aceitar uma configuração baseada em JSON; caso contrário, `false` a extensão aceita uma configuração baseada em XML. O `IsJsonExtension` elemento só está disponível com 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 através da versão 2014-06-01 ou superior.
SupportedOS	Especifica o sistema operativo no qual a extensão é executada. O `SupportedOS` elemento só está disponível através da versão 2014-06-01 ou superior.
Data De Publicação	Especifica a data em que a extensão foi publicada. O `PublishedDate` elemento só está disponível através da versão 2014-06-01 ou superior.