Listar Versões da Extensão

Artigo
07/19/2023

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

Pedir

O List Extension Versions pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo seu ID de subscrição, <provider-namespace> pelo espaço de nomes da extensão e <type> pelo tipo de extensão.

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

Parâmetros do URI

Nenhum.

Cabeçalhos do 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 no 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 para extensões do Microsoft Azure é `Microsoft.WindowsAzure.Extensions`.
Tipo	Especifica o tipo da extensão.
Versão	Especifica a versão principal e a versão secundária 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 utilizado para encriptação.
PublicConfigurationSchema	Especifica o esquema codificado com base64 da configuração pública.
PrivateConfigurationSchema	Especifica o esquema codificado com 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` indicando 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 de 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 com a 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 com a versão 2014-06-01 ou superior.
PublishedDate	Especifica a data em que a extensão foi publicada. O `PublishedDate` elemento só está disponível com a versão 2014-06-01 ou superior.