メインコンテンツまでスキップ

プロジェクトの権限の更新


説明

指定した ID のプロジェクトの権限を更新します。

必要権限

プロジェクトの管理

URL

PUT /project/projects/{projectId}/acl/{aclId}

パスパラメーター

名前必須か説明
projectIdstringプロジェクトID
aclIdstring権限ID
※本項目は、次のAPIで取得した値を使用してください。:「プロジェクトの権限の取得

リクエストボディ

名前必須か説明
aceChangeProjectAceChange×権限詳細の変更

レスポンス

名前説明
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

名前必須か説明
addsProjectAceAdd[]×追加するプロジェクト権限詳細
updatesProjectAceUpdate[]×更新するプロジェクト権限詳細
removesstring×プロジェクト権限から削除するパーティーのID
カンマ区切りで複数指定可能

ProjectAceAdd

名前必須か説明
partyIdstringアクセス制御の対象とするパーティーのID
partyTypestringアクセス制御の対象とするパーティーの分類(下記注意事項を参照)
・User:ユーザー
・Organization:組織
・UserGroup:ユーザーグループ
permissionsProjectPermissionTypeアクセス制御の対象とするパーティーの権限設定情報
権限名に対する権限の設定情報を表します。
指定する値は大文字/小文字を完全に一致させてください。

partyTypeで指定した値が大文字/小文字が異なる場合(例:USER)、APIの応答は「成功」を返しますが正しく設定されていません。
その場合は、次のAPIで対象のACLを削除してください。:「プロジェクトの権限の削除

ProjectAceUpdate

名前必須か説明
partyIdstringアクセス制御の対象とするパーティーのID
permissionsProjectPermissionTypeアクセス制御の対象とするパーティーの権限設定情報
権限名に対する権限の設定情報を表します。

ProjectPermissionType

名前必須か説明
browsePermissionType×プロジェクト閲覧権限
editPermissionType×プロジェクト編集権限
managePermissionType×プロジェクト管理権限

PermissionType

名前必須か説明
Allowstring×許可
Denystring×拒否

UpdatedProjectAcl

名前必須か説明
idstring×更新対象の権限のID
isAclDeletedboolean×更新処理により権限が削除されたか否か