Creating a Restore Point

Function

This API is used to back up a vault and generate a restore point.

URI

POST /v3/{project_id}/checkpoints

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header. Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
checkpoint	Yes	VaultBackup object	Parameters for backing up the vault

**Table 4** VaultBackup
Parameter	Mandatory	Type	Description
parameters	No	CheckpointParam object	Parameters for backing up to a vault.
vault_id	Yes	String	Vault ID. Default value: N/A

**Table 5** CheckpointParam
Parameter	Mandatory	Type	Description
auto_trigger	No	Boolean	Whether to trigger automatically. Default value: false The value can be: true: trigger automatically. false: Not trigger automatically.
description	No	String	Backup description. The value cannot contain angle brackets (< or >) and can contain a maximum of 255 characters. Default value: N/A
incremental	No	Boolean	Whether to perform incremental backup. The default value is true. The value can be: true: incremental backup false: non-incremental backup
name	No	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A
resources	No	Array of strings	IDs of the resources to be backed up. The IDs are in UUID format. The resources must have been associated with the vault and can be backed up. Default value: N/A
resource_details	No	Array of Resource objects	Details about the resources to be backed up.

**Table 6** Resource
Parameter	Mandatory	Type	Description
extra_info	No	ResourceExtraInfo object	Extra information of the resource
id	Yes	String	ID of the resource to be backed up. The resource must have been associated with the vault and can be backed up. Default value: N/A
name	No	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters. Default value: N/A
type	Yes	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Ironic::BareMetalServer: Bare Metal Servers; OS::Sfs::Turbo: SFS Turbo file systems Default value: N/A

**Table 7** ResourceExtraInfo
Parameter	Mandatory	Type	Description
exclude_volumes	No	Array of strings	ID of the volume that does not need to be backed up. This parameter is valid only for multi-disk backup. It specifies the disks that do not need to be backed up. When a disk is newly attached to a VM, the volume that does not need to be backed up can also be excluded. Default value: N/A
include_volumes	No	Array of ResourceExtraInfoIncludeVolumes objects	Volumes that need to be backed up. If this parameter is specified, only the specified volumes will be backed up. For example, if new volumes are added to a server after the server is associated with a vault, these new volumes will not be backed up. If this parameter is not specified, all volumes on the server will be backed up. This parameter takes effect only for disk-level backup. Default value: N/A

**Table 8** ResourceExtraInfoIncludeVolumes
Parameter	Mandatory	Type	Description
id	Yes	String	Volume ID in UUID format. Default value: N/A
os_version	No	String	OS type. Default value: N/A

Response Parameters

Status code: 200

**Table 9** Response body parameters
Parameter	Type	Description
checkpoint	CheckpointCreate object	Checkpoint information.

**Table 10** CheckpointCreate
Parameter	Type	Description
created_at	String	Creation time, for example, 2020-02-05T10:38:34.209782.
id	String	Checkpoint ID.
project_id	String	Project ID.
status	String	Checkpoint status. The value can be: available: The checkpoint is available. deleting: The checkpoint is being deleted. protecting: The checkpoint is being protected. deleted: The checkpoint has been deleted. error-deleting: An exception occurred during the deletion. error: The checkpoint is abnormal.
vault	CheckpointPlanCreate object	Vault information
extra_info	CheckpointExtraInfoResp object	Extended information

**Table 11** CheckpointPlanCreate
Parameter	Type	Description
id	String	Vault ID.
name	String	Vault name. The value can contain a maximum of 64 characters, including letters, digits, underscores (_), and hyphens (-).
resources	Array of CheckpointResourceResp objects	Backup objects
skipped_resources	Array of CheckpointCreateSkippedResource objects	Resources skipped during backup

**Table 12** CheckpointResourceResp
Parameter	Type	Description
extra_info	String	Extra information of the resource
id	String	ID of the resource to be backed up. The resource must have been associated with the vault and can be backed up.
name	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters.
protect_status	String	Protection status. The value can be: available: The resource is available. error: The resource is abnormal. protecting: The resource is being protected. restoring: The resource is being restored. removing: The resource is being removed.
resource_size	String	Allocated capacity for the associated resources, in GB Range: N/A
type	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Ironic::BareMetalServer: Bare Metal Servers; OS::Sfs::Turbo: SFS Turbo file systems Default value: N/A
backup_size	String	Backup replica size in GB. Range: N/A; Default value: N/A
backup_count	String	Number of replicas. Range: N/A; Default value: N/A

**Table 13** CheckpointCreateSkippedResource
Parameter	Type	Description
id	String	Resource ID, in UUID format. You can query the resource ID based on the type of the resource to be backed up.
type	String	Resource type. The value can be: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Ironic::BareMetalServer: Bare Metal Servers; OS::Sfs::Turbo: SFS Turbo file systems; OS::Workspace::DesktopV2: Workspaces
name	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters.
code	String	For details, see Error Codes.
reason	String	Reason for the skipping. For example, the resource is being backed up.

**Table 14** CheckpointExtraInfoResp
Parameter	Type	Description
name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-).
description	String	Backup description. Range: N/A
retention_duration	Integer	Number of days for storing backups. Range: N/A

Example Requests

Automatically backing up a vault and generating a restore point

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

Example Responses

Status code: 200

{
  "checkpoint" : {
    "status" : "protecting",
    "created_at" : "2019-05-10T07:59:12.733+00:00",
    "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"
      } ],
      "name" : "vault-be94"
    },
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
    "extra_info" : {
      "retention_duration" : -1,
      "name" : "backup_name",
      "description" : "backup_description"
    }
  }
}

Status Codes

Status Code	Description
200	OK

Error Codes

See Error Codes.

Parent topic: Restore Points

Previous topic: Replicating a Restore Point

Next topic: Application Cases

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.