Consulta de información acerca de una política de copia de respaldo entre regiones
Función
Esta API se utiliza para consultar información sobre una política de copia de respaldo entre regiones en la región de copia de respaldo de origen.
- Antes de invocar a una API, debe entender la API de Autenticación.
URI
- Formato de URI
GET /v3/{project_id}/instances/{instance_id}/backups/offsite-policy
- Descripción de parámetro
Tabla 1 Descripción de parámetro Nombre
Obligatorio
Descripción
project_id
Sí
Especifica el ID de proyecto de un tenant en una región.
Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
instance_id
Sí
Especifica el ID de instancia de base de datos.
Solicitud
Respuesta
- Respuesta normal
Tabla 2 Descripción de parámetro Nombre
Tipo
Descripción
policy_para
Array of objects
Indica el objeto de política de copia de respaldo, incluido el tipo de copia de respaldo, los días de retención de la copia de respaldo, el ID de región de destino y el ID del proyecto de destino.
Para obtener más información, véase Tabla 3.
Tabla 3 descripción de la estructura de datos del campo policy_para Nombre
Tipo
Descripción
backup_type
String
Indica el tipo de copia de respaldo. Su valor puede ser cualquiera de los siguientes:
- auto: copia de respaldo completa automatizada
- incremental: copia de respaldo incremental automatizada
- manual: copia de respaldo manual (devuelta sólo para instancias de base de datos de RDS for SQL Server)
keep_days
Integer
Indica el número de días para conservar los archivos de copia de respaldo.
destination_region
String
Indica el ID de región de destino para la política de copia de respaldo entre regiones.
destination_project_id
String
Indica el ID del proyecto de destino para la política de copia de respaldo entre regiones.
- Ejemplo de respuesta normal
Cuando la política de copia de respaldo está desactivada:
{ "policy_para": { "keep_days": 0 } }
Cuando tanto la política de copia de respaldo automatizada como la política de copia de respaldo incremental están habilitadas para instancias de base de datos de RDS for MySQL y 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" } ] }
Cuando la política de copia de respaldo automatizada, la política de copia de respaldo incremental y la política de copia de respaldo manual están habilitadas para instancias de base de datos de 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" } ] }
- Respuesta anormal
Para obtener más información, consulte Resultados de solicitud anormales.
Código de estado
- Normal
- Anormal
Para obtener más información, consulte Códigos de estado.
Código de error
Para obtener más información, consulte Códigos de error.