Obter Extensão

A Get Extension operação obtém informações sobre uma extensão especificada que foi adicionada a um serviço cloud.

Pedir

O Get Extension pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo seu ID de subscrição, <cloudservice-name> pelo nome do serviço cloud e <extensionId> pelo identificador que foi atribuído à extensão quando foi adicionado ao serviço cloud.

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

Parâmetros do URI

Nenhum.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

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 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 da resposta:

  
<?xml version="1.0" encoding="utf-8"?>  
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <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>  
  

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.