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

Actualización más reciente 2025-03-21 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.
Obtenga la región y el 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, vea 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	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
instance_id	Sí	String	ID de instancia, que es compatible con el formato UUID.
name	Sí	String	Nombre de copia de respaldo. El nombre debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_).
description	No	String	Descripción de copia de respaldo. Contiene hasta 256 caracteres y no puede contener los siguientes caracteres especiales: >!<"&'=

Parámetros de respuesta

Código de estado: 201

**Tabla 4** Parámetros de cuerpo 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 "aaaa-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. Valores: BUILDING: Copia de respaldo en curso COMPLETED: Copia de respaldo completada FAILED: Error de copia de respaldo AVAILABLE: Copia de respaldo disponible Valores enumerados: BUILDING COMPLETED FAILED AVAILABLE
type	String	Tipo de copia de respaldo. Valor: manual (copia de respaldo completo manual) Valores enumerados: manual
instance_id	String	ID de instancia, que es compatible con el formato UUID.

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

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

Operación exitosa.

{
  "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" : "07033b125fd94a8a96896f8bcfee6ddain07"
  },
  "job_id" : "e0fbbfc8-1ac4-4721-b9e9-7dd685c5bdd7"
}