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

**注記**  
 SOAP API for Amazon S3 は新規顧客には利用できず、2025 年 8 月 31 日にサポート終了 (EOL) となります。REST API か AWS 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:` 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) を参照)。