UPDATE OBJECTDOMAIN (Update a policy domain for object clients)

Use this command to update an attribute of a defined policy domain for object clients.

You can change the storage pools that were specified in the definition of the policy domain. The storage pool in the corresponding copy group is also updated.

Privilege class

To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the specified policy domain.

Syntax

Read syntax diagramSkip visual syntax diagram UPDate OBJECTDomain domain_name STANDARDPool=pool_nameCOLDPool=pool_name1
Notes:
  • 1 This parameter applies only to IBM Spectrum® Protect Plus.

Parameters

domain_name (Required)
Specifies the name of the policy domain.
STANDARDPool
Specifies the storage pool that will be used as the destination for requests from the object client. The data is sent to the IBM Spectrum Protect server from the Amazon Simple Storage Service (S3) Standard storage class by using the S3 protocol. You must specify an existing storage pool. The name of the storage pool must be unique, and the maximum length is 30 characters. This parameter is optional. To remove an existing storage pool from the policy domain, specify a null string ("") as the storage pool name.
Restriction: If you do not specify the STANDARDPOOL parameter, the object domain cannot receive requests from the S3 Standard storage class.
COLDPool
This parameter applies only to IBM Spectrum Protect Plus. Specifies the storage pool that will be used as the destination for requests from the object client. The data is sent to the IBM Spectrum Protect server from an S3 Glacier storage class by using the S3 protocol. You must specify an existing storage pool. The name of the storage pool must be unique, and the maximum length is 30 characters. This parameter is optional. To remove an existing storage pool from the policy domain, specify a null string ("") as the storage pool name.
Restriction: If you do not specify the COLDPOOL parameter, the object domain cannot receive requests from the S3 Glacier storage class.

Example for IBM Spectrum Protect Plus: Update the storage pool for a defined object policy domain

Update object client policy domain JACKIE1 to specify that the storage pool to be used for the policy domain is a cold-data-cache storage pool named COLDCACHEPOOL1.
update objectdomain jackie1 coldpool=coldcachepool1

Example for IBM Spectrum Protect Plus: Update a policy domain to remove a storage pool

Update object client policy domain JACKIE1 to remove the cold-data-cache storage pool named COLDCACHEPOOL1 from the policy domain.
update objectdomain jackie1 coldpool=""

To delete an object policy domain and the associated policy sets, management classes, and copy groups, issue the DELETE DOMAIN command.

Related commands

Table 1. Command related to UPDATE OBJECTDOMAIN
Command Description
DEFINE OBJECTDOMAIN Defines a policy domain that object clients can be assigned to.
DELETE DOMAIN Deletes a policy domain along with any policy objects in the policy domain.