複数のワークスペースでユーザーの権限を更新 - Cloud

Talend Cloud APIユーザーガイド

EnrichVersion
Cloud
EnrichProdName
Talend Cloud
EnrichPlatform
Talend API Designer
Talend API Tester
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
task
ジョブデザインと開発 > Designing APIs
ジョブデザインと開発 > Testing APIs

ワークスペースはさまざまな環境に属していることもあります。

Before you begin

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

About this task

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

Procedure

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

    Example

    GET https://api.us.cloud.talend.com/tmc/v2.4/workspaces?query=environment.name==default
  2. レスポンスボディから適切なワークスペースIDをコピーします。
  3. User Management APIでGET /management/usersエンドポイントを使って、ユーザーIDを取得します。
    environment_idクエリーパラメーターやworkspace_idクエリーパラメーターを使えば、単一の環境やワークスペースに検索を絞り込めます。

    Example

    GET https://api.us.cloud.talend.com/v1/management/users?environment_id=5f2a756784fe57eeb4a3f1a
  4. レスポンスボディから適切なユーザーIDをコピーします。
  5. POST (ワークスペースが新しい場合)かPUT (ワークスペースに既に権限が存在する場合) /permissions/batchエンドポイントを使って、ワークスペースのユーザーに権限を割り当てます。
    コピーした情報をリクエストのボディ(ワークスペースとユーザーID)に貼り付けます。

    Example

    POST https://api.us.cloud.talend.com/tmc/v2.4/permissions/batch
    [
        {
         "workspaceId": "5c9212a48c320343cbb5fc4b",
    "userId": "e8f79686-821b-491e-b796-86821b491eb2",
            "permissions": [
                "AUTHOR",
                "EXECUTE",
                "MANAGE",
                "PUBLISH",
                "VIEW"
            ]
        },
        {
              "workspaceId": "9d9212a67c320343chh5fc7l",
          "userId": "e8f79686-821b-491e-b796-86821b491eb2",
            "permissions": [
                "EXECUTE",
                "AUTHOR",
                "VIEW"
            ]
        },
        {
             "workspaceId": "9d9212a67c320343chh5fc7l",
          "userId": "3b7f0e11-4e93-4587-95b2-1ae6292fbb5b",
            "permissions": [
                "EXECUTE",
                "VIEW"
            ]
        }
    ]
  6. 権限が正しく設定されているかどうか検証するためには、ワークスペースごとにGET /permissionsエンドポイントをworkspaceIDクエリーパラメーターと共に使用します。
    変更したワークスペースが同じ環境に属している場合は、environmentIDパラメーターを使えばすべてのワークスペースとその権限を同時に取得できます。

    Example

    GET https://api.us.cloud.talend.com/tmc/v2.4/permissions?workspaceId=9d9212a67c320343chh5fc7l