How StorageGRID implements Swift REST API
PDF of this doc site
- Get started
Install and upgrade
Install appliance hardware
- Install hardware
- Set up hardware
- Install Red Hat Enterprise Linux or CentOS
- Install Ubuntu or Debian
- Install VMware
- Install appliance hardware
Configure and manage
- Manage security
Manage objects with ILM
- ILM and object lifecycle
- Administer StorageGRID
- Use a tenant account
Use S3 REST API
- Support for Amazon S3 REST API
Monitor and troubleshoot
- Monitor StorageGRID system
- Troubleshoot StorageGRID system
- Expand your grid
Recover nodes and maintain your grid
Grid node recovery procedures
- Recover from Storage Node failures
- Recover from Admin Node failures
- Decommission procedure
- Grid node recovery procedures
Maintain SG6000 hardware
- Maintenance configuration procedures
- Maintain SG5700 hardware
A client application can use Swift REST API calls to connect to Storage Nodes and Gateway Nodes to create containers and to store and retrieve objects. This enables service-oriented applications developed for OpenStack Swift to connect with on-premise object storage provided by the StorageGRID system.
Swift object management
After Swift objects have been ingested in the StorageGRID system, they are managed by the information lifecycle management (ILM) rules in the system's active ILM policy. The ILM rules and ILM policy determine how StorageGRID creates and distributes copies of object data and how it manages those copies over time. For example, an ILM rule might apply to objects in specific Swift containers and might specify that multiple object copies be saved to several data centers for a certain number of years.
Contact your NetApp Professional Services consultant or StorageGRID administrator if you need to understand how the grid's ILM rules and policies will affect the objects in your Swift tenant account.
Conflicting client requests
Conflicting client requests, such as two clients writing to the same key, are resolved on a "latest-wins" basis. The timing for the "latest-wins" evaluation is based on when the StorageGRID system completes a given request, and not on when Swift clients begin an operation.
Consistency guarantees and controls
By default, StorageGRID provides read-after-write consistency for newly created objects and eventual consistency for object updates and HEAD operations. Any GET following a successfully completed PUT will be able to read the newly written data. Overwrites of existing objects, metadata updates, and deletes are eventually consistent. Overwrites generally take seconds or minutes to propagate, but can take up to 15 days.
StorageGRID also allows you to control consistency on a per container basis. Consistency controls provide a balance between the availability of the objects and the consistency of those objects across different Storage Nodes and sites, as required by your application.