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

05/18/2023 Colaboradores

PDF

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 "controles de consistencia" son compatibles con todas las operaciones de los objetos, con la excepción de lo siguiente:
- OBTENER ACL de objeto
- OPTIONS /
- PONER objeto legal
- PUT Object retention
- SELECCIONE Contenido de objeto
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 «'últimos logros'» se basa en cuándo el sistema StorageGRID completa una solicitud determinada, y no en cuándo los clientes de S3 inician 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

Funcionamiento	Implementación
ELIMINAR objeto	Autenticación multifactor (MFA) y el encabezado de respuesta `x-amz-mfa` no son compatibles. Al procesar una solicitud DE ELIMINACIÓN de objeto, 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.
ELIMINAR varios objetos (ElieteObjects)	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.
ELIMINAR etiquetado de objetos	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 borrado, se devuelve el estado "MetodNotAllowed" con el `x-amz-delete-marker` encabezado de respuesta establecido en `true`.
OBTENER objeto	"OBTENER objeto"
OBTENER ACL de objeto	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.
OBTENER retención legal de objetos	"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"
OBTENGA retención de objetos	"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"
GET Object tagging	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 borrado, se devuelve el estado "MetodNotAllowed" con el `x-amz-delete-marker` encabezado de respuesta establecido en `true`.
OBJETO HEAD	"OBJETO HEAD"
Restauración DE objetos posterior	"Restauración DE objetos posterior"
OBJETO PUT	"OBJETO PUT"
PONER objeto: Copiar	"PONER objeto: Copiar"
PONER objeto legal	"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"
PUT Object retention	"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"
PUT Object tagging	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 se utiliza PUT Object tagging para actualizar las etiquetas de un objeto, StorageGRID no vuelve a procesar 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 base a «las últimas victorias». El plazo para la evaluación de «'últimos logros'» se basa en cuándo el sistema StorageGRID completa una solicitud determinada, y no en cuándo los clientes de S3 inician 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 borrado, se devuelve el estado "MetodNotAllowed" con el `x-amz-delete-marker` encabezado de respuesta establecido en `true`.
SelectObjectContent	"SelectObjectContent"

ELIMINAR objeto

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

Al procesar una solicitud DE ELIMINACIÓN de objeto, 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.

ELIMINAR varios objetos

(ElieteObjects)

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.

ELIMINAR etiquetado de objetos

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 borrado, se devuelve el estado "MetodNotAllowed" con el x-amz-delete-marker encabezado de respuesta establecido en true.

OBTENER objeto

"OBTENER objeto"

OBTENER ACL de objeto

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.

OBTENER retención legal de objetos

"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"

OBTENGA retención de objetos

"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"

GET Object tagging

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 borrado, se devuelve el estado "MetodNotAllowed" con el x-amz-delete-marker encabezado de respuesta establecido en true.

OBJETO HEAD

"OBJETO HEAD"

Restauración DE objetos posterior

"Restauración DE objetos posterior"

OBJETO PUT

"OBJETO PUT"

PONER objeto: Copiar

"PONER objeto: Copiar"

PONER objeto legal

"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"

PUT Object retention

"Use la API REST DE S3 para configurar el bloqueo de objetos de S3"

PUT Object tagging

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 se utiliza PUT Object tagging para actualizar las etiquetas de un objeto, StorageGRID no vuelve a procesar 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 base a «las últimas victorias». El plazo para la evaluación de «'últimos logros'» se basa en cuándo el sistema StorageGRID completa una solicitud determinada, y no en cuándo los clientes de S3 inician 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 borrado, se devuelve el estado "MetodNotAllowed" con el x-amz-delete-marker encabezado de respuesta establecido en true.

SelectObjectContent

"SelectObjectContent"

Información relacionada

"Se realizó un seguimiento de las operaciones de S3 en los registros de auditoría"

Operaciones en objetos

Creating your file...