REST API - create
  1. Operations
  2. vcenter
  3. settings
  4. namespaces

vcenter settings namespaces: create

Creates a namespace. 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

POST https://{server}/rest/vcenter/settings/namespaces

Request Body Structure:

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

Request Body Parameters:

Name Type Description
bold = required
spec create_spec the specification used for creating a namespace.
spec.name string The namespace name. 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.
spec.description string Description of 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 is entered into the description atribute.
spec.read_privilege string The privilege required for a user to read this namespace. The user must be assigned a global permission containing this privilege. 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.
spec.write_privilege string The privilege required for a user to update values in this namespace. The user must be assigned a global permission containing this privilege. 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.
spec.syncable boolean The boolean flag to indicate if the namespace is syncable. 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.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
400 already_exists if the namespace with the specified name already exists
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