EMC ViPR REST API

Search (SHIFT+S)

API Reference


Update Acls

PUT /block/vpools/{id}/acl

Add or remove individual block store virtual pool ACL entry(s). Request body must include at least one add or remove operation.

idthe URN of a ViPR VirtualPool

Required Roles

Requires one of the following roles:

  • SECURITY_ADMIN
  • SYSTEM_ADMIN
  • RESTRICTED_SYSTEM_ADMIN

Request Payload

All parameters are required unless otherwise stated.

Field Description Type Notes
<acl_assignment_changes>
<add>     0-* Elements
<privilege> String 0-* Elements
<subject_id> String
<group> String
<tenant> String
</add>      
<remove>     0-* Elements
<privilege> String 0-* Elements
<subject_id> String
<group> String
<tenant> String
</remove>      
</acl_assignment_changes>

Response Body

No data returned in response body

Field Description Type Notes
<acl_assignments>
<acl_assignment>     0-* Elements
<privilege> String 0-* Elements
<subject_id> String
<group> String
<tenant> String
</acl_assignment>      
</acl_assignments>

Examples

Request
PUT https://192.168.0.0:4443/block/vpools/urn:storageos:VirtualPool:18af14df-1f7e-4883-a0bd-44aee9372407:/acl HTTP/1.1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<acl_assignment_changes>
     <add>
          <privilege>USE</privilege>
          <tenant>urn:storageos:TenantOrg:dbeb4135-e297-40d9-a5d4-9b40c73bdb4b:</tenant>
     </add>
</acl_assignment_changes>
Response
HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <acl_assignments>
       <acl_assignment>
            <privilege>USE</privilege>
            <tenant>urn:storageos:TenantOrg:dbeb4135-e297-40d9-a5d4-9b40c73bdb4b:</tenant>
       </acl_assignment>
</acl_assignments>