Skip to main content

Enable the Cloud Backup service

Contributors

POST /account/{accountId}/providers/cloudmanager_cbs/api/v1/backup/working-environment/{workingEnvironmentId}

Enables Cloud Backup for a particular working environment. The API endpoint enables Cloud Backup on Cloud Volumes ONTAP on AWS, Azure, Google Cloud, and on-premises ONTAP systems. It checks and retrieves the storage account details that have been created for a specified account of the selected cloud provider. If an S3 object store bucket does not exist, the API endpoint creates a bucket. Then it configures the object store in ONTAP and also creates a SnapMirror policy if the chosen SnapMirror policy does not exist.

Token usage: BlueXP user token.

Parameters

Name Type In Required Description

accountId

string

path

True

Account ID

workingEnvironmentId

string

path

True

Working environment ID

authorization

string

header

True

User token

x-agent-id

string

header

True

Request identifier

Request Body

Name Type Required Description

account-id

string

False

Required when the provider is AWS for an on-premises use case

resource-group

string

False

Required when the provider is Azure for an on-premises use case

storage-account

string

False

Required when the provider is Azure for an on-premises use case

subscription

string

False

Required when the provider is Azure for an on-premises use case

project-id

string

False

Required when the provider is Google Cloud for an on-premises use case

bucket

string

False

Required input field for an on-premises use case

region

string

False

Required input field for an on-premises use case

provider

string

False

Required input field for an on-premises use case

storage-server

string

False

StorageGRID server URL. Required input field for StorageGRID provider

ip-space

string

False

Required input field for an on-premises use case

access-key

string

False

Required input field for an on-premises use case

secret-password

string

False

Required input field for an on-premises use case

backup-policy

backup-policy

False

Example request
{
  "provider": "AWS",
  "backup-policy": {
    "rule": {
    }
  }
}

Response

Status: 200, Default response
Name Type Required Description

state

string

False

Definitions

See Definitions

rule

Name Type Required Description

label

string

False

retention

string

False

backup-policy

Name Type Required Description

name

string

False

Required input

rule

array[rule]

False

body

Name Type Required Description

account-id

string

False

Required when the provider is AWS for an on-premises use case

resource-group

string

False

Required when the provider is Azure for an on-premises use case

storage-account

string

False

Required when the provider is Azure for an on-premises use case

subscription

string

False

Required when the provider is Azure for an on-premises use case

project-id

string

False

Required when the provider is Google Cloud for an on-premises use case

bucket

string

False

Required input field for an on-premises use case

region

string

False

Required input field for an on-premises use case

provider

string

False

Required input field for an on-premises use case

storage-server

string

False

StorageGRID server URL. Required input field for StorageGRID provider

ip-space

string

False

Required input field for an on-premises use case

access-key

string

False

Required input field for an on-premises use case

secret-password

string

False

Required input field for an on-premises use case

backup-policy

backup-policy

False