Todos os produtos
Search
Central de documentação

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

Última atualização: Jul 03, 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

Upload simples (Python SDK V2)

client.put_object

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

  • Suporta validação de dados CRC-64 (verificação de redundância cíclica de 64 bits). Esse recurso está ativado por padrão.

  • Suporta barras de progresso.

  • O corpo da requisição é do tipo io.Reader. Se o tipo io.Seeker for suportado, o sistema tentará retransmitir automaticamente em caso de falha no upload.

client.put_object_from_file

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

  • Obtém os dados do corpo da requisição a partir de um caminho de arquivo.

Upload por anexação (Python SDK V2)

client.append_object

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

  • Suporta validação de dados CRC-64. Esse recurso está ativado por padrão.

  • Suporta barras de progresso.

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

Operação AppendOnlyFile

AppendOnlyFile.write

AppendOnlyFile.write_from

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

  • Otimiza a tolerância a falhas durante retransmissões.

Upload multipartido (Python SDK V2)

Operações de upload multipartido

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Executa upload multipartido. 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 suporta validação CRC-64. Esse recurso está ativado por padrão.

  • A operação upload_part suporta barras de progresso.

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

Upload via formulário (Python SDK V2)

/

  • Gera informações como assinatura Post e política Post e chama o método HTTP POST para enviar um arquivo ao OSS.

Upload com URL assinada (Python SDK V2)

client.presign

  • Gera uma URL assinada para o método PUT com tempo de expiração definido. Isso permite que outros usuários enviem arquivos temporariamente.

Gerenciador de upload de arquivos (Python SDK V2)

Uploader.upload_from

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

  • Suporta validação de dados CRC-64. Esse recurso está ativado por padrão.

  • Suporta barras 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.

  • Obtém os dados do corpo da requisição a partir de um caminho de arquivo.

  • Suporta upload retomável.