EMC ECS REST API

Search (SHIFT+S)




Initiate File Access Mode Transition

PUT /?accessmode

Initiates the process to change the bucket's access mode.

URL Format

Host Style: http://bucketname.ns1.emc.com/?accessmode
Path Style: http://ns1.emc.com/bucketname/?accessmode

Request Headers

x-emc-file-access-mode requiredTarget access mode to switch to. Transition to ReadOnly from ReadWrite and to ReadWrite from ReadOnly are not supported. Valid values: Disabled, ReadOnly, ReadWrite
x-emc-file-access-duration optionalDuration in seconds for which the access mode should be enforced.
x-emc-file-access-host-list requiredComma-separated list of hosts or subnets which are allowed to mount the file system
x-emc-file-access-uid requiredUser ID specified by the client while accessing the objects belonging to the resource (bucket) whose access mode is being changed
x-emc-file-access-token optionalUsed to identify the objects that are to be granted file access. The system provides this token to the client in response to the Access Mode PUT operation. When the user included this token in the future PUT requests the system can identify the objects that were and were not present when this token was generated. Default: NULL (applies the access mode change to all the objects in the bucket)

Prerequisites

The following conditions must be met in order to call this operation.

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace and bucket corresponding to this object should exist.


Request Payload

No Request Payload


Response Headers

x-emc-file-access-mode alwaysIndicates the access mode the system is currently enforcing on the objects in the bucket.
x-emc-file-access-duration alwaysIndicates the time after which the file access mode will fall back to being default unless it is renewed with another PUT request.
x-emc-file-access-host-list alwaysComma-separated list of hosts or subnets which will be allowed to mount the file system
x-emc-file-access-uid alwaysUser ID that will have access to the objects
x-emc-file-access-token alwaysCan be saved and used by the client in future requests to identify the objects that will be affected by the current operation.

Response Body

Response indicating Success or Failure for this operation