ossutil を使用すると、Object Storage Service (OSS) 内のオブジェクトを効率的に管理できます。たとえば、ossutil を使用して、大きなオブジェクトのアップロード、オブジェクトのダウンロード、特定のプレフィックスを含む名前のオブジェクトのバッチ削除を実行できます。 ossutil は、Windows、Linux、macOS などの OS をサポートしています。要件を満たすバージョンをダウンロードしてインストールできます。
バージョン
現在のバージョン: 2.1.1.
ossutil のダウンロード
ダウンロードリンク | SHA-256 チェックサム |
af77d281229d51df7fd15d645a842dec97f6be4eeb245db20f90f197ac1cdfb3 | |
60f3a808cbbdfd4b5269b8f967c6a66f564c9dacff52d93a5d21a588976ab5a2 | |
0861cca6454307f884a4f54d73c8af42f8abe4fea4cb189b1481f37ca6aee3a8 | |
a22a50d528b54c806aeadbc65289ac03769b64265d2121e9221df7678bdb4f63 | |
10a6b6189542c21577513e18e6d4804bf80d99e88a6264801bdb7b1ec4419725 | |
ee699ca71a98ca9d42ad345058376f10f4e917f452b454a3e26b59911c7b08fc | |
f2d8cf95e9718d894d3f207b05b0d4649636c862cf25a05e4e38f4291732c8e9 | |
8797230d56ade91e7002fca3bdd72ab6a5e0d215867f0998241d91611afce120 | |
00b46eee2e9899a1cd6b26a3e6b8162f0f4dd488b4ae0afe2f84314b1f530701 |
ossutil のインストール
Linux
ossutil をインストールします。
インストールパッケージをダウンロードします。
curl -o ossutil-2.1.1-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.1.1/ossutil-2.1.1-linux-amd64.zip
説明この例では、64 ビット x86 Linux 用の ossutil をダウンロードしています。別のシステム用の ossutil をダウンロードするには、「ossutil のダウンロード」をご参照ください。
ossutil パッケージが保存されているディレクトリに移動し、次の unzip コマンドを実行します。
unzip ossutil-2.1.1-linux-amd64.zip
ossutil-2.1.1-linux-amd64 ディレクトリに移動します。
cd ossutil-2.1.1-linux-amd64
現在のディレクトリで次のコマンドを実行します。
chmod 755 ossutil
ossutil をグローバルに呼び出すには、次のコマンドを実行します。
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
ossutil がインストールされているかどうかを確認します。
ossutil
ヘルプ情報が返された場合、ossutil はインストールされています。
ossutil を構成します。
次のコマンドを実行して、構成プロセスを開始します。
ossutil config
画面の指示に従って、構成ファイルのパスを構成します。 Enter キーを押して、構成ファイルのデフォルトパスを使用することもできます。
Please enter the config file name,the file name can include path(default /root/.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 は /root/.ossutilconfig を構成ファイルとして使用します。別の構成ファイルを指定する場合は、コマンドを実行するたびに -c オプションを追加して構成ファイルを指定する必要があります。たとえば、構成ファイルを /home/config として保存する場合、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c /home/config
画面の指示に従って、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定します。
作成した AccessKey ID を入力します。
Please enter Access Key ID [****************id]:LTAI****************
作成した AccessKey シークレットを入力します。
Please enter Access Key Secret [****************sk]:R6vg*********************
OSS にデータが保存されているリージョンの ID を入力します。デフォルトのリージョン ID は cn-hangzhou です。
Please enter Region [cn-hangzhou]:cn-hangzhou
リージョンのエンドポイントを指定します。 Enter キーを押して、この手順をスキップすることもできます。
前の手順でリージョン ID を指定すると、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、
region-id
をcn-hangzhou
に設定すると、デフォルトのパブリックエンドポイントはhttps://oss-cn-hangzhou.aliyuncs.com
になります。別のエンドポイントを使用する場合は、エンドポイントを入力します。 OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com
次の表にパラメーターを示します。
パラメーター
必須
説明
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
accessKeySecret
はい
リージョン
はい
OSS バケットが配置されているリージョンの ID を入力します。この例では、中国 (杭州) リージョンの ID が使用されています。他のリージョンの ID については、「リージョンとエンドポイント」をご参照ください。
エンドポイント
いいえ
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com
) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。
Windows
ossutil をインストールします。
システムアーキテクチャとビットバージョンに対応する ossutil パッケージをダウンロードします。
ossutil パッケージからファイルをディレクトリに展開し、そのディレクトリに移動します。
ファイルのパスに環境変数を構成します。
アドレスバーをクリックして、現在のフォルダのパスをコピーします。
[環境変数] ダイアログボックスの [システム変数] セクションで、[Path] 変数を探してダブルクリックし、[新規] ボタンをクリックして、ファイルのパスをテキストボックスに貼り付けます。
cmd で
ossutil
コマンドを実行します。ヘルプ情報が返された場合、ossutil はインストールされています。ossutil
ossutil を構成します。
次のコマンドを実行して、構成プロセスを開始します。
ossutil config
プロンプトに従って構成ファイルのパスを構成します。 Enter キーを押して、構成ファイルのデフォルトパスを使用することもできます。
Please enter the config file name,the file name can include path(default "C:\Users\issuser\.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\issuser\.ossutilconfig として保存します。構成ファイルのパスを指定する場合は、ossutil でコマンドを実行するたびに -c オプションを追加して構成ファイルを指定します。たとえば、構成ファイルを c:\ossutil\config として保存する場合、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c c:\ossutil\config
画面の指示に従って、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定します。
作成した AccessKey ID を入力します。
Please enter Access Key ID [****************id]:LTAI****************
作成した AccessKey シークレットを入力します。
Please enter Access Key Secret [****************sk]:R6vg*********************
OSS にデータが保存されているリージョンの ID を入力します。デフォルトのリージョン ID は cn-hangzhou です。
Please enter Region [cn-hangzhou]:cn-hangzhou
リージョンのエンドポイントを指定します。 Enter キーを押して、この手順をスキップすることもできます。
前の手順でリージョン ID を指定すると、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、
region-id
をcn-hangzhou
に設定すると、デフォルトのパブリックエンドポイントはhttps://oss-cn-hangzhou.aliyuncs.com
になります。別のエンドポイントを使用する場合は、エンドポイントを入力します。 OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com
次の表にパラメーターを示します。
パラメーター
必須
説明
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
accessKeySecret
はい
リージョン
はい
OSS バケットが配置されているリージョンの ID を入力します。この例では、中国 (杭州) リージョンの ID が使用されています。他のリージョンの ID については、「リージョンとエンドポイント」をご参照ください。
エンドポイント
いいえ
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com
) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。
macOS
ossutil をインストールします。
インストールパッケージをダウンロードします。
curl -o ossutil-2.1.1-mac-arm64.zip https://gosspublic.alicdn.com/ossutil/v2/2.1.1/ossutil-2.1.1-mac-arm64.zip
説明この例では、64 ビット macOS ARM 用 ossutil がダウンロードされます。他のオペレーティングシステム用に ossutil をダウンロードする方法については、「ossutil のダウンロード」をご参照ください。
ossutil パッケージが保存されているディレクトリに移動し、次の unzip コマンドを実行します。
unzip ossutil-2.1.1-mac-arm64.zip
ossutil-2.1.1-mac-arm64 ディレクトリに移動します。
cd ossutil-2.1.1-mac-arm64
現在のディレクトリで次のコマンドを実行します。
chmod 755 ossutil
ossutil をグローバルに呼び出すには、次のコマンドを実行します。
sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil
ossutil がインストールされているかどうかを確認します。
ossutil
ヘルプ情報が返された場合、ossutil はインストールされています。
ossutil を構成します。
次のコマンドを実行して、構成プロセスを開始します。
ossutil config
プロンプトに従って構成ファイルのパスを構成します。 Enter キーを押して、構成ファイルのデフォルトパスを使用することもできます。
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 として保存します。構成ファイルのパスを指定する場合は、ossutil でコマンドを実行するたびに -c オプションを追加して構成ファイルを指定します。たとえば、構成ファイルを /home/config として保存する場合、ls コマンドを実行するときに、次の形式で -c オプションを追加します。
ossutil ls oss://examplebucket -c /home/config
画面の指示に従って、AccessKey ID、AccessKey シークレット、およびリージョン ID を指定します。
作成した AccessKey ID を入力します。
Please enter Access Key ID [****************id]:LTAI****************
作成した AccessKey シークレットを入力します。
Please enter Access Key Secret [****************sk]:R6vg*********************
OSS にデータが保存されているリージョンの ID を入力します。デフォルトのリージョン ID は cn-hangzhou です。
Please enter Region [cn-hangzhou]:cn-hangzhou
リージョンのエンドポイントを指定します。 Enter キーを押して、この手順をスキップすることもできます。
前の手順でリージョン ID を指定すると、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、
region-id
をcn-hangzhou
に設定すると、デフォルトのパブリックエンドポイントはhttps://oss-cn-hangzhou.aliyuncs.com
になります。別のエンドポイントを使用する場合は、エンドポイントを入力します。 OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou-internal.aliyuncs.com
次の表にパラメーターを示します。
パラメーター
必須
説明
accessKeyID
はい
RAM ユーザーの AccessKey ペア (AccessKey ID とシークレット) を入力します。 AccessKey ペアの取得方法については、「RAM ユーザーの AccessKey ペアを作成する」をご参照ください。
accessKeySecret
はい
リージョン
はい
OSS バケットが配置されているリージョンの ID を入力します。この例では、中国 (杭州) リージョンの ID が使用されています。他のリージョンの ID については、「リージョンとエンドポイント」をご参照ください。
エンドポイント
いいえ
バケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンのパブリックエンドポイント (
https://oss-cn-hangzhou.aliyuncs.com
) が使用されています。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、そのリージョンの内部エンドポイント (この例では
https://oss-cn-hangzhou-internal.aliyuncs.com
) を使用します。リージョンとエンドポイントのリストについては、「リージョンとエンドポイント」をご参照ください。