Jump to

• Request
• Response
• Examples

Add or Update a Key Value entry

put

/api/kv/{key}

Updates the value assigned to the specified key. You identify the key using the key parameter. You specify the new value by passing the value in the body of the request.

Request

Supported Media Types

• application/json

Path Parameters

• key: string
  key

Body ()

Body parameters

Root Schema : schema

Type: string

Security

• Authorization: apiKey
  Type: apiKey

Back to Top

Response

Supported Media Types

• text/plain; charset=utf-8

200 Response

200 Response

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: string

{
    "items":{
        "type":"string"
    }
}

Default Response

Error Payload

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: string

{
    "items":{
        "type":"string"
    }
}

Back to Top

Examples

The following example shows how to update the value of a specified key. You perform this task by submitting a PUT request to the REST resource using cURL. For more information about cURL, see Use cURL.

Note: The command in this example uses the URL structure https://rest_server_url/resource-path, where rest_server_url is the manager node for the Oracle Cloud Container instance. See Send Requests for the appropriate URL structure to use for Oracle Public Cloud.

cURL Command

curl -sk 
     -X "PUT" 
     -H "Authorization: Bearer b39f09c71c297f1d" 
     "https://rest_server_url/api/kv/Okey" 
     -d 'Oval'

Example of Response Body

true

Back to Top