Create Entity Access Control Grant

Create Entity Access Control Grant

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

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/entities/{objectId}/accessControls
COPY
Path Parameters
string
objectId
Required

objectId

Request Body
AccessControlGrant of type(s) application/json
Optional

Show optional properties

{
    "grantType": "string",
    "accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
{
    "id": "string",
    "tenant": {
        "name": "string",
        "id": "string"
    },
    "grantType": "string",
    "objectId": "string",
    "accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns AccessControlGrant of type(s) application/json;version=39.1 
"AccessControlGrant Object"
string
id
Optional

VcloudId URN identifier for ACL grant

object
tenant
Optional

Entity reference used to describe VCD entities

string
grantType
Required

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

string
objectId
Optional
Constraints: maxLength: 128

The object that this access control grant applies to

string
accessLevelId
Required
Constraints: maxLength: 128

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


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"accessLevelId:"string","grantType:"string"}' https://{api_host}/cloudapi/1.0.0/entities/{objectId}/accessControls
Availability
Added in 35.0
On This Page
Access Controls Operations
GET
Query Entity Access Control Grants
POST
Create Entity Access Control Grant
GET
Get Entity Access Control Grant
PUT
Update Entity Access Control Grant
DELETE
Remove Entity Access Control Grant