Object Storage Service:sync (Sincronizar objetos do OSS para um computador local)

Observações de uso

• Esta operação exige as permissões oss:GetObject e oss:ListObjects. Conceder permissões personalizadas a um usuário RAM.

• Nome do binário

  No ossutil 1.6.16 e versões posteriores, use ossutil diretamente como nome do binário na linha de comando. Não é necessário alterar o nome do binário conforme o sistema operacional. Caso utilize uma versão anterior à 1.6.16, atualize o nome do binário de acordo com seu sistema operacional. Para mais informações, consulte Referência de comandos do ossutil.

• Quantidade de objetos

  Sem a opção --delete, não há limite para a quantidade de objetos. Com a opção --delete, é possível sincronizar até 1 milhão de objetos por vez. Ultrapassar esse limite gera o erro over max sync numbers 1000000.

• Diferenças em relação ao comando cp

  • Por padrão, o comando sync percorre recursivamente todos os objetos e subdiretórios. Já o comando cp exige a opção -r para operações recursivas.

  • O comando sync aceita a opção --backup-dir para salvar arquivos exclusivos do destino em uma pasta de backup. O comando cp não oferece suporte a --backup-dir.

  • O comando sync não oferece suporte a --version-id, portanto não sincroniza versões anteriores dos objetos. O comando cp oferece suporte a --version-id.

  Os comandos sync e cp compartilham todas as demais opções. cp (Baixar arquivos).

Formato do comando

ossutil sync cloud_url  file_url
[-f --force]
[-u --update]
[--maxdownspeed <value>]
[--delete]
[--backup-dir <value>]
[--enable-symlink-dir]
[--disable-all-symlink]
[--disable-ignore-error]
[--only-current-dir]
[--output-dir <value>]
[--bigfile-threshold <value>]
[--part-size <value>]
[--checkpoint-dir <value>]
[--range <value>]
[--encoding-type <value>]
[--snapshot-path <value>]
[--include <value>]
[--exclude <value>]
[--disable-crc64]
[--payer <value>]
[-j, --job <value>]
[--parallel <value>]
[--retry-times <value>]

Parâmetros e opções:

Verificar resultados da sincronização

Verifique se todos os objetos foram transferidos corretamente:

• Verificar contagem de arquivos

  Compare a quantidade de objetos entre os diretórios do OSS e local:

  # Count files in the local directory.
  ls -1 /local/dir/ | wc -l
  
  # Count objects in the OSS directory.  
  ossutil ls oss://bucket/dir/ -r | grep "^oss://" | wc -l

• Listar objetos sincronizados

  Revise os objetos sincronizados:

  # List local files with sizes.
  ls -lh /local/dir/
  
  # Compare with the OSS directory.
  ossutil ls oss://bucket/dir/ -r

Exemplos

Os exemplos abaixo utilizam esta estrutura de arquivos. A pasta localdir no bucket do OSS contém a.txt, b.txt e o subdiretório C. A pasta local destdir contém d.txt:

examplebucket           local root directory
└── localdir/             └── destdir/
       ├── a.txt                └── d.txt
       ├── b.txt
       └── C/

• Sincronizar a pasta localdir do OSS para o computador local

  ossutil sync  oss://examplebucket/localdir/  destdir/ 

  Resultado: a.txt, b.txt e o subdiretório C são adicionados à pasta local destdir.

  examplebucket           local root directory
  └── localdir/             └── destdir/
         ├── a.txt                ├── a.txt 
         ├── b.txt                ├── b.txt
         └── C/                   ├── d.txt
                                     └── C/ 

• Sincronizar com --backup-dir: sincroniza localdir do examplebucket para a pasta local destdir e move os arquivos exclusivos do destino para a pasta backup.

  ossutil sync oss://examplebucket/localdir/  destdir/  --delete  --backup-dir backup/

  Resultado: a pasta localdir é sincronizada. Arquivos presentes em destdir mas ausentes na origem são movidos para a pasta backup. A pasta local destdir passa a conter apenas a.txt, b.txt e o subdiretório C. O arquivo original d.txt é movido para a pasta backup.

  examplebucket              local root directory
  └── localdir/               ├── destdir/
         ├── a.txt            │     ├── a.txt 
         ├── b.txt            │     ├── b.txt
         └── C/               │     └── C/                             
                                 └── backup/
                                        └──d.txt

• Saída de uma sincronização bem-sucedida:

  Succeed: Total num: 2, size: 750,081. OK num: 2(upload 2 files).
  
  average speed 1641000(byte/s)

Opções comuns

Para acessar um bucket em outra região, use -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.

ossutil sync oss://examplebucket/srcfolder/  examplefolder/ -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opções comuns.