全部產品
Search
文件中心

Alibaba Cloud Model Studio:BatchUpdateFileTag - 批次更新文檔標籤

更新時間:May 16, 2026

該介面用於批次更新資料連線中的文檔標籤。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

PUT /{WorkspaceId}/datacenter/batchupdatetag HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

WorkspaceId

string

業務空間 ID。在百鍊的控制台首頁,單擊頁面左上方業務空間詳情表徵圖擷取。

llm-3shx2gu255oqxxxx

請求參數

名稱

類型

必填

描述

樣本值

FileInfos

array<object>

需要更新的文檔列表

object

FileId

string

資料中心的檔案 ID,您可以在應用資料頁面,單擊檔案名稱旁的 ID 表徵圖擷取。

file_3d5319366e2c46309f4c11cfbeacd5fd_10045951

tags

array

  • 檔案關聯的標籤列表。最多傳入 100 個標籤,所有標籤字元長度總和不能超過 700。

string

標籤值,每個標籤最多 32 個字元,支援 Unicode 中 letter 分類下的字元(其中包括英文、中文和數字等),底線_,中劃線-,標籤中不能包含空格。

TagA

UpdateMode

string

更新模式,僅支援 APPEND(追加)和 OVERWRITE(覆蓋)

OVERWRITE

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

Code

string

錯誤狀態代碼

Success

Data

object

介面返回的業務欄位。

UpdateFileTagResultList

array<object>

標籤更新的結果清單

object

FileId

string

檔案 ID。

file_f40f2a32205d44b4a93b11617113da15_10045951

Success

boolean

介面調用是否成功,可能值為:

  • true:成功。

  • false:失敗。

true

ErrorCode

string

返回錯誤碼,僅當 Success 為 false 時返回。

NoPermission

ErrorMessage

string

錯誤描述資訊,僅當 Success 為 false 時返回。

FileId not exists.

Message

string

錯誤資訊

Required parameter(FileId) missing or invalid, please check the request parameters.

RequestId

string

Id of the request

17204B98-xxxx-4F9A-8464-2446A84821CA

Status

string

介面返回的狀態代碼。

200

Success

boolean

介面調用是否成功,可能值:

  • true:成功。

  • false:失敗。

true

樣本

正常返回樣本

JSON格式

{
  "Code": "Success",
  "Data": {
    "UpdateFileTagResultList": [
      {
        "FileId": "file_f40f2a32205d44b4a93b11617113da15_10045951",
        "Success": true,
        "ErrorCode": "NoPermission",
        "ErrorMessage": "FileId not exists."
      }
    ]
  },
  "Message": "Required parameter(FileId) missing or invalid, please check the request parameters.",
  "RequestId": "17204B98-xxxx-4F9A-8464-2446A84821CA",
  "Status": "200",
  "Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情