ossutil は、大容量ファイルの迅速なアップロード、ファイルのダウンロード、特定のプレフィックスを持つファイルの削除に使用できるコマンドラインツールです。ossutil は、Windows、Linux、macOS などのオペレーティングシステムで動作します。 ご利用の環境に適したバージョンをダウンロードしてインストールできます。
新しいバージョン
アップグレードされた ossutil 2.0 の使用を推奨します。 迅速なインストールと使用方法の詳細については、「ossutil のインストール」をご参照ください。ossutil 1.0 は更新されなくなりました。 新機能と最適化は、ossutil 2.0 でのみ提供されます。
ossutil 2.0 の主な機能：
新しいコマンド構造：
ossutil api put-bucket-aclなどの API レベルのコマンドやossutil configなどの高レベルコマンドを含む、多階層のコマンドをサポートします。設定管理の改善：初期設定プロセスが簡素化されました。 インストール後、AccessKey ID、AccessKey Secret、リージョン ID を提供するだけで、基本設定が完了します。
--profileパラメーターを使用して、複数の設定ファイルを指定することもでき、柔軟性が向上します。ls、cp、rmなどのバッチ処理コマンドでは、パス、ファイルサイズ、変更時刻、オブジェクトメタデータに基づくさまざまなフィルター条件をサポートします。 これにより、操作の正確性と効率が大幅に向上します。柔軟な出力形式：
--output-formatパラメーターを使用すると、さまざまなデータ処理要件に合わせて、出力形式を JSON、YAML、または XML に設定できます。--output-queryオプションを使用すると、出力をフィルターして必要な情報を取得できます。セキュリティの強化：セキュリティを向上させるため、ossutil 2.0 では環境変数を使用して機密パラメーターを設定できます。 これにより、コマンドラインでキーが公開されるのを防ぎ、データ漏洩のリスクを低減します。 さらに、
--dry-runオプションを使用すると、コマンドを実行する前にその動作を検証できるため、意図しない操作を防ぐことができます。
バージョン
現在のバージョン：1.7.19
以前のバージョン：以前の ossutil バージョンのソースコードとリリース履歴の詳細については、「GitHub」をご参照ください。
ダウンロードリンク
ダウンロードリンク | SHA-256 チェックサム |
f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86 | |
dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343 | |
ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d | |
f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57 | |
9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe | |
10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5 | |
772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799 | |
8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77 |
ossutil のダウンロードとインストール
Linux
ossutil をインストールします。
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash説明インストール前に ossutil パッケージを解凍する必要があります。 unzip や 7z などの解凍ツールがインストールされていることを確認してください。
デフォルトでは、ossutil は /usr/bin/ ディレクトリにインストールされます。
ossutil を設定します。
設定コマンドを入力します。
ossutil configプロンプトが表示されたら、設定ファイルのパスを設定します。
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):デフォルトでは、ossutil は設定ファイルを /home/user/.ossutilconfig に保存します。 設定ファイルに別のパスを指定した場合は、ossutil コマンドを実行するたびに -c オプションを追加して設定ファイルを指定する必要があります。 たとえば、設定ファイルを /home/config に保存した場合、ls コマンドを次の形式で実行し、-c オプションを含めます：
ossutil ls oss://examplebucket -c /home/configプロンプトが表示されたら、ツールの言語を設定します。中国語の場合は
CH、英語の場合はENを入力します。デフォルトでは、ツールはお使いのオペレーティングシステムの言語を使用します。この設定は、config コマンドが正常に実行された後に有効になります。Set the language for the tool.
Enter CH or EN. By default, the tool uses the same language as your operating system. This configuration takes effect after you run the config command.
プロンプトが表示されたら、Endpoint、AccessKey ID、AccessKey Secret、STSToken パラメーターを設定します。 STSToken パラメーターは、Security Token Service (STS) からの一時的な認証情報を使用して Object Storage Service (OSS) にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。
パラメーターは次のとおりです：
パラメーター
必須
説明
endpoint
はい
バケットが配置されているリージョンのエンドポイントを入力します。 たとえば、 リージョンのパブリックエンドポイントを に、シンガポールリージョンの場合は
https://oss-ap-southeast-1.aliyuncs.comに設定します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、 や
https://oss-ap-southeast-1-internal.aliyuncs.comなどの内部エンドポイントを使用します。各リージョンのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
重要コンプライアンスとセキュリティを向上させるためのポリシー変更により、2025 年 3 月 20 日以降、新規 OSS ユーザーは、中国本土リージョンにある OSS バケットでデータ API オペレーションを実行するために、カスタムドメイン名 (CNAME) を使用する必要があります。これらの操作では、デフォルトのパブリックエンドポイントの使用が制限されます。影響を受ける操作の完全なリストについては、公式発表をご参照ください。HTTPS 経由でデータにアクセスする場合は、有効な SSL 証明書をカスタムドメインにバインドする必要があります。コンソールでは HTTPS が強制されるため、これはOSS コンソールへのアクセスに必須です。
accessKeyID
はい
アカウントの AccessKey ペアを入力します。 AccessKey ペアの取得方法の詳細については、「AccessKey ペアの作成」をご参照ください。
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。 STS トークンの生成方法の詳細については、「AssumeRole」をご参照ください。
ossutil がインストールされていることを確認します。
ossutilサポートされている ossutil コマンドのリストが表示された場合、インストールは成功です。
Windows
ossutil をインストールします。
ダウンロードリンクをクリックして、Windows インストールパッケージをダウンロードします。
パッケージを解凍し、ossutil.bat ファイルをダブルクリックします。
ossutil を設定します。
設定コマンドを入力します。
ossutil configプロンプトが表示されたら、設定ファイルのパスを設定します。
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):デフォルトでは、ossutil は設定ファイルを C:\\Users\user\.ossutilconfig に保存します。 設定ファイルに別のパスを指定した場合は、コマンドを実行するたびに -c オプションを追加して設定ファイルを指定する必要があります。 たとえば、設定ファイルが c:\ossutil\config に保存されている場合、ls コマンドを次の形式で実行します：
ossutil ls oss://examplebucket -c c:\ossutil\configプロンプトが表示されたら、ツールの言語を設定します。中国語の場合は
CHを、英語の場合はENを入力します。デフォルトでは、ツールはお使いのオペレーティングシステムの言語を使用します。この設定は、config コマンドを実行した後に有効になります。プロンプトが表示されたら、Endpoint、AccessKey ID、AccessKey Secret、STSToken パラメーターを設定します。 STSToken パラメーターは、STS からの一時的な認証情報を使用して OSS にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。
次の表にパラメーターを示します：
パラメーター
必須
説明
endpoint
はい
バケットが配置されているリージョンのエンドポイントを入力します。 たとえば、 リージョンのパブリックエンドポイントを に、シンガポールリージョンの場合は
https://oss-ap-southeast-1.aliyuncs.comに設定します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、 や
https://oss-ap-southeast-1-internal.aliyuncs.comなどの内部エンドポイントを使用します。各リージョンのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
重要コンプライアンスとセキュリティを向上させるためのポリシー変更により、2025 年 3 月 20 日以降、新規 OSS ユーザーは、中国本土リージョンにある OSS バケットでデータ API オペレーションを実行するために、カスタムドメイン名 (CNAME) を使用する必要があります。これらの操作では、デフォルトのパブリックエンドポイントの使用が制限されます。影響を受ける操作の完全なリストについては、公式発表をご参照ください。HTTPS 経由でデータにアクセスする場合は、有効な SSL 証明書をカスタムドメインにバインドする必要があります。コンソールでは HTTPS が強制されるため、これはOSS コンソールへのアクセスに必須です。
accessKeyID
はい
アカウントの AccessKey ペアを入力します。 AccessKey ペアの取得方法の詳細については、「AccessKey ペアの作成」をご参照ください。
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。 STS トークンの生成方法の詳細については、「AssumeRole」をご参照ください。
ossutil がインストールされていることを確認します。
ossutilサポートされている ossutil コマンドのリストが表示された場合、インストールは成功です。
macOS
ossutil をインストールします。
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash説明デフォルトのインストールディレクトリは /usr/local/bin です。
ossutil を設定します。
設定コマンドを入力します。
ossutil configプロンプトが表示されたら、設定ファイルのパスを設定します。
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):デフォルトでは、ossutil は設定ファイルを /Users/user/.ossutilconfig に保存します。
設定ファイルに別のパスを指定した場合は、コマンドを実行するたびに -c オプションを追加して設定ファイルを指定する必要があります。 たとえば、設定ファイルが /Users/user/config に保存されている場合、ls コマンドを次の形式で実行します：
ossutil ls oss://examplebucket -c /Users/user/configプロンプトが表示されたら、ツールの言語を設定します。中国語の場合は
CH、英語の場合はENを入力します。デフォルトでは、ツールはお使いのオペレーティングシステムの言語を使用します。この設定は、config コマンドを実行した後に有効になります。プロンプトが表示されたら、Endpoint、AccessKey ID、AccessKey Secret、STSToken パラメーターを設定します。 STSToken パラメーターは、STS からの一時的な認証情報を使用して OSS にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。
次の表にパラメーターを示します：
パラメーター
必須
説明
endpoint
はい
バケットが配置されているリージョンのエンドポイントを入力します。 たとえば、 リージョンのパブリックエンドポイントを に、シンガポールリージョンの場合は
https://oss-ap-southeast-1.aliyuncs.comに設定します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、 や
https://oss-ap-southeast-1-internal.aliyuncs.comなどの内部エンドポイントを使用します。各リージョンのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
重要コンプライアンスとセキュリティを向上させるためのポリシー変更により、2025 年 3 月 20 日以降、新規 OSS ユーザーは、中国本土リージョンにある OSS バケットでデータ API オペレーションを実行するために、カスタムドメイン名 (CNAME) を使用する必要があります。これらの操作では、デフォルトのパブリックエンドポイントの使用が制限されます。影響を受ける操作の完全なリストについては、公式発表をご参照ください。HTTPS 経由でデータにアクセスする場合は、有効な SSL 証明書をカスタムドメインにバインドする必要があります。コンソールでは HTTPS が強制されるため、これはOSS コンソールへのアクセスに必須です。
accessKeyID
はい
アカウントの AccessKey ペアを入力します。 AccessKey ペアの取得方法の詳細については、「AccessKey ペアの作成」をご参照ください。
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必須です。 それ以外の場合は、このパラメーターを空のままにします。 STS トークンの生成方法の詳細については、「AssumeRole」をご参照ください。
ossutil がインストールされていることを確認します。
ossutilサポートされている ossutil コマンドのリストが表示された場合、インストールは成功です。
関連ドキュメント
ossutil をインストールした後、それを使用してオブジェクトのアップロード、ダウンロード、コピー、削除が可能です。 詳細については、「cp (オブジェクトのアップロード)」、「cp (オブジェクトのダウンロード)」、「cp (オブジェクトのコピー)」、および「rm (オブジェクトの削除)」をご参照ください。