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

**참고**  
 Amazon S3용 SOAP API는 신규 고객에게 제공되지 않으며 2025년 8월 31일에 서비스 종료(EOL)됩니다. REST API 또는 AWS SDK를 사용하는 것이 좋습니다.

`GetObjectExtended`는 HTTP GET 헤더([http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) 참조)에서 제공하는 기능을 대부분 수행하는 데 사용할 수 있는 다음과 같은 추가 요소를 지원한다는 점을 제외하면 [GetObject(SOAP API)](SOAPGetObject.md)와 동일합니다.

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) 참조).