Finaliser un envoi chunked

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Chunked Complete assemble les parties envoyées avec Chunked Part en un fichier final. La liste des parties est lue sur le serveur, vous n’envoyez donc que le jeton upload. Dès qu’il répond, le fichier est stocké et compte dans votre quota. Nécessite le scope blob:write, ou le jeton d’envoi qui a ouvert l’envoi, ainsi qu’un plan actif. Ce qui se passe en cas de refus dépend de la cause :

L’envoi reste ouvert lorsque le compte n’a pas de plan actif (PERMISSION_DENIED), dépasse son quota (STORAGE_QUOTA_EXCEEDED) ou que le stockage est indisponible (503). Corrigez la cause et appelez à nouveau Complete, sans renvoyer aucune partie.
L’envoi est annulé et ses parties sont supprimées lorsque le fichier fait moins de 512 octets (FILE_TOO_SMALL) ou dépasse sa limite (FILE_TOO_LARGE).
Rien ne change lorsqu’aucune partie n’a encore été envoyée (NO_CHUNKS_UPLOADED) ou qu’une partie autre que la dernière fait moins de 5 Mo (CHUNK_TOO_SMALL) : renvoyez cette partie et finalisez à nouveau.

Paramètres

string

requis

Le jeton upload renvoyé par Chunked Init. Il peut aussi être passé dans le paramètre de requête upload.

Limites de débit

5 requêtes par 10 secondes, afin que plusieurs envois parallèles puissent se terminer ensemble (RATE_LIMITED, 429).

Réponse

string

“success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

string

L’id du fichier stocké.

boolean

Indique si le fichier est privé.

string | null

L’URL publique, ou null pour les fichiers privés.

ISO 8601

Date à laquelle le fichier sera supprimé. Présent uniquement lorsqu’il expire.

number

La taille du fichier, en octets.

number

Le nombre de parties assemblées.

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Erreurs

Code	HTTP	Quand
`INVALID_UPLOAD_TOKEN`	400	Le jeton `upload` est absent, mal formé ou ne vous appartient pas.
`NO_CHUNKS_UPLOADED`	400	Aucune partie n’a encore été envoyée.
`CHUNK_TOO_SMALL`	400	Une partie autre que la dernière fait moins de 5 Mo.
`FILE_TOO_SMALL`	400	Le fichier fait moins de 512 octets. L’envoi est annulé.
`PERMISSION_DENIED`	401	Le compte n’a pas de plan actif. L’envoi reste ouvert.
`STORAGE_QUOTA_EXCEEDED`	403	Le fichier dépasserait le stockage inclus. L’envoi reste ouvert.
`UPLOAD_NOT_FOUND`	404	L’envoi a été terminé, annulé ou a expiré.
`FILE_TOO_LARGE`	413	Le fichier dépasse sa limite de taille. L’envoi est annulé.
`RATE_LIMITED`	429	Plus de 5 requêtes en 10 secondes.
`UPLOAD_FAILED`	500	L’assemblage a échoué. Réessayez.
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	Le stockage est temporairement indisponible. L’envoi reste ouvert.

Voir aussi

SDK Blob : blob.put() exécute tout le flux d’envoi chunked pour les fichiers de plus de 90 MiB

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

Premiers pas

Objets

Uploads par morceaux

Compte

Liens de partage

S3

Finaliser un envoi chunked

Paramètres

Limites de débit

Réponse

Erreurs

Voir aussi

​Paramètres

​Limites de débit

​Réponse

​Erreurs

​Voir aussi

Paramètres

Limites de débit

Réponse

Erreurs

Voir aussi