Aliyun OSS icon

Aliyun OSS

Sends data to Aliyun OSS

Actions12

Bucket → Search

AI-generated

Overview

The Aliyun OSS node for n8n allows you to interact with Alibaba Cloud's Object Storage Service (OSS). Specifically, the Bucket → Search operation enables you to search and list objects within a specified bucket, with options to filter results by prefix, delimiter, encoding type, and more. This is useful for automating workflows that need to process or analyze files stored in OSS buckets, such as data ingestion, backup management, or content cataloging.

Practical examples:

  • List all files in a bucket for further processing.
  • Retrieve only files with a specific prefix (e.g., all images in a folder).
  • Paginate through large sets of objects in a bucket.

Properties

Name Meaning
Bucket Name The name of the OSS bucket to search in. (Required)
Return All Whether to return all results or only up to a given limit. If false, the number of results is limited by the "Limit" property.
Limit Max number of results to return. Only shown if "Return All" is false. Accepts values from 1 to 500.
Additional Fields Collection of optional parameters:
• Delimiter: Character used to group keys.
• Encoding Type: Encoding for object keys in response (options: URL).
• Fetch Owner: Include owner field in results.
• Prefix: Limits response to keys starting with this prefix.
• Requester Pays: Indicates requester pays for requests/data transfer.
• Start After: Key after which listing starts.

Output

The output is an array of objects representing the contents of the bucket matching the search criteria. Each object typically includes fields such as:

[
  {
    "Key": "example/path/file.txt",
    "LastModified": "2024-06-01T12:34:56.000Z",
    "ETag": "\"abc123...\"",
    "Size": 12345,
    "StorageClass": "STANDARD",
    "Owner": {
      "ID": "owner-id",
      "DisplayName": "owner-name"
    }
    // ...other possible fields depending on additional options
  }
]
  • The exact structure may vary based on the selected "Additional Fields".
  • No binary data is returned by this operation; only metadata about objects is provided.

Dependencies

  • External Service: Requires access to Alibaba Cloud OSS.
  • Credentials: You must configure Aliyun credentials (accessKeyId, accessKeySecret, region) in n8n under the credential type named aliyun.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If your access key or secret is incorrect, authentication will fail. Double-check your credentials in n8n.
  • Bucket Not Found: If the specified bucket does not exist or is misspelled, you will receive an error.
  • Insufficient Permissions: Ensure your Aliyun user has permission to list objects in the target bucket.
  • API Rate Limits: Excessive requests may be throttled by Aliyun OSS.

Error Messages:

  • "The specified bucket does not exist": Check the "Bucket Name" property for typos.
  • "AccessDenied": Verify your credentials and permissions.
  • "InvalidArgument": Review the values for properties like "Limit" or "Prefix".

Links and References

Discussion