Aliyun OSS | 阿里云对象存储Install

Summary

List folders in a specified Aliyun OSS bucket, optionally filtered by prefix, and return either all or a limited number of folders with URLs built from default or custom domain endpoints.

Inputs

• Bucket Name | 存储桶名称 — Name of the target bucket; if left empty, uses the default bucket from credentials.
• Use Custom Domain | 使用自定义域名 — Toggle to use a custom domain instead of the default OSS endpoint for folder URLs.
• Custom Domain | 自定义域名 — Fully qualified custom domain URL (including protocol) bound to the bucket, used if 'Use Custom Domain' is enabled.
• Return All | 返回全部 (required) — Choose whether to return all folders or limit the number of results.
• Limit | 数量上限 — Maximum number of folders to return if 'Return All' is false; minimum 1, maximum 1000.
• Options | 其他选项 — Additional filters to refine the folder list, including:
• Options.prefix | 目录前缀 — Only return folders whose names start with this prefix.
• Options.baseFolder | 基准目录 — A base folder prefix to remove from the start of returned folder names.

Output shape

a list of folder objects, each containing the folder's name, full path within the bucket, bucket name, and a URL to the folder

The list supports pagination internally; setting 'Return All' returns all folders, otherwise limits the number returned. Folder URLs reflect the use of a custom domain if specified; otherwise, default OSS endpoints are used.

Examples

Example 1: Return all folders in the default bucket

Set 'Return All' to true, leave 'Bucket Name' empty.

Example 2: Return up to 100 folders with a specific prefix and custom domain

Set 'Return All' to false, 'Limit' to 100, 'Options.prefix' to the desired prefix, enable 'Use Custom Domain', and set 'Custom Domain' to your domain URL.

Links

• n8n community nodes installation guide