Keycloak Admin REST API如何查询超100条资源或按名称检索指定资源

Keycloak的资源服务查询接口原生支持name查询参数，传入后会直接返回匹配对应名称的资源，无需拉取全量列表，也不会受分页限制。你可以直接用以下方式调用：

# 方式1：手动编码空格为%20
RESOURCE_ID=$(curl -k -s -H "Authorization: bearer $ACCESS_TOKEN" \
"$KEYCLOAK_URL/auth/admin/realms/$REALM/clients/$CLIENT_ID/authz/resource-server/resource?name=xy%20resource" \
| jq -r '.[0]._id')

如果资源名称包含特殊字符，建议用curl参数自动编码，避免编码错误：

# 方式2：自动处理URL编码（兼容性更好）
RESOURCE_ID=$(curl -k -s -H "Authorization: bearer $ACCESS_TOKEN" -G \
--data-urlencode "name=xy resource" \
"$KEYCLOAK_URL/auth/admin/realms/$REALM/clients/$CLIENT_ID/authz/resource-server/resource" \
| jq -r '.[0]._id')

如果你需要拉取所有资源做批量处理，可以通过Keycloak Admin REST API的通用分页参数绕过默认100条的限制：

• first：分页起始偏移量，默认值为0
• max：单页返回最大条数，默认值为100

如果资源总数可控，直接把max设为足够大的数值即可一次性拉取全量：

RESOURCE_ID=$(curl -k -s -H "Authorization: bearer $ACCESS_TOKEN" \
"$KEYCLOAK_URL/auth/admin/realms/$REALM/clients/$CLIENT_ID/authz/resource-server/resource?max=1000" \
| jq -r '.[] | select(.name=="xy resource")._id')

如果资源数量不确定，可通过循环翻页的方式拉取全部资源，直到返回的资源数组为空即可停止。

内容的提问来源于stack exchange，提问作者Donato Szilagyi