OBTENER objeto
Puede usar la solicitud GET Object de S3 para recuperar un objeto de un bloque de S3.
No se admite el parámetro de solicitud de número de referencia
La partNumber
El parámetro request no es compatible con GET Object Requests. No puede realizar una solicitud GET para recuperar una parte específica de un objeto de varias partes. Se devuelve un error 501 no implementado con el siguiente mensaje:
GET Object by partNumber is not implemented
Solicitar encabezados para el cifrado del servidor con claves de cifrado proporcionadas por el cliente (SSE-C)
Utilice los tres encabezados si el objeto está cifrado con una clave única que ha proporcionado.
-
x-amz-server-side-encryption-customer-algorithm
: EspecificarAES256
. -
x-amz-server-side-encryption-customer-key
: Especifique la clave de cifrado del objeto. -
x-amz-server-side-encryption-customer-key-MD5
: Especifique el resumen MD5 de la clave de cifrado del objeto.
Las claves de cifrado que proporcione no se almacenan nunca. Si pierde una clave de cifrado, perderá el objeto correspondiente. Antes de utilizar las claves proporcionadas por el cliente para proteger los datos de objetos, revise las consideraciones en «"uso del cifrado en el servidor"». |
Caracteres UTF-8 en los metadatos de usuario
StorageGRID no analiza ni interpreta caracteres UTF-8 escapados en los metadatos definidos por el usuario. LAS solicitudes GET de un objeto con caracteres UTF-8 escapados en metadatos definidos por el usuario no devuelven el x-amz-missing-meta
encabezado si el nombre o valor de clave incluye caracteres no imprimibles.
Encabezado de solicitud no compatible
El siguiente encabezado de solicitud no es compatible y devuelve XNotImplemented
:
-
x-amz-website-redirect-location
Creación de versiones
Si es un versionId
no se especifica el subrecurso, la operación busca la versión más reciente del objeto en un bloque con versiones. Si la versión actual del objeto es un marcador de borrado, se devuelve el estado "'no encontrado'" con la x-amz-delete-marker
encabezado de respuesta establecido en true
.
Comportamiento de OBTENER objeto para objetos de pool de almacenamiento en cloud
Si un objeto se ha almacenado en un Cloud Storage Pool (consulte las instrucciones para gestionar objetos con gestión del ciclo de vida de la información), el comportamiento de una solicitud GET Object depende del estado del objeto. Consulte «'HEAD Object'» para obtener más información.
Si un objeto está almacenado en un Cloud Storage Pool y existen también una o varias copias del objeto en el grid, GET Object Requests intentará recuperar datos del grid, antes de recuperarlos del Cloud Storage Pool. |
Estado del objeto | Comportamiento DE GET Object |
---|---|
Objeto ingerido en StorageGRID pero aún no evaluado por ILM, u objeto almacenado en un pool de almacenamiento tradicional o utilizando código de borrado |
Se recupera una copia del objeto. |
Objeto en el pool de almacenamiento en cloud pero todavía no ha realizado la transición a un estado no recuperable |
Se recupera una copia del objeto. |
Objeto que ha pasado a un estado no recuperable |
Utilice una solicitud DE restauración POSTERIOR a objetos para restaurar el objeto en un estado recuperable. |
Objeto en proceso de restauración a partir de un estado no recuperable |
Espere a que se complete la solicitud DE restauración DE objeto POSTERIOR. |
Objeto completamente restaurado en el pool de almacenamiento en cloud |
Se recupera una copia del objeto. |
Objetos de varias partes o segmentados en un pool de almacenamiento en nube
Si cargó un objeto con varias partes o StorageGRID dividió un objeto grande en segmentos, StorageGRID determina si el objeto está disponible en el pool de almacenamiento en cloud al muestrear un subconjunto de las partes o segmentos del objeto. En algunos casos, es posible que UNA solicitud GET Object devuelva incorrectamente 200 OK
cuando algunas partes del objeto ya se han trasladado a un estado no recuperable o cuando algunas partes del objeto aún no se han restaurado.
En estos casos:
-
La solicitud GET Object puede devolver algunos datos pero detenerse a mitad de camino a través de la transferencia.
-
Una petición GET Object posterior podría devolver
403 Forbidden
.