Consulta de informações sobre uma política de backup entre regiões
Função
Esta API é usada para consultar informações sobre uma política de backup entre regiões na região de backup de origem.
- Antes de chamar uma API, você precisa entender a API em Autenticação.
URI
- Formato de URI
GET /v3/{project_id}/instances/{instance_id}/backups/offsite-policy
- Descrição do parâmetro
Tabela 1 Descrição do parâmetro Nome
Obrigatório
Descrição
project_id
Sim
Especifica o ID do projeto de um locatário em uma região.
Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id
Sim
Especifica o ID da instância de banco de dados.
Solicitação
Resposta
- Resposta normal
Tabela 2 Descrição do parâmetro Nome
Tipo
Descrição
policy_para
Array of objects
Indica o objeto de política de backup, incluindo o tipo de backup, os dias de retenção de backup, o ID da região de destino e o ID do projeto de destino.
Para mais detalhes, consulte Tabela 3.
Tabela 3 Descrição da estrutura de dados do campo policy_para Nome
Tipo
Descrição
backup_type
String
Indica o tipo de backup. O valor pode ser qualquer um dos seguintes:
- auto: backup completo automático
- incremental: backup incremental automático
- manual: backup manual (retornado apenas para instâncias de banco de dados do RDS for SQL Server)
keep_days
Integer
Indica o número de dias para reter os arquivos de backup.
destination_region
String
Indica o ID da região de destino para a política de backup entre regiões.
destination_project_id
String
Indica o ID do projeto de destino para a política de backup entre regiões.
- Exemplo de resposta normal
Quando a política de backup estiver desativada:
{ "policy_para": { "keep_days": 0 } }
Quando a política de backup automático e a política de backup incremental estão ativadas para instâncias de banco de dados RDS for MySQL e RDS for PostgreSQL:{ "policy_para": [ { "keep_days": 7, "backup_type": "auto", "destination_region": "aaa", "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9" }, { "keep_days": 7, "backup_type": "incremental", "destination_region": "aaa", "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9" } ] }
Quando a política de backup automático, a política de backup incremental e a política de backup manual estão ativadas para instâncias de banco de dados do RDS for SQL Server:{ "policy_para": [ { "keep_days": 7, "backup_type": "incremental", "destination_region": "aaa", "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9" }, { "keep_days": 7, "backup_type": "manual", "destination_region": "aaa", "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9" }, { "keep_days": 7, "backup_type": "auto", "destination_region": "aaa", "destination_project_id": "0503fd7f7580d3262fc5c001170fbab9" } ] }
- Resposta anormal
para mais detalhes, consulte Resultados anormais da solicitação.
Código de status
- Normal
- Anormal
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.