// removed jquery ui css and js

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. See the Access Control Lists section for the relevant release for additional context.
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. See the Enterprise Service Bus (ESB) section for the relevant release for additional context.

ESB Header

action: update.acls

See the Enterprise Service Bus (ESB) section for the relevant release for additional context.

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
  • Description: An identifier for a CloudCenter Resource managed by ACLs. The supported ACL-managed resources are listed as enumerations. 

  • Type: Enumeration

    EnumerationDescription
    POLICY

    See Policy Management > Scaling Policies or Aging Policies

    ACTION_POLICY

    See Policy Management > Action Policies

    PUBLISHED_APPSee Application Tasks > Publish to Marketplace
    DEPLOYMENT_ENVIRONMENT See Deployment Environment
    APPLICATION

    See Application Profile

    • Model an Application
    • Model an Application by Importing the Profile
    REPOSITORYSee Share Artifact Repositories
    CLOUD_ACCOUNT See Configure Cloud(s)
    SYSTEM_TAGSee System Tags
    SECURITY_PROFILESee Security and Firewall Rules
    SERVICESee Manage Services
    LINK_TO_PARENTSee Federated CCM Management (Effective CloudCenter 4.8)
    LINK_TO_CHILD
    CUSTOM_ACTIONSee Policies > Custom Actions 
    PROJECTSee Projects
    IMAGESee Manage Images

    DISTRIBUTED_JOB

    See Deployment Environments > Sharing Deployments
    EXTENSION See Extensions
    ACI_EXTENSIONSee ACI Extensions
    SERVICE_NOW_EXTENSIONSee ServiceNow Extensions (Effective CloudCenter 4.8.2)
    ACTION See Actions Library (Effective CloudCenter 4.8)
    VIRTUAL_MACHINESee VM Management (Effective CloudCenter 4.8)
    AGING_POLICYSee Policies (Effective CloudCenter 4.8.2)
    SUSPENSION_POLICY

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 the Tenant ID and Tenant Name Dependency description in the Sub-Tenants section for the relevant release for additional context.
  • 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 resource. For example, a ServiceNow extension owner's User ID.

  • Type: String

Response Attributes

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

  • Type: String

resourceName
  • Description: An identifier for a CloudCenter Resource managed by ACLs. The supported ACL-managed resources are listed as enumerations. 

  • Type: Enumeration

    EnumerationDescription
    POLICY

    See Policy Management > Scaling Policies or Aging Policies

    ACTION_POLICY

    See Policy Management > Action Policies

    PUBLISHED_APPSee Application Tasks > Publish to Marketplace
    DEPLOYMENT_ENVIRONMENT See Deployment Environment
    APPLICATION

    See Application Profile

    • Model an Application
    • Model an Application by Importing the Profile
    REPOSITORYSee Share Artifact Repositories
    CLOUD_ACCOUNT See Configure Cloud(s)
    SYSTEM_TAGSee System Tags
    SECURITY_PROFILESee Security and Firewall Rules
    SERVICESee Manage Services
    LINK_TO_PARENTSee Federated CCM Management (Effective CloudCenter 4.8)
    LINK_TO_CHILD
    CUSTOM_ACTIONSee Policies > Custom Actions 
    PROJECTSee Projects
    IMAGESee Manage Images

    DISTRIBUTED_JOB

    See Deployment Environments > Sharing Deployments
    EXTENSION See Extensions
    ACI_EXTENSIONSee ACI Extensions
    SERVICE_NOW_EXTENSIONSee ServiceNow Extensions (Effective CloudCenter 4.8.2)
    ACTION See Actions Library (Effective CloudCenter 4.8)
    VIRTUAL_MACHINESee VM Management (Effective CloudCenter 4.8)
    AGING_POLICYSee Policies (Effective CloudCenter 4.8.2)
    SUSPENSION_POLICY

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 resource. For example, a ServiceNow extension owner's User ID.

  • Type: String

resource
  • Description: Unique URL to access this resource.
  • Type: String
© 2017-2019 Cisco Systems, Inc. All rights reserved