Issue service grants
/apiplatform/management/v1/services/{serviceId}/grants
Issue a grant to a user or group for the {serviceId}
service.
The user requesting this resource must be assigned the Service Manager role and must be issued the Manage Service grant for the specified service.
Request
- application/json
-
serviceId: string
A unique ID referencing a specific service.
object
-
group(optional):
object group
-
type(optional):
string
The grant type's name.
-
user(optional):
object user
Response
- application/json
204 Response
403 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
500 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
Examples
The following example shows how to issue a grant to a user or group for the service by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL
curl -i -X POST
-H "Authorization: Bearer access_token"
-H "Content-Type:application/json"
-d @servicegrant-post.json
https://example.com//apiplatform/management/v1/services/{serviceId}/grants
where {serviceId}
is a unique Id of a specific service. See Get Services.
Example of Request Body
The following shows an example of the request body, included with the request above in a file named servicegrant-post.json
.
{ "type":"ReferenceServiceGrant", "user":{"id":"api-manager-user2"} }
Example of Response Headers
The following shows an example of the response headers.
HTTP/1.1 204 No Content Server: Oracle-Traffic-Director/12.2.1.0.0 Date: Sun, 22 Oct 2017 08:34:10 GMT X-oracle-dms-ecid: 49d14691-2176-4c99-aed3-38438604f528-00001e4e X-oracle-dms-rid: 0:1 Via: 1.1 otd_opc Proxy-agent: Oracle-Traffic-Director/12.2.1.0.0