Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Objeto principal

Colaboradores

Puede utilizar la solicitud S3 HeadObject para recuperar metadatos de un objeto sin devolver el objeto en sí. Si el objeto está almacenado en un Cloud Storage Pool, puede usar HeadObject para determinar el estado de transición del objeto.

HeadObject y objetos multiparte

Puede utilizar el partNumber parámetro request para recuperar metadatos de una parte específica de un objeto multiparte o segmentado. El x-amz-mp-parts-count elemento de respuesta indica cuántas partes tiene el objeto.

Se puede establecer partNumber en 1 para objetos segmentados/multiparte y objetos no segmentados/no multiparte; sin embargo, el x-amz-mp-parts-count elemento de respuesta sólo se devuelve para objetos segmentados o multiparte.

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 de CABECERA para un objeto con caracteres UTF-8 que se han escapado en los metadatos definidos por el usuario no devuelven x-amz-missing-meta la cabecera si el nombre o el valor de la clave incluyen caracteres no imprimibles.

Cabecera de solicitud admitida

Se admite el siguiente encabezado de solicitud:

  • x-amz-checksum-mode

    El partNumber parámetro y Range el encabezado no son compatibles con x-amz-checksum-mode para HeadObject. Cuando se incluyen en la solicitud con x-amz-checksum-mode Enabled, StorageGRID no devuelve un valor de suma de comprobación en la respuesta.

Encabezado de solicitud no compatible

La siguiente cabecera de solicitud no está soportada y devuelve XNotImplemented:

  • x-amz-website-redirect-location

Creación de versiones

Si no se especifica un versionId subrecurso, la operación recupera la versión más reciente del objeto en un bloque con versiones. Si la versión actual del objeto es un marcador de supresión, se devuelve un estado de no encontrado con la x-amz-delete-marker cabecera de respuesta establecida en true.

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: Especificar AES256.

  • x-amz-server-side-encryption-customer-key: Especifique su clave de cifrado para el objeto.

  • x-amz-server-side-encryption-customer-key-MD5: Especifique el resumen MD5 de la clave de cifrado del objeto.

Precaución 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 "Usar cifrado del servidor".

Respuestas HeadObject para objetos de Cloud Storage Pool

Si el objeto se almacena en un "Pool de almacenamiento en cloud", se devuelven las siguientes cabeceras de respuesta:

  • x-amz-storage-class: GLACIER

  • x-amz-restore

Los encabezados de respuesta proporcionan información sobre el estado de un objeto a medida que se mueve a un pool de almacenamiento en cloud, y que, opcionalmente, se realiza la transición a un estado no recuperable y se restaura.

Estado del objeto Respuesta a HeadObject

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

200 OK (No se devuelve ninguna cabecera de respuesta especial).

Objeto en el pool de almacenamiento en cloud pero todavía no ha realizado la transición a un estado no recuperable

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"

Hasta que el objeto se convierte en un estado no recuperable, el valor para expiry-date se establece en un tiempo lejano en el futuro. El sistema StorageGRID no controla la hora exacta de la transición.

El objeto ha pasado a estar en estado no recuperable, pero también existe al menos una copia en la cuadrícula

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"

El valor para expiry-date se establece en algún tiempo lejano en el futuro.

Nota: Si la copia en la cuadrícula no está disponible (por ejemplo, un nodo de almacenamiento está caído), debe emitir una "RestoreObject" solicitud para restaurar la copia del grupo de almacenamiento en la nube antes de poder recuperar el objeto con éxito.

El objeto ha pasado a un estado que no se puede recuperar y no existe ninguna copia en la cuadrícula

200 OK

x-amz-storage-class: GLACIER

Objeto en proceso de restauración a partir de un estado no recuperable

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="true"

Objeto completamente restaurado en el pool de almacenamiento en cloud

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2018 00:00:00 GMT"

`expiry-date`Indica cuándo el objeto del pool de almacenamiento en la nube volverá a un estado no recuperable.

Objetos de varias partes o segmentos en el pool de almacenamiento en cloud

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, una solicitud HeadObject podría regresar incorrectamente x-amz-restore: ongoing-request="false" 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.

HeadObject y replicación entre grid

Si está utilizando "federación de grid" y "replicación entre grid" está habilitado para un depósito, el cliente S3 puede verificar el estado de replicación de un objeto emitiendo una solicitud HeadObject. La respuesta incluye el encabezado de respuesta específico de StorageGRID x-ntap-sg-cgr-replication-status, que tendrá uno de los siguientes valores:

Cuadrícula Estado de replicación

Origen

  • COMPLETADO: La replicación fue exitosa.

  • PENDIENTE: El objeto aún no ha sido replicado.

  • FALLO: La replicación falló con un fallo permanente. Un usuario debe resolver el error.

Destino

REPLICA: El objeto fue replicado desde la cuadrícula de origen.

Nota StorageGRID no admite x-amz-replication-status el encabezado.