Veeam Backup for AWS 9
REST API Reference
Related documents

Redshift Clusters

The /redshift resource collection represents all Redshift clusters that reside in AWS Regions selected in the backup policy settings and can be protected by Veeam Backup for AWS.

Get Collection of Redshift Clusters

The HTTP GET request to the /redshift endpoint retrieves all Redshift clusters available to 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.

ResourceAwsAccountId
string

Returns only Redshift clusters that belong to an AWS Account with the specified AWS ID.

ResourceAwsOrganizationId
string

Returns only Redshift clusters that belong to an AWS Organizationwith the specified AWS ID.

RegionId
string <uuid>

Returns only Redshift clusters that reside in an AWS Region with the specified ID.

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 (RedshiftSortColumns)

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" "locationAsc" "locationDesc" "resourceAwsAccountIdAsc" "resourceAwsAccountIdDesc"
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/redshift
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshift?SearchPattern=string&ResourceAwsAccountId=string&ResourceAwsOrganizationId=string&RegionId=497f6eca-6276-4993-bfeb-53cbbbba6f08&Offset=0&Limit=0&Sort=nameAsc' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
application/json
{
  • "results": [
    ],
  • "totalCount": 0,
  • "_links": [
    ]
}

Perform Infrastructure Rescan for Redshift Clusters

The HTTP POST request to the /redshift/rescan endpoint runs the infrastructure rescanning operation for Redshift clusters.

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
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/redshift/rescan
Request samples 
curl -i -X POST \
  https://helpcenter.veeam.com/api/v1/redshift/rescan \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
{}

Get Redshift Cluster Data

The HTTP GET request to the /redshift/{redshiftId} endpoint retrieves data on a Redshift cluster with the specified ID.

SecurityBearer
Request
path Parameters
redshiftId
required
string <uuid>

System ID assigned to a Redshift cluster 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/redshift/{redshiftId}
Request samples 
curl -i -X GET \
  'https://helpcenter.veeam.com/api/v1/redshift/{redshiftId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-api-version: 1.7-rev0'
Response samples
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "awsResourceId": "string",
  • "resourceAwsAccountId": "string",
  • "name": "string",
  • "isDeleted": true,
  • "region": {
    },
  • "IAMRole": {
    },
  • "clusterSize": 0,
  • "creationTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}

Create Backup of Redshift Cluster

The HTTP POST request to the /redshift/{redshiftId}/takeBackup endpoint creates a manual backup of a Redshift cluster with the specified ID.

SecurityBearer
Request
path Parameters
redshiftId
required
string <uuid>

System ID assigned to a Redshift cluster 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: application/json
required
IAMRoleId
required
string <uuid>

Specifies the system ID assigned in the Veeam Backup for AWS REST API to an IAM role whose permissions Veeam Backup for AWS will use to access AWS resources and perform Redshift backup.

targetVaultId
required
string <uuid>

Specifies the system ID assigned in the Veeam Backup for AWS REST API to a backup vault that will be used to store the backup.

Array of objects (TagSpec)

Specifies custom tags to be assigned to the Redshift backup.

copyTagsFromInstanceEnabled
boolean

Defines whether to copy tags of the processed Redshift clusters and assign them to backups produced by 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/redshift/{redshiftId}/takeBackup
Request samples
application/json
{
  • "IAMRoleId": "31d997b7-510e-4a2c-a173-a131e417c339",
  • "targetVaultId": "f7120e0b-5e2b-4e35-a0c4-9d04ff05e67f",
  • "additionalTags": [
    ],
  • "copyTagsFromInstanceEnabled": true
}
Response samples
{}

Remove Backups of Redshift Cluster

The HTTP POST request to the /redshift/{redshiftId}/deleteBackup endpoint removes the whole backup chain of a Redshift cluster with the specified ID.

SecurityBearer
Request
path Parameters
redshiftId
required
string <uuid>

Specifies the system ID assigned to a Redshift cluster 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: application/json
required
destinationTypeToRemove
required
string (RedshiftBackupTypeToRemove)

Specifies the type of Redshift cluster backups that will be removed.

Enum: "All" "Backup" "ManualBackup"
manualBackupRestorePoint
string <uuid>

[Applies if the ManualBackup value was specified for the destinationTypeToRemove parameter] System ID assigned in the Veeam Backup for AWS REST API to the manual backup that will be removed.

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/redshift/{redshiftId}/deleteBackup
Request samples
application/json
{
  • "destinationTypeToRemove": "All",
  • "manualBackupRestorePoint": "14728a19-ade2-4036-988a-bbe9c2ccbbb0"
}
Response samples
{}