Skip to main content
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

StorageGRID S3 REST API 支援的版本和更新

PDF

StorageGRID 支援 Simple Storage Service （S3） API，該 API 以一組表述性狀態轉移 （REST） Web 服務的形式實作。

支援 S3 REST API 可讓您將為 S3 Web 服務開發的服務導向應用程式與使用 StorageGRID 系統的內部環境物件儲存連接起來。用戶端應用程式目前對 S3 REST API 呼叫的使用只需進行極少的變更。

支援的版本

StorageGRID 支援以下特定版本的 STS、S3 和 HTTP：

項目 版本

STS AssumeRole API 規範

"Amazon Web Services (AWS) 文件：Amazon Assumerole API 參考"

有關 AssumeRole 的詳細資訊，請參閱 "設定 AssumeRole"。

S3 API 規範

"AWS 文件：Amazon Simple Storage Service API 參考"

HTTP

1.1

有關 HTTP 的詳細資訊，請參閱 HTTP/1.1 （RFCs 7230-35）。

"IETF RFC 2616：超文字傳輸協定 (HTTP/1.1)"

注意：StorageGRID 不支援 HTTP/1.1 管線。

S3 REST API 支援的更新

發布 註解

12.0

  • 為管理介面新增了跨來源資源共享 (CORS) 支援，允許另一個網域使用管理 API 存取 StorageGRID 中的資料。"深入瞭解"。

  • 新增對 STS AssumeRole 和工作階段原則的支援。請參閱 "工作階段原則範例"。您可以在租戶群組下設定 AssumeRole。

11.9

  • 新增對以下請求和支援標頭的預先計算 SHA-256 Checksum 值的支援。您可以使用此功能來驗證上傳物件的完整性：

    • CompleteMultipartUpload： x-amz-checksum-sha256

    • CreateMultipartUpload： x-amz-checksum-algorithm

    • GetObject： x-amz-checksum-mode

    • HeadObject： x-amz-checksum-mode

    • ListParts

    • PutObject： x-amz-checksum-sha256

    • UploadPart： x-amz-checksum-sha256

  • 新增了網格系統管理員控制租戶層級保留和 Compliance 設定的功能。這些設定會影響 S3 物件鎖定設定。

    • 儲存桶預設保留模式和物件保留模式：治理或合規性（如果網格系統管理員允許）。

    • 儲存桶預設保留期間和物件 Retain Until Date：必須小於或等於網格系統管理員設定的最大保留期間所允許的值。

  • 改進了對 `aws-chunked`內容編碼和串流 `x-amz-content-sha256`值的支援。限制：

    • 如果存在， `chunk-signature`則為可選，且未經驗證

    • 如果存在， `x-amz-trailer`則忽略該內容。

11.8

更新了 S3 操作的名稱，使其與 "Amazon Web Services (AWS) 文件：Amazon Simple Storage Service API 參考"中使用的名稱相符。

11.7

  • 已新增 "快速參考：支援的 S3 API 請求"。

  • 新增對搭配 S3 Object Lock 使用 GOVERNANCE 模式的支援。

  • 新增了對 StorageGRID 特有的 x-ntap-sg-cgr-replication-status GET Object 和 HEAD Object 請求回應標頭的支援。此回應標頭提供物件在跨網格複寫中的複寫狀態。

  • SelectObjectContent requests 現在支援 Parquet 物件。

11.6

  • 新增在 GET Object 和 HEAD Object 請求中使用 partNumber 請求參數的支援。

  • 為 S3 Object Lock 在儲存桶層級新增預設保留模式和預設保留期間的支援。

  • 新增對原則條件鍵 s3:object-lock-remaining-retention-days 的支援，用於設定物件的允許保留期間範圍。

  • 已將單一 PUT Object 操作的最大_建議_大小變更為 5 GiB（5,368,709,120 位元組）。如果物件大於 5 GiB，請改用分段上傳。

11.5

  • 新增管理儲存桶加密的支援。

  • 新增對 S3 Object Lock 的支援，並棄用舊版法規遵循請求。

  • 新增對版本化儲存桶使用 DELETE Multiple Objects 的支援。

  • The `Content-MD5`請求標頭現已正確支援。

11.4

  • 新增了對 DELETE Bucket tagging、GET Bucket tagging 和 PUT Bucket tagging 的支援。不支援成本分配標籤。

  • 對於在 StorageGRID 11.4 中建立的儲存桶，不再需要限制物件金鑰名稱以符合效能最佳實務。

  • 新增對 `s3:ObjectRestore:Post`事件類型的儲存桶通知支援。

  • AWS 現在強制執行分段上傳的大小限制。分段上傳中的每個部分都必須介於 5 MiB 和 5 GiB 之間。最後一個部分可以小於 5 MiB。

  • 新增對 TLS 1.3 的支援

11.3

  • 新增使用客戶提供的金鑰對物件資料進行伺服器端加密（SSE-C）的支援。

  • 新增對 DELETE、GET 和 PUT Bucket 生命週期操作（僅限到期行動）以及 x-amz-expiration 回應標頭的支援。

  • 更新了 PUT Object、PUT Object - Copy 和 Multipart Upload，以描述在擷取時使用同步放置的 ILM 規則的影響。

  • TLS 1.1 加密演算法已不再受支援。

11.2

新增對 POST 物件還原的支援，可用於雲端儲存池。新增對在群組原則和儲存貯體原則中使用 AWS 語法來定義 ARN、原則條件鍵和原則變數的支援。使用 StorageGRID 語法的現有群組原則和儲存貯體原則將繼續獲得支援。

*注意：*在其他組態 JSON/XML 中使用 ARN/URN 的方式（包括在自訂 StorageGRID 功能中使用的方式）沒有改變。

11.1

新增對跨來源資源共用 (CORS)、S3 用戶端連線至網格節點的 HTTP，以及儲存桶法規遵循設定的支援。

11.0

新增了為儲存桶設定平台服務（CloudMirror 複寫、通知和 Elasticsearch 搜尋整合）的支援。此外，還新增了對儲存桶物件標籤位置限制和 Available 一致性的支援。

10.4

新增對 ILM 掃描變更的支援，包括版本控制、端點網域名稱頁面更新、原則中的條件和變數、原則範例以及 PutOverwriteObject 權限。

10.3

新增版本控制支援。

10.2

新增對群組和儲存桶存取原則以及多部分複本（Upload Part - Copy）的支援。

10.1

新增對多部分上傳、虛擬託管式請求及 v4 驗證的支援。

10.0

StorageGRID 系統已初步支援 S3 REST API。目前支援的 Simple Storage Service API Reference 版本為 2006-03-01。