Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

ECS 3.6.2 Data Access Guide

PDF

Supported EMC Atmos REST API Calls

ECS supports a subset of the EMC Atmos API.

Table 1. Supported Atmos REST API callsThe following Atmos REST API calls are supported. Calls for both the object and namespace interfaces are shown.
Method Path Description
Service Operations
GET /rest/service Get information about the system
Object Operations
POST /rest/objects /rest/namespace/<path> Create an object (See notes below)
DELETE /rest/objects/<ObjectID> /rest/namespace/<path> Delete object
PUT /rest/objects/<ObjectID> /rest/namespace/<path> Update object (See notes below)
GET /rest/objects/<ObjectID> /rest/namespace/<path> Read object (or directory list)
POST /rest/namespace/<path>?rename Rename an object
MetaData Operations
GET /rest/objects/<ObjectID>?metadata/user /rest/namespace/<path>?metadata/user Get user metadata for an object
POST /rest/objects/<ObjectID>?metadata/user /rest/namespace/<path>?metadata/user Set user metadata
DELETE /rest/objects/<objectID>?metadata/user /rest/namespace/<path>?metadata/user Delete user metadata
GET /rest/objects/<ObjectID>?metadata/system /rest/namespace/<path>?metadata/system Get system metadata for an object
GET /rest/objects/<ObjectID>?acl /rest/namespace/<path>?acl Get ACL
POST /rest/objects/<ObjectID>?acl /rest/namespace/<path>?acl Set ACL
GET /rest/objects/<ObjectID>?metadata/tags /rest/namespace/<path>?metadata/tags Get metadata tags for an object
GET /rest/objects/<ObjectID>?info /rest/namespace/<path>?info Get object info
Head /rest/objects/<ObjectID> /rest/namespace/<path> Get all object metadata
Object-space Operations
GET /rest/objects List objects
GET /rest/objects?listabletags Get listable tags
Anonymous Access
GET /rest/objects/<ObjectId>?uid=<uid>&expires=<exp>&signature=<sig> /rest/namespace/<path>?uid=<uid>&expires=<exp>&signature=<sig> Shareable URL
NOTE:
  • The x-emc-wschecksum header is supported in ECS.
  • The Atmos objects do not inherit ACL from the group ACL that is set at a bucket level.
    • If there is no user ACL provided, the ACL is inherited from the x-emc-useracl header.
    • If there is no group ACL provided, the Read ACL is used by default.
  • GET /rest/objects does not support different response types with x-emc-accept. For example, text/plain is not supported.
  • Read, Write, and Delete ACLs work in ECS the same as Atmos.
  • POST /rest/objects supports the x-emc-object-id header to enable legacy (44 character) object Ids.

Atmos listable tags

Listable tags are special user-defined tags used to list or filter objects. For example, an application could enable the user to tag a group of illustrations (objects) with a tag like "Vacation2016". Later the application can respond to a query of "Vacation2016" by listing only the objects tagged with this listable tag.

Using the Atmos protocol with ECS, a user cannot delete or modify another user's listable tags. Under some conditions, this ability is enabled in native Atmos.

Listable tags are indexed in ECS, increasing the performance and scalability of the retrieval of tagged objects.

In ECS, the EMC_TAGS metadata tag is used to persist listable tags. This tag name should not be used in user-defined metadata tags.

Object ID length

Support for the Atmos API in ECS expands the length of the object Id from 44 characters to 101 characters. Hence, when moving applications from Atmos to ECS you need to be aware that the object Id length will be different.

To create an object with the legacy 44 character Id length, you can use the x-emc-object-id header. This enables objects to be migrated to Atmos.


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\