リソース別の ACL リストの取得

概要

この操作は、すべてのユーザおよび役割の指定した名前付きリソースに対する権限を返します。リソースリストには、フォルダまたは名前付きリソースパスを含めることができます。各リソースのレスポンスには、リソースに対する権限を持っているユーザまたは役割が含まれています。

名前付きテーブルの権限には、EXECUTE (実行)、CREATE (作成)、MODIFY (変更)、DELETE (削除) があります。
リポジトリフォルダの権限には、READ (読み取り)、WRITE (書き込み) があります。
他の名前付きリソースの権限には、EXECUTE (実行) があります。

注: リクエストを行う場合、以下の点を考慮する必要があります。

POST リクエストでは、リポジトリフォルダの末尾にスラッシュを付加する必要があります。スラッシュがないとエラーが返されます。
名前付きリソースのパスでは、末尾にスラッシュを付加してはいけません。スラッシュがあるとエラーが返されます。

ACL 認証フロー

このリクエストを行うユーザは、WRITE 権限を持っているリポジトリフォルダ (またはサブフォルダ) 内のリソースに対する権限のリストのみを取得できます。

HTTP GET URL 形式

リソース別の ACL リストを取得する HTTP GET リクエストには次の形式を使用します。

HTTP GET http://<サーバー>:<ポート>/rest/Spatial/AccessControlService/acl/resources/resourceName

パラメータ


パラメータ	タイプ	必須	説明
resourceName	文字列	はい	1 つ以上の名前付きリソースへの完全パスを指定します。リソースには、フォルダまたはリソースのパスを指定できます。

HTTP POST URL 形式

HTTP POST リクエストには次の形式を使用します。

HTTP POST URL: /acl/resources
POST BODY: {
   "resources":[
      "/Samples/NamedTiles/WorldTile",
      "/Samples/NamedMaps/WorldMap"
   ]
}
POST HEADER: Content-Type:application/json

戻り値

指定したリソースリストに対するすべてのユーザおよび役割の権限を返します。

GET の例

要求 URL

http://<サーバー>:<ポート>/rest/Spatial/AccessControlService/acl/resources/Samples/NamedTiles/WorldTile

応答

{
   "resourceAclList":[
      {
         "name":"/Samples/NamedTiles/WorldTile",
         "resourceType":"NamedTile",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      }
   ]
}

POST の例

要求 URL

http://<サーバー>:<ポート>/rest/Spatial/AccessControlService/acl/resources

要求の本文

{
   "resources":[
      "/Samples/NamedTiles/WorldTile",
      "/Samples/NamedMaps/WorldMap"
   ]
}

応答

{
   "resourceAclList":[
      {
         "name":"/Samples/NamedTiles/WorldTile",
         "resourceType":"NamedTile",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      },
      {
         "name":"/Samples/NamedMaps/WorldMap",
         "resourceType":"NamedMapAndView",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      }
   ]
}