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

对存储分段执行的操作

贡献者
PDF

对于每个 S3 租户帐户， StorageGRID 系统最多支持 1 ， 000 个分段。

存储分段名称限制遵循AWS US Standard区域限制、但您应进一步将其限制为DNS命名约定、以支持S3虚拟托管模式请求。

有关详细信息，请参见以下内容：

获取分段（列出对象）和获取分段版本操作支持 StorageGRID 一致性控制。

您可以检查是否已为各个存储分段启用上次访问时间更新。

下表介绍了 StorageGRID 如何实施 S3 REST API 存储分段操作。要执行其中任何操作，必须为帐户提供必要的访问凭据。

操作 实施

删除存储分段

此操作将删除存储分段。

删除存储分段或

此操作将删除存储分段的 CORS 配置。

删除存储分段加密

此操作将从存储分段中删除默认加密。现有加密对象将保持加密状态、但添加到存储分段的任何新对象不会加密。

删除存储分段生命周期

此操作将从存储分段中删除生命周期配置。请参见 "创建 S3 生命周期配置"。

删除存储分段策略

此操作将删除附加到存储分段的策略。

删除存储分段复制

此操作将删除附加到存储分段的复制配置。

删除存储分段标记

此操作使用 tagging 用于从存储分段中删除所有标记的子资源。

获取存储分段

(ListObjects)

(List对象V2)

此操作将返回一个存储分段中的部分或全部（最多 1 ， 000 个）对象。对象的存储类可以具有两个值之一、即使对象是随一起载入的 REDUCED_REDUNDANCY 存储类选项：

  • STANDARD、表示对象存储在由存储节点组成的存储池中。

  • GLACIER、表示对象已移至云存储池指定的外部存储分段。

如果存储分段包含大量前缀相同的已删除密钥、则响应可能包括一些密钥 CommonPrefixes 不包含密钥。

获取 Bucket 对象版本

(ListObjectVersion)

如果对存储分段具有读取访问权限、则此操作将使用 versions 子资源列出了存储分段中所有版本对象的元数据。

获取分段 ACL

此操作将返回肯定响应以及存储分段所有者的 ID ， DisplayName 和权限，指示所有者对存储分段具有完全访问权限。

获取分段存储器

此操作将返回 cors 存储分段的配置。

获取存储分段加密

此操作将返回存储分段的默认加密配置。

获取存储分段生命周期

(GetBucketLifecycleConfiguration)

此操作将返回存储分段的生命周期配置。请参见 "创建 S3 生命周期配置"。

获取存储分段位置

此操作将返回使用设置的区域 LocationConstraint PUT分段请求中的元素。如果存储分段的区域为 us-east-1、将返回该区域的空字符串。

获取存储分段通知

(GetBucketNotizationConfiguration)

此操作将返回附加到存储分段的通知配置。

获取存储分段策略

此操作将返回附加到存储分段的策略。

获取存储分段复制

此操作将返回附加到存储分段的复制配置。

获取存储分段标记

此操作使用 tagging 用于返回存储分段的所有标记的子资源。

获取存储分段版本控制

此实施使用 versioning 用于返回存储分段版本控制状态的子资源。

  • blank ：从未启用版本控制（存储分段为 "`未版本控制` " ）

  • Enabled ：已启用版本控制

  • suspended ：先前已启用版本控制并已暂停

获取对象锁定配置

此操作将返回存储分段默认保留模式和默认保留期限（如果已配置）。

请参见 "使用S3 REST API配置S3对象锁定"。

头存储分段

此操作将确定某个存储分段是否存在，并且您有权访问该存储分段。

此操作将返回：

  • x-ntap-sg-bucket-id：UUID格式的存储分段的UUID。

  • x-ntap-sg-trace-id：关联请求的唯一跟踪ID。

放入存储分段

此操作将创建一个新存储分段。创建存储分段后，您就会成为存储分段所有者。

  • 存储分段名称必须符合以下规则：

    • 每个 StorageGRID 系统必须是唯一的（而不仅仅是租户帐户中的唯一）。

    • 必须符合 DNS 要求。

    • 必须至少包含 3 个字符，并且不能超过 63 个字符。

    • 可以是一个或多个标签的序列，并使用一个句点分隔相邻标签。每个标签必须以小写字母或数字开头和结尾，并且只能使用小写字母，数字和连字符。

    • 不能与文本格式的 IP 地址类似。

    • 不应在虚拟托管模式请求中使用句点。句点会在验证服务器通配符证书时出现发生原因 问题。

  • 默认情况下、将在中创建分段 us-east-1 区域；但是、您可以使用 LocationConstraint 请求正文中的请求元素以指定其他区域。使用时 LocationConstraint Element中、您必须指定已使用网格管理器或网格管理API定义的区域的确切名称。如果您不知道应使用的区域名称、请联系您的系统管理员。

  • 注 * ：如果 PUT 存储分段请求使用的区域尚未在 StorageGRID 中定义，则会发生错误。

  • 您可以包括 x-amz-bucket-object-lock-enabled 请求标题以创建启用了S3对象锁定的存储分段。请参见 "使用S3 REST API配置S3对象锁定"。

    创建存储分段时，必须启用 S3 对象锁定。创建分段后、您无法添加或禁用S3对象锁定。S3 对象锁定需要分段版本控制，在创建分段时会自动启用分段版本控制。

放入存储分段箱

此操作会为存储分段设置 CORS 配置，以便存储分段可以处理跨源请求。跨源资源共享（ CORS ）是一种安全机制，允许一个域中的客户端 Web 应用程序访问不同域中的资源。例如、假设您使用名为的S3存储分段 images 以存储图形。通过设置的CORS配置 images 存储分段中的图像、您可以在网站上显示该存储分段中的图像 http://www.example.com。

PUT 存储分段加密

此操作将设置现有存储分段的默认加密状态。启用存储分段级别加密后，添加到存储分段中的任何新对象都会进行加密。 StorageGRID 支持使用 StorageGRID 管理的密钥进行服务器端加密。指定服务器端加密配置规则时、请设置 SSEAlgorithm 参数设置为 AES256，并且不要使用 KMSMasterKeyID 参数。

如果对象上传请求已指定加密(即、如果请求包含)、则存储分段默认加密配置将被忽略 x-amz-server-side-encryption-* 请求标题)。

PUT 存储分段生命周期

(PutBucketLifecycleConfiguration)

此操作将为存储分段创建新的生命周期配置或替换现有的生命周期配置。StorageGRID 在一个生命周期配置中最多支持 1 ， 000 条生命周期规则。每个规则可以包含以下 XML 元素：

  • 到期日期（天，日期）

  • 非当前版本到期（非当前日期）

  • 筛选器（前缀，标记）

  • Status

  • ID

StorageGRID 不支持以下操作：

  • AbortIncompleteMultipartUpload

  • ExpiredObjectDeleteMarker

  • 过渡

请参见 "创建 S3 生命周期配置"。要了解存储分段生命周期中的到期操作如何与ILM放置说明交互、请参见 "ILM 如何在对象的整个生命周期内运行"。

  • 注 * ：存储分段生命周期配置可用于启用了 S3 对象锁定的存储分段，但传统合规存储分段不支持存储分段生命周期配置。

PUT 存储分段通知

(PutBucketNotizationConfiguration)

此操作将使用请求正文中包含的通知配置 XML 为存储分段配置通知。您应了解以下实施详细信息：

  • StorageGRID 支持将简单通知服务（ SNS ）主题作为目标。不支持简单队列服务(SQS)或Amazon Lamba端点。

  • 必须将通知目标指定为 StorageGRID 端点的 URN 。可以使用租户管理器或租户管理 API 创建端点。

    要成功配置通知，端点必须存在。如果端点不存在、则为 400 Bad Request 返回错误并显示代码 InvalidArgument。

  • 您不能为以下事件类型配置通知。这些事件类型 * 不 * 受支持。

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • 从StorageGRID 发送的事件通知使用标准JSON格式、不同之处在于它们不包含某些密钥、而对其他密钥使用特定值、如以下列表所示：

    • * 事件源 *

      sgws:s3

    • * awsRegion*

      不包括

    • * 。 x-AMZ-id-2*

      不包括

    • * arn*

      urn:sgws:s3:::bucket_name

PUT 存储分段策略

此操作将设置附加到存储分段的策略。

PUT 存储分段复制

此操作将进行配置 "StorageGRID CloudMirror复制" 使用请求正文中提供的复制配置XML的存储分段。对于 CloudMirror 复制，您应了解以下实施详细信息：

  • StorageGRID 仅支持复制配置的 V1 。这意味着、StorageGRID 不支持使用 Filter Element中的规则、并遵循V1中有关删除对象版本的约定。有关详细信息，请参见 "有关复制配置的 Amazon S3 文档"。

  • 分段复制可以在分版本或未分版本的分段上配置。

  • 您可以在复制配置 XML 的每个规则中指定不同的目标存储分段。一个源存储分段可以复制到多个目标存储分段。

  • 必须将目标分段指定为租户管理器或租户管理 API 中指定的 StorageGRID 端点的 URN 。请参见 "配置 CloudMirror 复制"。

    要成功进行复制配置，必须存在此端点。如果端点不存在、则请求将以失败的形式出现 400 Bad Request。错误消息显示： Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • 您无需指定 Role 在配置XML中。StorageGRID 不使用此值，如果提交，则会忽略此值。

  • 如果在配置XML中省略存储类、则StorageGRID 将使用 STANDARD 默认情况下、存储类。

  • 如果从源存储分段中删除对象或删除源存储分段本身，则跨区域复制行为如下：

    • 如果在复制对象或存储分段之前将其删除、则不会复制该对象或存储分段、也不会通知您。

    • 如果您在复制对象或存储分段后将其删除，则 StorageGRID 会对跨区域复制的 V1 遵循标准 Amazon S3 删除行为。

放置存储分段标记

此操作使用 tagging 用于为存储分段添加或更新一组标记的子资源。添加存储分段标记时，请注意以下限制：

  • StorageGRID 和 Amazon S3 为每个存储分段最多支持 50 个标签。

  • 与存储分段关联的标记必须具有唯一的标记密钥。一个标记密钥的长度最多可包含 128 个 Unicode 字符。

  • 标记值的长度最多可以为 256 个 Unicode 字符。

  • 密钥和值区分大小写。

PUT 存储分版本

此实施使用 versioning 用于设置现有存储分段的版本控制状态的子资源。您可以使用以下值之一设置版本控制状态：

  • Enabled ：为存储分段中的对象启用版本控制。添加到存储分段中的所有对象都会收到唯一的版本 ID 。

  • suspended ：为存储分段中的对象禁用版本控制。添加到存储分段中的所有对象都会收到版本ID null。

PUT 对象锁定配置

此操作将配置或删除存储分段默认保留模式和默认保留期限。

如果修改了默认保留期限，则现有对象版本的保留日期将保持不变，不会使用新的默认保留期限重新计算。

请参见 "使用S3 REST API配置S3对象锁定" 了解详细信息。
相关信息

"一致性控制"

"获取存储分段上次访问时间"

"使用存储分段和组访问策略"

"在审核日志中跟踪 S3 操作"