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

YouTrack 開発者ポータルヘルプ

バージョン値をアーカイブする

REST API を使用して、バージョンバンドル内の値をアーカイブします。バージョンバンドルの値は、VersionBundleElement エンティティで表されます。

値をアーカイブすると、共有バージョンバンドルが更新されます。これは、このバンドルを使用するすべてのカスタムフィールドに影響を与える可能性があります。

バージョンバンドルの詳細については、バージョンバンドルを参照してください。

要約

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

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

ステップバイステップ

バージョン値をアーカイブするには

  1. バージョンバンドルとその値の一覧を取得します。

    curl -X GET 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/version?fields=id,name,values(id,name,archived,released)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'

    レスポンスの中から、アーカイブしたいバンドルと値を特定します。この例では、エンティティ ID が 97-4 の Affected versions バンドルと、エンティティ ID が 133-12 の 2025.3 バージョン値を使用しています。

    [ { "values": [ { "name": "2025.3", "archived": false, "released": true, "id": "133-12", "$type": "VersionBundleElement" }, { "name": "2026.1", "archived": false, "released": false, "id": "133-19", "$type": "VersionBundleElement" } ], "name": "Affected versions", "id": "97-4", "$type": "VersionBundle" } ]
  2. バージョン値をアーカイブするには、その archived 属性を true に設定します。

    curl -X POST 'https://example.youtrack.cloud/api/admin/customFieldSettings/bundles/version/97-4/values/133-12?fields=id,name,archived,released' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json' \ -d '{"archived": true}'

    リクエストが成功した場合、レスポンスにはアーカイブされたバージョンの値が含まれます。

    { "name": "2025.3", "archived": true, "released": true, "id": "133-12", "$type": "VersionBundleElement" }

その結果、バージョン値はバージョンバンドルにアーカイブされます。

2026 年 10 月 02 日