Operaciones de objeto
Las siguientes operaciones de la API de Swift se realizan en objetos.
ELIMINAR objeto
Esta operación elimina los metadatos y el contenido de un objeto del sistema StorageGRID.
Se requieren los siguientes parámetros de solicitud:
-
Account
-
Container
-
Object
Se requiere el siguiente encabezado de solicitud:
-
X-Auth-Token
Una ejecución correcta devuelve los encabezados de respuesta siguientes con un HTTP/1.1 204 No Content
respuesta:
-
Content-Length
-
Content-Type
-
Date
-
X-Trans-Id
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 un plazo de 30 segundos (por ejemplo, porque una ubicación no está disponible temporalmente), StorageGRID pone en cola las copias para su eliminación y luego indica que el cliente se ha realizado correctamente.
Para obtener más información sobre cómo eliminar objetos, consulte las instrucciones para gestionar objetos con gestión del ciclo de vida de la información.
OBJETO GET
Esta operación recupera el contenido de objetos y obtiene los metadatos de objetos de un sistema StorageGRID.
Se requieren los siguientes parámetros de solicitud:
-
Account
-
Container
-
Object
Se requiere el siguiente encabezado de solicitud:
-
X-Auth-Token
Los siguientes encabezados de solicitud son opcionales:
-
Accept-Encoding
-
If-Match
-
If-Modified-Since
-
If-None-Match
-
If-Unmodified-Since
-
Range
Una ejecución correcta devuelve los encabezados siguientes con un HTTP/1.1 200 OK
respuesta:
-
Accept-Ranges
-
Content-Disposition
, devuelto sólo siContent-Disposition
se establecieron los metadatos -
Content-Encoding
, devuelto sólo siContent-Encoding
se establecieron los metadatos -
Content-Length
-
Content-Type
-
Date
-
ETag
-
Last-Modified
-
X-Timestamp
-
X-Trans-Id
OBJETO HEAD
Esta operación recupera los metadatos y las propiedades de un objeto ingerido desde un sistema StorageGRID.
Se requieren los siguientes parámetros de solicitud:
-
Account
-
Container
-
Object
Se requiere el siguiente encabezado de solicitud:
-
X-Auth-Token
Una ejecución correcta devuelve los siguientes encabezados con una respuesta "HTTP/1.1 200 OK":
-
Accept-Ranges
-
Content-Disposition
, devuelto sólo siContent-Disposition
se establecieron los metadatos -
Content-Encoding
, devuelto sólo siContent-Encoding
se establecieron los metadatos -
Content-Length
-
Content-Type
-
Date
-
ETag
-
Last-Modified
-
X-Timestamp
-
X-Trans-Id
PONER objeto
Esta operación crea un objeto nuevo con datos y metadatos, o reemplaza un objeto existente con datos y metadatos en un sistema StorageGRID.
La StorageGRID admite objetos de hasta 5 TIB (5,497,558,138,880 bytes) con un tamaño.
|
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 Swift inician una operación. |
Se requieren los siguientes parámetros de solicitud:
-
Account
-
Container
-
Object
Se requiere el siguiente encabezado de solicitud:
-
X-Auth-Token
Los siguientes encabezados de solicitud son opcionales:
-
Content-Disposition
-
Content-Encoding
No utilice chunked
Content-Encoding
Si la regla de ILM que se aplica a un objeto filtra objetos según el tamaño y utiliza la ubicación síncrona durante el procesamiento (las opciones equilibradas o estrictas del comportamiento de ingesta). -
Transfer-Encoding
No utilice comprimido ni descomprimido
Transfer-Encoding
Si la regla de ILM que se aplica a un objeto filtra objetos según el tamaño y utiliza la ubicación síncrona durante el procesamiento (las opciones equilibradas o estrictas del comportamiento de ingesta). -
Content-Length
Si una regla de ILM filtra objetos por tamaño y utiliza la ubicación síncrona durante el procesamiento, debe especificar
Content-Length
.Si no sigue estas directrices para Content-Encoding
,Transfer-Encoding
, y.Content-Length
, StorageGRID debe guardar el objeto para poder determinar el tamaño del objeto y aplicar la regla ILM. En otras palabras, StorageGRID debe crear de forma predeterminada copias provisionales de un objeto durante el procesamiento. Es decir, StorageGRID debe utilizar la opción Dual COMMIT para el comportamiento de procesamiento.Para obtener más información sobre las reglas de la ubicación síncrona y ILM, consulte las instrucciones para gestionar objetos con gestión del ciclo de vida de la información.
-
Content-Type
-
ETag
-
X-Object-Meta-<name\>
(metadatos relacionados con objetos)Si desea utilizar la opción tiempo de creación definido por el usuario como tiempo de referencia para una regla de ILM, debe almacenar el valor en un encabezado definido por el usuario denominado
X-Object-Meta-Creation-Time
. Por ejemplo:X-Object-Meta-Creation-Time: 1443399726
Este campo se evalúa como segundos desde el 1 de enero de 1970.
-
X-Storage-Class: reduced_redundancy
Este encabezado afecta al número de copias de objeto que crea StorageGRID si la regla de ILM que coincide con un objeto ingerido especifica un comportamiento de procesamiento de Doble COMMIT o equilibrado.
-
Commit doble: Si la regla ILM especifica la opción COMMIT doble para el comportamiento de la ingesta, StorageGRID crea una única copia provisional mientras se ingiere el objeto (COMMIT único).
-
Balanceado: Si la regla ILM especifica la opción equilibrada, StorageGRID realiza una única copia provisional sólo si el sistema no puede hacer inmediatamente todas las copias especificadas en la regla. Si StorageGRID puede realizar una colocación síncrona, este encabezado no tiene ningún efecto.
La
reduced_redundancy
El encabezado se utiliza mejor cuando la regla de ILM que coincide con el objeto crea una única copia replicada. En este caso, utilizarreduced_redundancy
elimina la creación y eliminación innecesarias de una copia de objetos adicional en cada operación de procesamiento.Con el
reduced_redundancy
la cabecera no se recomienda en otras circunstancias porque aumenta el riesgo de pérdida de datos de objetos durante el procesamiento. Por ejemplo, puede perder datos si la única copia se almacena inicialmente en un nodo de almacenamiento que falla antes de que se pueda realizar la evaluación de ILM.Tener solo una copia replicada durante un periodo de tiempo pone los datos en riesgo de pérdida permanente. Si sólo existe una copia replicada de un objeto, éste se pierde si falla un nodo de almacenamiento o tiene un error importante. También perderá temporalmente el acceso al objeto durante procedimientos de mantenimiento, como las actualizaciones.
Tenga en cuenta que especificar
reduced_redundancy
sólo afecta al número de copias que se crean cuando un objeto se ingiere por primera vez. No afecta al número de copias del objeto que se realizan cuando el objeto se evalúa mediante la política de ILM activa y no provoca que los datos se almacenen en niveles más bajos de redundancia en el sistema StorageGRID. -
Una ejecución correcta devuelve los siguientes encabezados con una respuesta "HTTP/1.1 201 creado":
-
Content-Length
-
Content-Type
-
Date
-
ETag
-
Last-Modified
-
X-Trans-Id