すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud CLI:Alibaba Cloud CLI を使用した OSS リソースの管理

最終更新日:Nov 04, 2025

Alibaba Cloud CLI は、Object Storage Service (OSS) のコマンドラインインターフェイス (CLI) である ossutil を統合しています。この統合により、統一された CLI 環境で OSS リソースを管理できます。このトピックでは、Alibaba Cloud CLI で ossutil を使用する方法について説明します。

背景

  • ossutil を使用すると、Windows、Linux、または macOS システムから OSS データを管理できます。これは、Alibaba Cloud CLI にプラグインとして統合されています。Alibaba Cloud CLI から ossutil を直接呼び出して、バケットやオブジェクトなどのコア OSS リソースを管理できます。

  • version 3.0.304 以降、Alibaba Cloud CLI は <a baseurl="t3144192_v1_0_0.xdita" data-node="4930824" data-root="39083" data-tag="xref" href="t2720201.xdita#" id="cf22035ef1brd">ossutil 2.0</a> を統合し、より安定した効率的なユーザーエクスペリエンスを提供します。ossutil 1.0ossutil 2.0 の両方と互換性があり、ossutil 1.0 のコマンドも引き続き使用できます。ossutil 2.0 のすべての新機能とパフォーマンスの向上を活用できるよう、Alibaba Cloud CLI を最新バージョンにアップグレードすることをお勧めします。

  • Alibaba Cloud CLI における ossutil 1.0ossutil 2.0 の主な違いは次のとおりです。

    コマンド呼び出しの違い

    新しいバージョンでは、コマンドが oss から ossutil にアップグレードされ、機能モジュールがより明確に区別され、より高度な機能がサポートされるようになりました。

    バージョン

    コマンドフォーマット

    ossutil 1.0

    aliyun oss

    ossutil 2.0

    aliyun ossutil

    説明

    新しいバージョンではコマンドが oss から ossutil に変更されます。ossutil 2.0 を使用する場合は、スクリプトまたは自動化タスクでコマンドを更新する必要があります。

    コマンドの違い

    項目

    ossutil 1.0

    ossutil 2.0

    バケット設定

    ルートコマンドの下で、ロギングやライフサイクルなどの機能別に分類されています。

    • 各コマンドは 1 つの API 操作に対応し、ossutil api サブコマンドの下に配置されます。

    • 設定パラメーターは XML と JSON の両方のフォーマットをサポートします。

    • 出力を JSON に変換するなど、出力内容のフォーマット変換をサポートします。

    rm コマンド

    • バケットの削除をサポートします。

    • オブジェクトとパートの同時削除など、単一の操作で複数のデータ型を削除することをサポートします。

    例: rm oss://bucket/prefix -r -f -m

    • バケットの削除はサポートしていません。バケットを削除するには、新しい rb コマンドを使用できます。

    • 単一の操作で 1 つのデータ型のみの削除をサポートします。たとえば、オブジェクトとパートを削除するには、コマンドを個別に呼び出す必要があります。

    例: rm oss://bucket/prefix -r -f および

    rm oss://bucket/prefix -m -r -f

    Append コマンド

    • コマンドは appendfromfile です。

    • データソースはローカルパスのみをサポートします。

    • コマンドは append です。

    • データソースはローカルパス、OSS パス、および標準入力をサポートします。

    cat コマンド

    オブジェクト全体のコンテンツの出力のみをサポートします。

    最初の 10 バイトや最後の 10 バイトなど、オブジェクトの一部の出力をサポートします。

    cp コマンド

    オブジェクト間のコピーでは、データのみがコピーされ、メタデータやタグはコピーされません。

    オブジェクト間でコピーする場合、--copy-props を使用してメタデータとタグのレプリケーションルールを制御できます: コピーしない、メタデータをコピーする、またはメタデータとタグをコピーする。

    デフォルトでは、メタデータとタグがコピーされます。

    オブジェクト属性の変更 (ACL、ストレージクラス、メタデータ、タグ)

    • set-acl コマンドを使用してオブジェクトの ACL を変更します。

    • set-meta コマンドを使用してオブジェクトのメタデータを変更します。

    • cp コマンドを使用してオブジェクトのストレージクラスとタグを変更します。

    • object-tagging コマンドを使用してオブジェクトのタグを変更します。

    • オブジェクト属性変更コマンドは単一のコマンド: set-props に統合されました。変更する必要のある属性パラメーターに基づいて適切な API 操作を選択し、属性変更をより効率的に行うことができます。

    • エイリアスを介して set-acl と set-meta をサポートしますが、コマンドラインパラメーターは元のコマンドとは異なります。

    • replace、update、purge、delete など、豊富なメタデータとタグの変更ディレクティブをサポートします。

    事前署名

    • 事前署名付き URL を生成するコマンドは sign です。

    • 署名の有効期限は、120 秒などの時間間隔のみをサポートします。

    • 事前署名付き URL を生成するコマンドは presign です。

    • sign エイリアスをサポートしますが、コマンドラインパラメーターは元のコマンドとは異なります。

    • 署名の有効期限は、120 秒などの時間間隔と絶対時間の両方の設定をサポートします。

    • V4 署名の場合、事前署名付き URL の最大有効期間は 7 日間です。

    バージョン復元

    削除マーカーを削除することによる最新オブジェクトバージョンの復元のみをサポートします。

    • 削除マーカーを削除して最新のオブジェクトバージョンを復元することをサポートします。

    • オブジェクトバージョンをコピーすることにより、バージョン ID に基づいて指定されたオブジェクトバージョンに復元することをサポートします。

    • オブジェクトバージョンをコピーすることにより、時間に基づいて指定されたオブジェクトバージョンに復元することをサポートします。

    ハッシュ

    ローカルファイルのハッシュ計算のみをサポートします。

    • ローカルファイル、オブジェクトパス、およびバッチ操作のハッシュ計算をサポートします。

    sync

    • --delete パラメーターがない場合、効果は cp コマンドと同じです。ソースをスキャンしてデータを同時にコピーし、最大数量制限はありません。

    • --delete パラメーターを使用すると、データレプリケーションフェーズでもスキャンアンドコピーモードが使用されます。

    • --delete パラメーターが設定されているかどうかに関係なく、最大数量制限が課せられます。デフォルトは 100 万で、最大 500 万まで設定できます。

    • まずソースと宛先のリストをスキャンし、データを同期してから、--delete オプションに基づいて宛先ファイルを削除します。これにより、--update または --size-only オプションと組み合わせることで、より優れた同期パフォーマンスが提供されます。

    オプションの違い

    項目

    ossutil 1.0

    ossutil 2.0

    --include

    --exclude

    • オブジェクトまたはファイル名のマッチングのみをサポートします。

    • 複数の「include」および「exclude」ルールが指定されている場合、最終的な一致が決定されるまで、各ルールは左から右に順次適用されます。

    • オブジェクトまたはファイル名のマッチングをサポートします。

    • オブジェクトまたはファイルパスのマッチングをサポートします。

    • 複数の「include」および「exclude」ルールが指定されている場合、ルールは左から右の順に適用されます。ルール (include または exclude) が一致した場合、後続のチェックはすぐに停止します。

    --snapshot-path

    サポート

    サポートされていません

    --encoding-type

    入力パラメーターと出力パラメーターの両方に適用されます。

    • 高レベルのコマンドでは、このパラメーターは入力パラメーターにのみ適用され、出力結果には適用されません。

    • API レベルのコマンドでは、このパラメーターの意味は API 操作の対応するパラメーターと一致します。

    宛先の除外オプション

    --update のみをサポートします。

    --update、--size-only、--checksum、および --ignore-existing をサポートします。

    速度制限

    --max-speed オプションを使用したアップロード速度制限のみをサポートします。

    --bandwidth-limit オプションを使用したアップロードおよびダウンロード速度制限をサポートします。

    デフォルト設定

    署名アルゴリズム

    署名 V1 アルゴリズムを使用します。

    署名 V4 アルゴリズムを使用します。署名 V4 アルゴリズムを使用する場合、最大有効期間は 1 週間です。

    HTTPS プロトコル

    指定しない場合、デフォルトで HTTP プロトコルが使用されます。

    指定しない場合、デフォルトで HTTPS プロトコルが使用されます。

    オブジェクト一覧表示 API

    ListObjects API 操作を使用します。

    デフォルトで ListObjectsV2 API 操作を使用します。--list-objects オプションを使用して ListObjects API 操作に切り替えることができます。

    クライアントの読み取り/書き込みタイムアウト

    デフォルト値は 1200 秒です。

    デフォルトのタイムアウトは 20 秒です。

    クライアント接続タイムアウト

    デフォルトのクライアント接続タイムアウトは 120 秒です。

    デフォルトのクライアント接続タイムアウトは 10 秒です。

    再開可能なアップロード

    レジュームアップロードはデフォルトで有効になっています。

    レジュームアップロードはデフォルトで無効になっています。

ossutil 2.0

説明
  • Alibaba Cloud CLI の最新バージョンでは、ossutil 2.0 は最新バージョンへの自動チェックとアップグレードをサポートしています。update コマンドを実行する必要はありません。

  • ossutil 2.0 のバージョンは Alibaba Cloud CLI のバージョンとは独立しています。更新は CLI のバージョンに依存しません。

構文

Alibaba Cloud CLI における ossutil 2.0 のコマンド構文は次のとおりです。

aliyun ossutil command [argument] [flags]

aliyun ossutil command subcommond [argument] [flags]  

aliyun ossutil topic
  • argument: パラメーターで、文字列です。

  • flags: オプションです。ショートネームスタイル -o[=value]/ -o [value] とロングネームスタイル --options[=value]/--options[value] をサポートします。排他的なオプションを複数回指定した場合、最後の値のみが有効になります。

以下にコマンドの例を示します。

  • コマンド: aliyun ossutil cat oss://bucket/object

  • 複数レベルのコマンド: aliyun ossutil api get-bucket-cors --bucket bucketexample

  • ヘルパーコマンド: aliyun ossutil filter

コマンド

ossutil 2.0 は、高レベルコマンド、API レベルコマンド、補助コマンドの 3 種類のコマンドを提供します。

  • 高レベルコマンド: バケットの作成と削除、データのコピー、オブジェクト属性の変更など、オブジェクトやバケットに対する一般的な操作に使用されます。

    コマンド

    説明

    mb

    バケットを作成します。

    rb

    バケットを削除します。

    du

    バケットまたはディレクトリ (プレフィックス) のサイズをクエリします。

    stat

    バケットまたはオブジェクトの説明を表示します。

    mkdir

    名前が / 文字で終わるオブジェクトを作成します。

    append

    追加可能オブジェクトの末尾にコンテンツを追加します。

    cat

    オブジェクトのコンテンツを標準出力に送信します。

    ls

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

    cp

    オブジェクトをアップロード、ダウンロード、またはコピーします。

    rm

    オブジェクトを削除します。

    set-props

    オブジェクトの属性を設定します。

    presign

    オブジェクトの署名付き URL を生成します。

    restore

    凍結されたオブジェクトを復元します。

    revert

    オブジェクトを指定されたバージョンに戻します。

    sync

    ソースから宛先にディレクトリまたはオブジェクトを同期します。

    hash

    ファイルまたはオブジェクトのハッシュを計算します。

  • API レベルコマンド: API 操作への直接アクセスを提供し、対応する API 操作の設定パラメーターをサポートします。

    コマンド

    説明

    put-bucket-acl

    バケットの ACL を設定または変更します。

    get-bucket-acl

    バケットの ACL をクエリします。

    ....

    put-bucket-cors

    オリジン間リソース共有 (CORS) ルールを作成します。

    get-bucket-cors

    CORS ルールをクエリします。

    delete-bucket-cors

    CORS ルールを削除します。

    ...

  • 補助コマンド: ファイルの設定や追加のヘルプ情報へのアクセスなどのタスクに使用されます。

    コマンド

    説明

    help

    ヘルプ情報を取得します。

    config

    設定項目とアクセス資格情報を保存するための設定ファイルを作成します。

    version

    ossutil のバージョンを表示します。

    probe

    プローブタスクを実行します。

コマンドラインオプション

ossutil 2.0 のコマンドラインオプションは、グローバルオプションとローカルオプションに分かれています。グローバルオプションはすべてのコマンドに適用されます。ローカルオプションは特定のコマンドにのみ適用されます。コマンドラインオプションは最も高い優先順位を持ち、設定ファイルや環境変数で設定されたパラメーターを上書きできます。

コマンドラインオプションのクエリ

次のコマンドを実行して、コマンドラインオプションをクエリします。

ossutil cp -h

コマンド出力:

Flags:
      --acl string                         オブジェクトのアクセス制御リスト (ACL)、有効な値: "private"、"public-read"、"public-read-write"、"default"
      --bandwidth-limit SizeSuffix         帯域幅制限 (B/s)、またはサフィックス B|K|M|G|T|P を使用
      --bigfile-threshold SizeSuffix       ファイルサイズのしきい値。しきい値より大きいファイルサイズはマルチパートアップロード、ダウンロード、またはコピーを使用するか、サフィックス B|K|M|G|T|P を使用します (デフォルト 100Mi)
      --cache-control string               オブジェクトがダウンロードされたときの Web ページのキャッシュ動作
      --checkers int                       並列実行するチェッカーの数 (デフォルト 16)
      --checkpoint-dir string              ブレークポイント継続情報のための指定されたディレクトリ
      --checksum                           サイズとチェックサム (利用可能な場合) が異なるソースファイルのみをコピー
      --content-disposition string         オブジェクトへのアクセスに使用されるメソッド
      --content-encoding string            オブジェクトのエンコードに使用されるメソッド
      --content-type string                オブジェクトの MIME タイプ
      --copy-props string                  ソースオブジェクトからどのプロパティをコピーするかを決定します。有効な値: "none"、"metadata"、"default"
  -d, --dirs                               サブディレクトリのコンテンツの代わりに、一致するサブディレクトリ名を返します
      --encoding-type string               ユーザーが入力するオブジェクト名またはファイル名のエンコーディングタイプ、有効な値: "url"
      --end-with string                    リスト操作が終了するオブジェクトの名前 (含む)
      --exclude stringArray                パターンに一致するファイルを除外
      --exclude-from stringArray           ファイルから除外パターンを読み込む
      --expires string                     UTC でのキャッシュの有効期限
      --files-from stringArray             ファイルからソースファイル名のリストを読み込み、空白行とコメント行を無視します
      --files-from-raw stringArray         行の処理を行わずにファイルからソースファイル名のリストを読み込みます
      --filter stringArray                 ファイルフィルタリングルール
      --filter-from stringArray            ファイルからファイルフィルタリングルールを読み込む
  -f, --force                              ユーザーに操作の確認を求めずにサイレントに操作
      --ignore-existing                    宛先に既に存在するすべてのファイルをスキップ
      --include stringArray                パターンに一致するファイルを除外しない
      --include-from stringArray           ファイルからインクルードパターンを読み込む
  -j, --job int                            複数ファイル間の同時実行タスクの量 (デフォルト 3)
      --list-objects                       ListObjectsV2 の代わりに ListObjects を使用してオブジェクトをリスト
      --max-age Duration                   これより古いファイルを転送しない、s またはサフィックス ms|s|m|h|d|w|M|y (デフォルト off)
      --max-mtime Time                     これより新しいファイルを転送しない、UTC 時間フォーマット (デフォルト off)
      --max-size SizeSuffix                サイズより大きいファイルを転送しない、B またはサフィックス B|K|M|G|T|P、1K(KiB)=1024B
      --metadata strings                   オブジェクトのユーザーメタデータを指定、key=value 形式
      --metadata-directive string          宛先オブジェクトのメタデータを設定するために使用されるメソッド、有効な値: "COPY"、"REPLACE"
      --metadata-exclude stringArray       パターンに一致するメタデータを除外
      --metadata-filter stringArray        メタデータフィルタリングルール
      --metadata-filter-from stringArray   ファイルからメタデータフィルタリングルールを読み込む
      --metadata-include stringArray       パターンに一致するメタデータを除外しない
      --min-age Duration                   これより新しいファイルを転送しない、s またはサフィックス ms|s|m|h|d|w|M|y (デフォルト off)
      --min-mtime Time                     これより古いファイルを転送しない、UTC 時間フォーマット (デフォルト off)
      --min-size SizeSuffix                サイズより小さいファイルを転送しない、B またはサフィックス B|K|M|G|T|P、1K(KiB)=1024B
      --no-error-report                    バッチ操作中にエラーレポートファイルを生成しない
      --no-progress                        進行状況は表示されません
      --output-dir string                  出力ファイルを配置するディレクトリを指定します。出力ファイルには、バッチ操作中に生成されたエラーレポートファイルが含まれます (デフォルト "ossutil_output")
      --page-size int                      リスト操作の各応答で返される結果の数 (デフォルト 1000)、範囲 1 - 1000
      --parallel int                       ファイルで作業するときの同時実行タスクの量
      --part-size SizeSuffix               パートサイズ、デフォルトではファイルサイズに応じて適切なサイズを計算するか、サフィックス B|K|M|G|T|P を使用、範囲 100Ki - 5Gi
  -r, --recursive                          再帰的に操作します。オプションが指定されている場合、コマンドはバケットの下のすべての一致するオブジェクトに対して操作を行います。そうでない場合は、単一のオブジェクトに対して操作を行います。
      --request-payer string               リクエストの支払者。リクエスタに支払いたい場合はこの値を設定します。有効な値: "requester"
      --size-only                          サイズが異なるソースファイルのみをコピー
      --start-after string                 リスト操作が開始されるオブジェクトの名前 (含まない)
      --storage-class string               オブジェクトのストレージクラス、有効な値: "Standard"、"IA"、"Archive"、"ColdArchive"、"DeepColdArchive"
      --tagging strings                    宛先オブジェクトのタグを指定、key=value 形式
      --tagging-directive string           宛先オブジェクトのタグを設定するために使用されるメソッド、有効な値: "COPY"、"REPLACE"
  -u, --update                             ソースファイルが宛先ファイルより新しい場合にのみコピー

Global Flags:
  -i, --access-key-id string        oss へのアクセス中の AccessKeyID
  -k, --access-key-secret string    oss へのアクセス中の AccessKeySecret
      --addressing-style string     エンドポイントをアドレス指定するスタイル (デフォルト "virtual")、有効な値: "virtual"、"path"、"cname"
      --cloudbox-id string          クラウドボックスの ID。クラウドボックスのシナリオに適用されます
  -c, --config-file string          設定ファイルのパス (デフォルト "~/.ossutilconfig")
      --connect-timeout int         クライアント接続がタイムアウトしました、単位は: s (デフォルト 10)
  -n, --dry-run                     永続的な変更なしで試行実行
  -e, --endpoint string             他のサービスが OSS にアクセスするために使用できるドメイン名。
  -h, --help                        コマンドのヘルプ
      --language string             表示テキスト言語
      --log-file string             ログ出力ファイルを指定します。- の場合、Stdout に出力します
      --loglevel string             デバッグメッセージレベル (デフォルト "off")、有効な値: "off"、"info"、"debug"
      --mode string                 認証モードを指定します。有効な値: "AK"、"StsToken"、"EcsRamRole"、"Anonymous"
      --output-format string        コマンド出力のフォーマットスタイル (デフォルト "raw")
      --output-properties strings   出力フォーマットのプロパティ
      --output-query string         応答データのフィルタリングに使用する JMESPath クエリ
      --profile string              設定ファイルからの特定のプロファイル。
      --proxy string                プロキシサーバーを指定します。'env' の場合、HTTP_PROXY および HTTPS_PROXY 環境変数を使用します
  -q, --quiet                       静音モード、可能な限り少ないものを出力
      --read-timeout int            クライアントの読み取りがタイムアウトしました、単位は: s (デフォルト 20)
      --region string               バケットが配置されているリージョン。
      --retry-times int             失敗した場合のリトライ回数 (デフォルト 10)
      --role-arn string             ロールの ARN を指定します
      --role-session-name string    セッション名を指定します
      --sign-version string         署名アルゴリズムのバージョン (デフォルト "v4")、有効な値: "v1"、"v4"
      --skip-verify-cert            oss サーバーのデジタル証明書ファイルを検証しないことを指定します
  -t, --sts-token string            oss へのアクセス中の STSToken

コマンドラインオプションの使用

コマンドライン操作では、一部のコマンドは操作オブジェクトを指定したり、オプションを設定したりするために追加のパラメーターを必要とします。パラメーターを必要とするコマンドの場合、意図した機能を実現するために適切なパラメーター値を指定する必要があります。例:

ossutil ls --profile dev

ossutil ls --profile dev コマンドを使用すると、ユーザーはパラメーター値 dev を使用して特定の設定ファイルを指定できます。パラメーター付きのオプションは通常、オプション名とパラメーター値を区切るためにスペースまたは等号 (=) を必要とします。たとえば、--profile dev--profile=dev などです。パラメーター値にスペースが含まれている場合は、コマンドが正しく解析されるように、値全体を二重引用符で囲む必要があります。たとえば、--description "OSS bucket list" などです。

グローバルコマンドラインオプション

オプション

タイプ

説明

-i, --access-key-id

string

OSS へのアクセスに使用される AccessKey ID。

-k, --access-key-secret

string

OSS へのアクセスに使用される AccessKey シークレット。

--addressing-style

string

アドレッシングスタイル。有効な値:

  • virtual (デフォルト): 仮想ホスティングモード。

  • path: パスモード。

  • cname: カスタムドメイン名モード。

-c, --config-file

string

設定ファイルのパス。デフォルト値: ~\\.ossutilconfig

--connect-timeout

int

クライアント接続タイムアウト (秒)。デフォルト値: 10。単位: 秒。

-n, --dry-run

/

変更を加えずに試行実行します。

-e, --endpoint

string

リージョンのエンドポイント。

-h, --help

/

特定のコマンドのヘルプ情報を表示します。

--language

string

表示言語。

--loglevel

string

ログレベル。有効な値:

  • off (デフォルト)

  • info

  • debug

--mode

string

認証モード。有効な値:

  • AK: AccessKey ペア。

  • StsToken: 一時的なアクセス資格情報。

  • EcsRamRole: Elastic Compute Service (ECS) インスタンスにアタッチされた RAM ロール。

  • Anonymous: 匿名アクセス。

--output-format

string

出力フォーマット。デフォルト値: raw。

--output-query

string

JMESPath クエリ条件。

--profile

string

設定ファイル内のプロファイルを指定します。

-q, --quiet

/

静音モードを有効にして、最小限の情報を出力します。

--read-timeout

int

クライアントの読み取り/書き込みリクエストのタイムアウト。単位: 秒。デフォルト値: 20。

--region

string

データセンターが配置されているリージョン。例: cn-hangzhou。

--retry-times

int

エラー発生時のリトライ回数。デフォルト値: 10。

--sign-version

string

署名アルゴリズムのバージョン。有効な値:

  • v1

  • v4 (デフォルト)

--skip-verify-cert

/

サーバーから提供されたデジタル証明書を検証しないことを指定します。

-t, --sts-token

string

OSS へのアクセスに使用されるセキュリティトークンサービス (STS) トークン。

--proxy

string

プロキシサーバー。

設定方法:

  • 直接設定: プロキシサーバーを直接指定できます。例:

    • http://proxy.example.com:8080

    • https://proxy.example.com:8443

  • env: HTTP_PROXY および HTTPS_PROXY 環境変数を使用してプロキシサーバー情報を取得します。これらの環境変数をオペレーティングシステムで設定する必要があります。例:

    • HTTP_PROXY=http://proxy.example.com:8080

    • HTTPS_PROXY=https://proxy.example.com:8443

    これらの環境変数を設定した後、プロキシサーバーオプションの値を env に設定できます。すると、システムはこれらの環境変数で指定されたプロキシ設定を自動的に使用します。

--log-file

string

ログ出力ファイル。有効な値:

  • -: ログは stdout にエクスポートされます。

  • ファイルパス: 特定のファイルパスを指定すると、ログはそのファイルにエクスポートされます。

特定のファイルパスを指定しない場合、ログはデフォルトの設定ファイルにエクスポートされます。

--cloudbox-id 

string

CloudBox の ID。これは CloudBox のシナリオに適用されます。

オプションのタイプ

タイプ

オプション

説明

文字列

--option string

  • 文字列引数には、ASCII 文字セットの文字、数字、記号、およびスペースを含めることができます。

  • 文字列にスペースが含まれている場合は、引用符で囲みます。

例: --acl private

ブール値

--option

オプションをオンまたはオフにします。

例: --dry-run

整数

--option Int

このオプションは、値として符号なし整数を取ります。

例: --read-timeout 10

タイムスタンプ。

--option Time

ISO 8601 形式のタイムスタンプ (DateTime または Date)。

例: --max-mtime 2006-01-02T15:04:05

サイズサフィックス

--option SizeSuffix

サイズ単位。デフォルトの単位は B です。その他の単位には K (KiB)、M (MiB)、G (GiB)、T (TiB)、P (PiB)、E (EiB) があります。

たとえば、最小サイズ 1024 バイトは次のように指定できます。

--min-size 1024

--min-size 1K

時間単位

--option Duration

時間単位。デフォルトの単位は秒 (s) です。サポートされている時間単位は、ミリ秒 (ms)、秒 (s)、分 (m)、時間 (h)、日 (d)、週 (w)、月 (M)、年 (y) です。

数値は 10 進数にすることができます。

たとえば、最小時間単位 1.5 日は次のように指定できます。

--min-age 1.5d

文字列リスト

--option strings

コマンドでオプションを 1 回または複数回指定できます。オプションの各出現に対して、単一の値またはカンマ区切りの複数の値を指定できます。

例: --metadata user=jack,email=ja**@test.com --metadata address=china

文字列配列

--option stringArray

コマンドでオプションを 1 回または複数回指定できます。オプションの各出現に対して、1 つの値のみを指定できます。

例: --include *.jpg --include *.txt

ファイルからのデータ読み込み

ほとんどの場合、コマンドラインで直接パラメーター値を指定します。複雑な値を処理する必要がある場合、ファイルから値を読み込むと効率が向上します。コマンドを連結する場合、標準入力を使用してパラメーター値を指定する必要があります。パラメーターが異なる方法で値を取ることができる場合:

  • 値が file:// で始まる場合、データは指定されたファイルから読み込まれます。

  • 値が - の場合、データは標準入力から読み込まれます。

たとえば、JSON 形式で設定される CORS ルールを作成する場合、次のサンプルコマンドは、cors-configuration.json ファイルから CORS 設定を読み込んで CORS ルールを作成します。

{
  "CORSRule": {
    "AllowedOrigin": ["www.aliyun.com"],
    "AllowedMethod": ["PUT","GET"],
    "MaxAgeSeconds": 10000
  }
}
aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.json

次のサンプルコマンドは、コマンドラインで JSON 設定データを取得して CORS ルールを作成します。

{"CORSRule":{"AllowedOrigin":["www.aliyun.com"],"AllowedMethod":["PUT","GET"],"MaxAgeSeconds":10000}}
aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration  "{\"CORSRule\":{\"AllowedOrigin\":[\"www.aliyun.com\"],\"AllowedMethod\":[\"PUT\",\"GET\"],\"MaxAgeSeconds\":10000}}"

次のサンプルコマンドは、標準入力から設定を取得して CORS ルールを作成します。

cat cors-configuration.json | aliyun ossutil api put-bucket-cors --bucket examplebucket --cors-configuration -

コマンド出力の制御

出力フォーマット

du、stat、ls コマンドおよび api コマンドのサブコマンドで --output-format パラメーターを使用して、出力をフォーマットできます。次の表に、--output-format オプションの有効な値を示します。

フォーマット

説明

raw

生の形式で出力を返します。つまり、サーバーがコンテンツを返す形式です。

json

出力を JSON 形式で返します。

yaml

出力を YAML 形式で返します。

次の例では、get-bucket-cors コマンドの出力は生の形式です。

aliyun ossutil api get-bucket-cors --bucket bucketexample
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>www.aliyun.com</AllowedOrigin>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>GET</AllowedMethod>
    <MaxAgeSeconds>10000</MaxAgeSeconds>
  </CORSRule>
  <ResponseVary>false</ResponseVary>
</CORSConfiguration>

次の例では、出力は JSON でフォーマットされています。

aliyun ossutil api get-bucket-cors --bucket bucketexample --output-format json
{
  "CORSRule": {
    "AllowedMethod": [
      "PUT",
      "GET"
    ],
    "AllowedOrigin": "www.aliyun.com",
    "MaxAgeSeconds": "10000"
  },
  "ResponseVary": "false"
}

出力のフィルタリング

ossutil は、組み込みの JSON ベースの出力クエリメカニズムを提供します。--output-query value オプションを使用して出力をクエリできます。

説明

このオプションは、API コマンドセットのサブコマンドにのみ適用されます。

出力クエリ機能は JMESPath に基づいています。出力クエリ機能を使用すると、出力は JSON でフォーマットされ、JMESPath クエリ式に基づいてフィルタリングされ、指定された形式で返されます。JMEPath の詳細については、「JMESPath 仕様」をご参照ください。

次の例では、get-bucket-cors コマンドは AllowedMethod パラメーターの値のみを返します。

aliyun ossutil api get-bucket-cors --bucket bucketexample --output-query CORSRule.AllowedMethod --output-format json
[
  "PUT",
  "GET"
]

人間が読みやすい表示

ossutil は --human-readable オプションを提供しており、du および stat コマンドの出力のデータサイズと数量をより人間が読みやすい方法で表示できます。具体的には、データサイズは 1024 ベースの KiB、MiB、GiB、TiB、PiB で表示され、数量は 1000 ベースの単位略語 k、m、g、t、p を使用して表示されます。

Raw モードの例

aliyun ossutil stat oss://bucketexample
ACL                         : private
AccessMonitor               : Disabled
ArchiveObjectCount          : 2
ArchiveRealStorage          : 10
ArchiveStorage              : 131072
...
StandardObjectCount         : 119212
StandardStorage             : 66756852803
Storage                     : 66756852813
StorageClass                : Standard
TransferAcceleration        : Disabled

人間が読みやすいモードの例

aliyun ossutil stat oss://bucketexample --human-readable
ACL                         : private
AccessMonitor               : Disabled
ArchiveObjectCount          : 2
ArchiveRealStorage          : 10
ArchiveStorage              : 131.072k
...
StandardObjectCount         : 119.212k
StandardStorage             : 66.757G
Storage                     : 66.757G
StorageClass                : Standard
TransferAcceleration        : Disabled

コマンドのリターンコード

プロセスを使用して ossutil を呼び出すと、エコー情報をリアルタイムで表示できません。プロセスが終了すると、結果に基づいてリターンコードが表示されます。次のコマンドを実行して、以前に実行したコマンドのリターンコードを表示し、トラブルシューティングに使用できます。

Linux

echo $? コマンドを実行して、以前に実行したコマンドのリターンコードを表示します。

Windows

echo %errorlevel% コマンドを実行して、以前に実行したコマンドのリターンコードを表示します。

macOS

echo $? コマンドを実行して、以前に実行したコマンドのリターンコードを表示します。

リターンコード

説明

0

成功を示します。サーバーに送信されたリクエストは正常に処理され、サーバーはステータスコード 200 を返しました。

1

パラメーターエラーを示します。たとえば、必要なサブコマンドまたはパラメーターが欠落しているか、コマンドまたはパラメーターが不明です。

2

サーバーエラーを示します。コマンドはリクエストをサーバーに正常に送信しましたが、サーバーはエラー (2xx 以外のステータスコード) を返しました。

3

OSS SDK for Go の呼び出し中にサーバー側以外のエラーが発生したことを示します。

4

cp や rm コマンドなどを使用したバッチ処理での部分的な失敗を示します。

5

中断を示します。コマンドは Ctrl+C を使用してキャンセルされました。

  • 例 1: ローカルファイル upload.rar を bucket という名前のバケットに 20 MB/s の速度でアップロードします。デフォルトの単位はバイト/秒 (B/s) です。

    aliyun ossutil cp D:\\upload.rar oss://bucket/ --bandwidth-limit 20971520
  • 例 2: ローカルファイル file.rar を bucket という名前のバケットに 50 MB/s の速度でアップロードします。指定された単位はメガバイト/秒 (MB/s) です。

    aliyun ossutil cp D:\\file.rar oss://bucket/dir -r --bandwidth-limit 50M
  • 例 3: bucket という名前のバケットからオブジェクト download.rar を現在のディレクトリにダウンロードし、ダウンロード速度を 20 MB/s に制限します。

    aliyun ossutil cp oss://bucket/download.rar . --bandwidth-limit 20971520

ossutil 1.0

構文

aliyun oss [command] [args...] [options...]

コマンド

コマンド

説明

access-monitor

バケットのアクセストラッキング状態を指定します。

appendfromfile

アップロードされた追加可能オブジェクトにコンテンツを追加します。

bucket-cname

バケットの CNAME 設定を表示します。

bucket-encryption

バケットの暗号化設定を追加、変更、クエリ、または削除します。

bucket-policy

バケットのバケットポリシー設定を追加、変更、クエリ、または削除します。

bucket-tagging

バケットのタグ設定を追加、変更、クエリ、または削除します。

bucket-versioning

バケットのバージョン管理設定を追加またはクエリします。

cat

オブジェクトのコンテンツを ossutil に出力します。

config

OSS アクセス情報を保存するための設定ファイルを作成します。

cors

バケットの CORS 設定を追加、変更、クエリ、または削除します。

cors-options

バケットが指定されたクロスドメインアクセスリクエストを許可するかどうかをテストします。

cp

ファイルをアップロード、ダウンロード、またはコピーします。

create-symlink

シンボリックリンクを作成します。

du

指定されたバケット、オブジェクト、またはディレクトリのストレージ使用量をクエリします。

getallpartsize

バケット内の未完了のマルチパートアップロードタスクの各パートのサイズと、これらのパートの合計サイズをクエリします。

hash

ローカルファイルの CRC-64 または MD5 ハッシュを計算します。

help

コマンドに関するヘルプ情報をクエリします。コマンドの使用方法がわからない場合は、help コマンドを使用してそのコマンドのヘルプ情報を取得します。

inventory

バケットにインベントリ設定を追加するか、バケットのインベントリ設定をクエリ、リスト、削除します。

lifecycle

バケットにライフサイクル設定を追加するか、バケットのライフサイクル設定を変更、クエリ、削除します。

listpart

オブジェクトに対して開始された未完了のマルチパートアップロードタスクで生成されたパートをリストします。

logging

バケットにロギング設定を追加するか、バケットのロギング設定を変更、クエリ、削除します。

lrb

1 つまたは複数のリージョンにあるバケットをリストします。

ls

バケット、オブジェクト、またはパートをリストします。

mb

バケットを作成します。

mkdir

バケット内にディレクトリを作成します。

object-tagging

バケットにタグ付け設定を追加するか、オブジェクトのタグ付け設定を変更、クエリ、削除します。

probe

OSS へのアクセスを監視します。このコマンドを実行して、アップロードおよびダウンロードプロセス中のネットワーク障害または不正なパラメーター設定によって引き起こされる問題をトラブルシューティングすることもできます。

read-symlink

シンボリックリンクの説明を読み取ります。

referer

バケットにホットリンク保護設定を追加するか、バケットのホットリンク保護設定を変更、クエリ、削除します。

replication

バケットのクロスリージョンレプリケーション (CRR) 設定を管理します。

request-payment

バケットのリクエスト元支払いモードを設定するか、バケットのリクエスト元支払い設定をクエリします。

resource-group

バケットのリソースグループを設定し、リソースグループに関する情報をクエリします。

restore

オブジェクトを凍結状態から読み取り可能状態に復元します。

revert-versioning

削除されたオブジェクトをオブジェクトの最新バージョンに回復します。

rm

バケット、オブジェクト、またはパートを削除します。

set-acl

バケットまたはオブジェクトの ACL を設定します。

set-meta

アップロードされたオブジェクトのメタデータを設定します。

sign

オブジェクトの署名付き URL を生成し、ダウンロードまたはプレビューのためにサードパーティと共有します。

stat

指定されたバケットまたはオブジェクトの説明を取得します。

style

バケットの画像スタイルを設定します。

sync

ローカルファイルを OSS に、OSS オブジェクトをローカルディスクに、または OSS パス間でオブジェクトを同期します。

update

ossutil のバージョンを更新します。

website

バケットに静的 Web サイトホスティング、リダイレクト、または back-to-origin 設定を追加するか、バケットの静的 Web サイトホスティング、リダイレクト、または back-to-origin 設定を変更、クエリ、削除します。

worm

バケットに設定された保持ポリシーをクエリします。

  • 例 1: vmeixme という名前のバケットを作成し、バケットのストレージクラスを Standard に設定します。

    aliyun oss mb oss://vmeixme --storage-class Standard
  • 例 2: バケットに horse という名前のフォルダを作成できます。

    aliyun oss mkdir oss://vmeixme/horse/
  • 例 3: バケット、オブジェクト、パートを含む、アカウント下の OSS リソースをリストし、返される結果の最大数を 20 に設定します。

    aliyun oss ls --limited-num 20

よくある質問

ossutil の使用中にエラーが発生した場合は、次のトピックを参照してエラーをトラブルシューティングしてください。