Conclusão de Upload em Partes Blob

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: SUA_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: 'SUA_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': 'SUA_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

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

Conclusão do upload sela um upload aberto com Início do upload: as partes armazenadas são montadas no objeto final, que passa a ficar disponível na sua URL pública. Você não envia ETags nem lista de partes, apenas o token upload; a lista de partes é relida do armazenamento, que já é a autoridade sobre quais partes chegaram. Dois modos de falha deixam deliberadamente o upload aberto, para você corrigir o problema e repetir o PATCH em vez de reenviar até 1 GiB: STORAGE_QUOTA_EXCEEDED (libere espaço e tente de novo) e CHUNK_TOO_SMALL (reenvie as partes problemáticas e tente de novo). FILE_TOO_SMALL e FILE_TOO_LARGE cancelam o upload. O limite é de 5 conclusões a cada 10 segundos, então vários uploads paralelos podem terminar ao mesmo tempo.

string

obrigatório

O token upload opaco retornado pelo Início do upload.

{ "upload": "UPLOAD_TOKEN" }

Resposta

string

Indica se a chamada foi bem-sucedida. “success” se bem-sucedida, “error” caso contrário.

object

Mostrar Alternar objeto

string

O ID (chave) do objeto armazenado.

number

O tamanho total do objeto montado, em bytes.

number

De quantas partes o objeto foi montado.

string

A URL pública da CDN do objeto.

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: SUA_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: 'SUA_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': 'SUA_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"
  }
}

Solução de problemas

Relacionado ao Upload

// O token de upload está ausente, malformado ou não pertence à sua conta.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

// O upload não tem chunks armazenados para montar.
{
    "status": "error",
    "code": "NO_CHUNKS_UPLOADED"
}

// Um chunk que não é o último está abaixo de 5 MB. O upload permanece aberto:
// reenvie as partes problemáticas e repita o PATCH.
{
    "status": "error",
    "code": "CHUNK_TOO_SMALL"
}

// O objeto montado tem menos de 512 bytes. O upload é cancelado.
{
    "status": "error",
    "code": "FILE_TOO_SMALL"
}

Não autorizado

// A chave de API está ausente ou é inválida. Defina uma chave válida no cabeçalho Authorization.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

Cota de armazenamento excedida

// A conta encheu enquanto as partes eram enviadas. O upload PERMANECE
// ABERTO: libere espaço (ou faça upgrade) e repita o PATCH, ou cancele
// com DELETE /v1/objects/chunked.
{
    "status": "error",
    "code": "STORAGE_QUOTA_EXCEEDED"
}

Não encontrado

// O upload já foi concluído, cancelado ou expirou.
{
    "status": "error",
    "code": "UPLOAD_NOT_FOUND"
}

Payload grande demais

// O objeto montado excede 1 GiB. O upload é cancelado.
{
    "status": "error",
    "code": "FILE_TOO_LARGE"
}

Limite de requisições

// Limite de conclusões atingido (5 requisições por janela de 10s, bloqueio de 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

Falha no upload

// Falha ao montar ou registrar o objeto. Se a mensagem disser para iniciar
// um novo upload, o uploadId foi consumido: abra um novo upload e envie o
// arquivo novamente. Caso contrário, repita o PATCH.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

Cancelar UploadEsta documentação fornece uma visão abrangente do endpoint DELETE /v1/objects/chunked da API Blob da SquareCloud.

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: SUA_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: 'SUA_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': 'SUA_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"
  }
}

Endpoints do Blob

Uploads em Partes

Conclusão de Upload em Partes Blob

Resposta

Solução de problemas

Relacionado ao Upload

Não autorizado

Cota de armazenamento excedida

Não encontrado

Payload grande demais

Limite de requisições

Falha no upload

​Resposta

​Solução de problemas

​Relacionado ao Upload

​Não autorizado

​Cota de armazenamento excedida

​Não encontrado

​Payload grande demais

​Limite de requisições

​Falha no upload

Resposta

Solução de problemas

Relacionado ao Upload

Não autorizado

Cota de armazenamento excedida

Não encontrado

Payload grande demais

Limite de requisições

Falha no upload