Creates an instance of StorageManager to manage storage (i.e., files) of your application.
The http client to make RESTful API calls to the application's execution engine
The http client to make RESTful API calls to the application's execution engine
Returns a BucketManager for the root bucket. It is equivalent to calling bucket('root')
Creates a new BucketManager object for the specified bucket.
Buckets are the basic containers that hold your application data (i.e., files). Everything that you store in your app storage must be contained in a bucket. You can use buckets to organize your data and control access to your data, but unlike directories and folders, you cannot nest buckets.
Altogic automatically provides a default root bucket where you can store your files. You can pretty much do everthing with the root bucket that you can do with a normal bucket except you cannot delete or rename it.
The name or id of the bucket.
Returns a new BucketManager object that will be used for managing the bucket
Creates a new bucket. If there already exists a bucket with the specified name, it returns an error. You can specify additional information to store with each bucket using the tags which are array of string values. By default if this method is called within the context of a user session, it also assigns the userId of the session to the bucket metadata.
Files can be specified as public or private, which defines how the public URL of the file will behave. If a file is marked as private then external apps/parties will not be able to access it through its public URL. With isPublic parameter of a bucket, you can specify default privacy setting of the files contained in this bucket, meaning that when you add a file to a bucket and if the file did not specify public/private setting, then the the bucket's privacy setting will be applied. You can always override the default privacy setting of a bucket at the individual file level.
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 bucket to create (case sensitive). 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 added to the bucket metadata.
Returns info about newly created bucket
Deletes a file identified by the url string. You can directly use this method to delete any file that you know its url (e.g., no need to specify bucket name/id and file name/id)
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 url of the file that will be deleted
Returns the overall information about your apps cloud storage including total number of buckets and files stored, total storage size in bytes and average, min and max file size in bytes.
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 information about your app's cloud storage
Gets the list of buckets in your app cloud storage. If query expression is specified, it runs the specified filter query to narrow down returned results, otherwise, returns all buckets contained in your app's cloud storage. You can use the following bucket fields in your query expressions.
| Field name | Type | Desciption |
|---|---|---|
| _id | text (identifier) |
Unique identifier of the file |
| name | text |
Name of the bucket |
| isPublic | boolean |
Default privacy setting that will be applied to files of the bucket |
| userId | text (identifier) |
The unique identifier of the user who created the bucket. The userId information is populated only when the bucket is created within the context of a user session. |
| tags | string array |
List of tags added to the bucket metadata |
| createdAt | datetime (text) |
The creation date and time of the bucket |
| updatedAt | datetime (text) |
The last modification date and time of bucket metadata |
You can paginate through your buckets and sort them using the input BucketListOptions 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 buckets
Options to configure how buckets will be listed, primarily used to set pagination and sorting settings
Returns the array of matching buckets. If returnCountInfo=true in BucketListOptions, it returns an object which includes the count information and the matching buckets array.
Gets the list of files matching the search expression. This method performs a global search across all the files contained in all the buckets. You can use the following file fields in your search expression.
| 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 search expression string that will be used to filter file objects
Pagination and sorting options
Returns the files mathcing the search query. If returnCountInfo=true in FileListOptions, returns an object which includes count information and array of matching files.
Generated using TypeDoc
Allows you manage your app's cloud storage buckets and files. With StorageManager you can create and list buckets and use the BucketManager to manage a specific bucket and and its contained files.
You store your files, documents, images etc. under buckets, which are the basic containers that hold your application data. You typically create a bucket and upload files/objects to this bucket.
When you deploy your app to an environment Altogic creates a default bucket called
root. Therootbucket helps you to group your app files that are not under any other bucket. Any file upload, which does not specify a bucket, is uploaded to therootbucket.You cannot rename or delete
rootbucket, but you can empty its contents and change its default privacy setting. By default the files contained inrootbucket is publicly accessible through their URLs. You can change the default privacy setting of therootbucket using the BucketManager.makePublic or BucketManager.makePrivate methods.