Aliyun OSS icon

Aliyun OSS

Sends data to Aliyun OSS

Folder → Create

AI-generated

Overview

The Aliyun OSS node for n8n allows you to interact with Alibaba Cloud's Object Storage Service (OSS). Specifically, the Folder → Create operation enables users to create a new folder within a specified bucket in their OSS account. This is useful for organizing files and data within buckets, mirroring directory structures, or preparing storage locations for subsequent file uploads.

Common scenarios:

  • Automating the creation of project-specific folders when onboarding new clients.
  • Structuring data storage by date, user, or category before uploading files.
  • Integrating with other workflows that require dynamic folder management in OSS.

Example:
When a new customer signs up, automatically create a dedicated folder in an OSS bucket to store their documents.


Properties

Name Meaning
Bucket Name The name of the OSS bucket where the new folder will be created. This is required.
Folder Name The name of the folder to create inside the specified bucket. This is required.
Additional Fields A collection of optional settings:
- Parent Folder Key: Specify a parent folder under which to create the new folder.
- Requester Pays: If enabled, requester pays for requests and data transfer.
- Storage Class: Choose the storage class for the folder. Options: Deep Archive, Glacier, Intelligent Tiering, One Zone IA, Reduced Redundancy, Standard, Standard IA.

Output

The output is a JSON object indicating the success of the folder creation operation:

{
  "success": true
}

If the operation fails and "Continue On Fail" is enabled, the output will include an error message:

{
  "error": "Error message here"
}

Dependencies

  • External Service: Requires access to Alibaba Cloud OSS.
  • Credentials: You must configure Aliyun credentials in n8n (region, accessKeyId, accessKeySecret).
  • n8n Configuration: The node expects valid OSS credentials to be set up in the workflow's credentials section.

Troubleshooting

Common Issues:

  • Invalid Credentials: If your OSS credentials are incorrect or missing, the node will fail to authenticate.
  • Bucket Not Found: If the specified bucket does not exist, the operation will fail.
  • Insufficient Permissions: The provided credentials must have permission to create folders in the target bucket.
  • Folder Already Exists: Attempting to create a folder that already exists may result in an error or be silently ignored, depending on OSS behavior.

Common Error Messages:

  • "InvalidAccessKeyId": Check your Access Key ID.
  • "SignatureDoesNotMatch": Ensure your Access Key Secret is correct.
  • "NoSuchBucket": Verify the bucket name.
  • "AccessDenied": Make sure your credentials have the necessary permissions.

How to resolve:

  • Double-check your credentials and bucket/folder names.
  • Ensure the OSS user has the right permissions.
  • Confirm the bucket exists in the specified region.

Links and References

Discussion