Magna-buckets Dialog | Description
| The Magna-buckets dialog is used to provision a new bucket on a Magna-s3 cluster.
Bucket field | Specifies the name for the bucket. Input guidelines mandate lowercase letters from a to z and digits from 0 to 9, with no spaces allowed.
Magna-s3 field | Lists the available Magna-s3 clusters where the bucket can be created.
Send Events toggle | Determines whether bucket events are sent to an Event Hub. The message sent is a JSON in the following format:
    {
        "EventName":"s3:ObjectCreated:Put",
        "Key":"objects/index.html",
        "Records":[
            {
                "eventVersion":"2.0",
                "eventSource":"minio:s3",
                "awsRegion":"",
                "eventTime":"2025-05-01T07:04:48.731Z",
                "eventName":"s3:ObjectCreated:Put",
                "userIdentity":{
                    "principalId":"s3admin"
                },
                "requestParameters":{
                    "principalId":"s3admin",
                    "region":"",
                    "sourceIPAddress":"10.1.0.1"
                },
                "responseElements":{
                    "x-amz-id-2":"987bd8c071d1333a742d869f4b1e15151dd3d9818d703d3c03eb413433ca47ca",
                    "x-amz-request-id":"183B55516BB7C5C7",
                    "x-minio-deployment-id":"c71d1376-a602-49e2-9d2b-ef6ed0b8e541",
                    "x-minio-origin-endpoint":"http://10.1.0.6:9001"
                },
                "s3":{
                    "s3SchemaVersion":"1.0",
                    "configurationId":"Config",
                    "bucket":{
                    "name":"objects",
                    "ownerIdentity":{
                        "principalId":"s3admin"
                    },
                    "arn":"arn:aws:s3:::objects"
                    },
                    "object":{
                    "key":"index.html",
                    "size":186,
                    "eTag":"b4a268daefeb0f7b5fa958a0084847c7",
                    "contentType":"text/html",
                    "userMetadata":{
                        "contenttype":"text/html"
                    },
                    "sequencer":"183B55516BF2D388"
                    }
                },
                "source":{
                    "host":"10.1.0.1",
                    "port":"",
                    "userAgent":"MinIO (linux; amd64) minio-go/v7.0.67 s3/RELEASE.2024-03-30T15-29-52Z"
                }
            }
        ]
        }
PUT Event toggle | Indicates whether put events are forwarded to an Event Hub.
GET Event toggle | Indicates whether get events are forwarded to an Event Hub.
DELETE Event toggle | Indicates whether delete events are forwarded to an Event Hub.
Prefix field | A prefix is a string of characters at the beginning of an object key name, used to filter events for object names that start with that prefix.
Suffix field | A suffix is a string of characters at the end of an object key name, used to filter events for object names that end with that suffix.
Hub Name field | Lists the available Event Hubs to which the events will be dispatched.
Enable Encryption toggle | Specifies whether the objects stored in the bucket are encrypted.
Enable Versioning toggle | Specifies whether object versioning is enabled in the bucket.
Enable Locks toggle | Specifies whether the bucket will enforce retention locking policies.If set to true, versioning will be enabled automatically.
Retention Mode field | Specifies the retention level, which include: Governance Prevents any operation that would alter the object or its locking settings by non-privileged users. The lock is automatically lifted once the configured retention rule duration has elapsed. The Nexus Admin user can lift the lock manually. Compliance Prevents any operation that would alter the object or its locking settings. The lock is automatically lifted after the configured retention rule duration has elapsed, and it cannot be manually lifted by any user. This option enforces complete immutability for locked objects, ensuring that the lock cannot be changed or removed before the retention period expires.
Duration field | Specifies the duration of the retention lock in days or years.
Create button | Saves the bucket configuration and provisions it.
Cancel button | Abort and close the dialog.
Magna-buckets Actions Menu | Description
| On the right-hand side of the Magna-buckets list view, you will find the "Actions" menu that displays shortcut icons and the dropdown menu icon. Below, we have listed the actions for the Magna-buckets module.
Copy ID item | Stores the bucket ID in the clipboard.
Open Bucket item | Opens the Bucket Explorer dialog, allowing you to browse the contents of a bucket, upload and download objects, and delete objects.
Delete Bucket item | Opens a confirmation dialog that, if confirmed, deletes the bucket.
Bucket Explorer Dialog | Description
| The Bucket Explorer dialog provides a file browsing interface for accessing files and folders within Bucket. Below, we have outlined the features of the Bucket Explorer dialog.
Search for box | Input text to search and filter the explorer view.
List view | Navigate through folders in the bucket. Click on a file to download it to your local computer.
Load button | Refreshes and displays the contents of the Bucket.
Delete button | Deletes the specified files and folders from the Bucket.
New Folder button | Launches the new folder dialog to create a new folder within the Bucket.
Upload button | Opens the Files Dialog, allowing you to select files from your local computer to upload to the Bucket.
Show Versions toggle | The default view displays the latest version of the object. If "Show Versions" is enabled, all versions of the object will be listed.
Close button | Close the Bucket Explorer dialog.

#### The magna-buckets Policy The following is a list of policy grants that define and regulate access permissions for both users and the API. To manage these policies, please use the Roles dialog.
Grants | Description | API Command
full | Grants full access | ALL
copy-file | Permits the file copy operation in the storage. | copy-file
delete | Permits the deletion of the item. | delete
delete-file | Permits the file delete operation in the storage. | delete-file
download-file | Permits the download of a file from the storage. | download-file
edit | Permits access to the "Storage Explorer" dialog. |
list | Permits listing in the List View area or as JSON objects. | list
list-bucket | Permits listing of files and folders in the File Explorer dialog or as JSON objects. | list-bucket
move-file | Permits the file move operation in the storage. | move-file
new | Permits access to the new "Provisioning" dialog. |
new-folder | Permits new folder operation in the storage. | new-folder
read-file | Permits file read operation in the storage. | read-file
save | Permits execution of the create or update process. | create
upload-file | Permits file upload operation in the storage. | upload-file Read more in API Builder
write-file | Permits file write operation in the storage. | write-file