メイン コンテンツをスキップする 補完的コンテンツへスキップ

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

新しいバージョニングポリシーに従い、Talend APIエンドポイントは、新しいビジネスドメインに段階的かつ確実に移行されました。

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

このタスクについて

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

手順

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

    /workspaces/{workspaceId}/users/{userId}/permissions

    /security/permissions/batch

    /security/workspaces/{workspaceId}/users/{userId}/permissions

    /security/permissions/batch

    ワークスペース /workspaces /orchestration/workspaces
    タスクの実行

    /executions

    /executables/tasks/

    /processing/executions

    /processing/executables/tasks/

    タスク

    /tasks

    /executables/events/search

    /orchestration/tasks

    /orchestration/executables/events/search

    スケジュール /schedules /orchestration/schedules
    リソース /resources /orchestration/resources
    プロモーションの実行 /executions/promotions /processing/executions/promotions
    プロモーション /promotions /orchestration/promotions
    Projects /projects /orchestration/projects
    プランの実行

    /executions/plans

    /executables/plans/executions

    /executables/plans/{planId}/executions

    /processing/executions/plans

    /processing/executables/plans/executions

    /processing/executables/plans/{planId}/executions

    プラン /executables/plans /orchestration/executables/plans
    環境 /environments /orchestration/environments
    接続 /connections /orchestration/connections
    アーティファクト /artifacts /orchestration/artifacts
    アカウントのサブスクリプション /subscription /account/subscription
  3. パーソナルアクセストークンを使って、新しいAPIコールをテストします。成功したら、変更をコミットします。

次のタスク

移行後は、サービスアカウントマルチトリガータスクまたはプランを採用することを検討します:
  • サービスアカウントは、Talend Cloudへの認証にアクセストークンを使ってTalend APIエンドポイントをコールする人間以外のユーザーエンティティを表します。これは、IDとセキュリティ管理の強化と自動化に役立ちます。
  • マルチトリガータスクまたはプランは時間ベースのトリガーを15個まで持つことができるので、スケジュールのメンテナンスが改善され、複数のトリガーを必要とする場合もタスクまたはプランの重複を回避できます。
これはオプションですが、新しいAPIエンドポイントへの完全移行後に推奨されるものです。
情報メモヒント: サービスアカウントは、ドメイン固有のAPIエンドポイントによってのみサポートされています。サービスアカウントの利点を効果的に活用するためには、これらの新しいエンドポイントへの完全移行が必要となります。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。