Update Access to Child CCM ACL from Parent CCM

Details

API Details
Name

Update Access to Child CCM ACL from Parent CCM

DescriptionAllows the Parent CCM tenant admin to update Access Control List (ACL) Permissions to the Child CCM. These permissions are based on the authorized Child CCM settings (remoteLaunchOk, remoteTerminationOk, remotePolicyCreationOk, and remoteAppProfileCreationOk) and can be configured any time after the link is established.
MethodPUT
URI

v1/acls

CloudCenter ReleaseIntroduced in CloudCenter 4.3.
Notes
  • Available in CloudCenter 4.3 to 4.5.
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
  • If this handshake using each other's certificate is mutually authenticated, the link is successfully established.
  • Once a link request is approved between the parent and the subordinate, the Parent CCM admin can update the Access Control List (ACL) Permissions to the Child CCM based on the Parent Manger Permission options.

ESB Header

action: update.acls

Example

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

Request Body

{
     "id": 7,
     "resourceName": "LINK_TO_CHILD",
     "users": [{
         "id": 2,
         "perms": ["administration", "remote_launch", "remote_termination", 
			"remote_policy_creation", "remote_app_profile_creation"]
     }],
     "userGroups": [],
     "tenantUsers": [{
         "id": "1",
         "resource": "https://<ChildCCM_HOST>:<PORT>/v1/acls/1?id=7&
			resourceName=LINK_TO_CHILD",
         "perms": ["administration", "remote_launch", "remote_termination", 
			"remote_policy_creation", "remote_app_profile_creation"],
         "name": "Company Inc",
         "userId": "2",
         "shortName": "CloudCenter",
         "parentTenantId": null,
         "showAsShareAllUsersOnDilog": true
     }],
     "tenantAndSubtenantUsers": [],
     "ownerUserId": "2"
 }

Response

{
    "id": "7",
    "resourceName": "LINK_TO_CHILD",
    "users": [{
        "id": "2",
        "resource": "https://<ChildCCM_HOST>:<PORT>/v1/acls/2",
        "perms": ["remote_launch", "administration", "remote_policy_creation", 
			"write", "read", "delete", "remote_app_profile_creation", 
			"remote_termination"],
        "username": "cloudCenteradmin",
        "enabled": true,
        "type": "TENANT",
        "firstName": "CloudCenter",
        "lastName": "Admin",
        "tenantId": "1",
        "emailAddr": "admin@cliqrtech.com"
    }],
    "userGroups": [],
    "tenantUsers": [{
        "id": "1",
        "resource": "https://<ChildCCM_HOST>:<PORT>/v1/acls/1",
        "perms": ["remote_launch", "administration", "remote_policy_creation", 
			"write", "read", "delete", "remote_app_profile_creation", 
			"remote_termination"],
        "name": "Company Inc",
        "userId": "2",
        "shortName": "CloudCenter",
        "parentTenantId": null
    }],
    "tenantAndSubtenantUsers": [],
    "ownerUserId": "2",
    "resource": "https://<ParentCCM_HOST>:<PORT>/v1/acls/"
}

Request Attributes

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

  • Type: String

The linkID for which the ACL permissions are updated. Required.

resourceName

Required.

users

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

  • Type: String

The userId for which the ACL permissions are updated. Required.

perms (click for additional details)

Required.

userGroups (click for additional context)
tenantUsers

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

  • Type: String

The tenantId for which the ACL permissions are updated. Required.

resource
  • Description: Unique URL to access this resource
  • Type: String

perms (click for additional details)
name
  • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

  • Type: String

userId
  • Description: Unique, system-generated identifier for a user
  • Type: String
shortName
  • Description: Unique short version of this tenant's name to be used in the Login page. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.
  • Type: String
parentTenantId
  • Description: Unique, system-generated identifier for the parent tenant organization
  • Type: Integer
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

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

  • Type: String

resourceName

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
resource
  • Description: Unique URL to access this resource
  • Type: String