Adicionar extensão

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

Solicitação

A solicitação Add Extension 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
POST	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. Esse cabeçalho deve ser definido como 2013-03-01 ou uma versão posterior.

Corpo da solicitação

O seguinte exemplo mostra o formato do corpo da solicitação:

  
<?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 a seguir descreve os elementos do corpo da solicitação.

Nome do elemento	Descrição
ProviderNameSpace	Obrigatórios. Especifica o namespace do provedor da extensão. O namespace do provedor para extensões do Azure é Microsoft.Windows.Azure.Extensions.
Type	Obrigatórios. Especifica o tipo da extensão.
Id	Obrigatórios. Especifica o identificador da extensão.
Impressão digital	Opcional. Especifica 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	Opcional. Especifica o algoritmo de impressão digital do certificado que é usado para criptografar a configuração especificada em PrivateConfiguration.
PublicConfiguration	Opcional. Especifica a configuração pública definida usando o esquema retornado pela operação Listar Extensões Disponíveis .
PrivateConfiguration	Opcional. Especifica a configuração privada definida usando o esquema retornado pela operação Listar Extensões Disponíveis .
Versão	Opcional. Especifica a versão da extensão. Se esse elemento não for especificado ou um asterisco (*) for usado como o valor, a versão mais recente da extensão será usada. Se o valor for especificado com um número da 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 está selecionada. Se um número de versão principal e um número de versão secundária forem especificados (X.Y), a versão de extensão específica será selecionada. Se uma versão for especificada, uma atualização automática será executada na instância de função.

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

Corpo da resposta

Nenhum.