Veeam Backup for AWS 9
REST API Reference
Related documents

Redshift Serverless Backup Policies

The /redshiftServerless/policies resource collection represents Redshift Serverless backup policies created in Veeam Backup for AWS.

Get Collection of Redshift Serverless Backup Policies

The HTTP GET request to the /redshiftServerless/policies endpoint retrieves a list of all Redshift Serverless backup policies created in Veeam Backup for AWS.

SecurityBearer
Request
query Parameters
SearchPattern
string

Returns only those items of a resource collection whose names match the specified search pattern in the parameter value.

RedshiftId
string <uuid>

Returns only backup policies that protect a Redshift Serverless namespace with the specified ID.

IsEnabled
boolean

Returns only enabled or disabled backup policies.

LastPolicySessionStatus
Array of strings

Returns only backup policies with the specified most recent backup session status.

Items Enum: "Running" "NeverExecuted" "Succeeded" "Warning" "Failed" "Canceled"
Sort
Array of strings (PoliciesSortColumns)

Specifies the order of items in the response. For more information, see the Veeam Backup for AWS REST API Reference Overview, section Sort Parameter.

Items Enum: "priorityAsc" "priorityDesc" "nameAsc" "nameDesc" "usnAsc" "usnDesc"
Offset
integer <int32> >= 0

Excludes from a response the first N items of a resource collection.

Limit
integer <int32> >= -1

Specifies the maximum number of items of a resource collection to return in a response.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies?SearchPattern=string&RedshiftId=497f6eca-6276-4993-bfeb-53cbbbba6f08&IsEnabled=true&LastPolicySessionStatus=Running&Sort=priorityAsc&Offset=0&Limit=-1' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "totalCount": 0,
  • "results": [
    ],
  • "_links": [
    ]
}

Create Backup Policy

The HTTP POST request to the /redshiftServerless/policies endpoint creates a new Redshift Serverless backup policy.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Request Body schema:
required
name
required
string

Specifies a name for the backup policy.

identityId
required
string <uuid>

Specifies a system ID assigned in the Veeam Backup for AWS REST API to an AWS Organization or an IAM role that belongs to an AWS account.

required
Array of objects (RedshiftServerlessPolicyRegion) non-empty

Specifies backup settings configured for the backup policy.

backupType
required
string (PolicySelectionTypes)

Specifies the type of the backup policy.

Enum: "AllItems" "SelectedItems"
description
string

Specifies a description for the backup policy.

priority
integer <int64>

Specifies the priority order number for the backup policy.

isEnabled
boolean

Defines whether the backup policy is enabled.

object (RedshiftServerlessPolicyIncludedBackupItems)

Specifies AWS resources that are protected by the backup policy.

object (RedshiftServerlessPolicyExcludedBackupItems)

Specifies AWS resources that must be excluded from the backup policy.

object (RedshiftServerlessPolicyBackupSettings)

Specifies tag settings configured for the policy.

object (RedshiftServerlessScheduleSettings)

Specifies backup schedule specified for the backup policy.

object (RetrySettings)

Specifies retry settings configured for the backup policy.

object (NotificationSettings)

Specifies retry and notification settings for the backup policy.

object (OrganizationSpecification)

[Applies only if you back up resources within an AWS Organization] Specifies organization settings configured for the backup policy.

Responses
201

Created

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies
Request samples
{
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identityId": "ebc92baa-b430-498d-b30d-132ff32a5256",
  • "isEnabled": true,
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    }
}
Response samples
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identity": {
    },
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    },
  • "isEnabled": true,
  • "createdBy": "string",
  • "modifiedBy": "string",
  • "lastPolicySessionStatus": "Running",
  • "warning": "string",
  • "usn": 0,
  • "_embeddedResources": {
    },
  • "_links": [
    ]
}

Get Backup Policy Data

The HTTP GET request to the /redshiftServerless/policies/{policyId} endpoint retrieves settings of a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies/{policyId}
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identity": {
    },
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    },
  • "isEnabled": true,
  • "createdBy": "string",
  • "modifiedBy": "string",
  • "lastPolicySessionStatus": "Running",
  • "warning": "string",
  • "usn": 0,
  • "_embeddedResources": {
    },
  • "_links": [
    ]
}

Modify Backup Policy

The HTTP PUT request to the /redshiftServerless/policies/{policyId} endpoint updates settings of a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Request Body schema:
required
name
required
string

Specifies a name for the backup policy.

identityId
required
string <uuid>

Specifies a system ID assigned in the Veeam Backup for AWS REST API to an AWS Organization or an IAM role that belongs to an AWS account.

required
Array of objects (RedshiftServerlessPolicyRegion) non-empty

Specifies backup settings configured for the backup policy.

backupType
required
string (PolicySelectionTypes)

Specifies the type of the backup policy.

Enum: "AllItems" "SelectedItems"
description
string

Specifies a description for the backup policy.

priority
integer <int64>

Specifies the priority order number for the backup policy.

isEnabled
boolean

Defines whether the backup policy is enabled.

object (RedshiftServerlessPolicyIncludedBackupItems)

Specifies AWS resources that are protected by the backup policy.

object (RedshiftServerlessPolicyExcludedBackupItems)

Specifies AWS resources that must be excluded from the backup policy.

object (RedshiftServerlessPolicyBackupSettings)

Specifies tag settings configured for the policy.

object (RedshiftServerlessScheduleSettings)

Specifies backup schedule specified for the backup policy.

object (RetrySettings)

Specifies retry settings configured for the backup policy.

object (NotificationSettings)

Specifies retry and notification settings for the backup policy.

object (OrganizationSpecification)

[Applies only if you back up resources within an AWS Organization] Specifies organization settings configured for the backup policy.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

put/api/v1/redshiftServerless/policies/{policyId}
Request samples
{
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identityId": "ebc92baa-b430-498d-b30d-132ff32a5256",
  • "isEnabled": true,
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    }
}
Response samples
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identity": {
    },
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    },
  • "isEnabled": true,
  • "createdBy": "string",
  • "modifiedBy": "string",
  • "lastPolicySessionStatus": "Running",
  • "warning": "string",
  • "usn": 0,
  • "_embeddedResources": {
    },
  • "_links": [
    ]
}

Delete Backup Policy

The HTTP DELETE request to the /redshiftServerless/policies/{policyId} endpoint deletes a Redshift Serverless backup policy with the specified ID.

NOTE
When you delete a backup policy, cloud-native backups created by this backup policy remain intact in AWS. Such backups are not deleted from the configuration database — you can find them in the Protected Data view.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
204

No Content

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

409

Failed to delete policy, verify it is not in use and try again.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

delete/api/v1/redshiftServerless/policies/{policyId}
Request samples 
curl -i -X DELETE \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "type": "http://example.com",
  • "title": "string",
  • "status": 400,
  • "errorCode": "AccessDenied",
  • "details": "string",
  • "instance": "http://example.com",
  • "data": {
    }
}

Get Resources Protected by Backup Policy

The HTTP GET request to the /redshiftServerless/policies/{policyId}/selectedItems endpoint retrieves information on all AWS resources protected by a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

query Parameters
Offset
integer <int32> >= 0

Excludes from a response the first N items of a resource collection.

Limit
integer <int32> >= -1

Specifies the maximum number of items of a resource collection to return in a response.

SearchPattern
string

Returns only those items of a resource collection whose names match the specified search pattern in the parameter value.

Sort
Array of strings (PolicyItemsSortColumns)

Specifies the order of items in the response. For more information, see the Veeam Backup for AWS REST API Reference Overview, section Sort Parameter.

Items Enum: "nameAsc" "nameDesc"
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies/{policyId}/selectedItems
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/selectedItems?Offset=0&Limit=-1&SearchPattern=string&Sort=nameAsc' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "totalCount": 0,
  • "results": [
    ],
  • "_links": [
    ]
}

Get Resources Excluded from Backup Policy

The HTTP GET request to the /redshiftServerless/policies/{policyId}/excludedItems endpoint retrieves information on all AWS resources excluded from a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

query Parameters
Offset
integer <int32> >= 0

Excludes from a response the first N items of a resource collection.

Limit
integer <int32> >= -1

Specifies the maximum number of items of a resource collection to return in a response.

SearchPattern
string

Returns only those items of a resource collection whose names match the specified search pattern in the parameter value.

Sort
Array of strings (PolicyItemsSortColumns)

Specifies the order of items in the response. For more information, see the Veeam Backup for AWS REST API Reference Overview, section Sort Parameter.

Items Enum: "nameAsc" "nameDesc"
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies/{policyId}/excludedItems
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/excludedItems?Offset=0&Limit=-1&SearchPattern=string&Sort=nameAsc' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "totalCount": 0,
  • "results": [
    ],
  • "_links": [
    ]
}

Get AWS Regions Selected for Backup Policy

The HTTP GET request to the /redshiftServerless/policies/{policyId}/regions endpoint retrieves information on all AWS Regions selected for a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

query Parameters
SearchPattern
string

Returns only those items of a resource collection whose names match the specified search pattern in the parameter value.

Offset
integer <int32>

Excludes from a response the first N items of a resource collection.

Limit
integer <int32>

Specifies the maximum number of items of a resource collection to return in a response.

Sort
Array of strings (RegionsSortColumns)

Specifies the order of items in the response. For more information, see the Veeam Backup for AWS REST API Reference Overview, section Sort Parameter.

Items Enum: "nameAsc" "nameDesc"
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies/{policyId}/regions
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/regions?SearchPattern=string&Offset=0&Limit=0&Sort=nameAsc' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "totalCount": 0,
  • "results": [
    ],
  • "_links": [
    ]
}

Enable Backup Policy

The HTTP POST request to the /redshiftServerless/policies/{policyId}/enable endpoint enables a disabled Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/{policyId}/enable
Request samples 
curl -i -X POST \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/enable' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "type": "http://example.com",
  • "title": "string",
  • "status": 400,
  • "errorCode": "AccessDenied",
  • "details": "string",
  • "instance": "http://example.com",
  • "data": {
    }
}

Disable Backup Policy

The HTTP POST request to the /redshiftServerless/policies/{policyId}/disable endpoint disables an enabled Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/{policyId}/disable
Request samples 
curl -i -X POST \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/disable' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "type": "http://example.com",
  • "title": "string",
  • "status": 400,
  • "errorCode": "AccessDenied",
  • "details": "string",
  • "instance": "http://example.com",
  • "data": {
    }
}

Start Backup Policy

The HTTP POST request to the /redshiftServerless/policies/{policyId}/start endpoint launches a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
202

Accepted

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

409

The policy has already started.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/{policyId}/start
Request samples 
curl -i -X POST \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/start' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{}

Stop Backup Policy

The HTTP POST request to the /redshiftServerless/policies/{policyId}/stop endpoint stops execution of a Redshift Serverless backup policy with the specified ID.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/{policyId}/stop
Request samples 
curl -i -X POST \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/stop' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "type": "http://example.com",
  • "title": "string",
  • "status": 400,
  • "errorCode": "AccessDenied",
  • "details": "string",
  • "instance": "http://example.com",
  • "data": {
    }
}

Validate Backup Policy Settings

The HTTP POST request to the /redshiftServerless/policies/validate checks whether the settings you plan to specify for a Redshift Serverless backup policy are valid.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Request Body schema: application/json
required
name
required
string

Specifies a name for the backup policy.

identityId
required
string <uuid>

Specifies a system ID assigned in the Veeam Backup for AWS REST API to an AWS Organization or an IAM role that belongs to an AWS account.

required
Array of objects (RedshiftServerlessPolicyRegion) non-empty

Specifies backup settings configured for the backup policy.

backupType
required
string (PolicySelectionTypes)

Specifies the type of the backup policy.

Enum: "AllItems" "SelectedItems"
description
string

Specifies a description for the backup policy.

priority
integer <int64>

Specifies the priority order number for the backup policy.

isEnabled
boolean

Defines whether the backup policy is enabled.

object (RedshiftServerlessPolicyIncludedBackupItems)

Specifies AWS resources that are protected by the backup policy.

object (RedshiftServerlessPolicyExcludedBackupItems)

Specifies AWS resources that must be excluded from the backup policy.

object (RedshiftServerlessPolicyBackupSettings)

Specifies tag settings configured for the policy.

object (RedshiftServerlessScheduleSettings)

Specifies backup schedule specified for the backup policy.

object (RetrySettings)

Specifies retry settings configured for the backup policy.

object (NotificationSettings)

Specifies retry and notification settings for the backup policy.

object (OrganizationSpecification)

[Applies only if you back up resources within an AWS Organization] Specifies organization settings configured for the backup policy.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/validate
Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "identityId": "ebc92baa-b430-498d-b30d-132ff32a5256",
  • "isEnabled": true,
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    }
}
Response samples
[
  • {
    }
]

Set Backup Policy Priority

The HTTP POST request to the /redshiftServerless/policies/orderPriorities sets the priority order for Redshift Serverless backup policies.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Request Body schema: application/json
required
required
Array of objects (PolicyPrioritySpec)

Specifies policy priority ordinal numbers.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/orderPriorities
Request samples
application/json
{
  • "priorities": [
    ]
}
Response samples
{ }

Export Backup Policy Settings

The HTTP GET request to the /redshiftServerless/policies/{policyId}/export exports settings of an enabled Redshift Serverless backup policy with the specified ID to a JSON file.

SecurityBearer
Request
path Parameters
policyId
required
string <uuid>

Specifies the system ID assigned to a Redshift Serverless backup policy in the Veeam Backup for AWS REST API.

header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

get/api/v1/redshiftServerless/policies/{policyId}/export
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/{policyId}/export' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "isEnabled": true,
  • "identityName": "string",
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    }
}

Import Backup Policy Settings

The HTTP POST request to the redshiftServerless/policies/import creates a Redshift Serverless backup policy with imported settings.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Request Body schema: application/json
required
name
required
string

Specifies the name of the backup policy.

identityName
required
string

Specifies the name of an AWS Organization or the name of an IAM role that belongs to an AWS account.

required
Array of objects (RedshiftServerlessPolicyExportRegion) non-empty

Specifies the backup settings configured for the backup policy.

backupType
required
string (PolicySelectionTypes)

Specifies the type of the backup policy.

Enum: "AllItems" "SelectedItems"
description
string

Specifies the description of the backup policy.

priority
integer <int64>

Specifies the priority order number of the backup policy.

isEnabled
boolean

Defines whether the backup policy is enabled.

object (RedshiftServerlessPolicySelectedItemsExportModel)

Specifies AWS resources protected by the backup policy.

object (RedshiftServerlessPolicyExcludedItemsExportModel)

Specifies AWS resources excluded from the backup policy.

object (RedshiftServerlessPolicyBackupSettings)

Specifies tag settings configured for the policy.

object (RedshiftServerlessScheduleSettings)

Specifies backup schedule specified for the backup policy.

object (RetrySettings)

Specifies retry settings configured for the backup policy.

object (NotificationSettings)

Specifies retry and notification settings for the backup policy.

object (OrganizationSettingsExportModel)

[Applies if an AWS Organization is added to Veeam Backup for AWS] Specifies organization settings configured for the backup policy.

Responses
202

Accepted

400

Bad Request. The request body is malformed, incomplete or otherwise invalid.

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.

404

Not Found. One or more resources specified in the request could not be found in the specified resource collection.

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/import
Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "priority": 0,
  • "isEnabled": true,
  • "identityName": "string",
  • "regions": [
    ],
  • "backupType": "AllItems",
  • "selectedItems": {
    },
  • "excludedItems": {
    },
  • "backupSettings": {
    },
  • "scheduleSettings": {
    },
  • "retrySettings": {
    },
  • "notificationSettings": {
    },
  • "organizationSettings": {
    }
}
Response samples
{}

Export Collection of Backup Policies

The HTTP POST request to the /redshiftServerless/policies/export endpoint exports all Redshift Serverless backup policies created in Veeam Backup for AWS to a .CSV or an .XML file. To specify the required type of the file, use the Accept request header.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.7-rev0

Specifies the current version and revision of the Veeam Backup for AWS REST API.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

500

Internal Server Error. The request has been received but could not be completed because of an internal error on the server side.

503

Service Unavailable

504

Gateway Timeout

post/api/v1/redshiftServerless/policies/export
Request samples 
curl -i -X POST \
  https://helpcenter.veeam.com/api/v1/redshiftServerless/policies/export \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'