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/ Configuración de una política de copia de respaldo de la misma región
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Configuración de una política de copia de respaldo de la misma región

Función

Esta API se utiliza para configurar una política de copia de respaldo de la misma región. Antes de invocar a esta API:

URI

PUT /v3/{project_id}/instances/{instance_id}/backups/policy/update

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
Tabla 3 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

backup_policy

Sí

MysqlBackupPolicy object

Política de copia de respaldo de base de datos.
Tabla 4 MysqlBackupPolicy

Parámetro

Obligatorio

Tipo

Descripción

start_time

Sí

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 no puede estar vacío. Debe ser un valor válido en el formato "hh:mm-HH:MM". La hora actual está en el formato UTC.

  • El valor HH debe ser 1 mayor que el valor hh.
  • Los valores de mm y MM deben ser los mismos y deben establecerse en 00.

Ejemplo: 21:00–22:00

keep_days

Sí

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.

period

Sí

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

No

Integer

Número de copias de respaldo retenidas de nivel 1. El valor puede ser 0 o 1. El valor predeterminado es 0. Este parámetro solo es necesario cuando la función copia de respaldo de nivel 1 está habilitada.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

status

String

Información de estado. Valores:

  • BUILDING: Modificación en curso
  • COMPLETED: Modificación completada
  • FAILED: Error en la modificación

instance_id

String

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

instance_name

String

Nombre de instancia.

Código de estado: 400

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.

Código de estado: 500

Tabla 7 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

Modificación de la política de copia de respaldo automatizada de la instancia de BD (los datos se respaldan de 19:00 a 20:00 todos los lunes a viernes. Los archivos de copia de respaldo se conservan durante siete días).

PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/backups/policy/update
{
  "backup_policy" : {
    "keep_days" : 7,
    "start_time" : "19:00-20:00",
    "period" : "1,2,3,4,5"
  }
}

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "status" : "COMPLETED",
  "instance_id" : "ba62a0b83a1b42bfab275829d86ac0fdin07",
  "instance_name" : "gauss-mysql"
}

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.