Changing the object base configuration to enable S3 API
IBM Spectrum Scale uses Swift3 Middleware for OpenStack Swift, allowing access to IBM Spectrum Scale by using Amazon Simple Storage Service (S3) API.
Perform the following steps if S3 API was not enabled as part of the object base configuration:
- To enable S3 API, run the following command:
mmobj s3 enable
The system enables S3 API.
- To verify that S3 API is enabled, run the following
mmobj s3 list
- To disable S3 API, run the following command:
mmobj s3 disable
The system disables S3 API.
- To verify that S3 API is disabled, run the following
mmobj s3 list
Remember: You can use the Swift3 Middleware for OpenStack Swift with S3 clients that are using the V2 or V4 S3 protocol.
The V2 protocol is the default. If you use the V4 protocol, make sure that the region of the request matches the value of the location property in the
proxy-server.conf. The default value for location in the Swift3 Middleware is
US, which means that V4 S3 clients must set
USas the region. You can change the location value to something other than
USby changing the property in the
proxy-server.conf file. To change the location, issue a command like the following one:
mmobj config change --ccrfile "proxy-server.conf" --section "filter:swift3" --property "location" --value "NEW_LOCATION"
"NEW_LOCATION"with the appropriate value for your environment. Once you change the value, any S3 clients that are using the V4 protocol must set their region to the same value.
Note: When getting a listing of buckets with the S3 protocol, a hardcoded date similar to
2009-02-03 10:45:09is returned as the creation date of each bucket because of a limitation in Swift. To get the actual creation date of the bucket, use the Swift protocol to query the associated container instead.