Skip to main content

Modify the Backup and Recovery service backup configuration

PUT /account/{accountId}/providers/cloudmanager_cbs/api/v2/backup/working-environment/{workingEnvironmentId}

Modifies the NetApp Backup and Recovery service backup configuration for a particular system synchronously (V2 version). You can modify the state, backup policy, archive storage class, cloud storage pool, AWS/Azure/Google Cloud/StorageGRID access and secret key, IPspace, maximum transfer rate, and enable automatic backup.

Token usage: NetApp Console user token.

Parameters

Name Type In Required Description

accountId

string

path

True

Account ID

workingEnvironmentId

string

path

True

System ID of the source Cloud Volumes ONTAP instance

authorization

string

header

True

User token

X-Agent-Id

string

header

True

Request identifier

Request Body

Name Type Required Description

state

string

False

Updates the SnapMirror relationship state in the system to the specified state

backup-policy

backup-policy

False

Uses an existing policy or creates a new policy if not found in the list of ONTAP policies and modifies the backed up system relationships to use the existing one.

archive-storage-class

string

False

Required for AWS if modifying the storage class or enabling archive for the first time.

auto-backup-enabled

boolean

False

Automatically backs up all volumes in the systems

max-transfer-rate

number

False

Modifies node-level throttling of an ONTAP cluster. Value to be specified in kilo bytes per second(kbps). A value of 0 implies unlimited throttling

delete-yearly-snapshots

boolean

False

Disables the deletion of local yearly snapshots after being transferred to object store

export-existing-snapshots

boolean

False

Exports pre-existing snapshots to object storage

ip-space

string

False

IP space for the backed up system

toggle-rsw-scan

boolean

False

Toggles RSW scheduled scan on or off

rsw-scan-interval

string

False

RSW scheduled scans interval

aws

aws

False

Accesses key and secret password for the system

gcp

gcp

False

Accesses key and secret password for the system

sgws

sgws

False

Accesses key and secret password for the system
Example request 
{
  "state": "string",
  "backup-policy": {
    "name": "string",
    "rule": [
      {
        "label": "string",
        "retention": "string"
      }
    ],
    "archive-after-days": "string",
    "object-lock": "string",
    "sgws-archival": {
      "cloud-storage-pool": {
        "provider": "string",
        "provider-account-id": "string",
        "region": "string",
        "access-key": "string",
        "secret-password": "string",
        "archive-storage-class": "string",
        "resource-group": "string"
      }
    }
  },
  "archive-storage-class": "string",
  "ip-space": "string",
  "rsw-scan-interval": "string",
  "aws": {
    "access-key": "string",
    "secret-password": "string"
  },
  "gcp": {
    "access-key": "string",
    "secret-password": "string"
  },
  "sgws": {
    "access-key": "string",
    "secret-password": "string",
    "storage-grid-id": "string"
  }
}

Response

Status: 202, Default response
Name Type Required Description

job-id

string

False
Example response 
{
  "job-id": "string"
}

Definitions

See Definitions

rule

Name Type Required Description

label

string

False

retention

string

False

cloud-storage-pool

Name Type Required Description

provider

string

True

Cloud provider where the cloud storage pool is hosted

provider-account-id

string

True

Cloud provider account ID where the cloud storage pool is hosted

region

string

True

Cloud provider region where the cloud storage pool is hosted

access-key

string

False

Required input field if the provider is AWS

secret-password

string

False

Required input field if the provider is AWS

archive-storage-class

string

False

Required for AWS to specify which storage class to use for archiving

resource-group

string

False

Required when the provider is Azure

sgws-archival

Name Type Required Description

cloud-storage-pool

cloud-storage-pool

False

backup-policy

Uses an existing policy or creates a new policy if not found in the list of ONTAP policies and modifies the backed up system relationships to use the existing one.

Name Type Required Description

name

string

False

Policy name of the existing policy or any custom name with which a new policy needs to be created. If not specified, a policy with the NetApp Backup and Recovery service default naming convention is created.

rule

array[rule]

False

Specifies the rules for a new policy

archive-after-days

string

False

object-lock

string

False

sgws-archival

sgws-archival

False

aws

Accesses key and secret password for the system

Name Type Required Description

access-key

string

False

secret-password

string

False

gcp

Accesses key and secret password for the system

Name Type Required Description

access-key

string

False

secret-password

string

False

sgws

Accesses key and secret password for the system

Name Type Required Description

access-key

string

False

secret-password

string

False

storage-grid-id

string

False

StorageGRID ID. Required input field for StorageGRID provider

body

Name Type Required Description

state

string

False

Updates the SnapMirror relationship state in the system to the specified state

backup-policy

backup-policy

False

Uses an existing policy or creates a new policy if not found in the list of ONTAP policies and modifies the backed up system relationships to use the existing one.

archive-storage-class

string

False

Required for AWS if modifying the storage class or enabling archive for the first time.

auto-backup-enabled

boolean

False

Automatically backs up all volumes in the systems

max-transfer-rate

number

False

Modifies node-level throttling of an ONTAP cluster. Value to be specified in kilo bytes per second(kbps). A value of 0 implies unlimited throttling

delete-yearly-snapshots

boolean

False

Disables the deletion of local yearly snapshots after being transferred to object store

export-existing-snapshots

boolean

False

Exports pre-existing snapshots to object storage

ip-space

string

False

IP space for the backed up system

toggle-rsw-scan

boolean

False

Toggles RSW scheduled scan on or off

rsw-scan-interval

string

False

RSW scheduled scans interval

aws

aws

False

Accesses key and secret password for the system

gcp

gcp

False

Accesses key and secret password for the system

sgws

sgws

False

Accesses key and secret password for the system