Todos os produtos
Search

Este produto

    PolarDB:DescribeDBClusterVersionZonal

    Central de documentação

    PolarDB:DescribeDBClusterVersionZonal

    Última atualização: Jun 28, 2026

    Consulta a versão de um cluster de borda do PolarDB.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    polardb:DescribeDBClusterVersionZonal

    get

    *All Resource

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    GET  HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    DBClusterId

    string

    Sim

    O ID do cluster.

    pc-****************
    DescribeType

    string

    Não

    Especifica se devem ser retornadas informações sobre a versão mais recente ou uma lista de versões atualizáveis. Valores válidos:

    • LATEST_VERSION: Consulta informações sobre a versão mais recente.

    • AVAILABLE_VERSION: Consulta a lista de versões atualizáveis.

    LATEST_VERSION

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    IsLatestVersion

    string

    Indica se a versão atual do kernel do banco de dados é a versão mais recente. Valores válidos:

    • true

    • false

    true
    IsProxyLatestVersion

    string

    Indica se a versão atual do proxy do banco de dados é a versão mais recente. Valores válidos:

    • true

    • false

    true
    DBVersion

    string

    A versão principal do mecanismo de banco de dados. Valores válidos:

    • 8.0

    • 5.7

    • 5.6

    5.6
    DBRevisionVersion

    string

    A versão de patch do mecanismo de banco de dados.

    8.0.1.1.7
    RequestId

    string

    O ID da solicitação.

    47921222-0D37-4133-8C0D-017DC3******
    DBVersionStatus

    string

    O status da versão secundária atual do banco de dados. Valores válidos:

    • Stable: A versão atual é estável.

    • Old: A versão atual está desatualizada. Atualize para a versão mais recente.

    • HighRisk: A versão atual possui bugs críticos. Atualize para a versão mais recente imediatamente.

    • Beta: A versão atual é uma versão beta.

    Stable
    DBClusterId

    string

    O ID do cluster.

    pc-****************
    DBMinorVersion

    string

    A versão secundária do mecanismo de banco de dados.

    • Se DBVersion for 8.0, os valores válidos são:

      • 8.0.2

      • 8.0.1

    • Se DBVersion for 5.7, o valor é 5.7.28.

    • Se DBVersion for 5.6, o valor é 5.6.16.

    8.0.1
    ProxyRevisionVersion

    string

    A versão do proxy do banco de dados.

    2.4.15
    ProxyVersionStatus

    string

    O status da versão do proxy do banco de dados. Valores válidos:

    • Stable: A versão atual é estável.

    • Old: A versão atual está desatualizada. Atualize para a versão mais recente.

    • HighRisk: A versão atual possui bugs críticos. Atualize para a versão mais recente imediatamente.

    • Beta: A versão atual é uma versão beta.

    Stable
    ProxyLatestVersion

    string

    A versão mais recente do proxy do banco de dados.

    2.4.17
    DBLatestVersion

    string

    A versão mais recente do kernel do banco de dados.

    8.0.1.1.16
    DBRevisionVersionList

    array<object>

    A lista de versões atualizáveis.

    object

    ReleaseType

    string

    O status de lançamento da versão do banco de dados. Valores válidos:

    • Stable: A versão atual é estável.

    • Old: A versão atual está desatualizada. Não atualize para esta versão.

    • HighRisk: A versão atual possui bugs críticos. Não atualize para esta versão.

    • Beta: A versão atual é uma versão beta.

    Stable
    RevisionVersionCode

    string

    O código da versão de patch do mecanismo de banco de dados. Use este código para especificar a versão de destino para uma atualização.

    20230707
    RevisionVersionName

    string

    A versão de patch do mecanismo de banco de dados.

    8.0.1.1.35.1
    ReleaseNote

    string

    As notas de lançamento.

    ReleaseNote
    ProxyRevisionVersionList

    array<object>

    A lista de versões atualizáveis do proxy do banco de dados.

    • Stable: A versão atual é estável.

    • Old: A versão atual está desatualizada. Não atualize para esta versão.

    • HighRisk: A versão atual possui bugs críticos. Não atualize para esta versão.

    • Beta: A versão atual é uma versão beta.

    object

    ReleaseType

    string

    O tipo de lançamento. Valores válidos:

    • LTS: Versão com suporte de longo prazo (LTS).

    • BETA: Versão de pré-visualização.

    LTS
    RevisionVersionCode

    string

    O código da versão de patch do proxy do banco de dados. Use este código para especificar a versão de destino para uma atualização.

    20230707
    RevisionVersionName

    string

    A versão de patch do proxy do banco de dados.

    2.8.24
    ReleaseNote

    string

    As notas de lançamento.

    ReleaseNote

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "IsLatestVersion": "true",
  "IsProxyLatestVersion": "true",
  "DBVersion": "5.6",
  "DBRevisionVersion": "8.0.1.1.7",
  "RequestId": "47921222-0D37-4133-8C0D-017DC3******",
  "DBVersionStatus": "Stable",
  "DBClusterId": "pc-****************",
  "DBMinorVersion": "8.0.1",
  "ProxyRevisionVersion": "2.4.15",
  "ProxyVersionStatus": "Stable",
  "ProxyLatestVersion": "2.4.17",
  "DBLatestVersion": "8.0.1.1.16",
  "DBRevisionVersionList": [
    {
      "ReleaseType": "Stable",
      "RevisionVersionCode": "20230707",
      "RevisionVersionName": "8.0.1.1.35.1",
      "ReleaseNote": "ReleaseNote"
    }
  ],
  "ProxyRevisionVersionList": [
    {
      "ReleaseType": "LTS",
      "RevisionVersionCode": "20230707",
      "RevisionVersionName": "2.8.24",
      "ReleaseNote": "ReleaseNote"
    }
  ]
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.
    400 InvalidDBVersion.Malformed The Specified DBVersion is not valid. The specified DBVersion parameter is invalid.
    400 InvalidEngineVersion.Older The primary cluster version is too old, please upgrade it. The version of the primary cluster instance is out-of-date. Please upgrade the instance version.
    404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. The specified DBClusterId parameter does not exist in the current record.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.