Listar extensões

Artigo
07/19/2023

A operação List Extensions lista todas as extensões que foram adicionadas a um serviço de nuvem.

Solicitação

A solicitação List Extensions pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura e <cloudservice-name> pelo nome do serviço de nuvem.

Método	URI da solicitação
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/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. O valor desse 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 seguinte exemplo mostra o formato do corpo da solicitação:

  
<?xml version="1.0" encoding="utf-8"?>  
<Extensions xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Extension>  
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
    <Type>type-of-extension</Type>  
    <Id>identifier-of-extension</Id>  
    <Version>version-of-extension</Version>  
    <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
    <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
    <IsJsonExtension>indicator-of-json-support</IsJsonExtension>  
    <DisallowMajorVersionUpgrade>indicator-of-allowed-version-upgrades</DisallowMajorVersionUpgrade>  
  </Extension>  
</Extensions>

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

Nome do elemento	Descrição
ProviderNameSpace	O namespace do provedor da extensão. O namespace do provedor para extensões do Microsoft Azure é `Microsoft.Windows.Azure.Extensions`.
Type	Obrigatórios. O tipo da extensão.
Id	O identificador da extensão.
Versão	A versão da extensão.
Impressão digital	A impressão digital do certificado que é usada para criptografar a configuração especificada em `PrivateConfiguration`. Se esse elemento não for especificado, um certificado poderá ser gerado automaticamente e adicionado ao serviço de nuvem.
ThumbprintAlgorithm	O algoritmo da impressão digital do certificado que é usado para criptografar a configuração especificada em `PrivateConfiguration`.
PublicConfiguration	A configuração pública definida usando o esquema retornado pela operação Listar Extensões Disponíveis .
IsJsonExtension	Indica se a configuração da extensão suporta JSON. Os valores possíveis são: - `true` - `false` O `IsJsonExtension` elemento só está disponível usando a versão 2014-06-01 ou superior.
DisallowMajorVersionUpgrade	Indica se a extensão oferece suporte à atualização automática para as novas versões principais. O `DisallowMajorVersionUpgrade` elemento só está disponível usando a versão 2014-06-01 ou superior.

Compartilhar via