Aliyun OSS icon

Aliyun OSS

Sends data to Aliyun OSS

Actions12

Bucket → Get Many

AI-generated

Overview

The Aliyun OSS node for n8n allows you to interact with Alibaba Cloud's Object Storage Service (OSS). Specifically, the Bucket → Get Many operation retrieves a list of buckets from your Aliyun OSS account. This is useful for automating workflows that need to enumerate available storage buckets, such as syncing data, auditing storage resources, or dynamically selecting a bucket for further file operations.

Practical examples:

  • List all storage buckets to display them in a dashboard.
  • Retrieve up to a specified number of buckets for reporting or monitoring.
  • Use the output as input for subsequent nodes that require a bucket name.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit. If enabled, all buckets are returned; if disabled, only up to the specified limit are returned.
Limit Max number of results to return (only shown if "Return All" is false). Accepts values between 1 and 500.

Output

The output is an array of JSON objects, each representing a bucket. Each object typically contains details about a single bucket, such as its name, creation date, and other metadata provided by Aliyun OSS.

Example output:

[
  {
    "name": "example-bucket",
    "creationDate": "2023-01-01T12:00:00Z",
    "location": "oss-cn-hangzhou"
    // ...other fields depending on Aliyun OSS API response
  },
  ...
]
  • The structure may include additional fields as returned by the Aliyun OSS SDK/API.
  • No binary data is produced by this operation.

Dependencies

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

Troubleshooting

Common issues:

  • Invalid Credentials: If your Aliyun credentials are incorrect or missing, the node will fail to connect and retrieve buckets.
  • Insufficient Permissions: The provided credentials must have permission to list buckets in OSS.
  • API Limits: If you request more than 500 buckets with the "Limit" property, the node will not allow it due to the maximum enforced value.

Error messages and resolutions:

  • "InvalidAccessKeyId" or "SignatureDoesNotMatch": Check your Aliyun credentials.
  • "NoSuchBucket": Ensure you are operating on existing buckets.
  • "RequestTimeout": Network issues or incorrect region configuration—verify your settings.

Links and References

Discussion