ワークスペース上のユーザーにフルアクセス権を付与 - Cloud

Talend Cloud APIユーザーガイド

Version
Cloud
Language
日本語 (日本)
Product
Talend Cloud
Module
Talend API Designer
Talend API Tester
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
Content
ジョブデザインと開発 > Designing APIs
ジョブデザインと開発 > Testing APIs

始める前に

  • Talend Cloud Management Console[Environment Administrator] (環境管理者)ロールを担っていること。
  • 権限を設定するワークスペースとユーザーのIDを知っていること。

このタスクについて

Management Console APIにはhttps://api.us.cloud.talend.com/tmc/swagger/swagger-ui.html経由でアクセスできます。各データセンターに該当するURLのリストは、Talend CloudのリージョンとURLで確認できます。

手順

  1. GET /workspacesエンドポイントを使って、権限を設定しているワークスペースのIDを取得します。
    query=environment.name=={environmentName}クエリーパラメーターを使って、検索を単一の環境に絞り込むことができます。

    例え

    GET https://api.us.cloud.talend.com/tmc/v2.4/workspaces?query=environment.name==default
  2. GET /v1/management/usersエンドポイントを使って、権限を設定したいユーザーのIDを取得します。

    例え

    GET https://api.us.cloud.talend.com/v1/management/users?page=1&size=50
  3. ユーザーが既にワークスペースで権限を持っている場合、PUT /workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、リクエストのボディに権限(["AUTHOR"、"EXECUTE"、"MANAGE"、"PUBLISH"、"VIEW"、"ENGINE_USE"])を追加します。

    例え

    PUT https://api.us.cloud.talend.com/tmc/v2.4/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
    ["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW", "ENGINE_USE"]
    注: ENGINE_USE権限は、TMC_ENGINE_USEユーザー権限を持つユーザーにのみ与えられます。この組み合わせにより、[Operator] (オペレーター)ロールを持たないユーザーでも、シートを消費することなくRemote Enginesを使ってタスクを実行できるようになります。
  4. ユーザーがワークスペースで何の権限も持たない場合、POST /workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、リクエストのボディに権限(["AUTHOR"、"EXECUTE"、"MANAGE"、"PUBLISH"、"VIEW"、"ENGINE_USE"])を追加します。

    例え

    POST https://api.us.cloud.talend.com/tmc/v2.4/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
    ["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW", "ENGINE_USE"]
    注: ENGINE_USE権限は、TMC_ENGINE_USEユーザー権限を持つユーザーにのみ与えられます。この組み合わせにより、[Operator] (オペレーター)ロールを持たないユーザーでも、シートを消費することなくRemote Enginesを使ってタスクを実行できるようになります。
  5. GET /workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、更新を確定します。

    例え

    GET https://api.us.cloud.talend.com/tmc/v2.4/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
    レスポンスボディにはワークスペースIDと割り当てられたすべての権限が含まれるはずです。
    "workspaceId": "7a35e78eaea645620e47f826",
    "userId": "d13404b5-e9nc-4g5f-9904-a5f0dc287fb0",
    "permissions":["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW", "ENGINE_USE"]