llms.txt : 機械可読形式のドキュメント索引。このページの Markdown バージョンも利用可能です。

YouTrack 開発者ポータルヘルプ

セット内の値をアーカイブする

REST API を使用して、カスタムフィールドの値セットに値をアーカイブします。REST API では、カスタムフィールドの値セットはバンドルエンティティによって表されます。

このユースケースでは、列挙型バンドル内の値をアーカイブします。archived 属性をサポートする他のバンドル要素タイプ(BuildBundleElement、OwnedBundleElement、StateBundleElement、VersionBundleElement など)でも、同じパターンを使用できます。

要約

必要な ID を取得したら、このエンドポイントに POST リクエストを送信して値を更新してください。

/api/admin/customFieldSettings/bundles/enum/{bundleID}/values/{valueID}?fields={fields}

ステップバイステップ

列挙値をセットにアーカイブするには

  1. 列挙型バンドルとその値のリストを取得します。列挙型バンドルを参照してください。

    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" } ]
  2. 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" }
  3. オプション。バンドル内の値を確認してください。

    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 日