Replicating a Backup

Function

This API is used to replicate a backup across regions.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

POST /v3/{project_id}/backups/{backup_id}/replicate

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
backup_id	Yes	String	ID of the backup to be replicated
project_id	Yes	String	Project ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
replicate	Yes	BackupReplicateReqBody object	Replication parameter

**Table 4** BackupReplicateReqBody
Parameter	Mandatory	Type	Description
description	No	String	Replica description Minimum: 0 Maximum: 255
destination_project_id	Yes	String	ID of the replication destination project
destination_region	Yes	String	Replication destination region Minimum: 0 Maximum: 255
destination_vault_id	Yes	String	ID of the vault in the replication destination region
enable_acceleration	No	Boolean	Whether to enable the acceleration function to shorten the replication time for cross-region replication. If this parameter is not set, the acceleration function is disabled. Default: false
name	No	String	Replica name Minimum: 1 Maximum: 64

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
replication	BackupReplicateRespBody object	Replication response parameter

**Table 6** BackupReplicateRespBody
Parameter	Type	Description
backup_id	String	ID of the source backup used for replication
destination_project_id	String	ID of the replication destination project
destination_region	String	Replication destination region
destination_vault_id	String	ID of the vault in the replication destination region
project_id	String	ID of the project where replication is performed
provider_id	String	Resource type ID
replication_record_id	String	Replication record ID
source_region	String	Replication source region

Example Requests

Replicating a backup from the source vault to the destination vault

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/backups/a5200268-74a5-4806-acc6-95793ab0228b/replicate

{
  "replicate" : {
    "description" : "backup_description",
    "destination_project_id" : "68589cac08274b82b4e254268a3862d8",
    "destination_region" : "region2",
    "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274",
    "enable_acceleration" : false,
    "name" : "backup_name"
  }
}

Example Responses

Status code: 200

{
  "replication" : {
    "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274",
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "backup_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
    "destination_project_id" : "68589cac08274b82b4e254268a3862d8",
    "destination_region" : "region2",
    "source_region" : "region1",
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "replication_record_id" : "1579a71e-8d8d-41e6-85dc-d77f5ce8d91a"
  }
}