Baixar e instalar a ferramenta de linha de comando ossutil - Object Storage Service: Central de Documentação do Alibaba Cloud

O ossutil é uma ferramenta de linha de comando que permite fazer upload rápido de arquivos grandes, baixar arquivos e excluir arquivos com um prefixo específico. O ossutil é executado em sistemas operacionais como Windows, Linux e macOS. Baixe e instale a versão adequada ao seu ambiente.

Nova versão disponível

Recomendamos o uso da versão atualizada ossutil 2.0. Para obter mais informações sobre como instalá-la e usá-la rapidamente, consulte Instale o ossutil. O ossutil 1.0 não recebe mais atualizações. Novos recursos e otimizações estão disponíveis apenas no ossutil 2.0.

Principais recursos do ossutil 2.0:

Nova estrutura de comandos: oferece suporte a comandos multinível, incluindo comandos no nível de api, como ossutil api put-bucket-acl, e comandos de alto nível, como ossutil config.
Gerenciamento de configuração aprimorado: o processo inicial de configuração foi simplificado. Após a instalação, basta fornecer o AccessKey id, o AccessKey secret e o id da região para concluir a configuração básica. Também é possível usar o parâmetro --profile para especificar vários arquivos de configuração, oferecendo maior flexibilidade.
Mais parâmetros de filtro: para comandos de processamento em lote, como ls, cp e rm, há suporte a diversas condições de filtro baseadas em caminho, tamanho do arquivo, hora de modificação e metadados do objeto. Esse recurso aumenta significativamente a precisão e a eficiência das operações.
Formatos de saída flexíveis: o parâmetro --output-format permite definir o formato de saída como JSON, YAML ou XML para atender a diferentes requisitos de processamento de dados. A opção --output-query possibilita filtrar a saída para recuperar as informações necessárias.
Segurança reforçada: para melhorar a segurança, o ossutil 2.0 permite definir parâmetros sensíveis por meio de variáveis de ambiente. Isso evita a exposição de chaves na linha de comando e reduz o risco de vazamento de dados. Além disso, a opção --dry-run permite verificar o comportamento de um comando antes da execução, ajudando a prevenir operações não intencionais.

Versões

Versão atual: 1.7.19
Versões anteriores: para obter mais informações sobre o código-fonte e o histórico de versões anteriores do ossutil, consulte GitHub.

Links para download

Link para download	Checksum SHA-256
Linux x86 32 bits	f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86
Linux x86 64 bits	dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343
Linux ARM 32 bits	ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d
Linux ARM 64 bits	f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57
macOS 64 bits	9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe
macOS ARM 64 bits	10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5
Windows x86 32 bits	772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799
Windows x86 64 bits	8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

Baixar e instalar o ossutil

Linux

Instale o ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Nota
- É necessário descompactar o pacote do ossutil antes da instalação. Certifique-se de ter uma ferramenta de descompactação, como unzip ou 7z, instalada.
- Por padrão, o ossutil é instalado no diretório /usr/bin/.

Configure o ossutil.

Execute o comando de configuração.
```
ossutil config
```
Quando solicitado, configure o caminho do arquivo de configuração.
```
Please enter the config file name. The file name can include a path. (Default: /home/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Por padrão, o ossutil salva o arquivo de configuração em /home/user/.ossutilconfig. Se você especificar um caminho diferente para o arquivo de configuração, será necessário adicionar a opção -c para indicar o arquivo sempre que executar um comando do ossutil. Por exemplo, se salvar o arquivo de configuração em /home/config, execute o comando ls no seguinte formato, incluindo a opção -c:
```
ossutil ls oss://examplebucket -c /home/config
```
Quando solicitado, defina o idioma da ferramenta. Insira CH para chinês ou EN para inglês. Por padrão, a ferramenta utiliza o idioma do seu sistema operacional. Essa configuração entra em vigor após a execução bem-sucedida do comando config.
Defina o idioma da ferramenta.

Insira CH ou EN. Por padrão, a ferramenta utiliza o mesmo idioma do seu sistema operacional. Essa configuração entra em vigor após a execução do comando config.

Quando solicitado, defina os parâmetros Endpoint, AccessKey id, AccessKey secret e STSToken. O parâmetro STSToken é necessário apenas quando você usa credenciais temporárias do Security Token Service (STS) para acessar o OSS. Caso contrário, deixe esse parâmetro vazio.

Os parâmetros são descritos da seguinte forma:

Parâmetro	Obrigatório	Descrição
endpoint	Sim	Insira o endpoint da região onde seu bucket está localizado. Por exemplo, defina o endpoint público como para a região ou `https://oss-ap-southeast-1.aliyuncs.com` para a região de Singapore. Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno, como ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obter mais informações sobre os endpoints de cada região, consulte Regions and endpoints. Importante Devido a uma alteração de política para melhorar a conformidade e a segurança, a partir de 20 de março de 2025, novos usuários do OSS devem use a custom domain name (CNAME) para realizar operações de api de dados em buckets do OSS localizados em regiões da China continental. Os endpoints públicos padrão são restritos para essas operações. Consulte o anúncio oficial para obter uma lista completa das operações afetadas. Se você acessar seus dados via https, deverá bind a valid SSL Certificate ao seu domínio personalizado. Isso é obrigatório para acesso ao OSS Console, pois o console impõe o uso de https.
accessKeyID	Sim	Insira o par de AccessKeys da sua conta. Para obter mais informações sobre como obter um par de AccessKeys, consulte Crie um par de AccessKey. Criar rapidamente um par de AccessKeys para um usuário RAM com permissões de gerenciamento do OSS usando um script ROS Na página Create Stack do console do Resource Orchestration Service (ROS), marque a caixa de seleção de confirmação na seção Security Confirmation e clique em Create. Para obter mais informações, consulte Create a stack. Após a criação da stack, copie o par de AccessKeys criado na aba Outputs. A lista de saída contém dois itens: AccessKeySecret e AccessKeyId. Copie seus respectivos valores.
accessKeySecret	Sim
stsToken	Não	Este parâmetro é necessário apenas quando você usa credenciais de acesso temporárias para acessar o OSS. Caso contrário, deixe-o vazio. Para obter mais informações sobre como gerar um token STS, consulte AssumeRole.

Verifique se o ossutil foi instalado corretamente.
```
ossutil
```
Se uma lista de comandos suportados pelo ossutil for exibida, a instalação foi concluída com êxito.

Windows

Instale o ossutil.
1. Clique no link de download para baixar o pacote de instalação para Windows.
2. Descompacte o pacote e clique duas vezes no arquivo ossutil.bat.

Configure o ossutil.

Execute o comando de configuração.
```
ossutil config
```
Quando solicitado, defina o caminho do arquivo de configuração.
```
Please enter the config file name. The file name can include a path. (Default: C:\\Users\user\.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Por padrão, o ossutil salva o arquivo de configuração em C:\\Users\user\.ossutilconfig. Se você especificar um caminho diferente para o arquivo de configuração, será necessário adicionar a opção -c para indicar o arquivo sempre que executar um comando. Por exemplo, se o arquivo de configuração estiver salvo em c:\ossutil\config, execute o comando ls no seguinte formato:
```
ossutil ls oss://examplebucket -c c:\ossutil\config
```
Quando solicitado, defina o idioma da ferramenta. Insira CH para chinês ou EN para inglês. Por padrão, a ferramenta utiliza o idioma do seu sistema operacional. Essa configuração entra em vigor após a execução do comando config.

Quando solicitado, defina os parâmetros Endpoint, AccessKey id, AccessKey secret e STSToken. O parâmetro STSToken é necessário apenas quando você usa credenciais temporárias do STS para acessar o OSS. Caso contrário, deixe esse parâmetro vazio.

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
endpoint	Sim	Insira o endpoint da região onde seu bucket está localizado. Por exemplo, defina o endpoint público como para a região ou `https://oss-ap-southeast-1.aliyuncs.com` para a região de Singapore. Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno, como ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obter mais informações sobre os endpoints de cada região, consulte Regions and endpoints. Importante Devido a uma alteração de política para melhorar a conformidade e a segurança, a partir de 20 de março de 2025, novos usuários do OSS devem use a custom domain name (CNAME) para realizar operações de api de dados em buckets do OSS localizados em regiões da China continental. Os endpoints públicos padrão são restritos para essas operações. Consulte o anúncio oficial para obter uma lista completa das operações afetadas. Se você acessar seus dados via https, deverá bind a valid SSL Certificate ao seu domínio personalizado. Isso é obrigatório para acesso ao OSS Console, pois o console impõe o uso de https.
accessKeyID	Sim	Insira o par de AccessKeys da sua conta. Para obter mais informações sobre como obter um par de AccessKeys, consulte Crie um par de AccessKey. Criar rapidamente um par de AccessKeys para um usuário RAM com permissões de gerenciamento do OSS usando um script ROS Na página Create Stack do console do Resource Orchestration Service (ROS), marque a caixa de seleção de confirmação na seção Security Confirmation e clique em Create. Para obter mais informações, consulte Create a stack. Após a criação da stack, copie o par de AccessKeys criado na aba Outputs. As palavras-chave de saída incluem AccessKeyId e AccessKeySecret. Copie seus respectivos valores e guarde-os em segurança.
accessKeySecret	Sim
stsToken	Não	Este parâmetro é necessário apenas quando você usa credenciais de acesso temporárias para acessar o OSS. Caso contrário, deixe-o vazio. Para obter mais informações sobre como gerar um token STS, consulte AssumeRole.

Verifique se o ossutil foi instalado corretamente.
```
ossutil
```
Se uma lista de comandos suportados pelo ossutil for exibida, a instalação foi concluída com êxito.

macOS

Instale o ossutil.
```
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
```
Nota
O diretório de instalação padrão é /usr/local/bin.

Configure o ossutil.

Execute o comando de configuração.
```
ossutil config
```
Quando solicitado, defina o caminho do arquivo de configuração.
```
Please enter the config file name. The file name can include a path. (Default: /Users/user/.ossutilconfig. Press Enter to use the default path.
If you set the path to another file, you must specify the --config-file option to the file when you use other commands): 
```
Por padrão, o ossutil salva o arquivo de configuração em /Users/user/.ossutilconfig.

Se você especificar um caminho diferente para o arquivo de configuração, será necessário adicionar a opção -c para indicar o arquivo sempre que executar um comando. Por exemplo, se o arquivo de configuração estiver salvo em /home/config, execute o comando ls no seguinte formato:
```
ossutil ls oss://examplebucket -c /home/config
```
Quando solicitado, defina o idioma da ferramenta. Insira CH para chinês ou EN para inglês. Por padrão, a ferramenta utiliza o idioma do seu sistema operacional. Essa configuração entra em vigor após a execução do comando config.

Quando solicitado, defina os parâmetros Endpoint, AccessKey id, AccessKey secret e STSToken. O parâmetro STSToken é necessário apenas quando você usa credenciais temporárias do STS para acessar o OSS. Caso contrário, deixe esse parâmetro vazio.

A tabela a seguir descreve os parâmetros.

Parâmetro	Obrigatório	Descrição
endpoint	Sim	Insira o endpoint da região onde seu bucket está localizado. Por exemplo, defina o endpoint público como para a região ou `https://oss-ap-southeast-1.aliyuncs.com` para a região de Singapore. Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno, como ou `https://oss-ap-southeast-1-internal.aliyuncs.com`. Para obter mais informações sobre os endpoints de cada região, consulte Regions and endpoints. Importante Devido a uma alteração de política para melhorar a conformidade e a segurança, a partir de 20 de março de 2025, novos usuários do OSS devem use a custom domain name (CNAME) para realizar operações de api de dados em buckets do OSS localizados em regiões da China continental. Os endpoints públicos padrão são restritos para essas operações. Consulte o anúncio oficial para obter uma lista completa das operações afetadas. Se você acessar seus dados via https, deverá bind a valid SSL Certificate ao seu domínio personalizado. Isso é obrigatório para acesso ao OSS Console, pois o console impõe o uso de https.
accessKeyID	Sim	Insira o par de AccessKeys da sua conta. Para obter mais informações sobre como obter um par de AccessKeys, consulte Crie um par de AccessKey. Criar rapidamente um par de AccessKeys para um usuário RAM com permissões de gerenciamento do OSS usando um script ROS Na página Create Stack do console do Resource Orchestration Service (ROS), marque a caixa de seleção de confirmação na seção Security Confirmation e clique em Create. Para obter mais informações, consulte Create a stack. Após a criação da stack, copie o par de AccessKeys criado na aba Outputs. As palavras-chave de saída incluem AccessKeyId e AccessKeySecret. Copie seus respectivos valores e guarde-os em segurança.
accessKeySecret	Sim
stsToken	Não	Este parâmetro é necessário apenas quando você usa credenciais de acesso temporárias para acessar o OSS. Caso contrário, deixe-o vazio. Para obter mais informações sobre como gerar um token STS, consulte AssumeRole.

Verifique se o ossutil foi instalado corretamente.
```
ossutil
```
Se uma lista de comandos suportados pelo ossutil for exibida, a instalação foi concluída com êxito.

Referências

Após instalar o ossutil, você pode usá-lo para fazer upload, download, cópia e exclusão de objetos. Para obter mais informações, consulte cp (upload objects), cp (download objects), cp (copy objects) e rm (exclua objetos).