ファイルにユーザータグを追加します。
操作説明
このオペレーションは、インクリメンタル更新を実行します。
-
同じキーを持つタグが既に存在する場合、その値は上書きされます。
-
タグが存在しない場合は、新しく追加されます。
-
異なるキーを持つ既存のタグは影響を受けません。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/file/put_usertags HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| domain_id |
string |
必須 |
|
|
| body |
object |
任意 |
リクエストボディ。 |
|
| drive_id |
string |
必須 |
ドライブ ID。 |
1 |
| file_id |
string |
必須 |
ファイル ID。 |
9520943DC264 |
| user_tags |
array<object> |
必須 |
追加するタグの配列。配列には 1～1,000 個のタグを含める必要があり、重複するタグキーを含めることはできません。 |
|
|
object |
必須 |
タグキーとタグ値の合計長は、最大 2,000 バイトです。 |
||
| key |
string |
必須 |
タグキー。空にしたり、「#」 文字を含めたりすることはできません。 |
tag |
| value |
string |
任意 |
タグ値。「#」 文字は使用できません。 |
value |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンス。 |
||
| file_id |
string |
ファイル ID。 |
9520943DC264 |
例
成功レスポンス
JSONJSON
{
"file_id": "9520943DC264"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。