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/ Cloud Backup and Recovery/ Referencia de la API/ APIs de CBR/ Puntos de restauración/ Creación de un punto de restauración

Actualización más reciente 2023-02-03 GMT+08:00

Ver PDF

Creación de un punto de restauración

Función

Esta API se utiliza para hacer una copia de seguridad de un almacén y generar un punto de restauración.

URI

POST /v3/{project_id}/checkpoints

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	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. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
checkpoint	Sí	VaultBackup object	Parámetros para realizar una copia de seguridad del almacén

**Tabla 4** VaultBackup
Parámetro	Obligatorio	Tipo	Descripción
parameters	No	CheckpointParam object	Parámetros
vault_id	Sí	String	ID de almacén

**Tabla 5** CheckpointParam
Parámetro	Obligatorio	Tipo	Descripción
auto_trigger	No	Boolean	Si la activación automática está activada. Los valores posibles son true (yes) y false (no). Predeterminado: false
description	No	String	Descripción de la copia de respaldo Mínimo: 0 Máximo: 255
incremental	No	Boolean	Si la copia de respaldo es una copia de respaldo incremental. Los valores posibles son true (yes) y false (no). Predeterminado: true
name	No	String	Nombre de copia de seguridad, que puede contener solo dígitos, letras, guiones bajos (_), y guiones (-) Mínimo: 1 Máximo: 64
resources	No	Array of strings	Lista de UUID de recursos de los que se va a hacer una copia de seguridad
resource_details	No	Array of Resource objects	Detalles del recurso

**Tabla 6** Resource
Parámetro	Obligatorio	Tipo	Descripción
extra_info	No	ResourceExtraInfo object	Nombre de almacén
id	Sí	String	ID del tipo de recurso de almacén
name	No	String	Nombre del recurso al que se va a hacer una copia de seguridad. El valor consta de 0 a 255 caracteres. Mínimo: 0 Máximo: 255
type	Sí	String	Tipo del recurso que se va a hacer una copia de seguridad, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo

**Tabla 7** ResourceExtraInfo
Parámetro	Obligatorio	Tipo	Descripción
exclude_volumes	No	Array of strings	ID de los discos de los que no se realizará una copia de seguridad. Este parámetro se utiliza cuando se agregan servidores a un almacén, que incluye todos los discos de servidor. Pero algunos discos no necesitan ser respaldados. O en caso de que se haya agregado un servidor previamente y no sea necesario realizar copias de seguridad de algunos discos de este servidor.

Parámetros de respuesta

Código de estado: 200

**Tabla 8** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
checkpoint	CheckpointCreate object	Información de punto de restaruración

**Tabla 9** CheckpointCreate
Parámetro	Tipo	Descripción
created_at	String	Tiempo de creación, por ejemplo, 2020-02-05T10:38:34.209782
id	String	ID de punto de restauración
project_id	String	ID de proyecto
status	String	Estado Valores de enumeración: available deleting protecting deleted error-deleting error
vault	CheckpointPlanCreate object	Información del almacén
extra_info	CheckpointExtraInfoResp object	Información extendida

**Tabla 10** CheckpointPlanCreate
Parámetro	Tipo	Descripción
id	String	ID de almacén
name	String	Nombre de almacén
resources	Array of CheckpointResourceResp objects	Objetos de copia de seguridad
skipped_resources	Array of CheckpointCreateSkippedResource objects	Recursos omitidos durante la copia de respaldo

**Tabla 11** CheckpointResourceResp
Parámetro	Tipo	Descripción
extra_info	String	Información adicional del recurso
id	String	ID del recurso al que se va a realizar una copia de seguridad
name	String	Nombre del recurso al que se va a hacer una copia de seguridad
protect_status	String	Estado protegido Valores de enumeración: available error protecting restoring removing
resource_size	String	Capacidad asignada para el recurso asociado, en GB
type	String	Tipo del recurso que se va a hacer una copia de seguridad, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo
backup_size	String	Tamaño de copia de respaldo
backup_count	String	Cantidad de copias de respaldo

**Tabla 12** CheckpointCreateSkippedResource
Parámetro	Tipo	Descripción
id	String	ID de recurso
type	String	Tipo de recurso
name	String	Nombre de recurso
code	String	Para obtener más información, consulte Códigos de error.
reason	String	Motivo de la omisión. Por ejemplo, se está realizando una copia de seguridad del recurso.

**Tabla 13** CheckpointExtraInfoResp
Parámetro	Tipo	Descripción
name	String	Nombre de copia de respaldo
description	String	Descripción de la copia de respaldo
retention_duration	Integer	Número de días que se pueden conservar las copias de seguridad

Solicitudes de ejemplo

Creación de copias de seguridad

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/checkpoints

{
  "checkpoint" : {
    "parameters" : {
      "auto_trigger" : true,
      "description" : "backup_description",
      "incremental" : true,
      "name" : "backup_name",
      "resources" : [ "94eba8b2-acc9-4d82-badc-127144cc5526" ]
    },
    "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce"
  }
}

Ejemplo de respuestas

Código de estado: 200

{
  "checkpoint" : {
    "status" : "protecting",
    "created_at" : "2019-05-10T07:59:12.733403",
    "vault" : {
      "skipped_resources" : [ ],
      "id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
      "resources" : [ {
        "name" : "ecs-1f0f-0002",
        "resource_size" : "40",
        "protect_status" : "available",
        "type" : "OS::Nova::Server",
        "id" : "94eba8b2-acc9-4d82-badc-127144cc5526",
        "extra_info" : null
      } ],
      "name" : "vault-be94"
    },
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
    "extra_info" : {
      "retention_duration" : -1,
      "name" : "backup_name",
      "description" : "backup_description"
    }
  }
}