Update application key
/developers/services/v1/applications/{id}/key
Updates the key for the {appId}
the application. You can generate a new key by omitting the key attribute from the request body payload (sending {}
as the request body) or specify a key to use by sending it in the key attribute in the request body. Note that application keys must be unique.
Users requesting this resource must be assigned the API Manager, Plan Manager or Application Developer role and must be issued the Manage Application grant for the specified application.
Request
-
appId: string
A unique ID referencing a specific application.
Response
200 Response
400 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
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 update the key for the {appId}
the application by submitting a PUT request on the REST resource using cURL. For more information about cUR, see Use cURL
curl -i -X PUT -u apicsadmin:password https://example.com:443/developers/services/v1/applications/{id}/key
{id}
is the unique ID for an application. To retrieve available applications, see Get applications.
Example of Request Body
The following shows an example of the request body.
{ "key":"25f1f87a-4c9c-4609-b158-4fd81f4f5a26" }
Example of Response Headers
The following shows an example of the response headers.
HTTP/1.1 200 OK Server: Oracle Traffic Director Date: Wed, 20 Dec 2017 05:19:46 GMT Content-type: application/json X-oracle-dms-ecid: 6^3rv0_eR00000000 X-oracle-dms-rid: 0:1
Example of Response Body
The following example shows an example of the request body in JSON format, including a new application key.
{ "key":"25f1f87a-4c9c-4609-b158-4fd81f4f5a26" }