如何在Salt State的API调用中获取minion id作为参数？

当然有现成的默认变量可用啦！SaltStack 内置的 Grains 系统里就包含了 minion 的唯一 ID，你直接用 grains['id'] 就能拿到它，完全不需要额外配置或者自定义脚本。

为什么用 grains['id']？ #

Grains 是 Salt Minion 启动时自动收集的系统元数据集合，id 是其中最核心的字段之一——每个 Minion 的 ID 都是唯一且固定的（除非你手动修改配置），所以用它作为 API 参数绝对可靠。

实际使用示例 #

下面给你两种常见的 API 调用场景写法：

1. 使用 Salt 官方的 http.query 模块（推荐）

这种方式比直接调用 curl 更符合 Salt State 的规范，也更容易维护：

notify_api_on_completion:
  http.query:
    - name: https://your-api-domain.com/state-completed
    - method: POST
    - data: |
        {
          "minion_id": "{{ grains['id'] }}",
          "state_status": "success",
          "timestamp": "{{ grains['datetime'] }}"
        }
    - headers:
        Content-Type: application/json

2. 使用 cmd.run 调用 curl

如果你习惯用命令行工具，也可以这么写：

call_api_via_curl:
  cmd.run:
    - name: >
        curl -X POST 
        -H "Content-Type: application/json" 
        -d '{"minion_id": "{{ grains['id'] }}", "status": "done"}' 
        https://your-api-endpoint.com/notify

小提示 #

在 YAML 里写 Jinja 变量的时候，注意引号的嵌套问题——用块标量（|）来写 JSON 数据会避免很多转义麻烦，就像第一个示例那样，可读性也更强。

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