Performing operations on returned objects

Content Platform Tenant Management Help

Version
9.7.x
File Size
4269 KB
Audience
anonymous
Part Number
MK-95HCPH002-19

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.
  • While the metadata query engine is active, update ACLs on objects. With this operation:
    • For objects without ACLs, the ACL you specify is set for those objects.
    • For 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.

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.