ossutil を使用すると、Object Storage Service (OSS) 内のオブジェクトを効率的に管理できます。たとえば、ossutil を使用して、大きなオブジェクトのアップロード、オブジェクトのダウンロード、特定のプレフィックスを含む名前のオブジェクトの削除を実行できます。 ossutil は、Windows、Linux、macOS の以下の OS をサポートしています。ビジネス要件を満たす ossutil バージョンをダウンロードしてインストールできます。
新しいバージョンが利用可能です
ossutil 2.0 をインストールして使用することをお勧めします。詳細については、「ossutil のインストール」をご参照ください。
ossutil 2.0 の主な機能:
新しいコマンドの分類: コマンドは、
ossutil api put-bucket-aclなどの API レベルのコマンドと、ossutil configなどの高レベルのコマンドに分類されます。最適化された構成メカニズム: 初期構成プロセスが簡素化されました。 ossutil をインストールした後に基本構成を完了するには、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定するだけで済みます。
--profileパラメーターを使用して複数の構成ファイルを指定することもでき、構成の柔軟性が向上します。より多くのフィルターパラメーター:
ls、cp、rmなどのバッチ処理コマンド用に、パス、ファイルサイズ、最終更新時刻、およびオブジェクトのメタデータに基づくさまざまなフィルター条件が提供されており、操作の精度と効率が大幅に向上します。柔軟な出力形式: --output-format パラメーターと --output-query パラメーターが提供されています。
--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 を構成します。
ossutil configプロンプトが表示されたら、構成ファイルのパスを構成します。
Please enter the config file name,the file name can include path(default /home/user/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):デフォルトでは、ossutil は構成ファイルを /home/user/.ossutilconfig として保存します。構成ファイルに別のパスを指定する場合は、-c オプションを追加して、ossutil コマンドを実行するたびに構成ファイルを指定します。たとえば、構成ファイルを /home/config として保存する場合は、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c /home/config画面の指示に従って、ossutil の表示言語を指定します。
CHまたはENと入力します。デフォルトでは、ossutil は OS で使用されている言語で表示されます。構成は、config コマンドを実行した後に有効になります。画面の指示に従って、ossutil の表示言語を構成します。
CH または EN と入力します。デフォルトでは、ossutil はオペレーティングシステムで使用されている言語で表示されます。構成は、config コマンドを実行した後に有効になります。
画面の指示に従って、エンドポイント、accessKeyID、accessKeySecret、stsToken の各パラメーターを構成します。 stsToken パラメーターは、Security Token Service (STS) によって提供される一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必要です。
次の表に、パラメーターを示します。
パラメーター
必須
説明
エンドポイント
はい
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
Resource Orchestration Service (ROS) スクリプトを使用すると、OSS のフルアクセス権限を持つ RAM ユーザーの AccessKey ペアをすばやく作成できます。これを行うには、[テンプレートベースのスタック作成ウィザード] に移動し、[セキュリティ確認] セクションで [Alibaba Cloud ROS が RAM リソースを作成することを確認します] を選択し、[作成] をクリックします。
AccessKey ペアが作成されたら、「＋ Create」 タブで AccessKey ペアをコピーします。
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS バケットにアクセスする場合にのみ必要です。一時的なアクセス認証情報を使用して OSS バケットにアクセスしない場合は、このパラメーターを空のままにすることができます。 STS トークンの生成方法については、「AssumeRole」をご参照ください。
次のコマンドを実行して、ossutil がインストールされているかどうかを確認します。
ossutilossutil コマンドのリストが表示された場合は、ossutil がインストールされています。
Windows
ossutil をインストールします。
Windows 用インストールパッケージへのリンクをクリックして、パッケージをダウンロードします。
インストールパッケージを解凍します。次に、 ossutil.bat ファイルを実行します。
ossutil を構成します。
次のコマンドを実行して、ossutil を構成します。
ossutil config構成ファイルのパスを構成します。
Please enter the config file name,the file name can include path(default C:\\Users\user\.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):デフォルトでは、ossutil は構成ファイルを C:\\Users\user\.ossutilconfig として保存します。構成ファイルのパスを指定する場合は、-c オプションを追加して、ossutil コマンドを実行するたびに構成ファイルを指定します。たとえば、構成ファイルを c:\ossutil\config として保存する場合は、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c c:\ossutil\config画面の指示に従って、ossutil の表示言語を指定します。
ENと入力します。デフォルトでは、ossutil は OS で使用されている言語で表示されます。構成は、config コマンドを実行した後に有効になります。画面の指示に従って、エンドポイント、accessKeyID、accessKeySecret、stsToken の各パラメーターを構成します。 stsToken パラメーターは、Security Token Service (STS) によって提供される一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必要です。
次の表に、パラメーターを示します。
パラメーター
必須
説明
エンドポイント
はい
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
Resource Orchestration Service (ROS) スクリプトを使用すると、OSS のフルアクセス権限を持つ RAM ユーザーの AccessKey ペアをすばやく作成できます。これを行うには、[テンプレートベースのスタック作成ウィザード] に移動し、[セキュリティ確認] セクションで [Alibaba Cloud ROS が RAM リソースを作成することを確認します] を選択し、[作成] をクリックします。
手順
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS バケットにアクセスする場合にのみ必要です。一時的なアクセス認証情報を使用して OSS バケットにアクセスしない場合は、このパラメーターを空のままにすることができます。 STS トークンの生成方法については、「AssumeRole」をご参照ください。
次のコマンドを実行して、ossutil がインストールされているかどうかを確認します。
ossutilossutil コマンドのリストが表示された場合は、ossutil がインストールされています。
macOS
次のコマンドを実行して、ossutil をダウンロードしてインストールします。
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash説明デフォルトでは、ossutil は /usr/local/bin ディレクトリにインストールされます。
ossutil を構成します。
次のコマンドを実行して、ossutil を構成します。
ossutil config構成ファイルのパスを構成します。
Please enter the config file name,the file name can include path(default /Users/user/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):デフォルトでは、ossutil は構成ファイルを /Users/user/.ossutilconfig として保存します。
別の構成ファイルを指定する場合は、-c オプションを追加して、ossutil コマンドを実行するたびに構成ファイルを指定する必要があります。たとえば、構成ファイルを /home/config として保存する場合は、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c /home/config画面の指示に従って、ossutil の表示言語を指定します。
CHまたはENと入力します。デフォルトでは、ossutil は OS で使用されている言語で表示されます。構成は、config コマンドを実行した後に有効になります。画面の指示に従って、エンドポイント、accessKeyID、accessKeySecret、stsToken の各パラメーターを構成します。 stsToken パラメーターは、Security Token Service (STS) によって提供される一時的なアクセス認証情報を使用して OSS にアクセスする場合にのみ必要です。
次の表に、パラメーターを示します。
パラメーター
必須
説明
エンドポイント
はい
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
Resource Orchestration Service (ROS) スクリプトを使用すると、完全な OSS アクセス権限を持つ RAM ユーザーの AccessKey ペアをすばやく作成できます。そのためには、[テンプレートベースのスタック作成ウィザード] に移動し、[セキュリティ確認] セクションで [Alibaba Cloud ROS が RAM リソースを作成することを確認します] を選択し、[作成] をクリックします。
AccessKey ペアが作成されたら、変更を保存 タブで AccessKey ペアをコピーします。
accessKeySecret
はい
stsToken
いいえ
このパラメーターは、一時的なアクセス認証情報を使用して OSS バケットにアクセスする場合にのみ必要です。一時的なアクセス認証情報を使用して OSS バケットにアクセスしない場合は、このパラメーターを空のままにすることができます。 STS トークンの生成方法については、「AssumeRole」をご参照ください。
次のコマンドを実行して、ossutil がインストールされているかどうかを確認します。
ossutilossutil コマンドのリストが表示された場合は、ossutil がインストールされています。
参照
ossutil をインストールしたら、ossutil を使用して、オブジェクトのアップロード、オブジェクトのダウンロード、オブジェクトのコピー、オブジェクトの削除、その他の操作を実行できます。詳細については、「オブジェクトのアップロード」、「オブジェクトのダウンロード」、「オブジェクトのコピー」、「rm」をご参照ください。