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

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

貢獻者 netapp-pcarriga netapp-maireadn netapp-lhalbert netapp-perveilerk netapp-jsnyder
PDF

支援簡單儲存服務（S3）API、此API是以代表狀態傳輸（REST）網路服務的形式實作。StorageGRID

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（RFC 7230-35）。

"IETF RFC 2616：超文字傳輸傳輸協定（HTTP / 1.1）"

附註 StorageGRID ：不支援HTTP / 1.1鋪管。

S3 REST API 支援的更新

版本 註解

12.1.0

  • If-Match

    The `If-Match`標頭的行為會根據您的 StorageGRID 組態而有所不同。提供此標頭可能會傳回錯誤訊息（501 Not Implemented）。如果 `If-Match`標頭被接受但無法運作，則可能會觸發警示，其中包含有關啟用更嚴格的 501 Not Implemented 錯誤行為的說明。

  • If-None-Match

    The `If-None-Match`標頭的行為會根據您的 StorageGRID 組態而有所不同。提供此標頭可能會傳回錯誤訊息（501 Not Implemented）。如果 `If-None-Match`標頭被接受但無法運作，則可能會觸發警示，其中包含有關啟用更嚴格的 501 Not Implemented 錯誤行為的說明。

  • 為以下請求和支援的標頭新增了對預先計算 Checksum 值的支援：

    • CompleteMultipartUpload： x-amz-checksum-crc32， x-amz-checksum-crc32c，和 x-amz-checksum-crc64nvme

    • CreateMultipartUpload： CRC32， CRC32C，以及 CRC64NVME，適用於 x-amz-checksum-algorithm

    • CopyObject： CRC32， CRC32C， CRC64NVME，以及 SHA256（適用於 x-amz-checksum-algorithm）

    • PutObject： x-amz-checksum-crc32、 x-amz-checksum-crc32c`和 `x-amz-checksum-crc64nvme

    • UploadPart： x-amz-checksum-crc32、 x-amz-checksum-crc32c`和 `x-amz-checksum-crc64nvme

  • 新增了對 x-amz-checksum-type 的支援，適用於 CreateMultipartUpload 和 CompleteMultipartUpload。

  • 增加了對 `s3:x-amz-copy-source`原則條件索引鍵的支援。

  • 允許在現有儲存桶上啟用 S3 物件鎖定。

12.0

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

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

11.9

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

    • CompleteMultpartUpload ： x-amz-checksum-sha256

    • CreateMultpartUpload ： x-amz-checksum-algorithm

    • GetObject ： x-amz-checksum-mode

    • 標題物件： x-amz-checksum-mode

    • 清單零件

    • PutObject ： x-amz-checksum-sha256

    • 上傳部分： x-amz-checksum-sha256

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

    • 貯體預設保留模式和物件保留模式：監管或法規遵循（如果網格管理員允許）。

    • 貯體預設保留期間和物件保留截止日期：必須小於或等於網格管理員所設定的保留期間上限所允許的值。

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

    • 如果存在、 `chunk-signature`則為選用且未驗證

    • 如果存在、 `x-amz-trailer`內容會被忽略

11.8

更新 S3 作業的名稱，以符合中使用的名稱 "Amazon Web Services（AWS）文件：Amazon Simple Storage Service API Reference"。

11.7

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

  • 新增對使用 S3 物件鎖定的治理模式的支援。

  • 新增「取得物件」和「標頭物件」要求的 StorageGRID 特定回應標頭支援 x-ntap-sg-cgr-replication-status。此標頭提供物件的跨網格複寫狀態。

  • SelectObjectContent 要求現在支援 Parquet 物件。

11.6

  • 新增支援、可在「取得物件」和「標題物件要求」中使用 `partNumber`要求參數。

  • 新增S3物件鎖定的預設保留模式支援、以及儲存區層級的預設保留期間。

  • 新增對原則條件金鑰的支援 s3:object-lock-remaining-retention-days、可設定物件的允許保留期間範圍。

  • 將單一「放置物件」作業的最大大小 _ 建議 _ 變更為 5 GiB （ 5 、 368,709,120 位元組）。如果您的物件大於5 GiB、請改用多部份上傳。

11.5

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

  • 新增了對S3物件鎖定和過時舊版規範要求的支援。

  • 新增使用刪除版本型儲存區上的多個物件的支援。

  • `Content-MD5`現在已正確支援要求標頭。

11.4.11.4

  • 新增刪除庫位標記、取得庫位標記及置入庫位標記的支援。不支援成本分攤標記。

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

  • 新增對活動類型的儲存庫通知的支援 s3:ObjectRestore:Post。

  • 現在已強制多部分零件的AWS大小限制。多部分上傳中的每個部分必須介於5個mib和5 GiB之間。最後一個部分可能小於5個mib。

  • 新增 TLS 1.3 支援

11.3

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

  • 新增刪除、取得及放置 Bucket 生命週期作業（僅限到期動作）及回應標頭的支援 x-amz-expiration。

  • 更新的「放置物件」、「放置物件」-「複製」和「多重成分上傳」、說明ILM規則在擷取時使用同步放置的影響。

  • 不再支援TLS 1.1密碼。

11.2

新增後物件還原支援、可搭配雲端儲存資源池使用。新增了使用AWS語法的支援、可用於ARN、原則條件金鑰、以及群組和儲存區原則中的原則變數。我們StorageGRID 將繼續支援使用此功能的現有群組和儲存區原則。

*附註：*在其他組態JSON/XML中使用ARN/URN StorageGRID （包括用於自訂的版本功能）並未變更。

11.1

新增支援跨來源資源共享（ CORS ）、 HTTP for S3 用戶端連線至網格節點、以及儲存區的法規遵循設定。

11.0

新增支援、可設定適用於儲存區的平台服務（CloudMirror複寫、通知及Elasticsearch整合）。此外、也新增對貯體物件標記位置限制的支援、以及可用的一致性。

10.4

新增對ILM掃描版本設定、端點網域名稱頁面更新、原則、原則範例及PuttoverwriteObject權限中的條件和變數的支援。

10.3

新增版本管理支援。

10.2

新增對群組和庫位存取原則的支援、以及多部份複本（上傳零件-複本）的支援。

10.1

新增對多部分上傳、虛擬主機式請求和 v4 驗證的支援。

10.0

StorageGRID系統初步支援 S3 REST API。 _簡單儲存服務 API 參考_目前支援的版本是 2006-03-01。