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/ Creación de una copia de respaldo manual

Actualización más reciente 2023-12-14 GMT+08:00

Ver PDF

Creación de una copia de respaldo manual

Función

Esta API se utiliza para crear una copia de respaldo manual. Antes de invocar a esta API:

Aprender cómo autorizar y autenticarla.
Obtener los región y punto de conexión requeridos.

URI

POST /v3/{project_id}/backups/create

**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.

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
instance_id	Sí	String	ID de instancia, que es compatible con el formato UUID.
name	Sí	String	Nombre de copia de respaldo. El valor debe tener entre 4 y 64 caracteres y empezar con una letra. Distingue mayúsculas y minúsculas y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_).
description	No	String	Descripción de copia de respaldo. Contiene un máximo de 256 caracteres y no puede contener los caracteres especiales (>!<"&'=)

Parámetros de respuesta

Código de estado: 201

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
backup	backup object	Información de copia de respaldo.
job_id	String	ID de tarea.

**Tabla 5** backup
Parámetro	Tipo	Descripción
id	String	ID de copia de respaldo.
name	String	Nombre de copia de respaldo.
description	String	Descripción de copia de respaldo.
begin_time	String	La hora de inicio de la copia de respaldo en el formato "yyyy-mm-ddThh:mm:ssZ", donde "T" indica la hora de inicio del campo de tiempo, y "Z" indica el desplazamiento de la zona horaria.
status	String	Estado de la copia de respaldo. Valor: BUILDING: Copia de respaldo en curso COMPLETED: Copia de respaldo completada FAILED: Error de copia de respaldo AVAILABLE: Copia de respaldo disponible Valores válidos: BUILDING COMPLETED FAILED AVAILABLE
type	String	Tipo de copia de respaldo. Valor: manual: copia de respaldo completa manual Valores válidos: manual
instance_id	String	ID 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

Creación de una copia de respaldo manual

POST https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/backups/create
{
  "instance_id" : "07033b125fd94a8a96896f8bcfee6ddain07",
  "name" : "backup-1",
  "description": "Manual backup"
}

Ejemplo de respuesta

Código de estado: 201

Success.

{
  "backup" : {
    "id" : "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
    "name" : "backup-1",
    "description": "Manual backup"
    "begin_time" : "2020-07-07T01:17:05+0800",
    "status" : "BUILDING",
    "type" : "manual",
    "instance_id" : "ef25188419f941309882d2986b2210b9in07"
  },
  "job_id" : "e0fbbfc8-1ac4-4721-b9e9-7dd685c5bdd7"
}