vcenter settings namespaces items: put
Put a map of key value pairs in the namespace. This overrides any existing key/value if they already exist in the namespace. The writePrivilege defined in the namespace is checked before the operation is initiated. When the value is not passed in the map items, the item in the namespace is deleted. When an empty (0 length) String, "", is passed in as the value, the value is set to "". Usage beyond VMware Cloud on AWS is not supported. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
Request:
HTTP request
PATCH https://{server}/rest/vcenter/settings/namespaces/{namespace}/items
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| namespace | string | the targetted namespace. |
Request Body Structure:
{
"items" : [
{
"value" : "string",
"key" : "string"
}
]
}
"items" : [
{
"value" : "string",
"key" : "string"
}
]
}
Request Body Parameters:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| items | list | the input list of key value items. When the value is not passed in the map items, the item in the namespace is deleted. When an empty (0 length) String, "", is passed in as the value, the value is set to "". List of {"key": string, "value": string} |
| items[].key | string | |
| items[].value | string | Optional. |
Response:
HTTP Status Code: 200
NoneErrors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 403 | unauthorized | if the user is not authorized |
| 404 | not_found | if the namespace is not found |
| 500 | error | if the system reports an error while responding to the request |