REST API - get
  1. Operations
  2. vcenter
  3. namespaces
  4. access

vcenter namespaces access: get

Get the information about the access control of the subject on given domain on the namespace.

Request:

HTTP request

GET https://{server}/api/vcenter/namespaces/instances/{namespace}/access/{domain}/{subject}

?type={value}

Path Parameters

Name Type Description
Required
namespace string Identifier for the namespace.
domain string The domain of the subject.
subject string The principal for this operation.

Query Parameters:

Name Type Description
bold = required
type string Lists the types of subjects who can be associated with a role on the namespace. Value is one of:
USER: Single user.
GROUP: Group of users.The type of subject (user or group).

Response:

HTTP Status Code: 200

Response Body Structure:

{
    "role" : "EDIT"
}

Headers:

None

Type:

Name Type Description
bold = required
- info Information about the subject including the type and the role on the namespace.
-.role string Role of the subject on the namespace.

Lists the default roles which can be associated with a subject on a domain on the namespace. Value is one of:
EDIT: This role allows modification of the namespace.
VIEW: This is a read-only role on the namespace.

Errors:

HTTP Status Code Type Description
500 error if the system reports an error while responding to the request.
404 not_found if namespace cannot be located.
400 unsupported if the specified principal on given domain is not associated with the namespace.
401 unauthenticated if the user can not be authenticated.
403 unauthorized if the user does not have System.Read privilege.