本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetObjectExtended (SOAP API)
注意
Amazon S3 的 SOAP API 不適用於新客戶,並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。
GetObjectExtended 與 完全相同GetObject (SOAP API),但它支援下列其他元素,可用於完成 HTTP GET 標頭提供的許多相同功能 (請前往 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html
GetObjectExtended 還支援下列元素: GetObject
ByteRangeStart, ByteRangeEnd:這些元素指定僅應擷取一部分的物件資料。它們遵循 HTTP 位元組範圍的行為 (前往 https://http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35)。 IfModifiedSince:只有在物件的時間戳記晚於指定的時間戳記時,才傳回物件。(http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25://) IfUnmodifiedSince:只有在物件的時間戳記早於或等於指定的時間戳記時,才傳回物件。(前往 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28://) IfMatch:只有在物件的 ETag 符合提供的標籤時,才傳回物件 (前往 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24://)。 IfNoneMatch:只有在物件的 ETag 不符合提供的標籤時,才傳回物件 (前往 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26://)。 ReturnCompleteObjectOnConditionFailure:ReturnCompleteObjectOnConditionFailure:如果為 true,則如果請求包含範圍元素和一個或兩個 IfUnmodifiedSince/IfMatch 元素,且條件失敗,則傳回整個物件,而不是故障。這會啟用 If-Range 功能 (前往 https://http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27)。