Consulta da versão do kernel
Função
Essa API é usada para consultar a versão do kernel de uma instância de BD. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
GET /v3/{project_id}/instances/{instance_id}/database-version
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
instance_id |
Sim |
String |
ID da instância, que é compatível com o formato UUID. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token. |
X-Language |
Não |
String |
Tipo de linguagem da solicitação. O valor padrão é en-us. Valor:
|
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
datastore |
InstanceDatabaseVersionInfo object |
Informações sobre a versão do BD. |
upgrade_flag |
Boolean |
Se a versão pode ser atualizada.
|
Parâmetro |
Tipo |
Descrição |
---|---|---|
current_version |
String |
Versão atual do banco de dados. |
current_kernel_version |
String |
Versão atual do kernel do banco de dados. |
latest_version |
String |
Versão mais recente do banco de dados. |
latest_kernel_version |
String |
Última versão do kernel. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitação
Consulta da versão do kernel de uma instância de BD
GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/database-version
Exemplo de resposta
Código de status: 200
Bem-sucedido.
{ "datastore" : { "current_version" : "8.0.22", "current_kernel_version" : "2.0.28.15", "latest_version" : "8.0.22", "latest_kernel_version" : "2.0.42.230600" }, "upgrade_flag" : true }
Código de status
Código de status |
Descrição |
---|---|
200 |
Bem-sucedido. |
400 |
Erro do cliente. |
500 |
Erro no servidor. |
Código de erro
Para obter detalhes, consulte Códigos de erro.