Cloud Anchor Management API的cmd中curl更新TTL报错求助

核心问题根源 #

类Unix shell（如Bash）和Windows CMD的引号解析、特殊字符转义规则完全不同，原Unix脚本中的JSON payload在CMD环境下会被错误解析，从而触发"Unknown name"或"无效JSON"这类报错。

正确的CMD执行命令格式 #

假设原Unix环境的命令结构如下（示例）：

curl -X PATCH "https://anchor.googleapis.com/v1/anchors/[ANCHOR_ID]?updateMask=ttl" \
  -H "Authorization: Bearer [ACCESS_TOKEN]" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": "31536000s"
  }'

转换为CMD兼容的命令，需做以下关键调整：

1. 转义JSON中的双引号 #

CMD中，JSON内部的双引号必须用\"转义，同时整个JSON字符串要用一对双引号包裹，避免被CMD拆分解析。

2. 处理命令换行（可选） #

CMD不支持Unix式的\续行符，要么将命令写成单行，要么使用CMD专属的续行符^（注意续行符后不能有任何空格或字符）。

最终可用的CMD命令 #

单行版

curl -X PATCH "https://anchor.googleapis.com/v1/anchors/[ANCHOR_ID]?updateMask=ttl" -H "Authorization: Bearer [ACCESS_TOKEN]" -H "Content-Type: application/json" -d "{\"ttl\": \"31536000s\"}"

多行版（用^续行）

curl -X PATCH "https://anchor.googleapis.com/v1/anchors/[ANCHOR_ID]?updateMask=ttl" ^
-H "Authorization: Bearer [ACCESS_TOKEN]" ^
-H "Content-Type: application/json" ^
-d "{\"ttl\": \"31536000s\"}"

BAT文件执行注意事项 #

如果将命令写入BAT文件，除了遵循上述转义规则，还需注意：

• 续行符^后面必须是空行，不能有任何空格或字符。
• 若ACCESS_TOKEN包含&、%这类特殊字符，%需要替换为%%，&需要用^&转义。

示例BAT文件内容：

@echo off
set "ANCHOR_ID=你的锚点ID"
set "ACCESS_TOKEN=你的有效令牌"
set "TTL_VALUE=31536000s"

curl -X PATCH "https://anchor.googleapis.com/v1/anchors/%ANCHOR_ID%?updateMask=ttl" ^
-H "Authorization: Bearer %ACCESS_TOKEN%" ^
-H "Content-Type: application/json" ^
-d "{\"ttl\": \"%TTL_VALUE%\"}"

验证排查要点 #

• 确认URL中必须包含updateMask=ttl参数，这是API要求的必填项，缺失会直接触发"Unknown name"报错。
• 检查ACCESS_TOKEN是否有效，且账号具备anchors.update权限。
• 可添加curl -v参数开启调试，查看实际发送的请求内容，确认JSON payload是否正确传递。

内容的提问来源于stack exchange，提问作者HiGaTsu Ryu