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

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

説明​

指定した 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×更新処理により権限が削除されたか否か
に最終更新