complete-multipart-upload - Object Storage Service: Central de Documentação do Alibaba Cloud

O comando complete-multipart-upload conclui o upload multipart de um arquivo inteiro.

Notas de uso

Ao chamar a operação complete-multipart-upload, forneça uma lista de todas as partes válidas, incluindo PartNumber e ETag. Os valores de PartNumber variam de 1 a 10000 e devem estar em ordem crescente, mas não precisam ser consecutivos. O OSS verifica a validade de cada parte e garante que todas as partes, exceto a última, tenham no mínimo 100 KB. Após a verificação, o OSS combina essas partes em um objeto completo.
O OSS leva certo tempo para processar uma solicitação CompleteMultipartUpload. Caso a conexão entre o cliente e o OSS seja interrompida durante esse período, o OSS continua a processar a solicitação.
Um mesmo objeto pode ter vários UploadIds simultaneamente. Após a conclusão de um UploadId, ele se torna inválido, mas os outros UploadIds do objeto não são afetados.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM em uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

API	Ação	Descrição
CompleteMultipartUpload	`oss:PutObject`	Combina partes em um objeto.
CompleteMultipartUpload	`oss:PutObjectTagging`	Ao combinar partes em um objeto, caso você especifique tags de objeto por meio de x-oss-tagging, essa permissão é obrigatória.

Sintaxe do comando

ossutil api complete-multipart-upload --bucket value --key value --upload-id value --complete-multipart-upload value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket de destino.
--complete-all	string	Especifica se todas as partes enviadas para o UploadId atual devem ser listadas.
--complete-multipart-upload	string	O contêiner que armazena o conteúdo da solicitação CompleteMultipartUpload.
--encoding-type	string	O tipo de codificação para o conteúdo retornado.
--forbid-overwrite	string	Especifica se um objeto existente com o mesmo nome será sobrescrito durante a operação CompleteMultipartUpload.
--key	string	O caminho completo do objeto.
--upload-id	string	O ID do evento de upload multipart.

Nota

O comando complete-multipart-upload corresponde à operação de API CompleteMultipartUpload. Para obter mais informações sobre os parâmetros da API, consulte CompleteMultipartUpload.

--complete-multipart-upload

A opção --complete-multipart-upload aceita as sintaxes XML e JSON. Quando o valor da opção contém o prefixo file://, o sistema lê a configuração a partir de um arquivo.

Sintaxe XML:

<CompleteMultipartUpload>
  <Part>
    <PartNumber>integer</PartNumber>
    <ETag>string</ETag>
  </Part>
  ...
</CompleteMultipartUpload>

Sintaxe JSON:

{
  "Part": [
    {
      "PartNumber": integer,
      "ETag": "string"
    },
    ...
  ]
}

Nota

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

Exemplos

Os exemplos a seguir mostram como concluir um upload multipart do objeto exampleobject com o ID de upload 123 no bucket examplebucket.

Use um arquivo de configuração XML. O conteúdo de complete-multipart-upload.xml é o seguinte:

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUpload>
  <Part>
    <PartNumber>1</PartNumber>
    <ETag>"C884BAB4F7A89D38A194568C7DE****"</ETag>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <ETag>"C884BAB4F7A89D38A194568C7DEA****"</ETag>
  </Part>
</CompleteMultipartUpload>

Comando de exemplo:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.xml

Use um arquivo de configuração JSON. O conteúdo de complete-multipart-upload.json é o seguinte:

{
  "Part": [
    {
      "PartNumber": "1",
      "ETag": "\"C884BAB4F7A89D38A194568C7DE****\""
    },
    {
      "PartNumber": "2",
      "ETag": "\"C884BAB4F7A89D38A194568C7DEA****\""
    }
  ]
}

Comando de exemplo:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

Use parâmetros de configuração JSON. Comando de exemplo:

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json=》ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload "{\"Part\":[{\"PartNumber\":\"1\",\"ETag\":\"\\\"C884BAB4F7A89D38A194568C7DE****\\\"\"},{\"PartNumber\":\"2\",\"ETag\":\"\\\"C884BAB4F7A89D38A194568C7DEA****\\\"\"}]}"

O exemplo a seguir mostra como listar todas as partes enviadas para o ID de upload 123 no bucket examplebucket.

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-all yes