値のセットを作成する

REST API を使用して、カスタムフィールドに割り当て可能な再利用可能な値のセットを作成します。REST API では、値のセットはバンドルエンティティによって表されます。

このユースケースでは、列挙型バンドルを作成します。BuildBundle、OwnedBundle、StateBundle、VersionBundle などの他のバンドルタイプでも、同じパターンを使用できます。

列挙型バンドルの詳細については、列挙型バンドルを参照してください。

要約

値のセットを作成するには、対象フィールドタイプのバンドルエンドポイントに POST リクエストを送信します。

/api/admin/customFieldSettings/bundles/enum?fields={fields}

リクエスト本文に、バンドル名と追加したい値を記述してください。
{ "name": "Customer Impact", "values": [ {"name": "Low", "$type": "EnumBundleElement"}, {"name": "Medium", "$type": "EnumBundleElement"}, {"name": "High", "$type": "EnumBundleElement"} ], "$type": "EnumBundle" }
POST リクエストを使用して列挙型バンドルを作成します。
curl -X POST 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/enum?fields=id,name,values(id,name)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json' \ -d '{ "name": "Customer Impact", "values": [ {"name": "Low", "$type": "EnumBundleElement"}, {"name": "Medium", "$type": "EnumBundleElement"}, {"name": "High", "$type": "EnumBundleElement"} ], "$type": "EnumBundle" }'
レスポンスボディを確認してください。リクエストが成功した場合、レスポンスには作成されたバンドルが含まれています。
{ "values": [ { "name": "Low", "id": "67-12", "$type": "EnumBundleElement" }, { "name": "Medium", "id": "67-13", "$type": "EnumBundleElement" }, { "name": "High", "id": "67-14", "$type": "EnumBundleElement" } ], "name": "Customer Impact", "id": "86-10", "$type": "EnumBundle" }

その結果、REST API リクエストで参照できる列挙型バンドルが作成されました。このバンドルは、プロジェクトのカスタムフィールドに割り当てるまで、課題には表示されません。

この値セットを使用して列挙型カスタムフィールドを作成し、プロジェクトに追加するには、列挙型カスタムフィールドを作成し、プロジェクトに追加するを参照してください。既存のプロジェクトカスタムフィールドの値セットを置き換えるには、カスタムフィールドの値セットを置き換えるを参照してください。

2026 年 10 月 02 日