Creates an instance of BucketManager to manage a specific bucket of your cloud storage
The name or id of the bucket that this bucket manager will be operating on
The http client to make RESTful API calls to the application's execution engine
The name of the bucket that the bucket manager will be operating on
The http client to make RESTful API calls to the application's execution engine
Adds the specified tags to bucket's metadata.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
A single tag or an array of tags to add to bucket's metadata
Returns the updated bucket information
Deletes the bucket and all objects (e.g., files) inside the bucket. Returns an error if root bucket is tried to be deleted.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Deletes multiple files identified either by their names or ids.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Array of name or ids of the files to delete
Removes all objects (e.g., files) inside the bucket. This method does not delete the bucket itself. If you also want to delete the bucket, including all its contained objects, you can use delete method.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Check if the bucket exists.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Returns true if bucket exists, false otherwise
Creates a new FileManager object for the specified file.
The name or id of the file.
Returns a new FileManager object that will be used for managing the file
Gets information about the bucket. If detailed=true, it provides additional information about the total number of files contained, their overall total size in bytes, average, min and max file size in bytes etc.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Specifies whether to get detailed bucket statistics or not
Returns basic bucket metadata informaton. If detailed=true provides additional information about contained files.
Gets the list of files stored in the bucket. If query expression is specified, it runs the specified filter query to narrow down returned results, otherwise, returns all files contained in the bucket. You can use the following file fields in your query expressions.
| Field name | Type | Description |
|---|---|---|
| _id | text (identifier) |
Unique identifier of the file |
| bucketId | text (identifier) |
Identifier of the bucket |
| fileName | text |
Name of the file |
| isPublic | boolean |
Whether file is publicy accessible or not |
| size | integer |
Size of the file in bytes |
| encoding | text |
The encoding type of the file such as 7bit, utf8 |
| mimeType | text |
The mime-type of the file such as image/gif, text/html |
| publicPath | text |
The public path (URL) of the file |
| userId | text (identifier) |
The unique identifier of the user who created/uploaded the file. The userId information is populated only when the file is created/uploaded within the context of a user session. |
| tags | string array |
List of tags added to the file metadata |
| uploadedAt | datetime (text) |
The upload date and time of the file |
| updatedAt | datetime (text) |
The last modification date and time of file metadata |
You can paginate through your files and sort them using the input FileListOptions parameter.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
The query expression string that will be used to filter file objects
Pagination and sorting options
Returns the array of files. If returnCountInfo=true in FileListOptions, returns an object which includes count information and array of files.
Sets the default privacy of the bucket to false. You may also choose to make the contents of the bucket private by specifying includeFiles=true. This will automatically set isPublic=false for every file in the bucket.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Specifies whether to make each file in the bucket private.
Returns the updated bucket information
Sets the default privacy of the bucket to true. You may also choose to make the contents of the bucket publicly readable by specifying includeFiles=true. This will automatically set isPublic=true for every file in the bucket.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
Specifies whether to make each file in the bucket public.
Returns the updated bucket information
Removes the specified tags from bucket's metadata.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
A single tag or an array of tags to remove from bucket's metadata
Returns the updated bucket information
Renames the bucket.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
The new name of the bucket. root is a reserved name and cannot be used.
Returns the updated bucket information
Updates the overall bucket data (name, isPublic and tags) in a single method call.
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
The new name of the bucket. root is a reserved name and cannot be used.
The default privacy setting that will be applied to the files uploaded to this bucket.
Array of string values that will be set as the bucket metadata.
Specifies whether to make each file in the bucket to have the same privacy setting of the bucket.
Returns the updated bucket information
Uploads a file to an existing bucket. If there already exists a file with the same name in destination bucket, it ensures the uploaded file name to be unique in its bucket.
If onProgress callback function is defined in FileUploadOptions, it periodically calls this function to inform about upload progress. Please note that for the moment onProgress callback function can only be used in clients where XMLHttpRequest object is available (e.g., browsers).
If the client library key is set to enforce session, an active user session is required (e.g., user needs to be logged in) to call this method.
The name of the file e.g., filename.jpg
The body of the file that will be stored in the bucket
Content type of the file, privacy setting of the file and whether to create the bucket if not exists. contentType is ignored, if fileBody is Blob, File or FormData, otherwise contentType option needs to be specified. If not specified, contentType will default to text/plain;charset=UTF-8. If isPublic is not specified, defaults to the bucket's privacy setting. If createBucket is set to true (defaults to false), then creates a new bucket if the bucket does not exist.
Returns the metadata of the uploaded file
Generated using TypeDoc
BucketManager is primarily used to manage a bucket and its contents (e.g., files, documents, images). Using the StorageManager.bucket method, you can create a BucketManager instance for a specific bucket identified by its unique name or id.