Blob Chunked Upload Complete

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

string

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Chunked Complete schließt einen mit Chunked Init geöffneten Upload ab: Die gespeicherten Teile werden zum endgültigen Objekt zusammengesetzt, das unter seiner öffentlichen URL verfügbar wird. Du sendest keine ETags und keine Teileliste, nur das upload-Token; die Teileliste wird aus dem Storage zurückgelesen, der ohnehin die Autorität darüber ist, welche Teile angekommen sind. Zwei Fehlerfälle lassen den Upload bewusst offen, damit du das Problem beheben und den PATCH wiederholen kannst, statt bis zu 1 GiB erneut hochzuladen: STORAGE_QUOTA_EXCEEDED (Speicherplatz freigeben, dann erneut versuchen) und CHUNK_TOO_SMALL (die betroffenen Teile erneut senden, dann erneut versuchen). FILE_TOO_SMALL und FILE_TOO_LARGE brechen den Upload stattdessen ab. Das Rate Limit beträgt 5 Abschlüsse pro 10 Sekunden, sodass mehrere parallele Uploads gleichzeitig fertig werden können.

string

erforderlich

Das opake upload-Token, das Chunked Init zurückgegeben hat.

{ "upload": "UPLOAD_TOKEN" }

Response

string

Gibt an, ob der Aufruf erfolgreich war. “success” bei Erfolg, “error” andernfalls.

object

Anzeigen Objekt ein-/ausblenden

string

Die ID (der Schlüssel) des gespeicherten Objekts.

number

Die Gesamtgröße des zusammengesetzten Objekts, in Bytes.

number

Aus wie vielen Teilen das Objekt zusammengesetzt wurde.

string

Die öffentliche CDN-URL des Objekts.

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

Fehlerbehebung

Uploadbezogen

// The upload token is missing, malformed, or does not belong to your account.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

// The upload has no stored chunks to assemble.
{
    "status": "error",
    "code": "NO_CHUNKS_UPLOADED"
}

// A chunk other than the last is below 5 MB. The upload stays open:
// re-send the offending parts, then retry the PATCH.
{
    "status": "error",
    "code": "CHUNK_TOO_SMALL"
}

// The assembled object is below 512 bytes. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_SMALL"
}

Nicht autorisiert

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Speicherkontingent überschritten

// The account filled up while the parts were uploading. The upload is
// LEFT OPEN: free space (or upgrade) and retry the PATCH, or abort it
// with DELETE /v1/objects/chunked.
{
    "status": "error",
    "code": "STORAGE_QUOTA_EXCEEDED"
}

Nicht gefunden

// The upload was already completed, aborted, or expired.
{
    "status": "error",
    "code": "UPLOAD_NOT_FOUND"
}

Payload zu groß

// The assembled object exceeds 1 GiB. The upload is aborted.
{
    "status": "error",
    "code": "FILE_TOO_LARGE"
}

Rate-limitiert

// Complete rate limit reached (5 requests per 10s window, blocked for 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Upload fehlgeschlagen

// Failed to assemble or register the object. If the message says to start
// a new upload, the uploadId was consumed: open a new upload and send the
// file again. Otherwise, retry the PATCH.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

Zurück

Chunked AbortDiese Dokumentation bietet einen umfassenden Überblick über den Endpoint DELETE /v1/objects/chunked der SquareCloud Blob API.

Weiter

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 }),
});

import requests

response = requests.patch(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={'upload': upload_token},
)

{
  "status": "success",
  "response": {
    "id": "3155597145698959364/myfile-ex30.fastq.gz",
    "size": 734003200,
    "parts": 22,
    "url": "https://public-blob.squarecloud.dev/3155597145698959364/myfile-ex30.fastq.gz"
  }
}

Blob-Endpunkte

Chunked-Uploads

Blob Chunked Upload Complete

Response

Fehlerbehebung

Uploadbezogen

Nicht autorisiert

Speicherkontingent überschritten

Nicht gefunden

Payload zu groß

Rate-limitiert

Upload fehlgeschlagen

​Response

​Fehlerbehebung

​Uploadbezogen

​Nicht autorisiert

​Speicherkontingent überschritten

​Nicht gefunden

​Payload zu groß

​Rate-limitiert

​Upload fehlgeschlagen

Response

Fehlerbehebung

Uploadbezogen

Nicht autorisiert

Speicherkontingent überschritten

Nicht gefunden

Payload zu groß

Rate-limitiert

Upload fehlgeschlagen