List effective group's handle privileges
Returns the list of effective group's ({gid}) privileges in a handle ({id}).
Effective privileges are a sum of group's privileges and privileges inherited from its parent group memberships.
This operation requires handle_view privilege
or oz_handles_view_privileges admin privilege.
Example cURL requests
List effective group's privileges in a handle
curl -u username:password -X GET \
https://$ZONE_HOST/api/v3/onezone/handles/$HANDLE_ID/effective_groups/$GROUP_ID/privileges
{
"privileges": [
"handle_delete",
"handle_update",
"handle_view"
]
}
Path parameters
| Parameter | Type & Description |
|---|---|
| id required | string Handle Id. |
| gid required | string Group Id. |
Request Examples
onezone-rest-cli listEffectiveGroupHandlePrivileges id=45bf25a5cb16e12a9faa6d088a2c7088 gid=c44d4ab910245342be5a0a89fdff095eResponses
The list of effective group's privileges in the handle.
A list of privileges in the handle service.
Example
{
"privileges": [
"handle_delete",
"handle_update",
"handle_view"
]
}Invalid request.
error Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}Authentication error.
error Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}Authorization error.
error Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}Resource not found.
error Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}Internal server Error.
error Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}