Skip to main content

Create S3 NAS bucket

Contributors netapp-aherbin

An S3 NAS buckets is a mapping between an S3 bucket name and a NAS path. S3 NAS buckets allow you to provide S3 access to any part of an SVM namespace having existing volumes and directory structure.

Before you begin
About this task

You can configure S3 NAS buckets to specify any set of files and directories within the root directory of the SVM.

You can also set bucket policies that allow or disallow access to NAS data based on any combination of these parameters:

  • Files and directories

  • User and group permissions

  • S3 operations

For example, you might want separate bucket policies that grant read-only data access to a large group of users, and another that allows a limited group to perform operations on a subset of that data.

Because S3 NAS “buckets” are mappings and not S3 buckets, the following properties of standard S3 buckets don't apply to S3 NAS buckets.

  • aggr-list \ aggr-list-multiplier \ storage-service-level \ volume \ size \ exclude-aggr-list \ qos-policy-group
    No volumes or qtree are created when configuring S3 NAS buckets.

  • role \ is -protected \ is -protected-on-ontap \ is -protected-on-cloud
    S3 NAS buckets are not protected or mirrored using S3 SnapMirror, but will instead be using regular SnapMirror protection available at volume granularity.

  • versioning-state
    NAS volumes usually have Snapshot technology available to save different versions. However, versioning is not currently available in S3 NAS buckets.

  • logical-used \ object-count
    Equivalent statistics are available for NAS volumes through the volume commands.

System Manager

Add a new S3 NAS bucket on an NAS-enabled storage VM.

  1. Click Storage > Buckets, then click Add.

  2. Enter a name for the S3 NAS bucket and select the storage VM, do not enter a size, then click More Options.

  3. Enter a valid path name or click Browse to select from a list of valid path names.
    When you enter a valid pathname, options that are not relevant to S3 NAS configuration are hidden.

  4. If you have already mapped S3 users to NAS users and created groups, you can configure their permissions, then click Save.
    You must have already mapped S3 users to NAS users before configuring permissions in this step.

Otherwise, click Save to complete S3 NAS bucket configuration.

CLI

Create an S3 NAS bucket in an SVM containing NAS filesystems.
vserver object-store-server bucket create -vserver svm_name -bucket bucket_name -type nas -nas-path junction_path [-comment text]

Example:
cluster1::> vserver object-store-server bucket create -bucket testbucket -type nas -path /vol1