# API v2.6を新しいドメインに移行

[新しいバージョニングポリシー](https://api.talend.com/api-versioning-policy/)に従い、Talend APIエンドポイントは、新しいビジネスドメインに段階的かつ確実に移行されました。

r2024-03より、API v2.6は非推奨となります。以下のステップに示されているパスマップを使用し、APIリクエストをAPI v2.6からこれらの新しいドメインに移行します。

## このタスクについて

移行は次の手順で行います:

## 手順

1. 現在のAPIワークフローを確認し、v2.6またはそれ以前のバージョンで実行されたTalend Management Console APIコールを特定します。
2. 以下のテーブルのように、既存のURIリソースパスを新しいドメインに対応するパスに置き換えます:

   APIエンドポイント移行マップAPIエンドポイント移行マップ
   | 第一レベルのリソース | v2.6 API URIパス | 新しいドメイン固有のAPI URIパス |
   | --- | --- | --- |
   | ワークスペース権限 | /workspaces/{workspaceId}/users/{userId}/permissions<br><br>/security/permissions/batch | /security/workspaces/{workspaceId}/users/{userId}/permissions<br><br>/security/permissions/batch |
   | ワークスペース | /workspaces | /orchestration/workspaces |
   | タスクの実行 | /executions<br><br>/executables/tasks/ | /processing/executions<br><br>/processing/executables/tasks/ |
   | タスク | /tasks<br><br>/executables/events/search | /orchestration/tasks<br><br>/orchestration/executables/events/search |
   | スケジュール | /schedules | /orchestration/schedules |
   | リソース | /resources | /orchestration/resources |
   | プロモーションの実行 | /executions/promotions | /processing/executions/promotions |
   | プロモーション | /promotions | /orchestration/promotions |
   | プロジェクト | /projects | /orchestration/projects |
   | プランの実行 | /executions/plans<br><br>/executables/plans/executions<br><br>/executables/plans/{planId}/executions | /processing/executions/plans<br><br>/processing/executables/plans/executions<br><br>/processing/executables/plans/{planId}/executions |
   | プラン | /executables/plans | /orchestration/executables/plans |
   | 環境 | /environments | /orchestration/environments |
   | 接続 | /connections | /orchestration/connections |
   | アーティファクト | /artifacts | /orchestration/artifacts |
   | アカウントのサブスクリプション | /subscription | /account/subscription |
3. パーソナルアクセストークンを使って、新しいAPIコールをテストします。成功したら、変更をコミットします。

## 次のタスク

移行後は、[サービスアカウント](https://api.talend.com/use-cases/service-accounts/creating-a-service-account/)と[マルチトリガータスクまたはプラン](https://api.talend.com/use-cases/multiple-triggers/use-schedule-to-organize-task-runs/)を採用することを検討します:

* サービスアカウントは、Talend Cloudへの認証にアクセストークンを使ってTalend APIエンドポイントをコールする人間以外のユーザーエンティティを表します。これは、IDとセキュリティ管理の強化と自動化に役立ちます。
* マルチトリガータスクまたはプランは時間ベースのトリガーを15個まで持つことができるので、スケジュールのメンテナンスが改善され、複数のトリガーを必要とする場合もタスクまたはプランの重複を回避できます。

これはオプションですが、新しいAPIエンドポイントへの完全移行後に推奨されるものです。

情報メモヒント: サービスアカウントは、ドメイン固有のAPIエンドポイントによってのみサポートされています。サービスアカウントの利点を効果的に活用するためには、これらの新しいエンドポイントへの完全移行が必要となります。