Appearance
カスタムロール
カスタムロールは、ワークスペースのオーナーが権限の組み合わせを選んで定義するワークスペースロールです。 メンバーに割り当てると、組み込みロールの代わりにその権限が適用されます。
権限の組み合わせを変えると、割り当て済みのメンバー全員の到達範囲が変わるため、 定義の変更を到達可能性の変更として記録します。
イベント一覧
| イベント | リソース | 説明 |
|---|---|---|
workspace_role.create | workspace_role | カスタムロールが作成された |
workspace_role.rename | workspace_role | カスタムロール名が変更された |
workspace_role.update | workspace_role | カスタムロールの権限が変更された |
workspace_role.delete | workspace_role | カスタムロールが削除された |
イベント詳細
workspace_role.create プレビュー
記録期間: 2026-10-21 〜
カスタムロールの作成を記録します。
| フィールド | 値 |
|---|---|
event.code | workspace_role.create |
scope.type | workspace |
resource.type | workspace_role |
references | （なし） |
query | （なし） |
outbound | （なし） |
change | 作成時の権限 |
grant | （なし） |
extra | （なし） |
change
作成したカスタムロールに含まれる権限が入ります。
| 名前 | モード | 型 | 必須 | 説明 |
|---|---|---|---|---|
grants | 値 | string[] | 必須 | カスタムロールに含まれる権限。値は {領域}.{レベル} 形式です（例: public_connection.execute）。全メンバーに固定で付与される権限は含みません。 |
サンプル
json
{
"event": {
"code": "workspace_role.create",
...
},
"scope": {
"type": "workspace",
...
},
"resource": {
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst",
"path": "workspace_role/63e1be654aa70ad689601ca0",
"parts": [
{
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst"
}
],
...
},
"change": {
"fields": [
{
"name": "grants",
"new": [
"public_connection.execute",
"shared_notebook.read"
]
}
]
},
...
}workspace_role.rename プレビュー
記録期間: 2026-10-21 〜
カスタムロールの表示名の変更を記録します。
| フィールド | 値 |
|---|---|
event.code | workspace_role.rename |
scope.type | workspace |
resource.type | workspace_role |
references | （なし） |
query | （なし） |
outbound | （なし） |
change | name |
grant | （なし） |
extra | （なし） |
change
| 名前 | モード | 型 | 必須 | 説明 |
|---|---|---|---|---|
name | 値 | string | 必須 | 変更前後の表示名 sensitivity: pii |
サンプル
json
{
"event": {
"code": "workspace_role.rename",
...
},
"scope": {
"type": "workspace",
...
},
"resource": {
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Data Analyst",
"path": "workspace_role/63e1be654aa70ad689601ca0",
"parts": [
{
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Data Analyst"
}
],
...
},
"change": {
"fields": [
{
"name": "name",
"old": "Analyst",
"new": "Data Analyst"
}
]
},
...
}workspace_role.update プレビュー
記録期間: 2026-10-21 〜
カスタムロールに含まれる権限の変更を記録します。 変更は、このロールを割り当てられたすべてのメンバーに適用されます。
| フィールド | 値 |
|---|---|
event.code | workspace_role.update |
scope.type | workspace |
resource.type | workspace_role |
references | （なし） |
query | （なし） |
outbound | （なし） |
change | 変更前後の権限 |
grant | （なし） |
extra | （なし） |
change
変更前後のカスタムロールに含まれる権限が入ります。
| 名前 | モード | 型 | 必須 | 説明 |
|---|---|---|---|---|
grants | 値 | string[] | 必須 | カスタムロールに含まれる権限。値は {領域}.{レベル} 形式です（例: public_connection.execute）。全メンバーに固定で付与される権限は含みません。 |
サンプル
json
{
"event": {
"code": "workspace_role.update",
...
},
"scope": {
"type": "workspace",
...
},
"resource": {
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst",
"path": "workspace_role/63e1be654aa70ad689601ca0",
"parts": [
{
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst"
}
],
...
},
"change": {
"fields": [
{
"name": "grants",
"old": [
"shared_notebook.read"
],
"new": [
"public_connection.execute",
"shared_notebook.read"
]
}
]
},
...
}workspace_role.delete プレビュー
記録期間: 2026-10-21 〜
カスタムロールの削除を記録します。 メンバーや未承諾の招待に割り当てられているロールは削除できません。
| フィールド | 値 |
|---|---|
event.code | workspace_role.delete |
scope.type | workspace |
resource.type | workspace_role |
references | （なし） |
query | （なし） |
outbound | （なし） |
change | （なし） |
grant | （なし） |
extra | （なし） |
サンプル
json
{
"event": {
"code": "workspace_role.delete",
...
},
"scope": {
"type": "workspace",
...
},
"resource": {
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst",
"path": "workspace_role/63e1be654aa70ad689601ca0",
"parts": [
{
"type": "workspace_role",
"uid": "63e1be654aa70ad689601ca0",
"name": "Analyst"
}
],
...
},
...
}