Adicionar extensão

Adicionar extensão

 

O Add Extension operação assíncrona adiciona uma extensão disponível ao serviço de nuvem. No Microsoft Azure, um processo pode ser executado como uma extensão de um serviço em nuvem. Você pode encontrar a extensão disponível usando o Listar extensões disponíveis operação.

O Add Extension solicitação pode ser especificada da seguinte maneira. Substitua <subscription-id> pela sua ID de assinatura e <cloudservice-name> com o nome do serviço em 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 solicitações de gerenciamento de serviço de autenticação.

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

Cabeçalho de solicitação

Descrição

x-ms-version

Obrigatório. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 2013-03-01 ou uma versão posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte o controle de versão do serviço de gerenciamento.

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ório. Especifica o namespace do provedor da extensão. O namespace do provedor 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.

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 pelo Listar extensões disponíveis operação.

PrivateConfiguration

Opcional. Especifica a configuração privada que é definida usando o esquema retornado pelo Listar extensões disponíveis operação.

Versão

Opcional. Especifica a versão da extensão. Se esse elemento não for especificado ou um asterisco (*) é usado como o valor, a versão mais recente da extensão será usado. Se o valor for especificado com um número de versão principal e um asterisco como o número de versão secundária (X.*), a versão secundária mais recente da versão principal especificada está selecionada. Se for especificados um número de versão principal e um número de versão secundária (X.Y), a versão da extensão específica está 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 do 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 a 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 for concluída, falhou ou ainda está em andamento.

Mostrar:
© 2016 Microsoft