Consulta do intervalo de tempo de restauração
Função
Essa API é usada para consultar o intervalo de tempo de restauração de uma instância. 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}/restore-time
| 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âmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| date | Não | String | Data a ser consultada. O valor está no formato "aaaa-mm-dd" e o fuso horário é UTC. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Sim | String | Token do usuário. Para obter esse valor, chame a API do IAM para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token. |
| X-Language | Não | String | Tipo de linguagem da solicitação. O valor padrão é en-us. Valores:
|
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| restore_times | Array of RestoreTimeInfo objects | Intervalos de tempo de restauração. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| start_time | Integer | Hora de início do intervalo de tempo de restauração no formato de carimbo de data/hora UNIX. A unidade é milissegundo e o fuso horário é UTC. |
| end_time | Integer | Hora de término do intervalo de tempo de restauração no formato de carimbo de data/hora UNIX. A unidade é milissegundo e o fuso horário é UTC. |
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 do intervalo de tempo de restauração da instância de BD em 31 de janeiro de 2023
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/restore-time?date=2023-01-31 Exemplo de resposta
Código de status: 200
Bem-sucedido.
{
"restore_times" : [ {
"start_time" : 1675149246000,
"end_time" : 1675094400000
} ]
} Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.