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
command:
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
command:
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
filter:swift3
section of proxy-server.conf
. The default value for
location in the Swift3 Middleware is US
, which means that V4 S3 clients must set
US
as the region. You can change the location value to something other than
US
by 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"
Replace
"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:09
is
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.