How do I use the appendfromfile command? - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Para fazer um upload por adição, você precisa das permissões oss:GetObject e oss:PutObject. Para mais informações, consulte Conceder uma política personalizada.
No ossutil 1.6.16 e versões posteriores, use diretamente ossutil como nome do binário na linha de comando. Não é necessário alterar o nome do binário conforme o sistema operacional. Em versões anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte Guia de início rápido da ferramenta de linha de comando ossutil.

Para mais detalhes sobre uploads por adição, consulte Upload por adição.

Sintaxe do comando

ossutil appendfromfile localfilename oss://bucketname/objectname
[--meta <value>]

A tabela a seguir descreve os parâmetros e opções mencionados anteriormente.

Parâmetro/Opção	Descrição
localfilename	Caminho completo do arquivo local a ser enviado.
bucketname	Nome do bucket que armazena o objeto ao qual você deseja adicionar conteúdo.
objectname	Nome do objeto que receberá o conteúdo adicionado. Ao executar o comando appendfromfile para um upload por adição, mantenha o nome original do arquivo local para o objeto ou especifique outro nome.
--meta	Metadados do objeto. Configure este parâmetro apenas na primeira execução do comando appendfromfile para enviar um objeto. Exemplo: `--meta "x-oss-object-acl:private"`. Após configurar os metadados do objeto, execute o comando set-meta (Gerenciar metadados de objetos) para modificá-los.

Exemplos

Nos exemplos a seguir, o comando appendfromfile envia primeiro um arquivo local chamado exampleobject.txt, localizado no diretório raiz, para o bucket examplebucket e o armazena como o objeto exampleobject.txt. Em seguida, o mesmo comando adiciona conteúdo a esse objeto.

Execute o seguinte comando para enviar exampleobject.txt e definir a lista de controle de acesso (ACL) do objeto enviado como privada:
```
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"
```
A saída de exemplo abaixo indica que o arquivo local foi enviado ao bucket e armazenado como o objeto exampleobject.txt. O tamanho desse objeto é de 5 bytes.
```
total append 5(100.00%) byte,speed is 0.00(KB/s)
local file size is 5,the object new size is 5,average speed is 0.04(KB/s)
```
Execute o comando a seguir para adicionar o conteúdo de um arquivo chamado dest.txt ao objeto exampleobject.txt.

Para adicionar mais conteúdo a exampleobject.txt, substitua dest.txt pelo nome do arquivo cujo conteúdo será anexado:
```
ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txt
```
A saída de exemplo abaixo mostra que o conteúdo foi adicionado a exampleobject.txt e que o tamanho do objeto após a operação de upload por adição é de 150 bytes.
```
total append 150(100.00%) byte,speed is 0.00(KB/s)
local file size is 150,the object new size is 150,average speed is 1.19(KB/s)
```

Opções comuns

Para acessar um bucket em outra região, utilize -e para especificar o endpoint. Para acessar um bucket pertencente a outra conta Alibaba Cloud, use -i para o AccessKey ID e -k para o AccessKey secret.

Por exemplo, execute o comando abaixo para enviar o arquivo exampleobject.txt via upload por adição ao bucket examplebucket, localizado na região China (Shanghai) e pertencente a outra conta Alibaba Cloud:

ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opções comuns.