Configuring an Automated Backup Policy

Function

This API is used to configuring an automated backup policy.

Constraints

This API supports GeminiDB Cassandra instances.

URI

PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/backups/policy

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.

instance_id

Yes

String

Instance ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

backup_policy

Yes

object

Backup policy objects, including backup retention period (days) and start time For details, see Table 4.

database_tables

No

Array of objects

Database and table information in the backup policy. This parameter is available only to GeminiDB Cassandra. For details, see Table 5.

  • If this parameter is empty, an automated backup policy for an instance is set.

  • If this parameter is not empty, an automated backup policy for a databases or table is set.

Table 4 BackupPolicy

Parameter

Mandatory

Type

Description

keep_days

Yes

Integer

Backup retention days.

The value ranges from 0 to 35. The value 0 indicates that the automated backup policy is disabled.

start_time

No

String

Backup time window. Automated backup will be triggered during the backup time window. This parameter is mandatory if the automated backup policy is enabled. If the policy is disabled, you do not need to transfer this parameter.

The value must be the UTC time in the hh:mm-HH:MM format.

  • The HH value must be 1 greater than the hh value.

  • The values of mm and MM must be the same and must be set to 00, 15, 30, or 45.

  • Example value: 23:00-00:00

period

No

String

Backup period. After a backup period is specified, data will be automatically backed up on the selected days every week. This parameter is mandatory if the automated backup policy is enabled. If the policy is disabled, you do not need to transfer this parameter.

The value is a list of digits separated by commas (,). Each digit indicates a day of the week. The restrictions on the backup period are as follows:

  • If you set keep_days to 0, this parameter is not transferred.

  • If you set keep_days to 1 to 6, set this parameter to 1, 2, 3, 4, 5, 6, 7.

  • If you set keep_days to 7 to 35, select at least one day of the week for the backup cycle. Example value: 1,2,3,4

Table 5 PutDatabaseTablePolicy

Parameter

Mandatory

Type

Description

database_name

Yes

String

Database name.

table_names

No

Array of strings

Table names.

  • If this parameter is empty, a backup policy for an instance is set.

  • If this parameter is not empty, a backup policy for a databases or table is set.

Response Parameters

Status code: 204

No response parameters

Example Requests

  • URI example

    PUT https://{Endpoint}/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in02/backups/policy
    
  • Example request body

    Enabling or modifying the automated backup policy (Set period to 1, 2, 3, 4, 5, and 6, start_time to 01:00-02:00, and keep_days to 7.)

    {
      "backup_policy" : {
        "keep_days" : 7,
        "start_time" : "01:00-02:00",
        "period" : "1,2,3,4,5,6"
      },
       "database_tables" : [ {
         "database_name" : "databaseNameA",
         "table_names" : [ "table_A", "table_B" ]
       }, {
         "database_name" : "databaseNameB",
         "table_names" : null
       } ]
    }
    

    Disabling automated backup

    {
      "backup_policy" : {
        "keep_days" : 0
      }
    }
    

Example Responses

Status code: 204

No Content

{ }

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.