Todos os produtos
Search
Central de documentação

Object Storage Service:Upload de arquivos (Python SDK V2)

Última atualização: Sep 24, 2026

O OSS SDK for Python V2 oferece diversas operações para upload de arquivos. Selecione a operação mais adequada ao seu cenário.

Tipo

Nome da operação

Descrição

Simple upload (Python SDK V2)

client.put_object

  • Executa um upload simples. O tamanho máximo de um objeto é de 5 GiB.

  • Compatível com validação de dados por verificação de redundância cíclica de 64 bits (CRC-64). Este recurso está ativo por padrão.

  • Compatível com gráficos de barra de progresso.

  • O corpo da requisição é do tipo io.Reader. Quando o tipo io.Seeker é compatível, a retransmissão ocorre em caso de falha no upload.

client.put_object_from_file

  • Oferece os mesmos recursos da operação client.put_object.

  • Os dados do corpo da requisição são obtidos de um caminho de arquivo.

Append upload (Python SDK V2)

client.append_object

  • Executa um upload por anexação. O tamanho máximo do objeto final é de 5 GiB.

  • Compatível com validação de dados CRC-64. Este recurso está ativo por padrão.

  • Compatível com gráficos de barra de progresso.

  • O corpo da requisição é do tipo BodyType. A retransmissão ocorre em caso de falha no upload. Esta operação não é idempotente, portanto a retransmissão pode falhar.

AppendOnlyFile operation

AppendOnlyFile.write

AppendOnlyFile.write_from

  • Oferece os mesmos recursos da operação client.append_object.

  • Aprimora a tolerância a falhas em retransmissões malsucedidas.

Multipart upload (Python SDK V2)

Multipart upload operations

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Executa um multipart upload. O tamanho máximo de cada parte é de 5 GiB e o tamanho máximo do objeto é de 48,8 TiB.

  • A operação upload_part é compatível com validação CRC-64. Este recurso está ativo por padrão.

  • A operação upload_part é compatível com gráficos de barra de progresso.

  • O corpo da requisição para a operação upload_part é do tipo BodyType. Os tipos str, bytes, Iterable[bytes], IO[str] e IO[bytes] também são compatíveis.

Form upload (Python SDK V2)

/

  • Gera informações como assinatura Post e política Post, e usa o método HTTP POST para fazer upload de um arquivo para o OSS.

Upload using a signed URL (Python SDK V2)

client.presign

  • Gera uma URL assinada para o método PUT com prazo de expiração, permitindo que outros usuários façam upload de arquivos temporariamente.

File upload manager (Python SDK V2)

Uploader.upload_from

  • Encapsula operações de upload simples e multipart upload. O tamanho máximo de um objeto é de 48,8 TiB.

  • Compatível com validação de dados CRC-64. Este recurso está ativo por padrão.

  • Compatível com gráficos de barra de progresso.

  • O parâmetro do corpo da requisição é do tipo IO[bytes].

Uploader.upload_file

  • Oferece os mesmos recursos da operação Uploader.upload_from.

  • Os dados do corpo da requisição são obtidos de um caminho de arquivo.

  • Compatível com upload retomável.