プロジェクトの権限の更新
説明
指定した ID のプロジェクトの権限を更新します。
必要権限
プロジェクトの管理
URL
PUT /project/projects/{projectId}/acl/{aclId}
パスパラメーター
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| projectId | string | ○ | プロジェ クトID |
| aclId | string | ○ | 権限ID ※本項目は、次のAPIで取得した値を使用してください。: 「プロジェクトの権限の取得」 |
リクエストボディ
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| aceChange | ProjectAceChange | × | 権限詳細の変更 |
レスポンス
| 名前 | 型 | 説明 |
|---|---|---|
| ー | UpdatedProjectAcl[] | 権限の更新情報を返す。 |
エラーケース
- 指定したプロジェクトが存在しない
- 指定 したプロジェクトに権限が存在しない
- パーティーの分類にユーザー/ユーザーグループ/組織以外を指定する
- 指定したユーザー/ユーザーグループ/組織が存在しない
- プロジェクトの管理権限がない
- プロジェクトに追加する権限が重複している
特記事項
なし
サンプル
指定したプロジェクトの権限を更新する
PUT /project/projects/3/acl/20
Request Body
{
"aceChange": {
"adds": [
{
"partyType": "User",
"partyId": "8",
"permissions": {
"browse": "Allow",
"edit": "Deny",
"manage": "Deny"
}
}
],
"updates": [
{
"partyId": "7",
"permissions": {
"browse": "Allow",
},
}
],
"removes": "22,23"
},
}
Response
200 OK
[
{
id: "20",
isAclDeleted: false
}
]
型定義
ProjectAceChange
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| adds | ProjectAceAdd[] | × | 追加するプロジェクト権限詳細 |
| updates | ProjectAceUpdate[] | × | 更新するプロジェクト権限詳細 |
| removes | string | × | プロジェクト権限から削除するパーティーのID カンマ区切りで複数指定可能 |
ProjectAceAdd
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| partyId | string | ○ | アクセス制御の対象とするパーティーのID |
| partyType | string | ○ | アクセス制御の対象とするパーティーの分類(下記注意事項を参照) ・User:ユーザー ・Organization:組織 ・UserGroup:ユーザーグループ |
| permissions | ProjectPermissionType | ○ | アクセス制御の対象とするパーティーの権限設定情報 権限名に対する権限の設定情報を表します。 |
指定する値は大文字/小文字を完全に一致させてください。
partyTypeで指定した値が大文字/小文字が異なる場合(例:USER)、APIの応答は「成功」を返しますが正しく設定されていません。
その場合は、次のAPIで対象のACLを削除してください。: 「プロジェクトの権限の削除」
ProjectAceUpdate
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| partyId | string | ○ | アクセス制御の対象とするパーティーのID |
| permissions | ProjectPermissionType | ○ | アクセス制御の対象とするパーティーの権限設定情報 権限名に対する権限の設定情報を表します。 |
ProjectPermissionType
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| browse | PermissionType | × | プロジェクト閲覧権限 |
| edit | PermissionType | × | プロジェクト編集権限 |
| manage | PermissionType | × | プロジェクト管理権限 |
PermissionType
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| Allow | string | × | 許可 |
| Deny | string | × | 拒否 |
UpdatedProjectAcl
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| id | string | × | 更新対象の権限のID |
| isAclDeleted | boolean | × | 更新処理により権限が削除されたか否か |