O comando hash calcula o MD5 ou CRC64 de arquivos.
Considerações
Para obter o valor de hash, você precisa da permissão
oss:GetObject. Para mais detalhes, consulte Conceder uma política personalizada.Para objetos, o sistema prioriza por padrão os valores calculados no servidor e obtém o CRC64 ou contentmd5 via requisição headobject. Se esses valores não existirem, o cálculo ocorre durante o baixe.
Formato do comando
ossutil hash md5|crc64 source [flags]
Parâmetro | Tipo | Descrição |
--base64 | / | Exibe o resultado com codificação Base64. |
-d, --dirs | / | Retorna arquivos e subdiretórios do diretório atual, sem listar recursivamente todos os arquivos dos subdiretórios. |
--download | / | Baixa o objeto para calcular o hash. |
--encoding-type | string | Tipo de codificação do nome do objeto ou arquivo de entrada. Valor válido: url. |
--end-with | string | Retorna objetos anteriores ou iguais ao valor definido, em ordem alfabética. |
--exclude | stringArray | Regras de exclusão para caminhos ou nomes de arquivos. |
--exclude-from | stringArray | Lê as regras de exclusão de um arquivo de regras. |
--files-from | stringArray | Lê a lista de nomes de arquivos de origem de um arquivo, ignorando linhas vazias ou comentários. |
--files-from-raw | stringArray | Lê a lista de nomes de arquivos de origem diretamente de um arquivo. |
--filter | stringArray | Regras de filtro para caminhos ou nomes de arquivos. |
--filter-from | stringArray | Lê as regras de filtro de um arquivo de regras. |
-f, --force | / | Força a operação sem solicitar confirmação. |
--include | stringArray | Regras de inclusão para caminhos ou nomes de arquivos. |
--include-from | stringArray | Lê as regras de inclusão de um arquivo de regras. |
--limited-num | int | Número máximo de resultados a retornar. |
--list-objects | / | Usa a API ListObjects para listar objetos. |
--min-age | Duration | Processa apenas arquivos modificados antes do intervalo de tempo especificado. A unidade padrão é segundos, mas aceita sufixos de unidade. Por exemplo, 1h representa uma hora. Nota
|
--max-age | Duration | Copia apenas arquivos modificados dentro do intervalo de tempo especificado. A unidade padrão é segundos, aceitando sufixos como 1h para uma hora. Nota
|
--min-mtime | Time | Processa apenas arquivos modificados após a data e hora especificadas, no formato UTC. Exemplo: 2006-01-02T15:04:05. Nota
|
--max-mtime | Time | Limita o processamento a arquivos modificados antes da data e hora indicadas, em formato UTC, como 2006-01-02T15:04:05. |
--max-size | SizeSuffix | Define o tamanho máximo de arquivo para transferência, em bytes ou com sufixos B|K|M|G|T|P, onde 1K(KiB)=1024B. |
--metadata-exclude | stringArray | Regras para excluir metadados de objetos. |
--metadata-filter | stringArray | Regras para filtrar metadados de objetos. |
--metadata-filter-from | stringArray | Carrega regras de filtro de metadados de um arquivo. |
--metadata-include | stringArray | Regras para incluir metadados de objetos. |
--min-size | SizeSuffix | Especifica o tamanho mínimo de arquivo para transferência, em bytes ou usando sufixos B|K|M|G|T|P, sendo 1K(KiB)=1024B. |
--page-size | int | Quantidade máxima de objetos listados por página em operações em lote (padrão 1000), variando de 1 a 1000. |
-r, --recursive | / | Executa a operação recursivamente. Com esta opção, o comando atua sobre todos os objetos elegíveis no bucket; caso contrário, afeta apenas o objeto no caminho especificado. |
--request-payer | string | Define o pagador da requisição. Configure este valor se o modo de pagamento pelo solicitante estiver ativo. Valor válido: requester. |
--start-after | string | Lista objetos posteriores ao valor definido, em ordem alfabética, excluindo o próprio valor. |
Para mais informações, consulte Opções de linha de comando.
Exemplos de uso
-
Calcule o hash do arquivo local example.txt.
ossutil hash md5 example.txt -
Calcule o hash do arquivo local example.txt e codifique o resultado em Base64.
ossutil hash md5 example.txt --base64 -
Obtenha o valor de verificação CRC64 do arquivo local example.txt.
ossutil hash crc64 example.txt -
Calcule o hash de todos os arquivos no diretório local folder.
ossutil hash md5 folder/ -r -
Calcule o hash de todos os arquivos no diretório local folder e codifique o resultado em Base64.
ossutil hash md5 folder/ -r --base64 -
Obtenha o valor de verificação CRC64 de todos os arquivos no diretório local folder.
ossutil hash crc64 folder/ -r -
Calcule o hash do objeto example.txt armazenado no bucket examplebucket.
ossutil hash md5 oss://examplebucket/example.txt