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/ GaussDB(for MySQL)/ Referencia de la API/ Las API (recomendadas)/ Gestión de copias de respaldo/ Modificación de una política de copia respaldo automática
Actualización más reciente 2023-12-14 GMT+08:00
Ver PDF
Compartir

Modificación de una política de copia respaldo automática

Función

Esta API se utiliza para modificar una política de copia de respaldo automatizada. 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, consulte 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

No

String

Token de usuario.

X-Language

No

String

Idioma.
Tabla 3 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

backup_policy

Sí

MysqlBackupPolicy object

Información de la 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.

Valor de ejemplo:

21:00-22:00

keep_days

Sí

Integer

Días de retención de copia de respaldo.

Valor: de 1 a 732

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.

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

No

Integer

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:

  • 0
  • 1

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

status

String

Información de estado.

instance_id

String

ID de instancia.

instance_name

String

Nombre de instancia.

Código de estado: 400

Tabla 6 Parámetros de body 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 body 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 una política de copia de respaldo

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

Success.

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

Respuesta

  • Respuesta normal
    Tabla 8 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.

    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.