Object Storage Service:オプションの表示, オプションの表示

オプション

説明

-s, -- short-format

アイテムを短い形式で表示します。 このオプションを指定しない場合、長い形式が使用されます。

-- bigfile-threshold

再開可能アップロードを使用するためのオブジェクトサイズのしきい値。 デフォルト値: 104857600 (100 MB) 。 有効な値: 0 ~ 9223372036854775807 単位：バイト

-- acl

アクセス制御リスト (ACL) 。

-- 範囲

ダウンロードするオブジェクトのバイト範囲。 バイトは0から始まる番号が付けられます。

• 範囲を指定できます。 たとえば、3-9は、バイト3 (両端を含む) からバイト9 (両端を含む) までの範囲を指定します。

• ダウンロードを開始するフィールドを指定できます。 たとえば、3- は、バイト3 (両端を含む) からオブジェクトの末尾 (両端を含む) までの範囲を指定します。

• ダウンロードが終了するフィールドを指定できます。 たとえば、-9は、バイト0 (両端を含む) からバイト9 (両端を含む) までの範囲を指定します。

-すべてのバージョン

オブジェクトのすべてのバージョンを指定します。

-- type

データ検証に使用されるアルゴリズム。 有効な値：

• crc64 (デフォルト)

• md5

-v, -- version

ossutilのバージョンを表示します。

-u, -- update

更新操作を指定します。

-- 起源

HTTPリクエストのOriginヘッダーの値。

-- upmode

probeコマンドで使用されるアップロード方法。 有効な値：

• normal (デフォルト): オブジェクトはシンプルアップロードを使用してアップロードされます。

• append: オブジェクトは、追加アップロードを使用してアップロードされます。

• multipart: オブジェクトはマルチパートアップロードを使用してアップロードされます。

-- sseアルゴリズム

バケットの暗号化方法。 有効な値：

• KMS: Key Management Service (KMS) によって管理されるキーは、暗号化と復号化 (SSE-KMS) に使用されます。

• AES256: OSSが管理するキーは、暗号化と復号化 (SSE-OSS) に使用されます。

-含める

指定された条件を満たすオブジェクトを一覧表示します。 たとえば、*.jpgの値は、バケット内のすべてのJPGオブジェクトが一覧表示されることを指定します。

詳細については、「オプション -- includeおよび -- exclude」をご参照ください。

-除外

指定された条件を満たさないオブジェクトを一覧表示します。 たとえば、*.txtの値は、バケット内のすべてのTXTオブジェクトがリストされていないことを指定します。

詳細については、「オプション -- includeおよび -- exclude」をご参照ください。

-r, -- recursive

再帰操作を指定します。 このオプションを設定すると、バケット内のすべての条件が一致したオブジェクトに対して操作が実行されます。 このオプションを設定しない場合、操作はURLで指定されたオブジェクトに対してのみ実行されます。

-- addr

接続を確認するネットワークのアドレス。 ossutilはpingコマンドを実行して、ローカルコンピューターと指定されたアドレス間のネットワーク接続を確認します。

デフォルト値: www.aliyun.com

-- kms-masterkey-id

KMSで暗号化に使用する顧客マスターキー (CMK) ID。

-- version-id

オブジェクトのバージョンID。

-- version-id-marker

リスト操作の開始位置。 IDがmarkerの値の後にアルファベット順になっているオブジェクトバージョンが一覧表示されます。 このオプションは、バケットのバージョン管理が有効になっている場合にのみ設定できます。

-m, -- multipart

バケット内の不完全なマルチパートアップロードタスクに対して操作を実行することを指定します。

-d, -- directory

現在のディレクトリ内のオブジェクトとサブディレクトリのみが返されるように指定します。

-- 支払人

リクエストの支払人。 このオプションをrequesterに設定すると、pay-by-requesterモードが有効になります。

-- maxupspeed

最大アップロード速度。 デフォルト値: 0 (無制限) 。 単位: KB/s。

-- maxdownspeed

最大ダウンロード速度。 デフォルト値: 0 (無制限) 。 単位: KB/s。

-- retry-times

コマンドの実行時にエラーが発生した後のリトライ回数。 デフォルト値は 10 です。 有効な値: 1 ~ 500

-- ダウンロード

ossutilが、オブジェクトのURLを使用してバケットからオブジェクトをダウンロードすることにより、ローカルコンピューターとバケット間のネットワーク接続をチェックすることを指定します。

-j, -- jobs

複数のオブジェクトで実行できる同時タスクの数。 有効な値: 1 ~ 10000 デフォルト値: 3。

-a, -- all-type

バケット内のオブジェクトおよび不完全なマルチパートアップロードタスクに対して操作を実行することを指定します。

-- disable-empty-referer

Refererフィールドを空にできないことを指定します。

-- メソッド

HTTP リクエストの方式。 有効な値: PUT、GET、およびDELETE。

-- output-dir

出力オブジェクトが配置されているディレクトリを指定します。 出力オブジェクトには、cpコマンドを実行して複数のオブジェクトを同時にコピーするときに発生するエラーによって生成されるレポートオブジェクトが含まれます。

デフォルトでは、出力オブジェクトのディレクトリは現在のディレクトリのossutil_outputです。

-メタ

オブジェクトのメタデータを [header:value#header:value...] 形式で指定します。 例: Cache-Control:no-cache#Content-Encoding:gzip

-- object

probeコマンドのオブジェクト名。

-終了時間

LinuxまたはUNIXのタイムスタンプ。 最後に変更された時刻がタイムスタンプより後のオブジェクトは無視されます。

-- 限られたnum

返される結果の最大数。

-L、-- language

ossutilが使用する言語。 デフォルト値: CH。 有効な値：

• CH: 中国語。 このオプションをCHに設定する場合は、システムがUTF-8エンコードをサポートしていることを確認してください。

• EN: 英語。

-- 削除

バケット、オブジェクト、またはパーツを削除します。

-b, -- bucket

コマンドを実行してバケットを削除することを指定します。 このオプションは、バケットを削除する場合にのみ適用されます。

-- disable-crc64

データ送信のCRC-64を無効にします。 デフォルトでは、ossutilを使用してデータを転送するときにCRC-64が有効になります。

-- upload

ローカルファイルをバケットにアップロードして、ローカルコンピューターとバケット間のネットワーク接続を確認します。

-- 部分サイズ

部品サイズ (バイト単位) 。 デフォルトでは、ossutilはオブジェクトサイズに基づいて適切な部品サイズを計算します。 このオプションを設定して、パフォーマンスを最適化したり、特別な要件を満たしたりできます。 有効な値: 1 ~ 9223372036854775807

-- timeout

署名付きURLのタイムアウト期間。 有効な値: 0 ~ 9223372036854775807 デフォルト値: 60。 単位は秒です。

-- checkpoint-dir

再開可能なアップロード、ダウンロード、またはコピータスクのチェックポイント情報が格納されるディレクトリ。 タスクが失敗すると、ossutilは自動的にという名前のディレクトリを作成します。. ossutil_checkpointディレクトリにチェックポイント情報を保存します。 タスクが成功すると、ossutilはディレクトリを削除します。 チェックポイントディレクトリを指定する場合は、ディレクトリを削除できることを確認してください。

-- url

オブジェクトURL。

-- マーカー

リスト操作の開始位置。 バケット、オブジェクト、または部品の名前がマーカーの後にアルファベット順に表示されます。

-f, -- force

確認のプロンプトなしで操作を強制的に実行するように指定します。

-- snapshot-path

アップロードされたオブジェクトとダウンロードされたオブジェクトのスナップショットを保存するディレクトリ。 このオプションを設定すると、ossutilは指定されたディレクトリからスナップショット情報を読み取り、オブジェクトがアップロードまたはダウンロードされたときに増分アップロードまたはダウンロードを実行します。

• -- snapshot-pathオプションは、複数のオブジェクトの増分アップロードまたはダウンロードを高速化するために使用します。 このオプションは、オブジェクトのコピーには使用できません。 このオプションは、多数のオブジェクトがアップロードされ、2つのアップロードの間に他のユーザーがOSSでオブジェクトを変更しない場合に使用できます。

• -- snapshot-pathオプションは、ローカルコンピューターでアップロードまたはダウンロードされたオブジェクトの最終変更時刻を記録します。 次に、記録された時間を使用して、次にオブジェクトがアップロードまたはダウンロードされるときにどのオブジェクトをスキップできるかを決定する。 したがって、このオプションを使用する場合は、2つのアップロードまたはダウンロードの間でOSSの関連オブジェクトが変更されないようにしてください。 2つのアップロードまたはダウンロードの間にオブジェクトがOSSで更新される他のシナリオでは、-- updateオプションを使用して増分アップロードを実行するか、複数のオブジェクトを同時にダウンロードします。

• ossutilは、snapshot-pathで指定したディレクトリからスナップショット情報を自動的に削除しません。 使用しなくなったスナップショット情報を削除できます。

• スナップショット情報を読み書きするには、追加のオーバーヘッドが必要です。 アップロードまたはダウンロードするオブジェクトの数が少ない場合、ネットワークの状態が良好である場合、または他のユーザーがオブジェクトに対して操作を実行する必要がある場合は、このオプションを使用しないことをお勧めします。 これらのシナリオでは、-- updateオプションを使用して増分アップロードまたはダウンロードを実行できます。

• コマンドで -- updateオプションと -- snapshot-pathオプションの両方を設定できます。 ossutilは、-- snapshot-pathオプションで指定したディレクトリに保存されているスナップショットに基づいて、アップロードタスクまたはダウンロードタスクのオブジェクトをスキップするかどうかを決定します。 オブジェクトのスナップショットが生成されない場合、ossutilは -- updateオプションに基づいてオブジェクトをスキップするかどうかを決定します。

-- 開始時間

LinuxまたはUNIXのタイムスタンプを指定します。 このオプションを設定すると、最終変更時刻がタイムスタンプより前のオブジェクトは無視されます。

-- ストレージクラス

オブジェクトのストレージクラス。 有効な値：

• 標準 (デフォルト): このストレージクラスは、頻繁にアクセスされるオブジェクトに適しています。

• IA: このストレージクラスは、月に1回または2回アクセスされるデータなど、アクセス頻度の低いデータに適しています。 低頻度アクセス (IA) オブジェクトの最小保存期間は30日、最小課金サイズは64 KBです。 IAオブジェクトにリアルタイムでアクセスできます。 IAオブジェクトにアクセスすると、データ取得料金が発生します。

• アーカイブ: このストレージクラスは、長期間保存する必要があるデータに適しています。 アーカイブオブジェクトの最小保存期間は60日、最小課金サイズは64 KBです。 オブジェクトにアクセスする前に、アーカイブオブジェクトを復元する必要があります。 修復には約1分かかります。 アーカイブオブジェクトを復元すると、データ取得料金が発生します。

• ColdArchive: このストレージクラスは、ほとんどアクセスされないデータの長期保存に適しています。 Cold Archiveオブジェクトの最小保存期間は180日、最小課金サイズは64 KBです。 オブジェクトにアクセスする前に、Cold Archiveオブジェクトを復元する必要があります。 Cold Archiveオブジェクトの復元に必要な時間は、オブジェクトのサイズと復元モードによって異なります。 Cold Archiveオブジェクトを復元すると、データ取得料金が発生します。

-t, -- sts-token

OSSへのアクセスに使用されるSTSトークンを指定します。 このオプションは、STSを使用してOSSへの一時アクセスを許可する場合にのみ必要です。 このオプションの値は、構成ファイルの構成を上書きします。 STSトークンを生成する方法の詳細については、「許可されたサードパーティのアップロード」をご参照ください。

-- 平行

1つのオブジェクトに対して実行する同時操作の数。 有効な値: 1 ~ 10000 既定では、ossutilは操作タイプとオブジェクトサイズに基づいてこのオプションの値を自動的に設定します。

-- partition-download

ダウンロードするパーティション。 このオプションの値は、partition number: total number of partitions形式です。 たとえば、値1:5は、オブジェクトが5つのパーティションに分割され、現在のコマンドがパーティション1をダウンロードすることを指定します。 パーティションは1から始まる番号が付けられます。 オブジェクトのパーティショニングルールは、組み込みアルゴリズムに基づいてossutilによって決定されます。 このオプションは、オブジェクトを複数のパーティションに分割し、複数のossutilコマンドで同時にダウンロードできます。 各ossutilコマンドは、独自のパーティションをダウンロードします。

-- bucketname

バケットの名前です。

-- encoding-type

oss:// bucket_nameに続くキーのエンコードに使用するエンコードタイプ。 有効値: url このオプションを設定しない場合、キーはエンコードされません。

-- 起源

HTTPリクエストのOriginヘッダーの値。 このオプションの値は、クロスオリジンリクエストの送信元となるソースドメインを指定します。

-- acr-method

HTTPリクエストのAccess-Control-Request-Methodヘッダーの値。 有効な値: GET、PUT、POST、DELETE、およびHEAD。

-- acr-headers

HTTPリクエストのAccess-Control-Request-Headersヘッダーの値。 このオプションの値は、リクエストに追加する必要があるヘッダーを指定します。 ヘッダーには、共通リクエストヘッダーは含まれません。 複数のヘッダーを指定するには、ヘッダーをコンマ (,) で区切り、ヘッダーを二重引用符 ("") で囲みます。 例: -- acr-headers "header1,header2,header3"

-- upload-id-marker

リスト操作の開始位置。 アップロードIDがマーカーの後にアルファベット順である部品が一覧表示されます。

-h、-- ヘルプ

指定したコマンドのヘルプ情報を表示します。

-- trafic-limit

signコマンドでのHTTPによるアクセス速度。 単位：bit/s。

デフォルト値：0 0の値は、アクセス速度が無制限であることを指定します。

有効な値: 819200〜838860800 (100 KB/s〜100メガバイト/秒) 。

-- local-host

cpコマンド内のossutilのローカルIPアドレス。 このオプションを設定すると、指定されたIPアドレスを使用してOSSにアクセスします。

-- enable-symlink-dir

シンボリックリンクポイントがアップロードされるサブディレクトリ。 デフォルトでは、サブディレクトリはアップロードされません。 probeコマンドを使用して、シンボリックリンクが指すオブジェクトまたはディレクトリもシンボリックリンクであるかどうかを確認できます。

-- only-current-dir

現在のディレクトリ内のオブジェクトのみをアップロード、ダウンロード、またはコピーすることを指定します。 現在のディレクトリ内のサブディレクトリおよびサブディレクトリ内のオブジェクトは無視されます。

-- disable-dir-object

アップロードするディレクトリに対してOSSオブジェクトが生成されないことを指定しますが、ディレクトリはOSSコンソールのディレクトリ構造に保持されます。 ディレクトリ内のすべてのオブジェクトを削除すると、ディレクトリも削除されます。

-- probe-item

probeコマンドを使用して確認する項目。 有効な値：

• upload-speed: ossutilはアップロード帯域幅をチェックします。

• download-speed: ossutilはダウンロード帯域幅をチェックします。

• cycle-symlink: ossutilは、ローカルファイルディレクトリ内のシンボリックリンクが自分自身を指しているかどうかを確認します。

-- redundancyタイプ

バケットの冗長タイプ。 有効な値：

• LRS (デフォルト): バケットの冗長タイプをローカル冗長ストレージ (LRS) に設定した場合、OSSは同じゾーン内の異なるデバイス間で各オブジェクトのコピーを保存します。 このように、OSSは、2つのストレージデバイスが同時に破損した場合でも、データの信頼性と可用性を保証します。

• ZRS: バケットの冗長タイプをゾーン冗長ストレージ (ZRS) に設定した場合、OSSは同じリージョンの複数のゾーンにデータの複数のコピーを保存します。 ゾーンが使用できなくなっても、データにアクセスできます。

-- disable-encode-スラッシュ

URLのスラッシュ (/) をエンコードしないように指定します。

-- disable-all-symlink

シンボリックリンクが指すサブディレクトリおよびシンボリックリンクが指すサブディレクトリ内のすべてのオブジェクトが、オブジェクトのアップロード中に無視されることを指定します。

-- タグ付け

オブジェクトをアップロードまたはコピーするときのオブジェクトタグ。 例: "abc=1&bcd=2&……"

-- disable-無視-エラー

エラーによって例外がスローされ、コマンドが終了します。 バッチ操作でエラーが無視されないように指定します。

-- ブロックサイズ

指定されたバケットまたはディレクトリ内のオブジェクトの取得された合計サイズの単位。 有効な値: KB、MB、GB、TB。 このオプションを設定しない場合、取得されるオブジェクトの合計サイズは、デフォルトでバイト単位で測定されます。