> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI でワークスペースのメンバーを管理する

> squarecloud workspace member で、使い捨てのコードを使って Square Cloud のワークスペースに招待し、権限グループの変更やメンバーの削除を行います。

ワークスペースには、参加する本人が生成する招待コードで参加します。

<Steps>
  <Step title="新しいメンバーがコードを生成する">
    参加したい人が `squarecloud workspace member invite-code` を実行し、コードをワークスペースのオーナーに送ります。コードは 1 回だけ使え、5 分で期限切れになります。
  </Step>

  <Step title="オーナーがメンバーを追加する">
    オーナーが、ワークスペース ID、コード、権限グループを指定して `squarecloud workspace member add` を実行します。
  </Step>
</Steps>

## 権限グループ

`<group>` には次のいずれかを指定します。

| グループ | メンバーができること |
| - | - |
| `admin` | 共有アプリケーションのフルコントロール。環境変数、スナップショット、カスタムドメイン、デプロイ設定も含みます。 |
| `maintain` | 運用作業。コミット、起動、停止、再起動、ファイル、DNS、キャッシュのパージ。 |
| `manager` | 監視と制御。起動、停止、再起動、デプロイ情報。コミット、ファイル、ネットワークの変更はできません。 |
| `view` | 読み取り専用。 |

オーナー自身のグループは `owner` で、ほかの人に付与することはできません。[ワークスペースの権限](https://help.squarecloud.app/en-us/article/workspace-permissions-collaborators-12ahei1/)について詳しくはヘルプセンターを参照してください。

## `squarecloud workspace member invite-code`

```bash 使い方 theme={"system"}
squarecloud workspace member invite-code
```

5 分間有効な、使い捨ての自分の招待コードを生成します。

```bash 出力 theme={"system"}
Your invite code (single-use, valid for 5 minutes):
  <inviteCode>
```

## `squarecloud workspace member add`

```bash 使い方 theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> <group>
```

`<inviteCode>` を生成した人を、指定した権限グループでワークスペースに追加します。メンバーを追加できるのはワークスペースのオーナーだけで、上限はオーナーのプランのメンバー数までです。

```bash theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> maintain
```

## `squarecloud workspace member update`

```bash 使い方 theme={"system"}
squarecloud workspace member update <workspaceID> <memberID> <group>
```

メンバーの権限グループを変更します。メンバー ID は [`workspace info`](/ja/cli-reference/workspaces#squarecloud-workspace-info) で確認してください。

## `squarecloud workspace member remove`

```bash 使い方 theme={"system"}
squarecloud workspace member remove <workspaceID> <memberID> [-y]
```

| フラグ | 説明 |
| - | - |
| `-y`、`--yes` | 確認プロンプトをスキップします。 |

`y/N` の確認のあと、ワークスペースからメンバーを削除します。メンバーを削除できるのはワークスペースのオーナーだけです。自分がワークスペースから抜けるには、[`workspace leave`](/ja/cli-reference/workspaces#squarecloud-workspace-leave) を使います。

## 関連項目

| コマンド | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `invite-code` | [`GET .../members/code`](/ja/api-reference/endpoint/workspace/members/code) | [`api.workspaces.members.inviteCode()`](/ja/sdks/js/workspaces) | [自分の招待コードをコピー](/ja/vscode-extension/features#ワークスペース) |
| `add` | [`POST .../members`](/ja/api-reference/endpoint/workspace/members/invite) | [`api.workspaces.members.add()`](/ja/sdks/js/workspaces) | |
| `update` | [`PATCH .../members`](/ja/api-reference/endpoint/workspace/members/perms) | [`api.workspaces.members.update()`](/ja/sdks/js/workspaces) | |
| `remove` | [`DELETE .../members`](/ja/api-reference/endpoint/workspace/members/kick) | [`api.workspaces.members.remove()`](/ja/sdks/js/workspaces) | |