Exportar (0) Imprimir
Expandir Tudo

Listar extensões disponíveis

Atualizado: abril de 2014

A operação List Available Extensions lista as extensões que estão disponíveis para adicionar a seu serviço de nuvem. No Windows Azure, um processo pode ser executado como uma extensão de um serviço de nuvem. Por exemplo, o Acesso à Área de Trabalho Remota ou o Agente de Diagnóstico do Windows Azure podem ser executados como extensões para o serviço de nuvem.

A solicitação List Available Extensions pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura.

 

Método URI de solicitação Versão HTTP

GET

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

HTTP/1.1

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 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.

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 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.

O exemplo de código a seguir mostra o formato do corpo da resposta:


<?xml version="1.0" encoding="utf-8"?>
<ExtensionImages xmlns=”http://schemas.microsoft.com/windowsazure”>
  <ExtensionImage>
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>
    <Type>type-of-extension</Type>    
    <Version>version-of-extension</Version>
    <Label>label-of-extension</Label>
    <Description>description-of-extension</Description>
    <HostingResources>role-type</HostingResources>
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>
    <PublicConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PublicConfigurationSchema>
    <PrivateConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PrivateConfigurationSchema>
    <SampleConfig>base-64-encoded-sample-XML-for-extension</SampleConfig>
  </ExtensionImage>
</ExtensionImages>

A tabela a seguir descreve os principais elementos do corpo da resposta.

 

Nome do elemento Descrição

ProviderNameSpace

Especifica o namespace do provedor da extensão. O namespace do provedor para extensões do Windows Azure é Microsoft.WindowsAzure.Extensions.

Tipo

Especifica o tipo da extensão.

Versão

Especifica a versão da extensão.

Rótulo

Especifica o rótulo que é usado para identificar a extensão.

Descrição

Especifica a descrição da extensão.

HostingResources

Especifica o tipo de recurso que dá suporte à extensão. Esse valor pode ser WebRole, WorkerRole ou WebRole|WorkerRole.

ThumbprintAlgorithm

Especifica o algoritmo de impressão digital do certificado que é usado para criptografia.

PublicConfigurationSchema

Especifica o esquema codificado em base 64 da configuração pública.

PrivateConfigurationSchema

Especifica o esquema codificado em base 64 da configuração privada.

SampleConfig

Especifica um arquivo de configuração de exemplo para a extensão do recurso.

O elemento SampleConfig só estará disponível com a versão 2013-11-01 ou superior.

Qualquer certificado de gerenciamento associado à assinatura especificada por <subscription-id> pode ser usado para autenticar esta operação. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Para adicionar extensões a um serviço de nuvem, consulte Adicionar extensão.

Mostrar:
© 2014 Microsoft