すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:BatchUpdateFileTag

最終更新日:May 15, 2026

この API は、データ接続内のドキュメントタグを一括で更新します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

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

パスパラメータ

パラメーター

必須 / 任意

説明

WorkspaceId

string

必須

ワークスペース ID です。この ID を取得するには、Model Studio のコンソールホームに移動し、左上隅にあるワークスペース詳細アイコンをクリックします。

llm-3shx2gu255oqxxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

FileInfos

array<object>

必須

更新するファイルのリストです。

object

必須

FileId

string

必須

ファイル ID です。この ID を取得するには、アプリケーションデータページに移動し、ファイル名の横にあるIDアイコンをクリックします。

file_3d5319366e2c46309f4c11cfbeacd5fd_10045951

tags

array

必須

  • ファイルに関連付ける、最大 100 個のタグのリストです。すべてのタグの合計長は 700 文字を超えることはできません。

string

任意

タグです。長さは最大 32 文字で、スペースを含めることはできません。使用できる文字は、Unicode 文字 (英字、漢字、数字など) 、アンダースコア (_) 、ハイフン (-) です。

TagA

UpdateMode

string

任意

更新モードです。有効な値は APPEND と OVERWRITE です。

OVERWRITE

レスポンスフィールド

フィールド

説明

object

応答スキーマです。

Code

string

レスポンスコードです。値が Success の場合、呼び出しが成功したことを示します。

Success

Data

object

API によって返されるデータです。

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 です。

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

Status

string

リクエストに対して返されるステータスコードです。

200

Success

boolean

リクエストが受け入れられたかどうかを示します。各ファイルのステータスについては、UpdateFileTagResultList をご確認ください。有効な値:

  • true: リクエストは受け入れられました。

  • false: 無効なパラメーターなどが原因でリクエストに失敗しました。

true

成功レスポンス

JSONJSON

{
  "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
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。