[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"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

Update Entity Access Control Grant

Description

Updates the specified access-control grant.

Request

Request

URL

URL


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

Path Parameters

Path Parameters

string
objectId Required

string
accessControlId Required

Request Body

Request Body

AccessControlGrant of type(s) application/json Required
{
    "accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
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

200 OK

Returns AccessControlGrant of type(s) application/json;version=37.0
{
    "accessLevelId": "urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
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 PUT -H "Content-Type: application/json" -d '{"accessLevelId":"urn:vcloud:accessLevel:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}' https://{api_host}/cloudapi/1.0.0/entities/{objectId}/accessControls/{accessControlId}


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"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?