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

## 始める前に

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

## このタスクについて

Management Console APIには[このリンク](https://api.talend.com/apis/)でアクセスできます。各データセンターに該当するURLのリストは、[Talend Cloudのアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-url)で確認できます。

## 手順

1. GET orchestration/workspacesエンドポイントを使って、権限を設定しているスペースのIDを取得します。

   query=environment.name=={environmentName}クエリーパラメーターを使えば、検索を単一の環境に絞り込むことができます。
   ### 例
   ```
   GET https://api.us.cloud.talend.com/orchestration/workspaces?query=environment.name==default
   ```
2. GET /v1/management/usersエンドポイントを使って、権限を設定したいユーザーのIDを取得します。
   ### 例
   ```
   GET https://api.us.cloud.talend.com/account/users?page=1&size=50
   ```
3. ユーザーが既にスペースで権限を持っている場合は、PUT security/workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、リクエストのボディに権限(["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW"])を追加します。
   ### 例
   ```
   PUT https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
   ["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW"]
   ```

   情報メモ注: ユーザーアカウントにTMC\_ENGINE\_USEユーザー権限がある場合、このアカウントに付与されるスペース権限はEXECUTEとVIEWのみです。この組み合わせにより、[Operator] (オペレーター)ロールを持たないユーザーでも、シートを消費することなくRemote Enginesを使ってタスクを実行できるようになります。
4. ユーザーがスペースで何の権限も持たない場合は、POST /security/workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、リクエストのボディに権限(["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW"]を追加します。
   ### 例
   ```
   POST https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
   ["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW"]
   ```

   情報メモ注: ユーザーアカウントにTMC\_ENGINE\_USEユーザー権限がある場合、このアカウントに付与されるスペース権限はEXECUTEとVIEWのみです。この組み合わせにより、[Operator] (オペレーター)ロールを持たないユーザーでも、シートを消費することなくRemote Enginesを使ってタスクを実行できるようになります。
5. GET /security/workspaces/{workspaceId}/users/{userId}/permissionsエンドポイントを使って、アップデートを確定します。
   ### 例
   ```
   GET https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
   ```

   レスポンスのボディにはスペースIDと割り当てられたすべての権限が含まれるはずです。
   ```
   "workspaceId": "7a35e78eaea645620e47f826",
   "userId": "d13404b5-e9nc-4g5f-9904-a5f0dc287fb0",
   "permissions":["AUTHOR", "EXECUTE", "MANAGE", "PUBLISH", "VIEW"]
   ```