Todos os produtos
Search

Este produto

    PolarDB:DescribeDBClusterVersion

    Central de documentação

    PolarDB:DescribeDBClusterVersion

    Última atualização: Jun 28, 2026

    Obtém os detalhes da versão atual do kernel de um cluster PolarDB for MySQL.

    Descrição da operação

    Nota

    Para obter mais informações sobre as versões do kernel de clusters PolarDB for MySQL, consulte o Guia de versões do kernel e as Notas de versão do kernel.

    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:DescribeDBClusterVersion

    get

    *dbcluster

    acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    DBClusterId

    string

    Sim

    O ID do cluster.

    Nota

    Chame a operação DescribeDBClusters para visualizar os detalhes de todos os clusters em sua conta, como os IDs dos clusters.

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

    8.0
    DBRevisionVersion

    string

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

    Nota

    Para um cluster PolarDB for MySQL 5.6, este parâmetro é retornado apenas quando a data de lançamento da versão de revisão for posterior a 20200831. Caso contrário, este parâmetro estará vazio. Para obter mais informações sobre a versão do kernel de um cluster PolarDB for MySQL, consulte as Notas de versão do kernel.

    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.

    Nota

    Para obter mais informações sobre como atualizar a versão secundária de um banco de dados, consulte Atualizar versões.

    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.

    Nota

    Para obter mais informações sobre como atualizar a versão do proxy do banco de dados, consulte Atualizar versões.

    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>

    Uma 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 revisão do mecanismo de banco de dados. Você pode usar este código para especificar a versão de destino para uma atualização.

    20230707
    RevisionVersionName

    string

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

    8.0.1.1.35.1
    ReleaseNote

    string

    As notas de versão.

    ReleaseNote
    ProxyRevisionVersionList

    array<object>

    Uma lista de versões de proxy atualizáveis.

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

    • Old: Esta versão está desatualizada e não é recomendada para atualizações.

    • HighRisk: Esta versão possui bugs críticos e não é recomendada para atualizações.

    • Beta: Esta é uma versão beta.

    object

    ReleaseType

    string

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

    • LTS: versão com suporte de longo prazo.

    • BETA: versão de visualização.

    LTS
    RevisionVersionCode

    string

    O código da versão de revisão do mecanismo de proxy do banco de dados. Você pode usar este código para especificar a versão de destino para uma atualização.

    20230707
    RevisionVersionName

    string

    A versão de revisão do mecanismo de proxy do banco de dados.

    2.8.24
    ReleaseNote

    string

    As notas de versão.

    ReleaseNote
    DBLatestStableVersion

    string

    2.0.16.13.14.0
    IsLatestStableVersion

    string

    true

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "IsLatestVersion": "true",
  "IsProxyLatestVersion": "true",
  "DBVersion": "8.0",
  "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"
    }
  ],
  "DBLatestStableVersion": "2.0.16.13.14.0",
  "IsLatestStableVersion": "true"
}

    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.