GetObjectExtended (API SOAP)
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), 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
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). 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) 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) IfMatch:Retorne o objeto somente se o ETag corresponder às tags fornecidas. (acesse 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) 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).
