Operaciones de la API de REST de StorageGRID Swift
Sugerir cambios
PDF
Existen operaciones que se añaden a la API DE REST de Swift que son específicas del sistema StorageGRID.
OBTENGA la solicitud de consistencia del contenedor
El nivel de coherencia establece una compensación entre la disponibilidad de los objetos y la coherencia de dichos objetos en los diferentes nodos y sitios de almacenamiento. La solicitud DE consistencia DEL contenedor le permite determinar el nivel de consistencia que se aplica a un contenedor en particular.
Solicitud
| Solicitar encabezado HTTP | Descripción |
|---|---|
|
Especifica el token de autenticación Swift de la cuenta que se va a utilizar para la solicitud. |
|
Especifica el tipo de solicitud, donde |
|
El nombre de host al que se dirige la solicitud. |
Ejemplo de solicitud
GET /v1/28544923908243208806/Swift container X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: true Host: test.com
Respuesta
| Encabezado HTTP de respuesta | Descripción |
|---|---|
|
La fecha y la hora de la respuesta. |
|
Si la conexión con el servidor está abierta o cerrada. |
|
Identificador de transacción único para la solicitud. |
|
La longitud del cuerpo de respuesta. |
|
El nivel de control de consistencia que se aplica al contenedor. Se admiten los siguientes valores:
|
Ejemplo de respuesta
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0 x-ntap-sg-consistency: strong-site
PONGA la solicitud de consistencia del contenedor
La solicitud DE PUT Container permite especificar el nivel de coherencia que se aplicará a las operaciones realizadas en un contenedor. De forma predeterminada, se crean nuevos contenedores utilizando el nivel de coherencia «entre una y otra escritura».
Solicitud
| Solicitar encabezado HTTP | Descripción |
|---|---|
|
El token de autenticación Swift de la cuenta que se va a utilizar para la solicitud. |
|
El nivel de control de coherencia que se va a aplicar a las operaciones en el contenedor. Se admiten los siguientes valores:
|
|
El nombre de host al que se dirige la solicitud. |
Cómo interactúan los controles de consistencia y las reglas de ILM para afectar a la protección de datos
Tanto la elección del control de coherencia como la regla de ILM afectan a la forma en que se protegen los objetos. Estos ajustes pueden interactuar.
Por ejemplo, el control de consistencia usado cuando se almacena un objeto afecta a la colocación inicial de los metadatos de objetos, mientras que el comportamiento de procesamiento seleccionado para la regla de ILM afecta a la colocación inicial de las copias de objetos. Dado que StorageGRID requiere acceso tanto a los metadatos de un objeto como a sus datos para cumplir con las solicitudes de los clientes, seleccionar los niveles de protección correspondientes para el nivel de coherencia y el comportamiento de ingesta puede proporcionar una mejor protección de datos inicial y respuestas más predecibles del sistema.
Para las reglas de ILM hay disponibles los siguientes comportamientos de consumo:
-
Estricto: Todas las copias especificadas en la regla ILM deben hacerse antes de que el éxito se devuelva al cliente.
-
Balanceado: StorageGRID intenta hacer todas las copias especificadas en la regla ILM en la ingesta; si esto no es posible, se hacen copias provisionales y se devuelve éxito al cliente. Las copias especificadas en la regla ILM se realizan cuando es posible.
-
Commit doble: StorageGRID realiza inmediatamente copias provisionales del objeto y devuelve éxito al cliente. Las copias especificadas en la regla ILM se realizan cuando es posible.
|
Antes de seleccionar el comportamiento de procesamiento de una regla de ILM, lea la descripción completa de estos ajustes en las instrucciones para gestionar objetos con gestión del ciclo de vida de la información. |
Ejemplo de cómo puede interactuar el control de consistencia y la regla de ILM
Suponga que tiene una cuadrícula de dos sitios con la siguiente regla de ILM y la siguiente configuración de nivel de coherencia:
-
Norma ILM: Cree dos copias de objetos, una en el sitio local y otra en un sitio remoto. Se ha seleccionado el comportamiento de procesamiento estricto.
-
Nivel de coherencia: "Strong-global" (los metadatos de objetos se distribuyen inmediatamente a todos los sitios).
Cuando un cliente almacena un objeto en el grid, StorageGRID realiza copias de objetos y distribuye los metadatos en ambos sitios antes de devolver el éxito al cliente.
El objeto está completamente protegido contra la pérdida en el momento del mensaje de procesamiento correcto. Por ejemplo, si el sitio local se pierde poco después del procesamiento, seguirán existiendo copias de los datos del objeto y los metadatos del objeto en el sitio remoto. El objeto se puede recuperar completamente.
Si en su lugar usa la misma regla de ILM y el nivel de consistencia de «otrong-site», es posible que el cliente reciba un mensaje de éxito después de replicar los datos del objeto en el sitio remoto, pero antes de que los metadatos del objeto se distribuyan allí. En este caso, el nivel de protección de los metadatos de objetos no coincide con el nivel de protección de los datos de objetos. Si el sitio local se pierde poco después del procesamiento, se pierden los metadatos del objeto. No se puede recuperar el objeto.
La interrelación entre los niveles de coherencia y las reglas del ILM puede ser compleja. Póngase en contacto con NetApp si necesita ayuda.
Ejemplo de solicitud
PUT /v1/28544923908243208806/_Swift container_ X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: strong-site Host: test.com
Respuesta
| Encabezado HTTP de respuesta | Descripción |
|---|---|
|
La fecha y la hora de la respuesta. |
|
Si la conexión con el servidor está abierta o cerrada. |
|
Identificador de transacción único para la solicitud. |
|
La longitud del cuerpo de respuesta. |
Ejemplo de respuesta
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0