リソース ACL の削除
概要
この操作は、指定したユーザおよび役割のリソースに対する NamedResource.EXECUTE 権限を削除します。
特定のレスポンスを理解するには、次のビジネス ルールが参考になります。
- ResourceList には、すべての名前付きマップまたはすべての名前付きレイヤのどちらか 1 種類のリソースが含まれます。
- 権限の削除は、常に上位の親リソースと下位の従属リソースに継承されます。例えば、上位への継承では名前付きマップから名前付きタイルへと、下位への継承では名前付きマップから名前付きグループ レイヤ、名前付きレイヤ、名前付きラベル レイヤ、名前付きラベル ソースへと継承されます。
- 権限の削除が下位に継承されるときに、別の上位のリソースが機能するために下位のリソースに ACL が必要な場合は、権限は削除されません。例えば、同じ名前付きレイヤを参照する 2 つの名前付きマップに対してユーザが権限を持っている場合、一方の名前付きマップから権限を削除しても、その変更はレイヤには継承されません。ユーザはそのレイヤを参照するもう一方の名前付きマップを引き続きレンダリングできるからです。
- オプションのパラメータ recurseToData が true の場合、EXECUTE 権限を削除すると従属名前付きテーブルにも継承されます。EXECUTE 権限がないとユーザはテーブルに対してクエリを実行できないため、テーブルに Dataset.DML CREATE、MODIFY、または DELETE 権限がある場合は、それらの権限も削除されます。
- 名前付き WMTS タイルに関しては、権限の削除はどの従属リソースにも継承されません。
- すべてのユーザおよび役割で、指定したリソースに対する権限が削除されます。1 回のリクエストで、ユーザまたは役割ごとに異なる権限を指定することはできません。指定したリソース (およびその従属リソース) に対してユーザまたは役割が権限を持っているかどうかによって、権限が削除されるリソースは、ユーザまたは役割ごとに異なる場合があります。
ACL 認証フロー
このリクエストを行うユーザは、WRITE 権限を持っているリポジトリ フォルダ (またはサブフォルダ) 内のリソースに対する権限のみを削除できます。
HTTP POST URL 形式
指定したリソースから ACL を削除する場合、HTTP POST リクエストには次の形式を使用します。
HTTP POST URL: /acl/resources/delete
POST DATA: {
"users":[
"user1"
],
"roles":[
"role1"
],
"resources":[
"/Samples/NamedTiles/WorldTile"
],
"permissions":[
"EXECUTE"
]
}
POST HEADER: Content-Type:application/json
パラメータ
パラメータ | タイプ | 必須 | 説明 |
---|---|---|---|
ユーザ | 文字列 | はい | ユーザのリストを指定します。リクエストで役割が指定されていない場合にのみ必須です。 |
ロール | 文字列 | はい | 役割のリストを指定します。リクエストでユーザが指定されていない場合にのみ必須です。 |
リソース | 文字列 | はい | リソースのリストを指定します。 |
権限 | 文字列 | はい | リソースから削除する権限を指定します。指定できる権限は EXECUTE のみです。 |
recursetoData | 文字列 | いいえ | ACL 権限の削除を従属名前付きテーブルに継承するかどうかを指定します。 |
戻り値
指定したユーザおよび役割について、EXECUTE 権限が削除されたリソース (およびその従属リソース) のリスト。
POST の例
要求 URL
http://<サーバー>:<ポート>/rest/Spatial/AccessControlService/acl/resources/delete
要求の本文
{ "users":[ "user1" ], "roles":[ "role1" ], "resources":[ "/Samples/NamedTiles/WorldTile" ], "permissions":[ "EXECUTE" ] }
応答
{ "users":[ { "name":"user1", "resources":[ "/Samples/NamedTiles/WorldTile", "/Samples/NamedLayers/WorldcapFeatureLayer", "/Samples/NamedLayers/WorldFeatureLayer", "/Samples/NamedMaps/WorldMap", "/Samples/NamedLayers/Grid15FeatureLayer", "/Samples/NamedLabelSources/WorldCountriesLabelSource", "/Samples/NamedLayers/OceanFeatureLayer", "/Samples/NamedTables/OceanTable", "/Samples/NamedTables/Grid15Table", "/Samples/NamedTables/WorldcapTable", "/Samples/NamedTables/WorldTable" ] } ], "roles":[ { "name":"role1", "resources":[ "/Samples/NamedTiles/WorldTile", "/Samples/NamedLayers/WorldcapFeatureLayer", "/Samples/NamedLayers/WorldFeatureLayer", "/Samples/NamedMaps/WorldMap", "/Samples/NamedLayers/Grid15FeatureLayer", "/Samples/NamedLabelSources/WorldCountriesLabelSource", "/Samples/NamedLayers/OceanFeatureLayer", "/Samples/NamedTables/OceanTable", "/Samples/NamedTables/Grid15Table", "/Samples/NamedTables/WorldcapTable", "/Samples/NamedTables/WorldTable" ] } ] }