Skip to main content
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

StorageGRID Swift REST API 操作

贡献者
PDF

在 Swift REST API 中添加了特定于 StorageGRID 系统的操作。

获取容器一致性请求

一致性级别可在对象的可用性与这些对象在不同存储节点和站点之间的一致性之间实现平衡。使用获取容器一致性请求，您可以确定应用于特定容器的一致性级别。

请求

请求 HTTP 标头 Description

X-Auth-Token

指定要用于请求的帐户的 Swift 身份验证令牌。

x-ntap-sg-consistency

指定请求的类型，其中 true = 获取容器一致性， false = 获取容器。

主机

请求所定向到的主机名。

请求示例

GET /v1/28544923908243208806/Swift container
X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29
x-ntap-sg-consistency: true
Host: test.com

响应

响应 HTTP 标头 Description

dATE

响应的日期和时间。

连接

与服务器的连接是打开还是关闭。

X-Trans-ID

请求的唯一事务标识符。

内容长度

响应正文的长度。

x-ntap-sg-consistency

应用于容器的一致性控制级别。支持以下值：

  • * 全部 * ：所有节点均立即接收数据，否则请求将失败。

  • * 强 - 全局 * ：保证所有站点中所有客户端请求的写入后读一致性。

  • * 强站点 * ：保证站点内所有客户端请求的写入后读一致性。

  • * 读后新写入 * ：为新对象提供读后写入一致性，并最终为对象更新提供一致性。提供高可用性和数据保护保证。

  • 注意 * ：如果应用程序对不存在的对象使用 head 请求，则在一个或多个存储节点不可用时，可能会收到大量 500 个内部服务器错误。要防止出现这些错误，请使用 "`Available` " 级别。

  • * 可用 * （机头操作的最终一致性）：与 read-after-new-write 一致性级别相同，但仅为机头操作提供最终一致性。如果存储节点不可用，则为机头操作提供的可用性比 " read-after-new-write " 更高。

响应示例

HTTP/1.1 204 No Content
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
X-Trans-Id: 1936575373
Content-Length: 0
x-ntap-sg-consistency: strong-site
相关信息

使用租户帐户

提交容器一致性请求

使用 PUT 容器一致性请求可以指定要应用于对容器执行的操作的一致性级别。默认情况下，使用 read-after-new-write 一致性级别创建新容器。

请求

请求 HTTP 标头 Description

X-Auth-Token

要用于请求的帐户的 Swift 身份验证令牌。

x-ntap-sg-consistency

要应用于容器上的操作的一致性控制级别。支持以下值：

  • * 全部 * ：所有节点均立即接收数据，否则请求将失败。

  • * 强 - 全局 * ：保证所有站点中所有客户端请求的写入后读一致性。

  • * 强站点 * ：保证站点内所有客户端请求的写入后读一致性。

  • * 读后新写入 * ：为新对象提供读后写入一致性，并最终为对象更新提供一致性。提供高可用性和数据保护保证。

  • 注意 * ：如果应用程序对不存在的对象使用 head 请求，则在一个或多个存储节点不可用时，可能会收到大量 500 个内部服务器错误。要防止出现这些错误，请使用 "`Available` " 级别。

  • * 可用 * （机头操作的最终一致性）：与 read-after-new-write 一致性级别相同，但仅为机头操作提供最终一致性。如果存储节点不可用，则为机头操作提供的可用性比 " read-after-new-write " 更高。

主机

请求所定向到的主机名。

一致性控制和 ILM 规则如何交互以影响数据保护

您选择的一致性控制和 ILM 规则都会影响对象的保护方式。这些设置可以进行交互。

例如，存储对象时使用的一致性控制会影响对象元数据的初始放置，而为 ILM 规则选择的载入行为会影响对象副本的初始放置。由于 StorageGRID 需要访问对象的元数据及其数据来满足客户端请求，因此为一致性级别和载入行为选择匹配的保护级别可以提供更好的初始数据保护和更可预测的系统响应。

ILM 规则可以使用以下载入行为：

  • * 严格 * ：必须创建 ILM 规则中指定的所有副本，才能将成功返回给客户端。

  • * 平衡 * ： StorageGRID 尝试在载入时创建 ILM 规则中指定的所有副本；如果无法创建，则创建临时副本并将成功返回给客户端。在可能的情况下，将创建 ILM 规则中指定的副本。

  • * 双提交 * ： StorageGRID 会立即为对象创建临时副本，并将成功返回给客户端。如果可能，将创建 ILM 规则中指定的副本。

备注 在为 ILM 规则选择载入行为之前，请阅读有关通过信息生命周期管理管理对象的说明中有关这些设置的完整问题描述 。

一致性控制和 ILM 规则如何交互的示例

假设您有一个双站点网格，其中包含以下 ILM 规则和以下一致性级别设置：

  • * ILM 规则 * ：创建两个对象副本，一个在本地站点，一个在远程站点。此时将选择严格的载入行为。

  • * 一致性级别 * ： strong-global （对象元数据会立即分发到所有站点。）

当客户端将对象存储到网格时， StorageGRID 会创建两个对象副本并将元数据分发到两个站点，然后再向客户端返回成功。

在载入成功消息时，此对象将受到完全保护，不会丢失。例如，如果本地站点在载入后不久丢失，则远程站点上仍存在对象数据和对象元数据的副本。此对象完全可检索。

如果您改用相同的 ILM 规则和 strong-site 一致性级别，则在将对象数据复制到远程站点之后，在将对象元数据分发到该远程站点之前，客户端可能会收到一条成功消息。在这种情况下，对象元数据的保护级别与对象数据的保护级别不匹配。如果本地站点在载入后不久丢失，则对象元数据将丢失。无法检索此对象。

一致性级别和 ILM 规则之间的关系可能很复杂。如需帮助，请联系 NetApp 。

请求示例

PUT /v1/28544923908243208806/_Swift container_
X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29
x-ntap-sg-consistency: strong-site
Host: test.com

响应

响应 HTTP 标头 Description

dATE

响应的日期和时间。

连接

与服务器的连接是打开还是关闭。

X-Trans-ID

请求的唯一事务标识符。

内容长度

响应正文的长度。

响应示例

HTTP/1.1 204 No Content
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
X-Trans-Id: 1936575373
Content-Length: 0
相关信息

使用租户帐户