REST API - update

vcenter settings namespaces: update

Update a namespace with a changing configuration. Requires the SettingsStore.Manage privilege. 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}

Path Parameters

Name Type Description
Required
namespace string namespace identifier.

Request Body Structure:

{
    "spec"{
        "write_privilege""string",
        "description""string",
        "syncable"true,
        "read_privilege""string"
    }
}

Request Body Parameters:

Name Type Description
bold = required
spec update_spec specification to update the namespace.
spec.description string Description for the namespace. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. If unset no description update.

spec.read_privilege string Privilege required for reading this namespace. The user must be assigned a global permission containing this privilege to take effect. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. If unset no readPrivilege update.

spec.write_privilege string Privilege required for updating values in this namespace. The user must be assigned a global permission containing this privilege to take effect. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. If unset no writePrivilege update.

spec.syncable boolean Syncable flag this flag enables / disables sync of the namespace when appliances are linked. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. If unset no synable flag update.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
404 not_found if the namespace is not found
403 unauthorized if user is unauthorized to perform this operation
400 invalid_argument if any of privileges specified in the createspec does not exist
500 error if the system reports an error while responding to the request