Update ACL Resource Details

Details

API DetailsRelease-Specific Information
CloudCenter Platform 4xCloudCenter Suite 5x
NameUpdate ACL Resource Details
DescriptionUpdates permissions for any CloudCenter Resource managed by Access Control Lists (ACLs)
Allowed Role(s)WM_USER
MethodPUT
URIv1/acls/

cloudcenter-ccm-backend/api/v1/acls/

Sample Request
curl -k -X PUT -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/acls/
curl -k -X PUT -H "Accept: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/cloudcenter-ccm-backend/api/v1/acls/
Release

Introduced in CloudCenter 4.2

Modified in CloudCenter Suite 5.0.0

Notes
  • Only resource owners and users with WRITE perms can view all the fields for this resource.
  • Other users can only view common fields like name, description, and so forth. See Permission Control for additional context.
Back To LinksCommon CloudCenter API CallsWorkload Manager API

ESB Header

action: update.acls

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

Not applicable

Sample Request Body

{
    "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 - CloudCenter Platform 4x Example

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"],
        "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
  • 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 (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

Response Attributes

None.


© 2017-2019 Cisco Systems, Inc. All rights reserved