Todos os produtos
Search
Central de documentação

Object Storage Service:Upload de objetos com o OSS SDK for Go 2.0

Última atualização: Jul 03, 2026

O OSS SDK for Go V2 oferece diversas operações de upload. Escolha a mais adequada ao seu cenário.

Tipo

Operação

Descrição

Upload simples

Client.PutObject

  • Faz upload de um objeto de até 5 GiB.

  • Oferece suporte a CRC-64 (ativado por padrão).

  • Exibe o progresso do upload.

  • Aceita um corpo de requisição io.Reader. Se o corpo da requisição também implementar io.Seeker, o upload será repetido automaticamente em caso de falha.

Client.PutObjectFromFile

  • Oferece a mesma funcionalidade de Client.PutObject.

  • Lê o corpo da requisição de um caminho de arquivo local.

Upload por acréscimo

Client.AppendObject

  • Acrescenta dados a um objeto de até 5 GiB.

  • Oferece suporte a CRC-64 (ativado por padrão).

  • Exibe o progresso do upload.

  • Aceita um corpo de requisição io.Reader. Se o corpo da requisição também implementar io.Seeker, o upload será repetido automaticamente em caso de falha. A operação é idempotente, mas as tentativas ainda podem falhar.

Operações AppendOnlyFile

AppendOnlyFile.Write

AppendOnlyFile.WriteFrom

  • Oferece a mesma funcionalidade de Client.AppendObject.

  • Melhora a tolerância a falhas durante novas tentativas.

Upload multipart

Operações de upload multipart

Client.InitiateMultipartUpload

Client.UploadPart

Client.CompleteMultipartUpload

  • Faz upload de um objeto de até 48,8 TiB, com partes de até 5 GiB cada.

  • UploadPart oferece suporte a CRC-64 (ativado por padrão).

  • UploadPart exibe o progresso do upload.

  • Aceita um corpo de requisição io.Reader. Se o corpo da requisição também implementar io.Seeker, o upload será repetido automaticamente em caso de falha.

Upload via formulário

/

  • Gera uma assinatura e uma política de upload para enviar um objeto ao OSS por HTTP POST.

URL assinada

Client.Presign

  • Gera uma URL assinada com tempo limitado que autoriza uploads por HTTP PUT.

Uploader

Uploader.UploadFrom

  • Combina upload simples e multipart para fazer upload de um objeto de até 48,8 TiB.

  • Oferece suporte a CRC-64 (ativado por padrão).

  • Exibe o progresso do upload.

  • Aceita um corpo de requisição io.Reader. Se o corpo da requisição também implementar io.Seeker e io.ReaderAt, os dados serão transmitidos em fluxo sem cache na memória. Caso contrário, os dados serão armazenados em cache na memória antes do upload.

Uploader.UploadFile

  • Oferece a mesma funcionalidade de Uploader.UploadFrom.

  • Lê o corpo da requisição de um caminho de arquivo local.

  • Oferece suporte a upload retomável.