ECS Data Access Guide CONTENTS
Total Page:16
File Type:pdf, Size:1020Kb
ECS Version 3.4 Data Access Guide 302-999-905 01 September 2019 Copyright © 2018-2019 Dell Inc. or its subsidiaries. All rights reserved. Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.” DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE. Dell Technologies, Dell, EMC, Dell EMC and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners. Published in the USA. Dell EMC Hopkinton, Massachusetts 01748-9103 1-508-435-1000 In North America 1-866-464-7381 www.DellEMC.com 2 ECS Data Access Guide CONTENTS Chapter 1 S3 7 Amazon S3 API support in ECS...........................................................................8 S3 API supported and unsupported features.......................................................8 Behavior where bucket already exists....................................................11 Bucket policy support........................................................................................ 11 Creating, Assigning, and Managing Bucket Policies.............................. 13 Bucket policy scenarios........................................................................ 14 Supported bucket policy operations..................................................... 15 Supported bucket policy conditions...................................................... 17 Object lifecycle management............................................................................ 18 S3 Extensions................................................................................................... 26 Byte range extensions..........................................................................26 Retention............................................................................................. 30 File system enabled.............................................................................. 31 S3A support......................................................................................... 34 Geo-replication status..........................................................................34 Metadata Search.............................................................................................. 35 Assign metadata index values to a bucket............................................ 35 Using encryption with metadata search............................................... 38 Assign metadata to objects using the S3 protocol................................38 Use metadata search queries............................................................... 39 Using Metadata Search from the ECS Java SDK ................................ 45 ECS system metadata and optional attributes..................................... 45 S3 and Swift Interoperability............................................................................ 46 Create and manage secret keys........................................................................ 48 Create a key for an object user............................................................ 48 Create an S3 secret key: self-service...................................................49 Authenticating with the S3 service....................................................................51 Authenticating using Signature V2....................................................... 52 Authenticating using Signature V4....................................................... 52 Using s3curl with ECS.......................................................................................53 Use SDKs to access the S3 service...................................................................53 Using the Java Amazon SDK................................................................ 53 Java SDK client for ECS...................................................................... 55 ECS S3 error codes.......................................................................................... 56 Chapter 2 OpenStack Swift 65 OpenStack Swift support in ECS...................................................................... 66 OpenStack Swift supported operations............................................................ 66 Swift extensions............................................................................................... 68 Swift byte range extensions..............................................................................68 Updating a byte range within an object................................................ 68 Overwriting part of an object............................................................... 69 Appending data to an object.................................................................70 Reading multiple byte ranges within an object...................................... 71 Retention.......................................................................................................... 72 File system enabled...........................................................................................73 S3 and Swift interoperability.............................................................................73 OpenStack Swift authentication....................................................................... 73 Create Swift users in the ECS Portal................................................... 74 ECS Data Access Guide 3 Contents OpenStack Version 1 authentication ....................................................75 OpenStack Version 2 authentication.................................................... 76 Authentication using ECS Keystone V3 integration.............................. 78 Authorization on Container............................................................................... 80 ECS Swift error codes...................................................................................... 82 Chapter 3 EMC Atmos 85 EMC Atmos API support in ECS........................................................................86 Supported EMC Atmos REST API Calls............................................................ 86 Unsupported EMC Atmos REST API Calls.........................................................88 Subtenant Support in EMC Atmos REST API Calls........................................... 88 API Extensions..................................................................................................89 Appending data to an object................................................................ 89 ECS support for retention and retention expiration periods for Atmos objects................................................................................................. 90 ECS Atmos error codes.....................................................................................94 Chapter 4 CAS 99 Setting up CAS support in ECS....................................................................... 100 Cold Storage................................................................................................... 100 Compliance...................................................................................................... 101 Platform hardening and Compliance....................................................101 Compliance and retention policy......................................................... 101 Compliance agent............................................................................... 102 CAS retention in ECS...................................................................................... 102 Advanced retention for CAS applications: event-based retention, litigation hold, and the min/max governor.............................................................................. 104 Set up namespace retention policies............................................................... 108 Create and set up a bucket for a CAS user......................................................109 Set up a CAS object user................................................................................. 110 Set up bucket ACLs for CAS............................................................................ 110 ECS Management APIs that support CAS users............................................... 111 Content Addressable Storage (CAS) SDK API support.................................... 112 ECS CAS error codes....................................................................................... 112 Chapter 5 ECS Management REST API 119 ECS Management REST API introduction....................................................... 120 Authenticate with the ECS Management REST API........................................ 120 Authenticate without cookies ............................................................ 120 Logout................................................................................................ 122 ECS Management REST API whoami command................................. 122 ECS Management REST API summary............................................... 123 Chapter 6 ECS HDFS 127 ECS HDFS Introduction...................................................................................128 Configuring Hadoop to use ECS HDFS ..........................................................