# GetObjectExtended（SOAP API）
<a name="SOAPGetObjectExtended"></a>

**注意**  
 Amazon S3 的 SOAP API 不适用于新客户，并将于 2025 年 8 月 31 日接近使用寿命终止（EOL）。我们建议您使用 REST API 或 Amazon SDK。

`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 字节范围的行为（请访问 [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:` 如果为 true，则当请求包含一个范围元素以及一个或两个 IfUnmodifiedSince/IfMatch 元素且条件失败时，返回整个对象而不是故障。这将启用 If-Range 功能（请访问 [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.27](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27)）。