// removed jquery ui css and js

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