Create an S3 bucket and obtain an access key

Contributors netapp-madkat netapp-lhalbert

Before using StorageGRID with a FabricPool workload, you must create an S3 bucket for your FabricPool data. You also need to obtain an access key and secret access key for the tenant account you will use for FabricPool.

What you’ll need
  • You have created a tenant account for FabricPool use.

About this task

These instructions describe how to use the StorageGRID Tenant Manager to create a bucket and obtain access keys. You can also perform these tasks using the Tenant Management API or the StorageGRID S3 REST API. Or, if you are using ONTAP 9.10, you can create the bucket using the FabricPool setup wizard instead.

To learn more:

Steps
  1. Sign in to the Tenant Manager.

    You can do either of the following:

    • From the Tenant Accounts page in the Grid Manager, select the Sign in link for the tenant, and enter your credentials.

    • Enter the URL for the tenant account in a web browser, and enter your credentials.

  2. Create an S3 bucket for FabricPool data.

    You must create a unique bucket for each ONTAP cluster you plan to use.

    1. Select STORAGE (S3) > Buckets.

    2. Select Create bucket.

    3. Enter the name of the StorageGRID bucket you will use with FabricPool. For example, fabricpool-bucket.

      Important You cannot change the bucket name after creating the bucket.

      Bucket names must comply with these rules:

      • Must be unique across each StorageGRID system (not just unique within the tenant account).

      • Must be DNS compliant.

      • Must contain at least 3 and no more than 63 characters.

      • Can be a series of one or more labels, with adjacent labels separated by a period. Each label must start and end with a lowercase letter or a number and can only use lowercase letters, numbers, and hyphens.

      • Must not look like a text-formatted IP address.

      • Should not use periods in virtual hosted style requests. Periods will cause problems with server wildcard certificate verification.

    4. Select the region for this bucket.

      By default, all buckets are created in the us-east-1 region.

      Create Bucket for FabricPool
    5. Select Create bucket.

    Note For FabricPool buckets, the recommended bucket consistency level is “read-after-new-write.” The “available” consistency level is not recommended. See Change the consistency level.
  3. Create an access key and a secret access key.

    1. Select STORAGE (S3) > My access keys.

    2. Select Create key.

    3. Select Create access key.

    4. Copy the access key ID and the secret access key to a safe location, or select Download .csv to save a spreadsheet file containing the access key ID and secret access key.

      You will enter these values in ONTAP when you configure StorageGRID as a FabricPool cloud tier.

      Important If you create a new access key and secret access key in the future, remember to update the corresponding values in ONTAP immediately to ensure that ONTAP can store and retrieve data in StorageGRID without interruption.