Actions44
- User Actions
- Database Actions
- Collection Actions
- Document Actions
- Index Actions
- Function Actions
- Storage Actions
Overview
This node integrates with the Appwrite API to manage storage-related resources, specifically focusing on file operations within buckets. The "List Files" operation under the "Storage" resource retrieves a list of files stored in a specified bucket. This is useful for workflows that need to enumerate or process files stored remotely, such as syncing files, generating reports on stored content, or triggering actions based on file presence.
Practical examples include:
- Automatically listing all files in a cloud bucket to process or move them.
- Monitoring storage usage by counting or analyzing files in a bucket.
- Integrating with other systems by fetching file metadata before downloading or sharing.
Properties
| Name | Meaning |
|---|---|
| Bucket ID | Unique identifier of the storage bucket from which to list files. Required for all file operations. Use "unique()" to auto-generate when creating a new bucket. |
Output
The output is a JSON array where each item represents a file object retrieved from the specified bucket. Each file object contains metadata about a file stored in the bucket, such as its ID, name, size, and other relevant attributes provided by the Appwrite API.
If the node operation involves downloading files (not applicable here), it can also output binary data representing the file contents. For the "List Files" operation, only JSON metadata is returned.
Dependencies
- Requires an API key credential for authenticating with the Appwrite API.
- Needs proper configuration of the Appwrite API credentials in n8n.
- Depends on the Appwrite client library bundled within the node implementation.
Troubleshooting
Common issues:
- Invalid or missing Bucket ID will cause the operation to fail.
- Authentication errors if the API key credential is incorrect or expired.
- Network connectivity problems may prevent communication with the Appwrite server.
Error messages:
- Errors thrown by the node include detailed messages from the Appwrite API response when available.
- If the node encounters an unknown error, it returns a generic message "An unknown error occurred."
Resolutions:
- Verify the Bucket ID is correct and the bucket exists.
- Ensure the API key credential is valid and has sufficient permissions.
- Check network connectivity and firewall settings.
- Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.