Update Service Identity
put
/apiplatform/management/v1/services/{serviceId}/identity
Updates the name or version of the {serviceId}
service.
Users requesting this resource must be assigned the Service Manager role and must be issued the Manage Service grant for the specified service.
Request
Supported Media Types
- application/json
Path Parameters
-
serviceId: string
A unique ID referencing a specific service.
Root Schema : UpdateServiceIdentityRequest
Type:
Show Source
object
-
name(optional):
string
The updated service name.
-
version(optional):
string
The updated service version. You can clear a service's version by sending the JSON
null
value as the value for this attribute:"version":null
.
Response
Supported Media Types
- application/json
204 Response
The service's identity was updated.
400 Response
Bad request, indicates a problem with the input parameters.
Root Schema : Error
Type:
Show Source
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
Forbidden.
Root Schema : Error
Type:
Show Source
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
Unexpected error.
Root Schema : Error
Type:
Show Source
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 name or version of a service by submitting a PUT request on the REST resource using cURL. For more information about cURL, see Use cURL
curl -i -X PUT
-H "Authorization: Bearer access_token"
-H "Content-Type:application/json"
-d @serviceidentity-put.json
https://example.com/apiplatform/management/v1/services/{serviceId}/identity
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 serviceidentity-put.json
.
{ name: "service", version: "2.0" }
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