ossutil を使い始める - Object Storage Service - Alibaba Cloud ドキュメントセンター

ossutil は、Windows、macOS、および Linux から Object Storage Service (OSS) リソースを効率的に管理できるコマンドラインツールです。このトピックでは、コマンドを使用して、バケットの作成と削除、オブジェクトのアップロード、ダウンロード、一覧表示、削除など、一般的なバケットとオブジェクトの管理操作を実行する方法について説明します。

説明

このトピックでは、ossutil V2.0 を使用しています。 ossutil V1.0 と比較して、ossutil V2.0 はより高度な機能を提供します。 ossutil V2.0 を使用することをお勧めします。 ossutil V1.0 も利用可能です。 ossutil V1.0 の使用方法については、「ossutil V1.0」をご参照ください。
ossutil V2.0 をインストールして構成済みの場合は、「ossutil コマンド」を参照してすぐに使い始めることができます。

前提条件

Alibaba Cloud アカウントが作成されている。
OSS がアクティブ化されている。

ossutil のインストール

Linux

unzip ツールをインストールします。
Alibaba Cloud Linux
```
sudo yum install -y unzip
```
CentOS
```
sudo yum install -y unzip
```
Ubuntu
```
sudo apt install -y unzip
```
ossutil パッケージをダウンロードします。
```
curl -o ossutil-2.1.0-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.1.0/ossutil-2.1.0-linux-amd64.zip
```
説明
この例では、64 ビット x86 Linux 用の ossutil をダウンロードしています。別のシステム用の ossutil をダウンロードするには、「ossutil のダウンロード」をご参照ください。
ossutil パッケージが保存されているディレクトリに移動し、次の unzip コマンドを実行します。
```
unzip ossutil-2.1.0-linux-amd64.zip
```
ossutil-2.1.0-linux-amd64 ディレクトリに移動します。
```
cd ossutil-2.1.0-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 はインストールされています。

Windows

ossutil をインストールします。
1. システムアーキテクチャとビットバージョンに対応する ossutil パッケージをダウンロードします。
2. ossutil パッケージからファイルをディレクトリに展開し、そのディレクトリに移動します。
3. ファイルのパスに環境変数を構成します。
  1. アドレスバーをクリックして現在のフォルダのパスをコピーします。
  2. [環境変数] ダイアログボックスの [システム変数] セクションで、[path] 変数を探してダブルクリックし、[新規] ボタンをクリックして、ファイルのパスをテキストボックスに貼り付けます。
4. ossutil コマンドを実行して、ossutil がインストールされているかどうかを確認します。
```
ossutil
```
  ossutil のヘルプ情報が返された場合、ossutil はインストールされています。

macOS

ossutil をインストールします。
```
curl -o ossutil-2.1.0-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2/2.1.0/ossutil-2.1.0-mac-arm64.zip
```
説明
この例では、64 ビット macOS ARM 用の ossutil をダウンロードしています。別のシステム用の ossutil をダウンロードするには、「ossutil のダウンロード」をご参照ください。
ossutil パッケージが保存されているディレクトリに移動し、次の unzip コマンドを実行します。
```
unzip ossutil-2.1.0-mac-arm64.zip
```
ossutil-2.1.0-mac-arm64 ディレクトリに移動します。
```
cd ossutil-2.1.0-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 はインストールされています。

ossutil の構成

ossutil を構成します。
```
ossutil config
```

構成ファイルのパスを構成します。 Enter キーを押して、構成ファイルのデフォルトパスを使用できます。

この例では、Linux で ossutil を構成する方法を示します。

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):

以前に作成した AccessKey ID を入力します。

Please enter Access Key ID [****************id]:LTAI****************

以前に作成した AccessKey シークレットを入力します。

Please enter Access Key Secret [****************sk]:R6vg*********************

OSS にデータが保存されているリージョンの ID を入力します。
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
この例では、中国 (杭州) リージョンの ID を使用しています。他のリージョンの ID については、「リージョンとエンドポイント」をご参照ください。
リージョンのエンドポイントを指定します。この手順はスキップできます。前の手順でリージョン ID を指定した後、デフォルトでそのリージョンのパブリックエンドポイントが使用されます。たとえば、region-id を cn-hangzhou に設定すると、デフォルトでパブリックエンドポイント https://oss-cn-hangzhou.aliyuncs.com が使用されます。別のエンドポイントを使用する場合は、そのエンドポイントを入力します。
```
Please enter Endpoint (optional, use public endpoint by default) [None]: https://oss-cn-hangzhou.aliyuncs.com
```

サンプルコマンド

バケットを作成します。
```
 ossutil mb oss://examplebucket
```
出力が次の内容と同様の場合、バケットは作成されています。
```
0.668238(s) elapsed
```
バケットにオブジェクトをアップロードします。
1. uploadFile.txt という名前のローカルファイルを作成します。
```
echo 'Hello, OSS!' > uploadFile.txt
```
2. ファイルを examplebucket にアップロードします。
```
ossutil cp uploadFile.txt oss://examplebucket
```
  出力が次のコンテンツのようになっている場合、ファイルはバケットにアップロードされています。
```
Success: Total 1 file, size 12 B, Upload done:(1 objects, 12 B), avg 44 B/s

0.271779(s) elapsed
```
オブジェクトをダウンロードします。
uploadFile.txt オブジェクトをバケットから localfolder という名前のディレクトリにダウンロードします。
```
ossutil cp oss://examplebucket/uploadFile.txt localfolder/
```
出力が次の内容と同様の場合、オブジェクトはローカルディレクトリにダウンロードされています。
```
Success: Total 1 object, size 12 B, Download done:(1 files, 12 B), avg 74 B/s

0.162447(s) elapsed
```

バケット内のオブジェクトを一覧表示します。

ossutil ls oss://examplebucket

出力が次の内容と同様の場合、バケット内のオブジェクトが一覧表示されています。

LastModifiedTime                   Size(B)  StorageClass   ETAG                                  ObjectName
2024-11-26 14:35:29 +0800 CST           12      Standard   1103F650EB2C292D179A032D2A97B0F5      oss://examplebucket/uploadFile.txt
Object Number is: 1

0.124679(s) elapsed

バケットから uploadFile.txt オブジェクトを削除します。
```
ossutil rm oss://examplebucket/uploadFile.txt
```
出力が次の内容と同様の場合、オブジェクトはバケットから削除されています。
```
0.295530(s) elapsed
```
バケットを削除します。
```
ossutil rb oss://examplebucket
```
出力が次の内容と同様の場合、バケットは削除されています。
```
0.478659(s) elapsed
```

Object Storage Service:ossutil を使い始める

前提条件

ossutil のインストール

Linux

Alibaba Cloud Linux

CentOS

Ubuntu

Windows

macOS

ossutil の構成

サンプルコマンド

関連トピック