本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# GetObjectExtended (SOAP API)
<a name="SOAPGetObjectExtended"></a>

**注意**  
 Amazon S3 的 SOAP API 不適用於新客戶，並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。

`GetObjectExtended` 與 完全相同[GetObject (SOAP API)](SOAPGetObject.md)，但它支援下列其他元素，可用於完成 HTTP GET 標頭提供的許多相同功能 （請前往 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html](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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35))。
+ `IfModifiedSince:` 只有在物件的時間戳記晚於指定的時間戳記時，才傳回物件。([http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.25](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25)：//)
+ `IfUnmodifiedSince:` 只有在物件的時間戳記早於或等於指定的時間戳記時，才傳回物件。（前往 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.28](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28)：//)
+ `IfMatch:` 只有在物件的 ETag 符合提供的標籤時，才傳回物件 （前往 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.24](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24)：//)。
+ `IfNoneMatch:` 只有在物件的 ETag 不符合提供的標籤時，才傳回物件 （前往 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.26](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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27))。