セット内の値をアーカイブする
REST API を使用して、カスタムフィールドの値セットに値をアーカイブします。REST API では、カスタムフィールドの値セットはバンドルエンティティによって表されます。
このユースケースでは、列挙型バンドル内の値をアーカイブします。archived 属性をサポートする他のバンドル要素タイプ(BuildBundleElement、OwnedBundleElement、StateBundleElement、VersionBundleElement など)でも、同じパターンを使用できます。
要約
必要な ID を取得したら、このエンドポイントに POST リクエストを送信して値を更新してください。
/api/admin/customFieldSettings/bundles/enum/{bundleID}/values/{valueID}?fields={fields}
ステップバイステップ
列挙値をセットにアーカイブするには
列挙型バンドルとその値のリストを取得します。列挙型バンドルを参照してください。
curl -X GET 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/enum?fields=id,name,values(id,name,archived)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'レスポンスの中から、アーカイブしたいバンドルと値を見つけます。この例では、エンティティ ID が
86-125のPrioritiesバンドルと、エンティティ ID が67-5のMinor値を使用しています。[ { "values": [ { "name": "Major", "archived": false, "id": "67-2", "$type": "EnumBundleElement" }, { "name": "Normal", "archived": false, "id": "67-3", "$type": "EnumBundleElement" }, { "name": "Minor", "archived": false, "id": "67-5", "$type": "EnumBundleElement" } ], "name": "Priorities", "id": "86-125", "$type": "EnumBundle" } ]archived属性をtrueに設定することで、値をアーカイブします。curl -X POST 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/enum/86-125/values/67-5?fields=id,name,archived' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json' \ -d '{"archived": true}'リクエストが成功した場合、レスポンスにはアーカイブされた値が含まれます。
{ "name": "Minor", "archived": true, "id": "67-5", "$type": "EnumBundleElement" }オプション。バンドル内の値を確認してください。
curl -X GET 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/enum/86-125?fields=id,name,values(id,name,archived)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'アーカイブされた値は、
archived属性がtrueに設定された状態でリストされます。
その結果、その値は値の集合内にアーカイブされます。
2026 年 10 月 02 日