Modificación de la política de copia de respaldo automatizada
Función
Esta API se utiliza para modificar la política de copia de respaldo automatizada. Antes de invocar a esta API:
![](https://support.huaweicloud.com/intl/es-us/api-gaussdbformysql/public_sys-resources/notice_3.0-es-us.png)
Esta API no estará disponible el 31 de marzo de 2024. Se recomienda cambiar las cargas de trabajo a la nueva API (Modificación de una política de copia respaldo automática) antes de esa fecha.
- Aprender cómo autorizar y autenticarla.
- Obtener los región y punto de conexión requeridos.
URI
- Formato de URI
PUT https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/backups/policy/update
- Ejemplo
PUT https://{endpoint}/mysql/v3/97b026aa9cc4417888c14c84a1ad9860/instances/c3ec2c6148ad4d71b1a8411a62df0d3cin07/backups/policy/update
- Descripción de parámetro
Tabla 1 Descripción de parámetro Nombre
Tipo
Obligatorio
Descripción
project_id
String
Sí
ID de proyecto de un tenant en una región.
Para obtener este valor, consulte Obtención de un ID de proyecto.
instance_id
String
No
ID de instancia de base de datos.
Solicitud
Nombre |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
backup_policy |
object |
Sí |
Información de política de copia de respaldo. Para obtener más información, consulte Tabla 3. |
Nombre |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
keep_days |
Integer |
Sí |
Días de retención de copia de respaldo. El valor varía de 1 a 732. |
start_time |
String |
Sí |
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.
Valor de ejemplo:
|
period |
String |
Sí |
Configuración del ciclo de copia de respaldo. Los datos se respaldarán automáticamente en los días seleccionados cada semana. Intervalo de valores: El valor es un número separado por comas (,), que indica los días de la semana. Por ejemplo, el valor 1,2,3,4 indica que el período de copia de respaldo es lunes, martes, miércoles y jueves. |
retention_num_backup_level1 |
Integer |
No |
Número de copias de respaldo retenidas de nivel 1. El valor predeterminado es 0. Este parámetro es obligatorio cuando la función de copia de respaldo de nivel 1 está habilitada. Este parámetro no está disponible cuando la función de copia de respaldo de nivel 1 está deshabilitada. Valor:
|
- Ejemplo de solicitud
{ "backup_policy": { "keep_days": 7, "start_time": "19:00-20:00", "period": "1,2,3,4,5" } }
Respuesta
- Respuesta normal
Tabla 4 Descripción de parámetro Nombre
Tipo
Descripción
status
String
Estado de la copia de respaldo. Valor:
- BUILDING: Modificación en curso
- COMPLETED: Modificación completada
- FAILED: Error en la modificación
instance_id
String
ID de instancia de base de datos.
instance_name
String
Nombre de instancia de base de datos.
- Ejemplo de respuesta normal
{ "status": "COMPLETED", "instance_id": "ef25188419f941309882d2986b2210b9in07", "instance_name": "gauss-fhc" }
Código de estado
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.