Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Init Uploads
- S3 Object Replication Info Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- EMC Atmos
- OpenStack Swift
ECS API Changes
Get Bucket Policy
GET /?policy
Retrieves The Bucket Policy for the bucket.
URL Format
Host Style: http://bucketname.ns1.emc.com/?policy
Path Style: http://ns1.emc.com/bucketname?policy
Request Headers
| x-amz-date | optional | The timestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of x-amz-date header is chosen. |
| Authorization | required | Information needed to authenticate requests. |
Required Roles
Requires one of the following roles:
SYSTEM_ADMIN
SYSTEM_MONITOR
NAMESPACE_ADMIN
Prerequisites
The following conditions must be met in order to call this operation.
Only the owner of the bucket or a user having permission can retrieve the policy on a specified bucket
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 corresponding to this bucket should exist (for example, ns1).
Response Body
Bucket Policy on the specified bucket.
Version: Specifies the policy language version.
Id: Specifies an optional identifier for the policy.
Statement: Contains the policies.
Sid: It is an optional identifier that is provided for the policy statement.
Effect: Specifies whether the statement will result in an allow or an explicit deny.
Principal: Specifies the user.
NotPrincipal: Use the NotPrincipal element to specify an exception to a list of principals.
Action: Specifies the action or actions that will be allowed or denied. Statements must include either an Action or NotAction element.
NotAction: Specifies an advanced policy element that explicitly matches everything except a list of actions.
Resource: Specifies the object or objects that the statement covers.
NotResource: Specifies an advanced policy element that explicitly matches everything except a list of resources.
Condition: An optional element which specifies conditions for when a policy is in effect.