Como usar API S3-compatible de DreamObjects

DreamObjects es compatible con la API de Amazon S3, por lo que es fácil usar sus aplicaciones existentes. Sin embargo, a diferencia de Amazon, DreamObjects usa RGW, la puerta de enlace RADOS que se basa en el almacén de archivos CEPH.

Campos de Encabezados No Soportados

No se admiten los siguientes campos de encabezado de solicitud comunes:

Bucket y Hostname

Hay dos modos diferentes de acceder a los buckets. El primer método (preferido) identifica el depósito como el directorio de nivel superior en el URI:

GET /mybucket HTTP/1.1
Host: objects-us-east-1.dream.io

El segundo método identifica el bucket a través de un hostname bucket virtual. Por ejemplo:

GET / HTTP/1.1
Host: mybucket.objects-us-east-1.dream.io

Requerimiento de Encabezados Comunes

Respuesta de Estados Comunes

Las solicitudes a DreamObjects pueden estar autenticadas o no. DreamObjects asume que las solicitudes no autenticadas son enviadas por un usuario anónimo. DreamObjects también admite ACL predefinidas.

Autenticación

Autenticar un requerimiento requiere incluir una Llave de Acceso y un código de autenticación de mensajes basado en hash (HMAC) en la solicitud antes de que se envíe al servidor RGW. RGW utiliza un enfoque de autenticación compatible con S3:

HTTP/1.1
PUT /buckets/bucket/object.mpeg
Host: objects-us-east-1.dream.io
Date: Mon, 25 Mar 2024 00:01:01 +0000
Content-Encoding: mpeg
Content-Length: 9999999
                      
Authorization: AWS {access-key}:{hash-of-header-and-secret}

En el anterior ejemplo, reemplaza {access-key} con el valor de tu ID de clave de acceso seguido de dos puntos (:). Reemplaza {hash-of-header-and-secret} con un hash de la cadena de encabezado y el secreto correspondiente al ID de la clave de acceso.

Para generar el hash de la cadena de encabezado y el secreto:

1. Obtiene el valor de la cadena de encabezado.
2. Normaliza la cadena del encabezado de la solicitud en forma canónica.
3. Genera un HMAC utilizando un algoritmo hash SHA-1. Mira RFC 2104 y HMAC para más detalles.
4. Codifica el resultado hmac como base-64.

Para normalizar el encabezado en forma canónica:

1. Obtiene todos los campos empezando con x-amz-.
2. Asegúrate de que todos los campos estén en minúsculas.
3. Ordena los campos lexicográficamente.
4. Combina varias instancias del mismo nombre de campo en un solo campo y separa los valores del campo con una coma.
5. Reemplaza los espacios en blanco y los saltos de línea en los valores de campo con un solo espacio.
6. Elimina los espacios en blanco antes y después de los dos puntos.
7. Agrega una nueva línea después de cada campo.
8. Vuelve a fusionar los campos en el encabezado.

Reemplaza {hash-of-header-and-secret} con la cadena HMAC codificada en base 64.

PUT Object

Agrega un objeto a un bucket. Debes tener permisos de escritura en el bucket para realizar esta operación.

Sintaxis

PUT /{bucket}/{object} HTTP/1.1
                                                

Encabezados de Requerimiento

COPY Object

Para copiar un object, usa PUT y especifica un bucket de destino y el nombre del object.

Sintaxis

PUT /{dest-bucket}/{dest-object} HTTP/1.1
x-amz-copy-source: {source-bucket}/{source-object}

DELETE /{bucket}/{object} HTTP/1.1
                                                

GET /{bucket}/{object} HTTP/1.1
                                                

HEAD /{bucket}/{object} HTTP/1.1
                                                

GET /{bucket}/{object}?acl HTTP/1.1
                                                

PUT /{bucket}/{object}?acl
                                                

POST /{bucket}/{object}?uploads
                                                

PUT /{bucket}/{object}?partNumber=&uploadId= HTTP/1.1
                                                

GET /{bucket}/{object}?uploadId=123 HTTP/1.1
                                                

POST /{bucket}/{object}?uploadId= HTTP/1.1
                                                

DELETE /{bucket}/{object}?uploadId= HTTP/1.1