Node.js - bucket()

Create a new bucket for storing and retrieving files.

import { bucket } from '@nitric/sdk';

// Create a readable/writable reference to an 'assets' bucket
const assets = bucket('assets').for('reading', 'writing', 'deleting');


name required string

The unique name of this buckets within the app. Subsequent calls to bucket with the same name will return the same object.


All Nitric resources provide access permissions you can use to specify the level of access your code needs to the resource. See here for details Access Control documentation.

Available permissions:


This permission allows your function to read files from the bucket


This permission allows your function to write files to the bucket


This permission allows your function to delete files from the bucket

Working with files

See the following for examples on working with files in a bucket: