Changes to the Tenant Management API

StorageGRID 11.2 introduces version 3 of the Tenant Management API. Version 3 deprecates version 2; however, version 1 and version 2 are still supported.

Attention: You can continue to use version 1 and version 2 of the management API with StorageGRID 11.2; however, support for these versions of the API will be removed in a future release of StorageGRID. After upgrading to StorageGRID 11.2, the deprecated v1 and v2 APIs can be deactivated using the PUT /grid/config/management API.

Consistency level "default" is deprecated in version 3 of Tenant Management API

Version 3 of the Tenant Management API deprecates the consistency level that was called "default" for S3 buckets or Swift containers. The new default consistency is called "read-after-new-write."

As shown in the table, you can continue to specify "default" in a PUT request; however, "read-after-new-write" will now be returned in the response to a GET request.

Type of request Behavior in v2 of the Tenant Management API Behavior in v3 of the Tenant Management API
PUT /org/containers/{containerName}/consistency You can specify "default" or you can specify "read-after-new-write" to achieve the same consistency behavior. You can specify "default" or you can specify "read-after-new-write" to achieve the same consistency behavior.
GET /org/containers/{containerName}/consistency If the bucket used the "default" or "read-after-new-write" level, the API returned "default." The API returns "read-after-new-write" instead of "default."

responseTime marked optional

The responseTime parameter was incorrectly marked as required in the API Docs of the Tenant Management API. This parameter has always been optional, and now it is correctly marked as optional.