發布 Agent 版本

支援將指定 Agent 版本發布為線上生產版本。

該 API 使用目標 Agent 自身的 API Key 進行驗證，僅允許已開啟版本管理權限的 Agent 調用。

請求方式

POST

調用地址

https://api.${endpoint}/v1/agent/version/release

調用驗證

詳情請參閱 API 概述的驗證方式說明。請使用目標 Agent 的 API Key 作為 token。

請求

請求範例

curl -X POST 'https://api.${endpoint}/v1/agent/version/release' \ -H 'Authorization: Bearer ${token}' \ -H 'Content-Type: application/json' \ -d '{ "version": "v2" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/version/release' \
  -H 'Authorization: Bearer ${token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "version": "v2"
  }'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	說明
Authorization	Bearer ${token}	使用目標 Agent 的 API Key 進行調用驗證。
Content-Type	application/json	請求內容格式。

請求參數（Body Parameters）

參數	類型	說明	required
version	String	要發布為線上的版本號。	true

回應

回應內容

{ "code": 0, "message": "OK", "data": { "version": "v2", "previous_version": "v1" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "version": "v2",
    "previous_version": "v1"
  }
}

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
version	String	本次發布的版本號。
previous_version	String	發布前的線上版本號；首次發布時為空。

失敗回應

欄位	類型	說明
code	int	錯誤碼。
message	string	錯誤訊息。

狀態碼

狀態碼	說明
200	成功
400	參數錯誤
401	未授權
403	權限不足或 API Key 未開啟版本管理權限
429	請求過於頻繁
500	伺服器錯誤