Update ACL Resource Details

Details

API Details
NameUpdate ACL Resource Details
Description

Updates permissions for any CloudCenter Resource managed by Access Control Lists (ACLs).

MethodPUT
URIv1/acls/
CloudCenter ReleaseIntroduced in CloudCenter 4.2.
Notes
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
  • The resourceName attribute is mandatory in the request URI.
ESB Headeraction: update.acls

Example

curl -k -X PUT -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/acls/

Request Body - Example 1

{
    "id": "14",
    "resourceName": "DEPLOYMENT_ENVIRONMENT",
    "users": [
        {
            "id": 2,
            "perms": [
                "administration",
                "execute",
                "manage",
                "move_in",
                "move_out",
                "approve"
            ]
        }
    ],
    "userGroups": [],
    "tenantUsers": [
        {
            "id": 1,
            "perms": [
                "read"
            ]
        }
    ],
    "tenantAndSubtenantUsers": [],
    "ownerUserId": "2"
}

Request Body - Example 2

You must first share the deployment with other users to enable them to web SSH/VNC into the deployment's VMs:

  • Share the deployment (Access permission, see Permission Control > Deployment Permissions).
    AND
  • Share the deployment environment (Access permission, see Permission Control > Deployment Environment Permissions).

Only the deployment owner can share a deployment, irrespective of the Deployment Environment permissions

{
    "id": "7427",
    "resourceName": "DISTRIBUTED_JOB",
    "users": [{
        "id": "5",
        "resource": "https://<HOST>:<PORT>/v1/acls/5?id=7427&resourceName=DISTRIBUTED_JOB",
        "perms": ["administration", "write", "read", "delete"],
        "username": "eng_5",
        "enabled": true,
        "type": "TENANT",
        "firstName": "CloudCenter",
        "lastName": "Eng",
        "tenantId": "5",
        "emailAddr": "eng@company.com"
    }],
    "userGroups": [],
    "tenantUsers": [{
        "id": "5",
        "resource": "https://<HOST>:<PORT>/v1/acls/5?id=7427&resourceName=DISTRIBUTED_JOB",
        "perms": ["read"],
        "name": "CloudCenter Eng",
        "userId": "5",
        "shortName": "CcEng",
        "parentTenantId": 3
    }],
    "tenantAndSubtenantUsers": [],
    "ownerUserId": "5",
    "resource": "https://<HOST>:<PORT>/v1/acls/?id=7427&resourceName=DISTRIBUTED_JOB"
}

 

Response

A success or failure HTTP Status Code.

Request Attributes

id
  • DescriptionUnique, system-generated identifier for this CloudCenter Resource.

  • Type: String

Required

resourceName

Required

users (click for additional context)
userGroups (click for additional context)
tenantUsers (click for additional context)
tenantAndSubtenantUsers (click for additional context)
 ownerUserId 
  • DescriptionUnique, system-generated identifier for the owner of the tenant to which this service owner belongs
  • Type: String

Response Attributes

None.