This is an archive version of the document. To get the most up-to-date information, see the current version.

Delete Backup Policy

You can delete a backup policy from Veeam Backup for AWS.

Note

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

Request

To delete a backup policy with the specified ID, send the HTTP DELETE request to the /policies/{policyId} endpoint. {policyId} is a system ID assigned to the backup policy in the Veeam Backup for AWS REST API.

HTTP Request

DELETE https://<hostname>:<port>/api/v1/policies/{policyId}

Request Headers

The request contains the following headers.

Header

Required/Optional

Value

Description

Authorization

Required

Bearer <Access-Token>

Authenticates a client who sends the request to the server. Must contain the access token for the current logon session in the Bearer <Access-Token> format.

x-api-version

Required

1.0-rev0

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

Accept

Optional

  • application/json
  • application/problem+json

Specifies a media type of representation that is required in the response message. If the requested type is not supported, the server will return the response in the application/json media type.

Response

The server returns the following response to the client.

Response Code

A successfully completed operation returns a response code 200 (OK).

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTP headers.

Header

Value

Description

Content-Length

integer

Identifies the length of the response body message, in bytes.

Content-Type

  • application/json
  • application/problem+json

Identifies the media type of the response body message.

Delete Backup PolicyExample

The following request deletes a backup policy with the ID 6ac40b80-4bdb-46e9-9759-0fc0d1166ccf.

Request:

DELETE https://135.169.170.192:11005/api/v1/policies/6ac40b80-4bdb-46e9-9759-0fc0d1166ccf

 

Request Header:

Authorization: Bearer <Access-Token>

x-api-version: 1.0-rev0

 

Response:

200