All Products
Search
Document Center

Database Backup:ModifyBackupSetDownloadRules

Last Updated:Apr 18, 2024

Enables, configures, or disables the automatic download feature.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
BackupPlanIdstringYes

The ID of the backup schedule.

dbstooi01****
OpenAutoDownloadbooleanNo

Specifies whether to enable the automatic download feature. Default value: false.

false
BackupGatewayIdlongNo

The ID of the backup gateway that is used to download the backup set.

2331****
FullDataFormatstringNo

The format in which the full backup set is downloaded. Valid values:

  • Native
  • SQL
  • CSV
  • JSON
Note Default value: CSV.
CSV
IncrementDataFormatstringNo

The format in which the incremental backup set is downloaded. Valid values:

  • Native
  • SQL
  • CSV
  • JSON
Note Default value: Native.
Native
BackupSetDownloadDirstringNo

The server directory to which the backup set is downloaded.

test
BackupSetDownloadTargetTypestringNo

The type of the destination server to which the backup set is downloaded.

Note Set the value to agent, which indicates a server on which a backup gateway is installed.
agent
BackupSetDownloadTargetTypeLocationstringNo

The type of the destination directory to which the backup set is downloaded. This parameter is required if the automatic download feature is enabled. Valid values:

  • local
  • nas
  • ftp
  • minio
Note Default value: local.
local
ClientTokenstringNo

The client token that is used to ensure the idempotence of the request.

ETnLKlblzczshOTUbOCzx****

Response parameters

ParameterTypeDescriptionExample
object
HttpStatusCodeinteger

The HTTP status code.

200
RequestIdstring

The ID of the request.

D6E068C3-25BC-455A-85FE-45F0B22ECB1F
ErrCodestring

The error code.

Param.NotFound
Successboolean

Indicates whether the request is successful.

true
ErrMessagestring

The error message.

The specified parameter %s value is not valid.
BackupPlanIdstring

The ID of the backup schedule.

dbstooi01e****

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "RequestId": "D6E068C3-25BC-455A-85FE-45F0B22ECB1F",
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "The specified parameter %s value is not valid.  ",
  "BackupPlanId": "dbstooi01e****"
}

Error codes

HTTP status codeError codeError message
403Request.ForbiddenHave no Permissions

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history