跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/采集任务
POSTInfrastructure起始版本 1.0同步需要认证

上传模板

上传新自定义模板市场。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • nameString必填

    资源名称。

    示例： My Custom Log Template

  • descriptionString必填

    资源的详细描述。

    示例： Collects application logs from /var/log/myapp/

  • categoryString必填

    类型分类。

    示例： application

  • configObject必填

    配置信息。

    示例： (nested object)

  • variablesLinkedHashMap必填

    变量列表。

    示例： (nested object)

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • idString

    资源ID。

    示例： tmpl-nginx-001

  • nameString

    资源名称。

    示例： Nginx Access Log Collector

  • descriptionString

    资源的详细描述。

    示例： Collects Nginx access logs and parses common log format

  • categoryString

    类型分类。

    示例： web

  • authorString

    作者。

    示例： zstack

  • downloadsInteger

    下载次数。

    示例： 120

  • ratingLong

    评分。

    示例： 4.5

  • configObject

    配置信息。

    示例： (nested object)

  • variablesLinkedHashMap

    变量列表。

    示例： (nested object)

  • createDateString

    创建时间。

    示例： 2026-01-15T08:00:00Z

请求地址

POST/api/v1/collects/templates

/api/v1/collects/templates

操作 ID

UploadTemplate

永久链接

请求示例

curl -X POST '{host}/api/v1/collects/templates' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"My Custom Log Template","description":"Collects application logs from /var/log/myapp/","category":"application","config":"(nested object)","variables":"(nested object)"}'

响应示例

200
{
  "id": "tmpl-nginx-001",
  "name": "Nginx Access Log Collector",
  "description": "Collects Nginx access logs and parses common log format",
  "category": "web",
  "author": "zstack",
  "downloads": 120,
  "rating": 4.5,
  "config": null
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史