Passer au contenu principal
POST
Créer une URL d'import de dataset
POST /v1/datasets/upload/url Créez une URL d’import présignée pour un nouveau fichier de dataset.

Lier l’URL au fichier

Envoyez éventuellement content_length (le nombre exact d’octets, jusqu’à 5 GiB) et sha256 (une empreinte hexadécimale de 64 caractères). Le stockage rejette alors tout PUT dont la taille ou l’empreinte diffère, ce qui permet de détecter les imports tronqués ou corrompus avant le traitement.

Importer le fichier

Importez les octets exacts du fichier vers presigned_url avant son expiration. Copiez exactement chaque entrée de l’objet upload_headers de la réponse. L’objet contient toujours Content-Type: application/octet-stream ; lorsque vous avez déclaré content_length et sha256, il contient aussi les valeurs signées Content-Length et x-amz-checksum-sha256. Un en-tête signé manquant ou modifié renvoie 403.
La plupart des clients HTTP calculent Content-Length à partir du corps, mais cette valeur doit tout de même correspondre à la valeur signée. Après l’import, transmettez le dataset_id renvoyé à POST /v1/datasets/upload/process.

Autorisation

Nécessite le rôle Owner, Admin ou Editor de l’équipe. Les autres rôles reçoivent 403 Forbidden.