如何通过JFrog REST API仅为文件夹内文件添加标签（排除文件夹本身）

你的问题很典型——默认的递归属性设置会把文件夹本身也带上标签，要只给文件打标签，有两种实用的方法，看你场景选：

方法一：直接用API参数排除文件夹（推荐） #

Artifactory的api/storage端点支持通过参数控制是否包含目录对象。你只需要在原命令基础上添加两个参数即可：

curl -s -u username:password -X POST "https://server:port/api/storage/pathtoFolder?properties=key=value&recursive=true&include-dirs=false"

参数说明：

• recursive=true：显式开启递归处理（确保覆盖文件夹下所有层级的文件，有些环境可能默认开启，但显式写更稳妥）
• include-dirs=false：核心参数，告诉Artifactory只对文件设置属性，跳过所有文件夹（包括目标文件夹本身和子文件夹）

这个方法简单直接，不需要额外的查询步骤，只要你的Artifactory版本支持include-dirs参数（一般6.x及以上版本都支持），优先用这个。

方法二：用AQL查询+批量设置属性（兼容旧版本/复杂场景） #

如果你的Artifactory版本比较旧，不支持include-dirs参数，或者需要更精确的文件筛选（比如只给特定后缀的文件打标签），可以用AQL（Artifactory Query Language）先查询出所有目标文件，再批量设置属性：

步骤1：查询目标文件夹下的所有文件 #

用AQL写出查询语句，指定仓库、路径和文件类型：

curl -s -u username:password -X POST "https://server:port/api/search/aql" -H "Content-Type: text/plain" -d '
items.find({
    "repo": "你的仓库名称",
    "path": "pathtoFolder",
    "type": "file"
}).include("repo", "path", "name")
'

执行后会返回所有符合条件的文件的仓库、路径和文件名信息。

步骤2：批量设置属性 #

把查询到的文件列表整理成JSON格式，通过api/storage/bulk/properties端点批量添加标签：

curl -s -u username:password -X POST "https://server:port/api/storage/bulk/properties" -H "Content-Type: application/json" -d '{
    "items": [
        {"repo": "你的仓库名称", "path": "pathtoFolder/subpath1", "name": "file1.txt"},
        {"repo": "你的仓库名称", "path": "pathtoFolder/subpath2", "name": "file2.jar"}
        // 这里可以继续添加更多文件条目
    ],
    "properties": {"key": "value"}
}'

这种方法自由度更高，你可以在AQL里添加更多筛选条件（比如"name": {"$match": "*.jar"}只筛选jar包），适合复杂的需求场景。

内容的提问来源于stack exchange，提问作者abhishek phukan