Listar Extensões

Artigo
08/05/2023

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

Pedir

O List Extensions pedido pode ser especificado da seguinte forma. Substitua pelo <subscription-id> seu ID de subscrição e <cloudservice-name> pelo nome do serviço cloud.

Método	URI do pedido
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/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. O valor deste cabeçalho tem de 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 do pedido:

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

Nome do elemento	Descrição
ProviderNameSpace	O espaço de nomes do fornecedor da extensão. O espaço de nomes do fornecedor das extensões do Microsoft Azure é `Microsoft.Windows.Azure.Extensions`.
Tipo	Obrigatório. O tipo da extensão.
Id	O identificador da extensão.
Versão	A versão da extensão.
Thumbprint	O thumbprint do certificado utilizado para encriptar a configuração especificada em `PrivateConfiguration`. Se este elemento não for especificado, um certificado poderá ser gerado e adicionado automaticamente ao serviço cloud.
ThumbprintAlgorithm	O algoritmo thumbprint do certificado que é utilizado para encriptar a configuração especificada em `PrivateConfiguration`.
PublicConfiguration	A configuração pública que é definida com o esquema devolvido pela operação Lista de 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 através da versão 2014-06-01 ou superior.
DisallowMajorVersionUpgrade	Indica se a extensão suporta a atualização automática para novas versões principais. O `DisallowMajorVersionUpgrade` elemento só está disponível através da versão 2014-06-01 ou superior.

Partilhar via