[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Create Entity Access Control Grant

Description

Creates an access-control grant, giving the user the level of access for the vCD entity.

Request

Request

URL

URL


post
https://{api_host}/cloudapi/1.0.0/entities/{objectId}/accessControls
Copy

Path Parameters

Path Parameters

string
objectId Required

Request Body

Request Body

AccessControlGrant of type(s) application/json Required
{
	"accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
	"grantType": "string"
}
string
accessLevelId Required

The ID of the level of access which the subject will be granted.


string
grantType Required

Indicates whether this access control grant is based on user memberships or entitlements


string
id Optional

VcloudId URN identifier for ACL grant


string
objectId Optional

The object that this access control grant applies to


tenant Optional

The tenant this grant applies in. This is managed by the system and depends on the organization the requester operates in at the time of creation and the actual principal type.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created returns AccessControlGrant of type(s) application/json;version=36.3
{
	"accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
	"grantType": "string",
	"id": "string",
	"objectId": "string",
	"tenant": {
		"id": "string",
		"name": "string"
	}
}
string
accessLevelId Required

The ID of the level of access which the subject will be granted.


string
grantType Required

Indicates whether this access control grant is based on user memberships or entitlements


string
id Optional

VcloudId URN identifier for ACL grant


string
objectId Optional

The object that this access control grant applies to


tenant Optional

The tenant this grant applies in. This is managed by the system and depends on the organization the requester operates in at the time of creation and the actual principal type.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"accessLevelId":"urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","grantType":"string","id":"string","objectId":"string","tenant":{"id":"string","name":"string"}}' https://{api_host}/cloudapi/1.0.0/entities/{objectId}/accessControls


[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Feedback

Was this page helpful?