Todos os produtos
Search
Central de documentação

Object Storage Service:upload-part

Última atualização: Sep 24, 2026

O comando upload-part faz upload de dados em partes com base no nome e no ID de upload especificados de um objeto.

Observações

  • Antes de chamar a operação UploadPart para fazer upload de dados em partes, chame a operação InitiateMultipartUpload para obter um ID de upload gerado pelo OSS.

  • Se você usar o mesmo partNumber para fazer upload de uma nova parte, a parte existente carregada com esse partNumber será substituída.

  • O OSS inclui o hash MD5 de cada parte recebida no cabeçalho ETag da resposta.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

API

Action

Description

UploadPart

oss:PutObject

Faz upload de partes.

Sintaxe

ossutil api upload-part --bucket value --key value --part-number value --upload-id value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--key

string

Caminho completo do objeto.

--body

string

Corpo da requisição, que deve conter os dados completos de uma única parte. O valor deste parâmetro não pode ser deixado em branco.

--part-number

string

Número que identifica uma parte.

--upload-id

string

ID da tarefa MultipartUpload.

Nota
  • O comando upload-part corresponde à operação de API UploadPart. Para mais informações sobre os parâmetros disponíveis, consulte UploadPart.

  • Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Command-line options.

Exemplo

O exemplo a seguir demonstra como fazer upload de dados em partes com base no nome e no ID de upload especificados de um objeto.

ossutil api upload-part --bucket examplebucket --key exampleobject --upload-id 123 --part-number 1 --body file://partFile