VENDAS: 1-800-867-1389

Listar versões da extensão de recurso

Atualizado: julho de 2015

A operação List Resource Extension Versions lista as versões de uma extensão de recurso que estão disponíveis para adicionar a uma Máquina Virtual.

A solicitação List Resource Extension Versions pode ser especificada da seguinte maneira. Substitua <subscription-id> pela ID de assinatura, <publisher-name> pelo nome do editor da extensão de recurso e <extension-name> pelo nome da extensão de recurso.

 

Método URI de solicitação

GET

https://management.core.windows.net/<subscription-id>/services/resourceextensions/<publisher-name>/<extension-name>

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.

Nenhuma.

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 01/11/2013 ou 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"?>
<ResourceExtensions xmlns=”http://schemas.microsoft.com/windowsazure”>
  <ResourceExtension>
    <Publisher>name-of-publisher</Publisher>
    <Name>name-of-extension</Name>    
    <Version>version-of-extension</Version>
    <Label>label-of-extension</Label>
    <Description>description-of-extension</Description>
    <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>
    <ReplicationCompleted>indicator-of-replication-status</ReplicationCompleted>
    <Eula>eula-of-extension</Eula>
    <PrivacyUri>privacy-policy-of-extension</PrivacyUri>
    <HomepageUri>homepage-of-extension</HomepageUri>
    <IsJsonExtension>indicator-of-JSON-support</IsJsonExtension>
    <IsInternalExtension>indication-of-extension-location</IsInternalExtension>
    <DisallowMajorVersionUpgrade>indicator-of-version-upgrade</DisallowMajorVersionUpgrade>
    <CompanyName>name-of-publishing-company</CompanyName>
    <SupportedOS>supported-operating-system</SupportedOS>
    <PublishedDate>publish-date-of-extension</PublishedDate>
  </ResourceExtension>
</ResourceExtensions>

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

 

Nome do elemento Descrição

Publicador

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

Nome

Especifica o nome da extensão.

Versão

Especifica a versão principal e a versão secundária 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.

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.

ReplicationCompleted

Indica se a versão da extensão foi replicada em todas as regiões.

Os possíveis valores são:

  • true

  • false

true se a versão da extensão puder ser usada para criar ou atualizar uma implantação; caso contrário, false, indicando que a versão da extensão não está pronta para ser usada em todas as regiões.

O elemento ReplicationCompleted só estará disponível com a versão 01/04/2014 ou superior.

Eula

Especifica um URI que aponta para o Contrato de Licença de Usuário Final (EULA) da versão da extensão.

O elemento Eula só estará disponível com a versão 01/04/2014 ou superior.

PrivacyUri

Especifica um URI que aponta para a declaração de privacidade da versão da extensão.

O elemento PrivacyUri só estará disponível com a versão 01/04/2014 ou superior.

HomepageUri

Especifica um URI que aponta para a home page da versão da extensão.

O elemento HomepageUri só estará disponível com a versão 01/04/2014 ou superior.

IsJsonExtension

Indica se a versão da extensão aceita uma configuração baseada em JSON.

Os possíveis valores são:

  • true

  • false

true se a extensão aceita uma configuração baseada em JSON; caso contrário, false e a extensão aceita uma configuração baseada em XML.

O elemento IsJsonExtension só estará disponível com a versão 01/04/2014 ou superior.

IsInternalExtension

Indica se a versão da extensão estiver disponível para uso público. Este valor é apenas listado para o publicador da extensão.

Os possíveis valores são:

  • true

  • false

O elemento IsInternalExtension só estará disponível com a versão 01/05/2014 ou superior.

DisallowMajorVersionUpgrade

Indica se a versão da extensão tem suporte para atualizações principais.

  • true

  • false

O elemento DisallowMajorVersionUpgrade só estará disponível com a versão 01/05/2014 ou superior.

CompanyName

Especifica o nome da empresa que publicou a extensão.

O elemento CompanyName só estará disponível com a versão 01/06/2014 ou superior.

SupportedOS

Especifica o sistema operacional no qual a extensão é executada.

O elemento SupportedOS só estará disponível com a versão 01/06/2014 ou superior.

PublishedDate

Especifica a data quando a extensão foi publicada.

O elemento PublishedDate só estará disponível com a versão 01/06/2014 ou superior.

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2015 Microsoft