

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

**nota**  
 Las API de SOAP para Amazon S3 no están disponibles para nuevos clientes y se acercan al fin de la vida útil (EOL) el 31 de agosto de 2025. Le recomendamos que utilice la API de REST o los SDK de AWS. 

`GetObjectExtended` es exactamente igual que [GetObject (API de SOAP)](SOAPGetObject.md), excepto que admite los siguientes elementos adicionales que se pueden utilizar para realizar gran parte de la misma funcionalidad que proporcionan los encabezados HTTP GET (vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)).

GetObjectExtended admite los siguientes elementos además de los compatibles con GetObject:
+ `ByteRangeStart, ByteRangeEnd:` estos elementos especifican que solo se debe recuperar una parte de los datos del objeto. Siguen el comportamiento de los rangos de bytes HTTP (vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.35](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35)).
+ `IfModifiedSince:` devuelve el objeto solo si la marca temporal del objeto es posterior a la marca temporal especificada. ([http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.25](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25))
+ `IfUnmodifiedSince:` devuelve el objeto solo si la marca temporal del objeto es anterior o igual a la marca temporal especificada. (Vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.28](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28))
+ `IfMatch:` devuelve el objeto solo si su ETag coincide con las etiquetas proporcionadas. (Vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.24](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24))
+ `IfNoneMatch:` devuelve el objeto solo si su ETag no coincide con las etiquetas proporcionadas. (Vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.26](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26))
+ `ReturnCompleteObjectOnConditionFailure:`ReturnCompleteObjectOnConditionFailure: si es verdadero, si la solicitud incluye un elemento de rango y uno o ambos elementos IfUnmodifiedSince/IfMatch, y la condición produce un error, devuelva el objeto completo en lugar de un error. Esto habilita la funcionalidad If-Range (vaya a [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html\#sec14.27](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.27)).