GetObjectExtended(SOAP API)
注意
Amazon S3 的 SOAP API 不适用于新客户,并将于 2025 年 8 月 31 日接近使用寿命终止(EOL)。我们建议您使用 REST API 或 AWS SDK。
GetObjectExtended 与 GetObject(SOAP API)完全相同,区别在于它支持以下额外元素,可用于实现 HTTP GET 标头提供的许多相同功能(请访问 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)。 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:如果为 true,则当请求包含一个范围元素以及一个或两个 IfUnmodifiedSince/IfMatch 元素且条件失败时,返回整个对象而不是故障。这将启用 If-Range 功能(请访问 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27)。