Adicionar Extensão

A Add Extension operação assíncrona adiciona uma extensão disponível ao seu serviço cloud. No Microsoft Azure, um processo pode ser executado como uma extensão de um serviço cloud.

Pedir

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

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

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 para ou para 2013-03-01 uma versão posterior.

Corpo do Pedido

O exemplo seguinte mostra o formato do corpo do pedido:

  
<?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>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>  
  <Version>version-of-extension</Version>  
</Extension>  

A tabela seguinte descreve os elementos do corpo do pedido.

Nome do elemento	Descrição
ProviderNameSpace	Obrigatório. Especifica o espaço de nomes do fornecedor da extensão. O espaço de nomes do fornecedor para extensões do Azure é Microsoft.Windows.Azure.Extensions.
Tipo	Obrigatório. Especifica o tipo da extensão.
Id	Obrigatório. Especifica o identificador da extensão.
Thumbprint	Opcional. Especifica o thumbprint do certificado que é 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	Opcional. Especifica o algoritmo thumbprint do certificado que é utilizado para encriptar a configuração especificada em PrivateConfiguration.
PublicConfiguration	Opcional. Especifica a configuração pública definida com o esquema devolvido pela operação List Available Extensions .
PrivateConfiguration	Opcional. Especifica a configuração privada que é definida com o esquema devolvido pela operação List Available Extensions .
Versão	Opcional. Especifica a versão da extensão. Se este elemento não for especificado ou um asterisco (*) for utilizado como o valor, é utilizada a versão mais recente da extensão. Se o valor for especificado com um número de versão principal e um asterisco como o número da versão secundária (X.*), a versão secundária mais recente da versão principal especificada será selecionada. Se for especificado um número de versão principal e um número de versão secundária (X.Y), a versão específica da extensão será selecionada. Se for especificada uma versão, é efetuada uma atualização automática na instância de função.

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. Para uma operação assíncrona, pode chamar Obter Estado da Operação com o valor do cabeçalho para determinar se a operação está concluída, falhou ou ainda está em curso.

Corpo da Resposta

Nenhum.