Exportar (0) Imprimir
Expandir Tudo

Adicionar extensão

Atualizado: setembro de 2014

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. Você pode localizar a extensão disponível usando a operação Listar extensões disponíveis.

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 de solicitação

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 1/3/2013 ou por uma versão posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviç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ória. Especifica o namespace do provedor da extensão. O namespace do provedor para extensões do Azure é Microsoft.Windows.Azure.Extensions.

Tipo

Obrigatória. Especifica o tipo da extensão.

Id

Obrigatória. 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 que é definida usando o esquema retornado pela operação Listar extensões disponíveis.

PrivateConfiguration

Opcional. Especifica a configuração privada que é 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.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

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, se falhou ou se ainda está em andamento.

Mostrar:
© 2015 Microsoft