Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de copias de respaldo/ Consulta de una política de copia de respaldo automatizada
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de una política de copia de respaldo automatizada

Función

Esta API se utiliza para consultar una política de copia de respaldo automatizada. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/backups/policy

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, vea Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia, que es compatible con el formato UUID.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

backup_policy

BackupPolicy object

Información de política de copia de respaldo.
Tabla 4 BackupPolicy

Parámetro

Tipo

Descripción

keep_days

Integer

Días de retención de copia de respaldo. Rango de valores: 1–732. También puede ponerse en contacto con el servicio de atención al cliente para ampliar el período de retención a 3,660 días.

  • Valor mínimo: 1
  • Valor máximo: 732

start_time

String

Ventana de tiempo de copia de respaldo. Las copias de respaldo automatizadas se activarán durante la ventana de tiempo de copia de respaldo.

El valor debe ser un valor válido en el formato "hh:mm-HH:MM". La hora actual está en el formato UTC.

period

String

Configuración del ciclo de copia de respaldo. Los datos se respaldarán automáticamente en los días seleccionados cada semana.

El valor es una lista de números separados por comas (,), donde cada número más uno representa un día de la semana para copias de respaldo automatizadas.

Por ejemplo, 1,2,3,4,5,6,7 indica que los datos se respaldan todos los días de martes a lunes.

retention_num_backup_level1

Integer

Número de copias de respaldo retenidas de nivel 1. Este parámetro se devuelve cuando se habilita la copia de respaldo de nivel 1.

Código de estado: 400

Tabla 5 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 6 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Solicitud de ejemplo

Consulta de la política de copia de respaldo automatizada de una instancia de BD

GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/61a4ea66210545909d74a05c27a7179ein07/backups/policy

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "backup_policy" : {
    "keep_days" : "7,",
    "start_time" : "19:00-20:00",
    "period" : "1,2",
    "retention_num_backup_level1" : 1
  }
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.