すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ossutilを使い始める

    ドキュメントセンター

    Object Storage Service:ossutilを使い始める

    最終更新日:Nov 08, 2024

    ossutilは、Object Storage Service (OSS) 内のオブジェクトを効率的に管理するためにAlibaba Cloudが提供するコマンドラインツールです。 オブジェクトをOSSにアップロードするには、まずバケットを作成する必要があります。 オブジェクトをアップロードした後、署名付きURLを使用して、オブジェクトをローカルデバイスにダウンロードしたり、サードパーティのユーザーと共有してダウンロードやプレビューを行うことができます。

    前提条件

    • OSSが有効化されています。 詳細については、「OSSの有効化」をご参照ください。

    • AccessKeyペアが作成され、取得されます。 詳細については、「AccessKey の作成」をご参照ください。

    手順

    ossutil 1.0と比較して、ossutil 2.0はコマンドを階層で整理し、構成ファイル、アクセス資格情報、フィルターなどの複数の項目を最適化します。 ossutilの新規ユーザーの場合は、ossutil 2.0の使用を推奨します。

    ossutil 2.0の使用を開始する (プレビュー)

    ステップ1: ossutil 2.0のインストール

    Linux

    1. ossutilインストールパッケージをダウンロードします。 

      curl -o ossutil-2.0.4-beta.10251600-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.4-beta.10251600/ossutil-2.0.4-beta.10251600-linux-amd64.zip
      説明

      この例では、ossutilは64ビットLinux x86システム用にダウンロードされます。 他のオペレーティングシステム用のossutilインストールパッケージをダウンロードする方法の詳細については、「ossutilのインストール」をご参照ください。

    2. ossutilインストールパッケージが保存されているディレクトリに移動し、次のunzipコマンドを実行します。

      unzip ossutil-2.0.4-beta.10251600-linux-amd64.zip

    3. ossutil-2.0.4-beta.10251600-linux-amd64ディレクトリを入力します。

      cd ossutil-2.0.4-beta.10251600-linux-amd64

    4. 現在のディレクトリで次のコマンドを実行します。

      chmod 755 ossutil

    5. 次のコマンドを実行します。 ossutilのバージョン番号が返された場合、ossutil 2.0がインストールされます。

      ossutil version

    Windows

    1. [Windows x86 32bit] または [Windows x86 64bit] をクリックして、コンピューターの構成に基づいてossutilインストールパッケージをダウンロードします。

    2. ossutilインストールパッケージを解凍します。

    3. ossutil-v1.7.19-windows-amd64ディレクトリを入力します。 

      cd ossutil-v1.7.19-windows-amd64

    macOS

    1. ossutilインストールパッケージをダウンロードします。 

      curl -o ossutil-2.0.4-beta.10251600-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.4-beta.10251600/ossutil-2.0.4-beta.10251600-mac-arm64.zip
      説明

      この例では、ossutilは64ビットmacOS ARMシステム用にダウンロードされます。 他のオペレーティングシステム用のossutilインストールパッケージをダウンロードする方法の詳細については、「ossutilのインストール」をご参照ください。

    2. ossutilインストールパッケージが保存されているディレクトリに移動し、次のunzipコマンドを実行します。

      unzip ossutil-2.0.4-beta.10251600-mac-arm64.zip

    3. ossutil-2.0.4-beta.10251600-mac-arm64ディレクトリを入力します。

      cd ossutil-2.0.4-beta.10251600-mac-arm64

    4. 次のコマンドを実行します。

      chmod 755 ossutil

    5. 次のコマンドを実行します。 ossutilのバージョン番号が返された場合、ossutil 2.0がインストールされます。 

      ossutil version

    ステップ2: ossutilの設定

    1. 次のコマンドを実行してossutilを設定します。

      ossutil config

    2. 设定ファイルのパスを指定します。 

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

      デフォルトパスを使用するには、Enterキーを押すことを推奨します。 デフォルトパス: /root/.ossutilconfig。

    3. 画面の指示に基づいて、AccessKey ID、AccessKeyシークレット、およびリージョンを指定します。

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

      Please enter Access Key ID [None]:

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

      Please enter Access Key Secret [None]:

      データを格納するバケットが配置されているリージョンを入力します。 デフォルト値: cn-hangzhou。 

      Please enter Region [cn-hangzhou]:

    4. ossutilがインストールおよび設定されているかどうかを確認します。

      ossutil

      ossutilでサポートされているすべてのコマンドが表示される場合、ossutilがインストールおよび構成されます。

    ステップ3: バケットの作成

    次のコマンドを実行して、examplebucketという名前のバケットを作成します。

    ossutil mb oss://examplebucket

    出力が次のコンテンツに似ている場合、バケットが作成されます。 

    0.668238(s) elapsed

    ステップ4: オブジェクトのアップロード

    1. exampleobject.jpgという名前のサンプルオブジェクトをローカルコンピューターにダウンロードします。

    2. ダウンロードしたサンプルオブジェクトをexamplebucketバケットにアップロードします。 

      ossutil cp exampleobject.jpg oss://examplebucket

      出力が次のコンテンツに似ている場合、オブジェクトはバケットにアップロードされます。 

      Success: Total 1 file, size 2078 B, Upload done:(1 objects, 2078 B), avg 5.985 KiB/s
0.344043(s) elapsed

    ステップ5: オブジェクトをダウンロードする

    次のコマンドを実行して、exampleobject.jpgという名前のアップロードされたサンプルオブジェクトをexamplebucketバケットからコンピューターのlocalfolderディレクトリにダウンロードします。

    ossutil cp oss://examplebucket/exampleobject.jpg localfolder/

    出力が次のコンテンツに似ている場合、オブジェクトは指定されたローカルディレクトリにダウンロードされます。 

    Success: Total 1 object, size 13 B, Download done:(1 files, 13 B), avg 86 B/s
0.154553(s) elapsed

    ステップ6: オブジェクトを共有する

    次のコマンドを実行して、oss:// examplebucket/exampleobject.jpgという名前のオブジェクトのデフォルトの有効期間が15分の事前署名付きURLを生成します。

    ossutil presign oss://examplebucket/exampleobject.jpg

    出力が次のコンテンツに似ている場合、オブジェクトの署名済みURLが生成されます。 

    https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampleobject.jpg?x-oss-credential=LTAI5tAC9X28MocRaycC****%2F20240912%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20240912T092928Z&x-oss-expires=900&x-oss-signature=fe72a66bf42cc619023e9ae289882a4d2443870b616ae1fba17eb81bb02a****&x-oss-signature-version=OSS4-HMAC-SHA256
0.002727(s) elapsed

    事前署名されたURLをブラウザのアドレスバーにコピーして、オブジェクトにアクセスします。

    ステップ7: リソースのリリース

    Alibaba Cloud OSSは、従量課金方式を使用しています。 オブジェクトの保持期間中は引き続き料金が発生します。 アップロードされたオブジェクトに追加料金が発生しないようにするには、上記の操作が完了した後にリソースをリリースします。

    • オブジェクトの削除

      次のコマンドを実行して、exampleobject.jpgという名前のサンプルオブジェクトをexamplebucketから削除します。 

      ossutil rm oss://examplebucket/exampleobject.jpg

      出力が次のコンテンツに似ている場合、オブジェクトは削除されます。 

      0.295530(s) elapsed

    • バケットの削除

      次のコマンドを実行して、examplebucketという名前の空のバケットを削除します。

      ossutil rb oss://examplebucket

      出力が次のコンテンツに似ている場合、バケットは削除されます。 

      0.478659(s) elapsed

    上記の手順では、ossutil 2.0の基本的な使用方法について説明します。 詳細については、「ossutil 2.0 (プレビュー) 」をご参照ください。

    ossutil 1.0を使い始める

    ステップ1: ossutil 1.0のインストール

    Linux

    1. 解凍ツールをインストールします。 

      sudo yum install -y unzip

    2. 次のコマンドを実行してossutilをインストールします。 

      sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
      説明

      デフォルトでは、ossutilは /usr/binディレクトリにインストールされます。

    Windows

    1. [Windows x86 64bit] または [Windows x86 32bit] をクリックして、コンピューターの構成に基づいてossutilインストールパッケージをダウンロードします。

    2. インストールパッケージを解凍し、ossutil.batファイルを実行します。

    macOS

    次のコマンドを実行してossutilをインストールします。 

    sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
    説明

    デフォルトでは、ossutilは /usr/local/binディレクトリにインストールされます。

    ステップ2: ossutilの設定

    1. 次のコマンドを実行してossutilを設定します。 

      ossutil config

    2. 设定ファイルのパスを指定します。 

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

      デフォルトパスを使用するには、Enterキーを押すことを推奨します。 デフォルトパス: /root/.ossutilconfig。

    3. 画面の指示に従って、ossutilの言語を指定します。 CHまたはENを入力します。 デフォルトでは、ossutilはOSで使用される言語で表示されます。 この設定項目は、configコマンドを実行すると有効になります。 CHと入力することを推奨します。

    4. 画面の指示に基づいて、AccessKey ID、AccessKey Secret、リージョン、およびセキュリティトークンを指定します。

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

      Please enter Access Key ID:

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

      Please enter Access Key Secret:

      データを格納するバケットが配置されているリージョンを入力します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、cn-Hangzhouと入力します。 

      Please enter Region:

      セキュリティトークンを入力します。 Enterキーを押してstsTokenパラメーターを空のままにすることを推奨します。 

      Please enter stsToken:

    5. ossutilがインストールされているかどうかを確認します。

      ossutil

      ossutilでサポートされているすべてのコマンドが表示される場合、ossutilがインストールされます。

    ステップ3: バケットの作成

    次のコマンドを実行して、examplebucketという名前のバケットを作成します。 

    ossutil mb oss://examplebucket

    出力が次のコンテンツに似ている場合、バケットが作成されます。 

    0.668238(s) elapsed

    ステップ4: オブジェクトのアップロード

    1. exampleobject.jpgという名前のサンプルオブジェクトをローカルコンピューターにダウンロードします。

    2. ダウンロードしたサンプルオブジェクトをexamplebucketバケットにアップロードします。 

      ossutil cp exampleobject.jpg oss://examplebucket
      0.720812(s) elapsed

    ステップ5: オブジェクトのダウンロード

    次のコマンドを実行して、exampleobject.jpgという名前のアップロードされたサンプルオブジェクトをexamplebucketバケットからコンピュータのlocalfolderディレクトリにダウンロードします。 

    ossutil cp oss://examplebucket/exampleobject.jpg localfolder/

    出力が次のコンテンツに似ている場合、オブジェクトは指定されたローカルディレクトリにダウンロードされます。 

    0.154553(s) elapsed

    ステップ6: オブジェクトの共有

    次のコマンドを実行して、oss:// examplebucket/exampleobject.jpgという名前のオブジェクトの有効期間が3,600秒の署名付きURLを生成します。 

    ossutil sign oss://examplebucket/exampleobject.jpg --timeout 3600

    出力が次のコンテンツに似ている場合、署名付きURLが生成されます。 

    https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampleobject.jpg?Expires=1608282224&OSSAccessKeyId=LTAI4G33piUmgRN1DXx9****&Signature=jo4%2FGykfuc1A4fvyvKRpRyymYH**** 0.368676(s) elapsed

    署名付きURLをブラウザのアドレスバーにコピーして、オブジェクトにアクセスします。

    ステップ7: リリースリソース

    Alibaba Cloud OSSは、従量課金方式を使用しています。 オブジェクトの保持期間中は引き続き料金が発生します。 アップロードされたオブジェクトに追加料金が発生しないようにするには、上記の操作が完了した後にリソースをリリースします。

    • オブジェクトの削除

      次のコマンドを実行して、exampleobject.jpgという名前のサンプルオブジェクトをexamplebucketから削除します。 

      ossutil rm oss://examplebucket/exampleobject.jpg

      出力が次のコンテンツに似ている場合、オブジェクトは削除されます。 

      0.295530(s) elapsed

    • バケットの削除

      次のコマンドを実行して、examplebucketという名前の空のバケットを削除します。 

      ossutil rb oss://examplebucket

      出力が次のコンテンツに似ている場合、バケットは削除されます。 

      0.478659(s) elapsed

    上記の手順では、ossutil 1.0の基本的な使用方法について説明します。 詳細については、「ossutil 1.0」をご参照ください。