コンテンツへスキップ

ブラウザプロファイルのタグを一括設定

Request

選択したリソースのタグを上書きします。タグ管理権限と対象へのアクセス権限が必要です。チーム内で名前が完全一致するタグを再利用して色を更新し、存在しなければ作成します。色の変更は同じタグを使う他のリソースにも反映されます。リクエスト内のタグ名は重複できません。tags が空配列の場合、割り当てのみ解除し、タグ定義とグループは保持します。同期処理で、data は null です。タイムアウト後は対象と /api/envtag/all を確認してから再試行してください。冪等性キーはありません。

文書化されたビジネスエラー: 15003, 15004, 19039, 19173, 19193。 各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Bodyapplication/jsonrequired
Any of:
envIdsArray of strings, non-emptyrequired

ブラウザプロファイル ID。空でない envIds または uniqueIds が必要です。空でない envIds が優先されます。既存の一括選択と権限確認のルールで対象を解決します。

uniqueIdsArray of integers

envIds が空または省略された場合に使うプロファイル通し番号。

Example:
[ 1 ]
tagsArray of objectsrequired

現在のタグ割り当てをすべて置き換えるタグ。空配列は割り当てのみ解除し、タグ定義は削除しません。

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setTags/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "envIds": [
      "1993244721490239488"
    ],
    "tags": [
      {
        "tagName": "Sales",
        "tagColor": "blue"
      }
    ]
  }'

Responses

成功。タグ割り当てを同期更新しました。data は null です。

Bodyapplication/json
codeinteger
Example:0
msgstring or null
requestIdstring
datanull
Response
{ "code": 0, "msg": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d", "data": null }