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.

Operaciones en objetos

Colaboradores

En esta sección se describe cómo el sistema StorageGRID implementa operaciones de la API DE REST de S3 para objetos.

Las siguientes condiciones se aplican a todas las operaciones de objeto:

  • StorageGRID "valores de coherencia" son compatibles con todas las operaciones de los objetos, con la excepción de lo siguiente:

    • GetObjectAcl

    • OPTIONS /

    • PutObjectLegalHold

    • PutObjectRetention

    • SelectObjectContent

  • Las solicitudes de clientes en conflicto, como dos clientes que escriben en la misma clave, se resuelven en función de las "últimas victorias". El plazo para la evaluación de "logros más recientes" se basa en cuándo el sistema StorageGRID completa una solicitud determinada, y no en cuándo los clientes de S3 comienzan una operación.

  • Todos los objetos de un bloque StorageGRID son propiedad del propietario del bloque, incluidos los objetos creados por un usuario anónimo o por otra cuenta.

  • No se puede acceder a los objetos de datos procesados en el sistema de StorageGRID a través de Swift mediante S3.

En la siguiente tabla se describe cómo StorageGRID implementa operaciones de objetos API DE REST de S3.

Funcionamiento Implementación

DeleteObject

Autenticación multifactor (MFA) y el encabezado de respuesta x-amz-mfa no son compatibles.

Al procesar una solicitud DeleteObject, StorageGRID intenta eliminar inmediatamente todas las copias del objeto de todas las ubicaciones almacenadas. Si se realiza correctamente, StorageGRID devuelve una respuesta al cliente inmediatamente. Si no se pueden eliminar todas las copias en 30 segundos (por ejemplo, porque una ubicación no está disponible temporalmente), StorageGRID pone en cola las copias para su eliminación y, a continuación, indica que se ha realizado correctamente al cliente.

Creación de versiones

Para eliminar una versión específica, el solicitante debe ser el propietario del bloque y utilizar el versionId subrecurso. El uso de este subrecurso elimina permanentemente la versión. Si la versionId corresponde a un marcador de borrado, el encabezado de respuesta x-amz-delete-marker se devuelve establecido en true.

  • Si se elimina un objeto sin el versionId subrecurso en un bloque habilitado para la versión, da como resultado la generación de un marcador de borrado. La versionId para el marcador de borrado se devuelve mediante x-amz-version-id encabezado de respuesta, y el x-amz-delete-marker el encabezado de la respuesta se devuelve establecido en true.

  • Si se elimina un objeto sin el versionId subrecurso en un bloque suspendido de la versión, se produce la eliminación permanente de una versión "nula" ya existente o un marcador de borrado "nula" y la generación de un nuevo marcador de borrado "nulo". La x-amz-delete-marker el encabezado de la respuesta se devuelve establecido en true.

    Nota: En algunos casos, pueden existir varios marcadores de borrado para un objeto.

Consulte "Use la API REST DE S3 para configurar el bloqueo de objetos de S3" Para obtener información sobre cómo eliminar versiones de objetos en el modo de GOBIERNO.

DeleteObjects

(Anteriormente denominado DELETE Múltiples Objetos)

Autenticación multifactor (MFA) y el encabezado de respuesta x-amz-mfa no son compatibles.

Se pueden eliminar varios objetos en el mismo mensaje de solicitud.

Consulte "Use la API REST DE S3 para configurar el bloqueo de objetos de S3" Para obtener información sobre cómo eliminar versiones de objetos en el modo de GOBIERNO.

DeleteObjectTagging

Utiliza la tagging subrecurso para quitar todas las etiquetas de un objeto.

Creación de versiones

Si la versionId el parámetro de consulta no se especifica en la solicitud, la operación elimina todas las etiquetas de la versión más reciente del objeto en un bloque con versiones. Si la versión actual del objeto es un marcador de eliminación, se devuelve el estado MethodNotAllowed con el x-amz-delete-marker encabezado de respuesta establecido en true.

GetObject

GetObjectAcl

Si se proporcionan las credenciales de acceso necesarias para la cuenta, la operación devuelve una respuesta positiva y el ID, DisplayName y permiso del propietario del objeto, lo que indica que el propietario tiene acceso completo al objeto.

GetObjectLegalHold

GetObjectRetention

GetObjectEtiquetado

Utiliza la tagging subrecurso para devolver todas las etiquetas de un objeto.

Creación de versiones

Si la versionId el parámetro de consulta no se especifica en la solicitud, la operación devuelve todas las etiquetas de la versión más reciente del objeto en un bloque con versiones. Si la versión actual del objeto es un marcador de eliminación, se devuelve el estado MethodNotAllowed con el x-amz-delete-marker encabezado de respuesta establecido en true.

Objeto principal

RestoreObject

Objeto de puta

CopyObject

(Anteriormente denominado Objeto PUT - Copiar)

PutObjectLegalHold

PutObjectRetention

PutObjectEtiquetado

Utiliza la tagging subrecurso para agregar un conjunto de etiquetas a un objeto existente.

Límites de etiqueta de objeto

Puede agregar etiquetas a nuevos objetos cuando los cargue o puede agregarlos a objetos existentes. Tanto StorageGRID como Amazon S3 admiten hasta 10 etiquetas por cada objeto. Las etiquetas asociadas a un objeto deben tener claves de etiqueta únicas. Una clave de etiqueta puede tener hasta 128 caracteres Unicode de longitud y los valores de etiqueta pueden tener hasta 256 caracteres Unicode de longitud. La clave y los valores distinguen entre mayúsculas y minúsculas.

Comportamiento de ingesta y actualizaciones de etiquetas

Cuando utiliza PutObjectTagging para actualizar las etiquetas de un objeto, StorageGRID no vuelve a ingerir el objeto. Esto significa que no se utiliza la opción de comportamiento de ingesta especificada en la regla de ILM que coincide. Cualquier cambio en la ubicación del objeto que se active por la actualización se realice cuando los procesos de ILM normales se reevalúan el ILM en segundo plano.

Esto significa que si la regla ILM utiliza la opción estricta para el comportamiento de ingesta, no se realiza ninguna acción si no se pueden realizar las ubicaciones de objetos necesarias (por ejemplo, porque una nueva ubicación requerida no está disponible). El objeto actualizado conserva su ubicación actual hasta que sea posible la colocación requerida.

Resolución de conflictos

Las solicitudes de clientes en conflicto, como dos clientes que escriben en la misma clave, se resuelven en función de las "últimas victorias". El plazo para la evaluación de "logros más recientes" se basa en cuándo el sistema StorageGRID completa una solicitud determinada, y no en cuándo los clientes de S3 comienzan una operación.

Creación de versiones

Si la versionId el parámetro de consulta no se especifica en la solicitud, la operación agrega etiquetas a la versión más reciente del objeto en un bloque con versiones. Si la versión actual del objeto es un marcador de eliminación, se devuelve el estado MethodNotAllowed con el x-amz-delete-marker encabezado de respuesta establecido en true.

SelectObjectContent