ローカルファイルまたは OSS オブジェクトの MD5 または CRC-64 ハッシュを計算します。
OSS オブジェクトの場合、ossutil は HeadObject リクエストを用いてサーバーからハッシュ値を取得します。このリクエストにより、サーバー側に保存されている CRC-64 値または Content-MD5 値が返されます。サーバー側の値が利用できない場合は、ossutil がオブジェクトをダウンロードしてローカルでハッシュを計算します。--download オプションを指定すると、ハッシュ計算のためにオブジェクトをダウンロードします。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
oss:GetObject権限が付与されていること。詳細については、「RAM ユーザーへのカスタム権限の付与」をご参照ください。
構文
ossutil hash md5|crc64 source [flags]サポートされるアルゴリズム:
| アルゴリズム | 説明 |
|---|---|
md5 | ソースの MD5 ハッシュを計算します。 |
crc64 | ソースの CRC-64 チェックサムを計算します。 |
フラグ
| フラグ | 型 | 説明 |
|---|---|---|
--base64 | / | ハッシュ出力を Base64 エンコーディングで出力します。 |
-d, --dirs | / | サブディレクトリへ再帰的に移動せず、現在のディレクトリ内のオブジェクトおよびサブディレクトリのみを対象とします。 |
--download | / | ハッシュ計算前にオブジェクトをダウンロードします。 |
--encoding-type | string | オブジェクト名またはファイル名のエンコーディング方式を指定します。有効な値: url。 |
--end-with | string | 名前が辞書順で指定された値より前または等しいオブジェクトに一致させます。 |
--exclude | stringArray | パスまたはオブジェクト名に対する除外ルールを指定します。 |
--exclude-from | stringArray | 除外ルールをファイルから読み込みます。 |
--files-from | stringArray | ソースファイル名をファイルから読み込みます。空行およびコメント行は無視されます。 |
--files-from-raw | stringArray | ソースファイル名をファイルから読み込みます。 |
--filter | stringArray | パスまたはオブジェクト名に対するフィルタールールを指定します。 |
--filter-from | stringArray | フィルタールールをファイルから読み込みます。 |
-f, --force | / | 確認プロンプトを表示せずに操作を強制実行します。 |
--include | stringArray | パスまたはオブジェクト名に対する包含ルールを指定します。 |
--include-from | stringArray | 包含ルールをファイルから読み込みます。 |
--limited-num | int | 返される結果の最大数を指定します。 |
--list-objects | / | ListObjects 操作を使用してオブジェクトを一覧表示します。 |
--min-age | Duration | 指定された間隔よりも前に変更されたファイルのみを処理します。デフォルトの単位は秒です。サポートされる接尾辞: h(時間)。例: --min-age 1h では、1 時間以上前に変更されたファイルが対象になります。 |
--max-age | Duration | 指定された間隔以内に変更されたファイルのみを処理します。デフォルトの単位は秒です。例: --max-age 1h では、過去 1 時間以内に変更されたファイルが対象になります。 |
--min-mtime | Time | 指定された時刻以降に変更されたファイルのみを処理します。形式:協定世界時 (UTC)。例: 2006-01-02T15:04:05。 |
--max-mtime | Time | 指定された時刻より前に変更されたファイルのみを処理します。形式:協定世界時 (UTC)。例: 2006-01-02T15:04:05。 |
--max-size | SizeSuffix | 処理対象となる最大ファイルサイズを指定します。デフォルト単位:バイト (B)。サポートされる接尾辞:K(キビバイト)、M(メビバイト)、G(ギビバイト)、T(テビバイト)、P(ペビバイト)。 |
--metadata-exclude | stringArray | オブジェクトのメタデータに対する除外ルールを指定します。 |
--metadata-filter | stringArray | オブジェクトのメタデータに対するフィルタールールを指定します。 |
--metadata-filter-from | stringArray | メタデータフィルタールールをファイルから読み込みます。 |
--metadata-include | stringArray | オブジェクトのメタデータに対する包含ルールを指定します。 |
--min-size | SizeSuffix | 処理対象となる最小ファイルサイズを指定します。デフォルト単位:バイト (B)。サポートされる接尾辞は --max-size と同じです。 |
--page-size | int | 1 ページあたりに返される最大オブジェクト数を指定します。デフォルト値:1000。有効範囲:1~1000。 |
-r, --recursive | / | バケット内のすべての該当オブジェクトに対して操作を適用します。このオプションを指定しない場合、コマンドは指定されたオブジェクトのみに対して操作を実行します。 |
--request-payer | string | リクエスト元支払いモードが有効化されている場合に、リクエストの支払者を指定します。有効な値: requester。 |
--start-after | string | 名前が指定された値よりアルファベット順で後にあるオブジェクトを返します。 |
グローバルオプションの完全なリストについては、「コマンドラインオプション」をご参照ください。
使用例
ローカルファイルの MD5 ハッシュを計算する:
ossutil hash md5 example.txtMD5 ハッシュを計算し、出力を Base64 エンコーディングで出力する:
ossutil hash md5 example.txt --base64ローカルファイルの CRC-64 チェックサムを計算する:
ossutil hash crc64 example.txtローカルディレクトリ内のすべてのファイルについて MD5 ハッシュを計算する:
ossutil hash md5 folder/ -rローカルディレクトリ内のすべてのファイルについて MD5 ハッシュを計算し、出力を Base64 エンコーディングで出力する:
ossutil hash md5 folder/ -r --base64ローカルディレクトリ内のすべてのファイルについて CRC-64 チェックサムを計算する:
ossutil hash crc64 folder/ -rOSS オブジェクトの MD5 ハッシュを計算する:
ossutil hash md5 oss://examplebucket/example.txt