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

**nota**  
 As APIs SOAP para o Amazon S3 não estão disponíveis para novos clientes e chegam ao fim da vida útil (EOL) em 31 de agosto de 2025. Recomendamos usar a API REST ou os AWS SDKs. 

`GetObjectExtended` é exatamente igual a [GetObject (API SOAP)](SOAPGetObject.md), exceto pelo fato de oferecer suporte aos seguintes elementos adicionais que podem ser usados para realizar grande parte da mesma funcionalidade fornecida pelos cabeçalhos HTTP GET (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)).

GetObjectExtended oferece suporte aos seguintes elementos, além dos que são compatíveis com GetObject:
+ `ByteRangeStart, ByteRangeEnd:` Esses elementos especificam que somente uma parte dos dados do objeto deve ser recuperada. Eles seguem o comportamento dos intervalos de bytes HTTP (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.35](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35)).
+ `IfModifiedSince:` Retorne o objeto somente se o carimbo de data e hora do objeto for posterior ao carimbo de data e hora especificado. ([http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.25](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25))
+ `IfUnmodifiedSince:` Retorne o objeto somente se o carimbo de data e hora do objeto for anterior ou igual ao carimbo de data e hora especificado. (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.28](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28))
+ `IfMatch:` Retorne o objeto somente se o ETag corresponder às tags fornecidas. (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.24](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24))
+ `IfNoneMatch:` Retorne o objeto somente se o ETag não corresponder às tags fornecidas. (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.26](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26))
+ `ReturnCompleteObjectOnConditionFailure:`ReturnCompleteObjectOnConditionFailure: se for verdadeiro, e se a solicitação incluir um elemento de intervalo e um ou os dois elementos IfUnmodifiedSince/IfMatch, e a condição falhar, retorne o objeto inteiro em vez de uma falha. Isso habilita a funcionalidade If-Range (acesse [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.27](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27)).