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
Compartir

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:

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"
}

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.