Skip to main content
Close

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Bucket management

  1. Last updated
  2. Save as PDF

Buckets are containers that store your data on HCP for cloud scale. They contain objects, the files and documents that you intend on storing on the cloud. Each bucket can also be assigned its own custom configuration and can be set with a unique set of permissions.

GUID-D21246B3-0F30-4398-9CBD-B66F882D2DFB-low.png

To further define objects in a bucket, policies can be applied to them, which contain rules where both tags and prefixes can be added as filters to further define your virtual storage.

For more information about the different available policies, see Bucket policies. For more information about tags, see Tags. For more information about prefixes, see Prefixes.

On the Buckets page, the following information is displayed:

  • Bucket name: The name of the bucket
  • Owner: The user that owns the bucket
  • Storage class: The selected storage class for the bucket
  • NoteS3 Standard is currently the only supported storage class.
  • Access level: The level of authetication required to use and view the bucket.
    • Private: Only you have access to this bucket.
    • Authenticated: Lets you grant access to this bucket for any user with an account on the system.
    • Unauthenticated: Lets you grant public access to this bucket for anyone. You can choose to assign Read or Read/Write privileges.

By clicking a bucket's more icon, users can find additional options for using their buckets:

  • View: Takes users directly to the bucket's Overview page.
  • Browse: Takes users directly to the bucket's Browse page.
  • Properties: Takes users directly to the bucket's Properties page.
  • Delete: Deletes the bucket.
Child Topics

Creating a bucket
TipBucket names can only contain lowercase letters, numbers, periods, and hyphens.

To create a bucket:

Procedure

  1. From the Buckets page, click + Create Bucket.

    The Create bucket page appears.

  2. In the Name field, enter a name for your bucket.

  3. In the Access level section, select your required level of security.

    • Private: Only you have access to this bucket.
    • Authenticated: Lets you grant access to this bucket for any user with an account on the system.
    • Unauthenticated: Lets you grant public access to this bucket for anyone. You can choose to assign Read or Read/Write privileges.

  4. In the Bucket policies section, chose your preferred policy using the selection slider.

    • Expiration Lifecycle policy: Lets you define when objects expire.
    • Sync-to Replication: Lets you enable automatic copying of objects to remote buckets. You cannot apply both Sync-to and Sync-from replications to the same bucket.
    • Sync-from Replication: Lets you enable automatic copying of objects from remote buckets. You cannot apply both Sync-to and Sync-from replications to the same bucket.

  5. To add rules to your selected policy:

    1. On your selected policy, click Configure.
      NoteConfigure is only displayed on policies that are selected.
    2. On the Configure page, click + Add rule.
    3. To add prefixes or tags to your rule, click Filter object.
    4. When you are finished configuring your rule, click Done.

  6. When you are finished configuring your policy, click Create.

    You are returned to the Buckets page and a message confirming the creation of the new bucket is displayed.

  7. To view your new bucket, select it by clicking its name from the Bucket name column.

    The bucket page is displayed and an overview of your bucket is provided.

Creating a bucket
TipBucket names can only contain lowercase letters, numbers, periods, and hyphens.

To create a bucket:

Procedure

  1. From the Buckets page, click + Create Bucket.

    The Create bucket page appears.

  2. In the Name field, enter a name for your bucket.

  3. In the Access level section, select your required level of security.

    • Private: Only you have access to this bucket.
    • Authenticated: Lets you grant access to this bucket for any user with an account on the system.
    • Unauthenticated: Lets you grant public access to this bucket for anyone. You can choose to assign Read or Read/Write privileges.

  4. In the Bucket policies section, chose your preferred policy using the selection slider.

    • Expiration Lifecycle policy: Lets you define when objects expire.
    • Sync-to Replication: Lets you enable automatic copying of objects to remote buckets. You cannot apply both Sync-to and Sync-from replications to the same bucket.
    • Sync-from Replication: Lets you enable automatic copying of objects from remote buckets. You cannot apply both Sync-to and Sync-from replications to the same bucket.

  5. To add rules to your selected policy:

    1. On your selected policy, click Configure.
      NoteConfigure is only displayed on policies that are selected.
    2. On the Configure page, click + Add rule.
    3. To add prefixes or tags to your rule, click Filter object.
    4. When you are finished configuring your rule, click Done.

  6. When you are finished configuring your policy, click Create.

    You are returned to the Buckets page and a message confirming the creation of the new bucket is displayed.

  7. To view your new bucket, select it by clicking its name from the Bucket name column.

    The bucket page is displayed and an overview of your bucket is provided.

Deleting a bucket
A bucket can only be deleted if it is emptied of all objects contained within it.
WARNINGBucket deletion is permanent.

To delete a bucket:

Procedure

  1. From the Buckets page, navigate to the bucket you want to delete.

  2. Click the more icon for your bucket and then select Delete.

    A confirmation message appears.

  3. Click Confirm Delete.

Rules

Rules are conditions added to policies which apply certain actions to objects containing specific prefixes. They help users to further define object expiration for current and non-current versions of objects. Policies can support up to 1,000 rules at a time.

Tags can also be added to help further define rules and categorize your storage. To learn more, see Tags.

Parent Topic
Child Topics

Adding rules to policies

To add a new rule to a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

  4. Click + Add rule.

    The Add Rule page appears.

  5. To add tags to your rule, click + Add tag.

  6. To apply actions (for the Expiration Lifecycle policy) or to change configuration settings for your rule, scroll to the bottom of the page.

  7. When finished, click Done.

    The rule is added to the selected policy's Configure policy page.

  8. From the Rules table, select the rule(s) you want to add to your policy using the checkbox column.

  9. Click Done.

    You are returned to the Create bucket page and your rules are noted in the Configured rules section of your selected policy.
Parent Topic

Adding pre-existing rules to a policy

To add a pre-existing rule to a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tab.

  3. Click Configure on your selected policy.

  4. From the Rules table, select the rule(s) you want to add to your policy using the checkbox column.

  5. Click Done.

    You are returned to the Create bucket page and your rules are noted in the Configured rules section of your selected policy.
Parent Topic

Editing a rule

To edit a rule:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

  4. Click the more button for your rule and then select Edit.

  5. Click Done.

Parent Topic

Deleting rules from a policy

To delete a rule from a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

  4. Click the more button for your rule and then select Delete.

  5. Click Okay.

Parent Topic

Filters

Each rule can be assigned a filter. Filters help users identify a subset of objects in a bucket in to which the rule applies. They can be assigned as a prefix or tags and help you to further define and categorize your storage.

Parent Topic
Child Topics

Prefixes

Prefixes are an S3 concept that represent the path to a virtual folder. They are a way to help users visualize the concept of Cloud storage and storage, given that no actual folders truly exist, and allow users to group objects by using common strings.

For example, setting a rule that applies to the /foo prefix would apply to all objects that start with /foo, such as /foo/bar, /foo/bar1/bar2, etc.

NoteA rule can only be assigned a single prefix.
Parent Topic
Child Topics

Adding a prefix filter to a policy
ImportantWhen adding a prefix filter to an Expiration Lifecycle policy, users must enable at least one action on the policy.

To add a prefix filter to a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

  4. Click + Add rule.

    The Add Rule page appears.

  5. Click Filter objects.

    The Prefix field and Tags list appear.

  6. In the Prefix field, enter your prefix.

  7. Click Done.

Parent Topic

Editing a prefix filter

To edit a prefix filter on a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

    The Rules page appears.

  4. Click the more icon for your prefix filter and select Edit.

Parent Topic

Removing a prefix filter from a policy

To remove a prefix filter from a policy:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on the policy.

    The Rules page appears.

  4. Click the more icon for your prefix filter and select Delete.

Parent Topic

Tags

Tags are independent of prefixes. Users can create a rule with only tag(s) without a prefix. A filter with tag(s) means that a rule applies only to objects that have tags matching the tags in the rule. A rule applies AND operator to all filter conditions, so all specified tags must match with tags in the object for the rule to apply to that object.Tags are used to help further define rules and categorize your storage. They are represented as a key-value pair and are added to rules representing a specific value for that prefix.

For example, you could apply a tag to the /foo prefix as a rule for your policy with a key of Classification and a value of Internal to help further classify and define the permissions of objects in the /foo directory.

Parent Topic
Child Topics

Adding tags to rules

To add a tag to a rule:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on your selected policy.

  4. Click + Add rule.

  5. Click Filter objects.

    The Prefix field and Tags list appear.

  6. To add tags to your rule, click + Add tag.

    The Add tag window appears.

  7. In the Key and Value fields, enter your tagging information.

  8. When finished, click Save.

  9. (Optional) To add additional tags, click the Add another tag box and then click Save.

  10. On the Add rule page, click Done.

Parent Topic

Editing a tag

To edit a tag which is part of a current rule:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on your selected policy.

  4. On the Configure policy page, click the more icon for the rule containing your tag and then select Edit.

    The Add Rule page appears.

  5. Click Filter objects.

    The Prefix field and Tags list appear.

  6. To edit a tag, click its more icon from the Tags list and then select Edit.

  7. In the Key and Value fields, update your tagging information.

  8. When finished, click Save.

  9. To finalize your changes, on the Add rule page, click Done.

Parent Topic

Deleting a tag filter

To delete a tag from a rule:

Procedure

  1. From the Buckets page, select the bucket by clicking its name from the Bucket name column.

  2. Click the Properties tag.

  3. Click Configure on your selected policy.

  4. On the Configure policy page, click the more icon for the rule containing your tag and then select Delete.

Parent Topic

 

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Article type
    Reference
    Page Type
    Documentation Article
  2. Tags
    This page has no tags.