The Search Console allows you to perform operations on multiple objects at a time. You can use the Console to:
•Hold objects or release objects that are on hold.
•Delete or purge objects. Purge applies only to HCP namespaces, which can store multiple versions of objects. Purging an object deletes all versions of that object, including the current version. Deleting an object with multiple versions deletes only the current version.
![]() |
Note: HCP can delete or purge up to 2,000 objects in a single operation. If the search results include more than that, only the first 2,000 are deleted or purged. For all other operations, the operation works on the entire set of search results. |
Perform privileged delete or privileged purge operations. These operations work on objects that are under retention as well as on those that are not. When you perform a privileged operation, you’re required to specify a reason for it.
•While the metadata query engine is active, change object owners to an HCP user, an Active Directory user, or no owner. This operation applies only to objects in HCP namespaces.
•While the metadata query engine is active, set ACLs on objects. With this operation, the ACL you specify is added to any object without an ACL and replaces any existing ACLs on objects with ACLs. This operation applies only to objects in HCP namespaces.
For more information on ACLs, see Access control lists.
•While the metadata query engine is active, update ACLs on objects. With this operation:
oFor objects without ACLs, the ACL you specify is set for those objects.
oFor objects with ACLs, the existing ACLs are updated with the grants in the ACL you specify.
If an existing ACL doesn’t have a grant for a user or group that you specify, a grant for that user or group is added to the existing ACL. If an existing ACL already has a grant for a user or group that you specify, the grant in the existing ACL is replaced with the grant you specify for that user or group.
This operation applies only to objects in HCP namespaces.
![]() |
Note: ACLs are enabled on a per-namespace basis. If ACLs are not enabled for a namespace and you try to set or update ACLs on objects in that namespace, the operation fails for those objects. |
For any of the operations mentioned above to work on the objects in any given namespace:
•The namespace must be configured to allow the operation.
•You must have permission to perform the operation.
A requested operation works only on the objects in namespaces that support the operation and for which you have permission to perform the operation. Other objects in the search results are not affected.
You select the operation you want to perform from the Control operations field. In some cases, this field may show operations that are not allowed for some or all of the listed objects. If you try to perform an invalid operation on an object, the operation fails for that object.
Performing actions on returned objects causes the metadata query engine to update its index. However, even though these actions happen immediately, they may not be reflected in search results until the index update is complete.
While the HDDS search facility is active, changes caused by performing these operations are reflected in the next update of the index.
For more information on the indexes associated with each search facility, see Indexes.
![]() |
Important: Before performing an operation on multiple objects, ensure that the search results include only the objects you want to affect. To narrow down the results of a search, you can use one or more filters, as well as specify additional search criteria. For information on filters, see Filtering search results. |
To perform an operation on objects in the current search results, do one of these on the Search Results page:
•To place all the objects in the current search results on hold:
1.In the Control operations field, select Place results on hold.
2.In the window that opens, click on the Continue button.
•To release all held objects in the current search results:
1.In the Control operations field, select Release hold on results.
2.In the window that opens, click on the Continue button.
•To delete all the objects in the current search results except those that are under retention or on hold:
1.In the Control operations field, select Delete results.
2.In the window that opens, click on the Continue button.
•To delete all the objects in the current search results, including those that are under retention but excluding those that are on hold:
1.In the Control operations field, select Privileged Delete results.
2.In the field in the window that opens, type a reason for the delete operation. The reason text must be from one through 1,024 characters long and can contain any UTF-8 characters, including white space.
3.Click on the Continue button.
•To purge all versions of all the objects in the current search results except those that are under retention or on hold:
1.In the Control operations field, select Purge results.
2.In the window that opens, click on the Continue button.
•To purge all versions of all the objects in the current search results, including those that are under retention but excluding those that are on hold:
1.In the Control operations field, select Privileged Purge results.
2.In the field in the window that opens, type a reason for the purge operation. The reason text must be from one through 1,024 characters long and can contain any UTF-8 characters, including white space.
3.Click on the Continue button.
•While the metadata query engine is active, to change the ownership of all objects in the current search results:
1.In the Control operations field, select Change owner of results.
2.In the window that opens:
–To specify an HCP user account, type the username of the account in the Username field. Leave the Domain field blank.
–To specify an Active Directory user, type the username of an AD user account in the Username field and the domain in which the account is defined in the Domain field.
The username can be either the user principal name or the Security Accounts Manager (SAM) account name for the AD user account.
–To specify that the objects have no owner, leave both the Username and Domain fields blank.
3.Click on the Continue button.
•While the metadata query engine is active, to set an ACL on each object in the current search results:
1.In the Control operations field, select Set ACL on results.
2.In the field in the window that opens, type the ACL XML. This XML can be at most 8,192 characters long.
For information on specifying ACL XML, see XML format.
3.Click on the Continue button.
•While the metadata query engine is active, to update the existing ACLs for all objects in the current search results:
1.In the Control operations field, select Update ACL on results.
2.In the field in the window that opens, type the ACL XML. This XML can be at most 8,192 characters long.
3.Click on the Continue button.
When you click on the Continue button, HCP immediately begins the requested operation and opens a new window in which it shows its progress. For each object, the window shows whether the operation succeeded or failed. The sample window below shows objects that have successfully been placed on hold.
© 2016 Hitachi Data Systems Corporation. All rights reserved.