インストールおよび構成

このプラグインは、64 ビット・プロセッサーで稼働する Linux (x86_64、 arm64、 ppc64le、 s390x)、Windows ® (x64)、および macOS® (amd64、 arm64) プラットフォームと互換性があります。

plugin install コマンドを使用してプラグインをインストールします。

ibmcloud plugin install cloud-object-storage

プラグインがインストールされたら、 ibmcloud cos config コマンドを使用してプラグインを構成できます。 これを使用して、資格情報、デフォルトのダウンロード場所、認証の選択などをプラグインに入力できます。

最適なパフォーマンスを得るには、 IBMCLOUD_TRACE 環境変数を false に設定して、トレースを無効にします。

このプログラムは、ダウンロードしたファイルのデフォルト・ローカル・ディレクトリーを設定したり、デフォルト地域を設定したりする機能も備えています。 デフォルトのダウンロード場所を設定するには、ibmcloud cos config ddl と入力し、プログラムに有効なファイル・パスを入力します。 デフォルト地域を設定するには、ibmcloud cos config region と入力し、us-south などの地域コードをプログラムに入力します。 デフォルトでは、この値は us-geo に設定されます。

現在のIBM Cloud Object Storageプロンプトによる資格情報 ibmcloud cos config list。 構成ファイルはプラグインによって生成されるため、ファイルを手動で編集しないことをお勧めします。

$ ibmcloud cos config list
Key                     Value
Last Updated            Tuesday, April 28 2020 at 19:35:57
Default Region          us-south
Download Location       /home/ibmuser/Downloads
CRN                     8f275e7b-c076-49e2-b9c5-f985704cf678
AccessKeyID             9eib1eejar6HaezaohveV5hikei4aNg2ooV0qu
SecretAccessKey         ********************************************
Authentication Method   IAM
URL Style               VHost

$ ibmcloud resource service-instance 'My Awesome Cloud Object Storage'  --id
Retrieving service instance My Awesome Cloud Object Storage in all resource groups under account IBM as ibmuser@us.ibm.com...
crn:v1:bluemix:public:cloud-object-storage:global:a/94400e98c553415c9599db39b9be9219:3b7d66c8-9fdf-4f81-b7e6-08d187f07288:: 8f275e7b-c076-49e2-b9c5-f985704cf678

$ ibmcloud cos config crn
Resource Instance ID CRN:  ()> 8f275e7b-c076-49e2-b9c5-f985704cf678
Saving new Service Instance ID...
OK
Successfully stored your service instance ID.

$ ibmcloud cos config crn --list
Key   Value
CRN   8f275e7b-c076-49e2-b9c5-f985704cf678

コマンド・ライン・インターフェースでトレースを使用可能にする

トレースを有効にするには、IBMCLOUD_TRACE環境変数をtrue に設定します(大/小文字は無視されます)。 トレースを有効にすると、追加のデバッグ情報が端末に出力されます。

Linux/macOS 端末の場合:

export IBMCLOUD_TRACE=true

Windows プロンプトの場合:

SET IBMCLOUD_TRACE=true

トレースを無効にするには、IBMCLOUD_TRACE環境変数をfalse に設定します(大/小文字は無視されます)。

コマンド索引

各操作には、その機能、使用方法、オプションまたは必須のパラメータについての説明があります。 リストされているすべてのパラメーターは、オプションと示されていない限り、必須です。

CLI プラグインは、 Object Storageで使用可能なすべての機能をまだサポートしていません。 Aspera High-Speed Transfer、Immutable Object Storage、 Key Protect バケットの作成、またはバケット・ファイアウォールは、CLI では使用できません。

マルチパート・アップロードの中止

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットへのアップロードを終了して、マルチパート・アップロード・インスタンスを中止します。
• 使用法: ibmcloud cos multipart-upload-abort --bucket BUCKET_NAME --key KEY --upload-id ID [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • マルチパート・アップロードを識別するアップロード ID。
    • フラグ: --upload-id ID
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

静的 Web サイトの構成

• アクション: 静的 Web サイトをホストするようにバケットを構成します。

• 使用法: ibmcloud cos bucket-website-put --bucket BUCKET_NAME [--region REGION] [--output FORMAT]

• 指定するパラメーター:

  • バケットの名前。

    • フラグ: --bucket BUCKET_NAME

  • JSON 構造の形式での Web サイト構成。 file:// 接頭部は、指定されたファイル ( --website-configuration file://<filename.json> など) から JSON 構造をロードするために使用されます。

    • フラグ: --website-configuration STRUCTURE Web サイトの静的動作を構成するために、以下のパラメーターを使用できます。 何も必要ありません。 詳しくは、 資料を参照してください。

      {
        "ErrorDocument": {
          "Key": "string"
        },
        "IndexDocument": {
          "Suffix": "string"
        },
        "RoutingRules": [
          {
            "Condition": {
              "HttpErrorCodeReturnedEquals": "string",
              "KeyPrefixEquals": "string"
            },
            "Redirect": {
              "HostName": "string",
              "HttpRedirectCode": "string",
              "Protocol": "http"|"https",
              "ReplaceKeyPrefixWith": "string",
              "ReplaceKeyWith": "string"
            }
          }
          ...
        ]
      }
      

      あるいは、バケット Web サイトがトラフィックをリダイレクトするように構成されている場合は、構成されている唯一のパラメーターでなければなりません。

      	  "RedirectAllRequestsTo": {
      	    "HostName": "string",
      	    "Protocol": "http"|"https"
      	  }
      	  ```
      
      
      

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。

    • フラグ: --region REGION

  • オプション: 出力形式は json または text のみです。

    • フラグ: --output FORMAT

バケットからのオブジェクトのコピー

( --metadata フィーチャーを使用して) コピー中にメタデータをオブジェクトに追加する場合は、属性 --metadata-directive REPLACE を追加する必要があります。これは、操作中にデフォルトでメタデータがコピーされるためです (暗黙的な --metadata-directive COPY)。

• アクション: オブジェクトをソース・バケットから宛先バケットにコピーします。
• 使用法: ibmcloud cos object-copy --bucket BUCKET_NAME --key KEY --copy-source SOURCE [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--metadata MAP] [--metadata-directive DIRECTIVE] [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • 宛先バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • (SOURCE) ソース バケットの名前とソース オブジェクトのキー名。スラッシュ (/) で区切られます。URL エンコードされている必要があります。
    • フラグ: --copy-source SOURCE
  • オプション: 指定する CACHING_DIRECTIVES リクエストと応答のチェーン用。
    • フラグ: --cache-control CACHING_DIRECTIVES
  • オプション: プレゼンテーション情報を指定します（DIRECTIVES ）。
    • フラグ: --content-disposition DIRECTIVES
  • オプション: オブジェクトに適用されるコンテンツ エンコーディング (CONTENT_ENCODING) を指定し、Content-Type ヘッダー フィールドによって参照されるメディア タイプを取得するために適用する必要があるデコード メカニズムを指定します。
    • フラグ: --content-encoding CONTENT_ENCODING
  • オプション: コンテンツの言語。
    • フラグ: --content-language LANGUAGE
  • オプション: オブジェクト データの形式を記述する標準 MIME タイプ。
    • フラグ: --content-type MIME
  • オプション: エンティティタグ(Etag ) は指定されたタグ (ETAG ）。
    • フラグ: --copy-source-if-match ETAG
  • オプション: 指定された時刻 (TIMESTAMP) 以降に変更されている場合、オブジェクトをコピーします。
    • フラグ: --copy-source-if-modified-since TIMESTAMP
  • オプション: エンティティタグ(ETag ) は指定されたタグ (ETAG ）。
    • フラグ: --copy-source-if-none-match ETAG
  • オプション: 指定された時刻 (TIMESTAMP) 以降に変更されていない場合はオブジェクトをコピーします。
    • フラグ: --copy-source-if-unmodified-since TIMESTAMP
  • オプション: 保存するメタデータの MAP。
    • フラグ: --metadata MAP JSON 構文: --metadata フラグは、指定されたファイルから JSON 構造をロードするために使用される file:// 接頭部を取ります。

      {
        "file_name": "file_20xxxxxxxxxxxx45.zip",
        "label": "texas",
        "state": "Texas",
        "Date_to": "2019-11-09T16:00:00.000Z",
        "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
        "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
      }
      ```

   * _Optional_: Specifies whether the metadata is copied from the source object or replaced with metadata provided in the request. DIRECTIVE values: COPY,REPLACE.
        * Flag: ` --metadata-directive DIRECTIVE`
    * _Optional_: The REGION where the bucket is present. If this flag is not provided, the program uses the default option that is specified in config.
        * Flag: `--region REGION`
    * _Optional_: Output FORMAT can be only json or text.
        * Flag: `--output FORMAT`

新規バケットの作成

• アクション: IBM Cloud Object Storage インスタンスにバケットを作成します。
• 使用法: ibmcloud cos bucket-create --bucket BUCKET_NAME [--class CLASS_NAME][--class onerate_active] [--ibm-service-instance-id ID] [--region REGION] [--output FORMAT]
  • なお、IAM 認証を使用する場合は CRN を指定する必要があります。 これは、 ibmcloud cos config crn コマンドを使用して設定できます。
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: クラスの名前。
    • フラグ: --class CLASS_NAME
  • ユーザーはバケットを作成するときに onerate_active を指定する必要があります。
    • フラグ: --class onerate_active
  • オプション: 設定しますIBMリクエスト内のサービス インスタンス ID。
    • フラグ: --ibm-service-instance-id ID
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:staging:public:kms:us-south:a/9978e0xxxxxxxxxxxxxxxxxxxxxx8654:dfdxxxxx-xxxx-xxxx-xxxx-xxxxxxba6eb0:key:7cea005e-75d4-4a08-ad2f-5e56141f6a96 --kms-encryption-algorithm AES256

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:bluemix:public:hs-crypto:us-south:a/ee747e4xxxxxxxxxxxxxxxxxxxxxx7559:ac6xxxxx-xxxx-xxxx-xxxx-xxxxxx1bea99:key:e7451f36-d7ea-4f55-bc1c-ce4bcceb7018

新規マルチパート・アップロードの作成

• アクション: 新規マルチパート・アップロード・インスタンスを作成して、マルチパート・ファイル・アップロード・プロセスを開始します。

• 使用法: ibmcloud cos multipart-upload-create --bucket BUCKET_NAME --key KEY [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

• 指定するパラメーター:

  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • オプション: 指定する CACHING_DIRECTIVES リクエストと応答のチェーン用。
    • フラグ: --cache-control CACHING_DIRECTIVES
  • オプション: プレゼンテーション情報を指定します（DIRECTIVES ）。
    • フラグ: --content-disposition DIRECTIVES
  • オプション: コンテンツのエンコーディングを指定します（CONTENT_ENCODING ) のオブジェクトです。
    • フラグ: --content-encoding CONTENT_ENCODING
  • オプション: コンテンツの言語。
    • フラグ: --content-language LANGUAGE
  • オプション: オブジェクト データの形式を記述する標準 MIME タイプ。
    • フラグ: --content-type MIME
  • オプション: 保存するメタデータの MAP。
    • フラグ: --metadata MAP JSON 構文: --metadata フラグは、指定されたファイルから JSON 構造をロードするために使用される file:// 接頭部を取ります。

  {
    "file_name": "file_20xxxxxxxxxxxx45.zip",
    "label": "texas",
    "state": "Texas",
    "Date_to": "2019-11-09T16:00:00.000Z",
    "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
    "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
  }
  

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

既存のバケットの削除

• アクション: IBM Cloud Object Storage インスタンス内の既存のバケットを削除します。
• 使用法: ibmcloud cos bucket-delete --bucket BUCKET_NAME [--region REGION] [--force] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 操作では確認を求められません。
    • フラグ: --force
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

バケット CORS の削除

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットの CORS 構成を削除します。
• 使用法: ibmcloud cos bucket-cors-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

静的 Web サイト構成の削除

• アクション: バケットの静的 Web サイト構成を削除します。
• 使用法: ibmcloud cos bucket-website-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 指定するパラメーター:

  • バケットの名前。

    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトの削除

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットから 1 つのオブジェクトを削除します。
• 使用法: ibmcloud cos object-delete --bucket BUCKET_NAME --key KEY [--region REGION] [--force] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 操作では確認を求められません。
    • フラグ: --force
    • オプション: 出力形式は json または text のみです。
      • フラグ: --output FORMAT

複数のオブジェクトの削除

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットから複数のオブジェクトを削除します。

• 使用法: ibmcloud cos objects-delete --bucket BUCKET_NAME --delete STRUCTURE [--region REGION] [--output FORMAT]

• 指定するパラメーター:

  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • 省略構文または JSON 構文のいずれかを使用する構造 (STRUCTURE)。
    • フラグ: --delete STRUCTURE
    • 省略構文: --delete 'Objects=[{Key=string},{Key=string}],Quiet=boolean'

    • JSON 構文: --delete file://<filename.json>

      --delete コマンドは、削除するオブジェクトをリストする JSON 構造を取ります。 この例では、file:// 接頭部を使用して、指定したファイルから JSON 構造をロードします。

  	{
  	"Objects": [
  	{
  	"Key": "string",
  	"VersionId": "string"
  	}
  ...
  	],
  	"Quiet": true|false
  	}
  

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトのダウンロード

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットから 1 つのオブジェクトをダウンロードします。
• 使用法: ibmcloud cos object-get --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • オプション: エンティティタグ(ETag ）は、ETAG 指定されていない場合は 412 (前提条件が失敗) を返します。
    • フラグ: --if-match ETAG
  • オプション: 指定された TIMESTAMP 以降に変更された場合にのみオブジェクトを返し、それ以外の場合は 304 (変更されていない) を返します。
    • フラグ: --if-modified-since TIMESTAMP
  • オプション: エンティティタグ(ETag ）は、ETAG 指定されていない場合は 304 (変更なし) を返します。
    • フラグ: --if-none-match ETAG
  • オプション: 指定された TIMESTAMP 以降に変更されていない場合にのみオブジェクトを返し、そうでない場合は 412 (前提条件が失敗) を返します。
    • フラグ: --if-unmodified-since TIMESTAMP
  • オプション: オブジェクトの指定された RANGE バイトをダウンロードします。
    • フラグ: --range RANGE
  • オプション: レスポンスのCache-Control HEADERを設定します。
    • フラグ: --response-cache-control HEADER
  • オプション: 応答の Content-Disposition HEADER を設定します。
    • フラグ: --response-content-disposition HEADER
  • オプション: 応答の Content-Encoding ヘッダーを設定します。
    • フラグ: --response-content-encoding HEADER
  • オプション: レスポンスの Content-Language HEADER を設定します。
    • フラグ: --response-content-language HEADER
  • オプション: レスポンスの Content-Type ヘッダーを設定します。
    • フラグ: --response-content-type HEADER
  • オプション: 応答の Expires ヘッダーを設定します。
    • フラグ: --response-expires HEADER
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT
  • オプション: オブジェクトの内容を保存する場所。 このパラメーターが指定されていない場合、プログラムはデフォルトの場所を使用します。
    • パラメーター: OUTFILE

バケットの検出

• アクション: IBM Cloud Object Storage インスタンス内のバケットの地域およびクラスを判別します。
• 使用法: ibmcloud cos bucket-location-get --bucket BUCKET_NAME [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

バケットのクラスの取得

• アクション: IBM Cloud Object Storage インスタンス内のバケットのクラスを判別します。
• 使用法: ibmcloud cos bucket-class-get --bucket BUCKET_NAME [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

バケット CORS の取得

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットの CORS 構成を返します。
• 使用法: ibmcloud cos bucket-cors-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

バケットのヘッダーの取得

• アクション: IBM Cloud Object Storage インスタンス内にバケットが存在しているかどうかを判別します。
• 使用法: ibmcloud cos bucket-head --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

マルチパート・アップロードの完了

• アクション: 現在アップロードされているパートをアセンブルし、そのファイルをユーザーの IBM Cloud Object Storage アカウント内のバケットにアップロードして、マルチパート・アップロード・インスタンスを完了します。
• 使用法: ibmcloud cos multipart-upload-complete --bucket BUCKET_NAME --key KEY --upload-id ID --multipart-upload STRUCTURE [--region REGION] [--output FORMAT]
• 指定するパラメーター:

  • バケットの名前。

    • フラグ: --bucket BUCKET_NAME

  • オブジェクトのキー。

    • フラグ: --key KEY

  • マルチパート・アップロードを識別するアップロード ID。

    • フラグ: --upload-id ID

  • 設定する MultipartUpload の構造 (STRUCTURE)。

    • フラグ: --multipart-upload STRUCTURE
    • 省略構文: --multipart-upload 'Parts=[{ETag=string,PartNumber=integer},{ETag=string,PartNumber=integer}]'

    • JSON 構文: --multipart-upload file://<filename.json>

      --multipart-upload コマンドは、完全なファイルに再アセンブルする必要があるマルチパート・アップロードのパートを記述する JSON 構造を取ります。 この例では、file:// 接頭部を使用して、指定したファイルから JSON 構造をロードします。

    		{
    		"Parts": [
    			{
    			 "ETag": "string",
    			 "PartNumber": integer
    			}
    			...
    			]
    		}
    

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。

    • フラグ: --region REGION

  • オプション: 出力形式は json または text のみです。

    • フラグ: --output FORMAT

プログラムの構成

• アクション: プログラムの設定を構成します。
• 使用法: ibmcloud cos config [COMMAND]
• コマンド:
  • HMAC と IAM の認証の間で切り替えます。
    • コマンド: auth
  • CRN を構成に保管します。
    • コマンド: crn
  • デフォルトのダウンロード場所を構成に保管します。
    • コマンド: ddl
  • HMAC 資格情報を構成に保管します。
    • コマンド: hmac
  • 構成をリストします。
    • コマンド: list
  • デフォルト地域を構成に保管します。
    • コマンド: region
  • 切り替える VHost およびパス URL スタイル。
    • コマンド: url-style
  • デフォルトのサービス・エンドポイントを設定します。
    • コマンド: endpoint-url

      • パラメーター:

        • --list は、現在のデフォルトのサービス・エンドポイントを表示します (設定されている場合)。 それ以外の場合は、空になります。
        • --url some.end.point.url は、サービス・エンドポイントを指定された値に変更します。
        • --clear は、設定されているデフォルトのサービス・エンドポイント URL を削除します。

静的 Web サイト構成の取得

• アクション: バケットの静的 Web サイト構成を取得します。
• 使用法: ibmcloud cos bucket-website-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 指定するパラメーター:

  • バケットの名前。

    • フラグ: --bucket BUCKET_NAME
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトのヘッダーの取得

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットにファイルが存在しているかどうかを判別します。
• 使用法: ibmcloud cos object-head --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • オプション: エンティティタグ(ETag ）は、ETAG 指定されていない場合は 412 (前提条件が失敗) を返します。
    • フラグ: --if-match ETAG
  • オプション: 指定された TIMESTAMP 以降に変更された場合にのみオブジェクトを返し、それ以外の場合は 304 (変更されていない) を返します。
    • フラグ: --if-modified-since TIMESTAMP
  • オプション: エンティティタグ(ETag ）は、ETAG 指定されていない場合は 304 (変更なし) を返します。
    • フラグ: --if-none-match ETAG
  • オプション: 指定された TIMESTAMP 以降に変更されていない場合にのみオブジェクトを返し、そうでない場合は 412 (前提条件が失敗) を返します。
    • フラグ: --if-unmodified-since TIMESTAMP
  • オブジェクトの指定した RANGE バイトをダウンロードします。
    • フラグ: --range RANGE
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

すべてのバケットのリスト表示

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のすべてのバケットのリストを出力します。 バケットは、異なる地域に存在している可能性があります。
• 使用法: ibmcloud cos buckets [--ibm-service-instance-id ID] [--output FORMAT]
  • なお、IAM 認証を使用する場合は CRN を指定する必要があります。 これは、 ibmcloud cos config crn コマンドを使用して設定できます。
• 指定するパラメーター:
  • 指定するパラメーターはありません。
    • オプション: 設定しますIBMリクエスト内のサービス インスタンス ID。
      • フラグ: --ibm-service-instance-id
    • オプション: 出力形式は json または text のみです。
      • フラグ: --output FORMAT

進行中のマルチパート・アップロードのリスト表示

• アクション: 進行中のマルチパート・アップロードをリストします。
• 使用法: ibmcloud cos multipart-uploads --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--key-marker value] [--upload-id-marker value] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: 区切り文字は、キーをグループ化するために使用する文字です。
    • フラグ: --delimiter DELIMITER
  • オプション: 応答内のオブジェクト キーをエンコードするように要求し、使用するエンコード メソッドを指定します。
    • フラグ: --encoding-type METHOD
  • オプション: 指定された PREFIX で始まるキーに応答を制限します。
    • フラグ: --prefix PREFIX
  • オプション: このパラメータは、upload-id-marker と一緒に、リスト表示を開始するマルチパートアップロードを指定します。
    • フラグ: --key-marker value
  • オプション: キーマーカーと一緒に、リスト表示を開始するマルチパートアップロードを指定します。 key-marker が指定されていない場合、upload-id-marker パラメーターは無視されます。
    • フラグ: --upload-id-marker value
  • オプション: サービス呼び出しで取得する各ページのサイズ。 これは、コマンドの出力として返される項目の数には影響しません。 ページ・サイズをより小さく設定することで、各呼び出しで取得する項目が少なくなり、サービスに送られる呼び出し数が増えることになります。 これにより、サービス呼び出しがタイムアウトするのを防ぐことができます。(デフォルト: 1000)。
    • フラグ: --page-size SIZE
  • オプション: コマンドの出力で返される項目の合計数。 対象項目の合計数が指定した値を超える場合、コマンドの出力に NextToken が提供されます。 ページ区切りを再開するには、NextToken後続のコマンドの開始トークン引数の値。(デフォルト: 0)。
    • フラグ: --max-items NUMBER
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトのリスト表示

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットに存在するファイルをリストします。 この操作は現在、最近作成された 1000 個のオブジェクトに制限されており、フィルタリングできません。
• 使用法: ibmcloud cos objects --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--starting-token TOKEN] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: 区切り文字は、キーをグループ化するために使用する文字です。
    • フラグ: --delimiter DELIMITER
  • オプション: 応答内のオブジェクト キーをエンコードするように要求し、使用するエンコード メソッドを指定します。
    • フラグ: --encoding-type METHOD
  • オプション: 指定された PREFIX で始まるキーに応答を制限します。
    • フラグ: --prefix PREFIX
  • オプション: ページ区切りを開始する場所を指定するためのトークン。 これは以前に切り捨てられた応答からの NextToken です。
    • フラグ: --starting-token TOKEN
  • オプション: サービス呼び出しで取得する各ページのサイズ。 これは、コマンドの出力として返される項目の数には影響しません。 ページ・サイズをより小さく設定することで、各呼び出しで取得する項目が少なくなり、サービスに送られる呼び出し数が増えることになります。 これにより、サービス呼び出しがタイムアウトするのを防ぐことができます。(デフォルト: 1000)
    • フラグ: --page-size SIZE
  • オプション: コマンドの出力で返される項目の合計数。 対象項目の合計数が指定した値を超える場合、コマンドの出力に NextToken が提供されます。 ページ区切りを再開するには、NextToken後続のコマンドの開始トークン引数の値。(デフォルト: 0)
    • フラグ: --max-items NUMBER
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトのリスト v2

• アクション： 特定のバケット内のすべてのオブジェクトを一覧表示します。
• 使用法: list-objects-v2 --bucket BUCKET_NAME [--starting-token Starting Token] [--delimiter DELIMITER] [--encoding-type METHOD] [--fetch-owner Boolean] [--max-items NUMBER] [--prefix PREFIX] [--start-after Start After] [--page-size SIZE] [--region REGION] [--output FORMAT] [--json]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: 区切り文字は、キーをグループ化するために使用する文字です。
    • フラグ: --delimiter DELIMITER
  • オプション: 応答内のオブジェクト キーをエンコードするように要求し、使用するエンコード メソッドを指定します。
    • フラグ: --encoding-type METHOD
  • オプション: 指定された PREFIX で始まるキーに応答を制限します。
    • フラグ: --prefix PREFIX
  • オプション: ページ区切りを開始する場所を指定するためのトークン。 これは以前に切り捨てられた応答からの NextToken です。
    • フラグ: --starting-token TOKEN
  • オプション: サービス呼び出しで取得する各ページのサイズ。 これは、コマンドの出力として返される項目の数には影響しません。 ページ・サイズをより小さく設定することで、各呼び出しで取得する項目が少なくなり、サービスに送られる呼び出し数が増えることになります。 これにより、サービス呼び出しがタイムアウトするのを防ぐことができます。(デフォルト: 1000)
    • フラグ: --page-size SIZE
  • オプション: コマンドの出力で返される項目の合計数。 対象項目の合計数が指定した値を超える場合、コマンドの出力に NextToken が提供されます。 ページ区切りを再開するには、NextToken後続のコマンドの開始トークン引数の値。(デフォルト: 0)
    • フラグ: --max-items NUMBER
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT
  • オプション: ブール値は存在しませんlistV2デフォルトでは、結果の各キーとともに所有者フィールドを返す場合は、所有者フィールドの取得を true に設定します。
    • フラグ: --fetch-owner Boolean
  • オプション: 開始後が希望する場所ですS3リストを開始する場所。 S3 は、この指定されたキーの後からリストを開始します。 StartAfter は、バケット内の任意のキーにすることができます。
    • フラグ: --start-after Start After
  • 非推奨: 出力は生の JSON 形式で返されます。
    • フラグ: --json

パートのリスト

• アクション: 進行中のマルチパート・アップロード・インスタンスに関する情報を出力します。
• 使用法: ibmcloud cos parts --bucket BUCKET_NAME --key KEY --upload-id ID --part-number-marker VALUE [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 指定するパラメーター:
  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • マルチパート・アップロードを識別するアップロード ID。
    • フラグ: --upload-id ID
  • リスト表示を開始する前のパート番号値 (VALUE) (デフォルト: 1)
    • フラグ: --part-number-marker VALUE
  • オプション: サービス呼び出しで取得する各ページのサイズ。 これは、コマンドの出力として返される項目の数には影響しません。 ページ・サイズをより小さく設定することで、各呼び出しで取得する項目が少なくなり、サービスに送られる呼び出し数が増えることになります。 これにより、サービス呼び出しがタイムアウトするのを防ぐことができます。(デフォルト: 1000)
    • フラグ: --page-size SIZE
  • オプション: コマンドの出力で返される項目の合計数。 対象項目の合計数が指定した値を超える場合、コマンドの出力に NextToken が提供されます。 ページ区切りを再開するには、NextToken後続のコマンドの開始トークン引数の値。(デフォルト: 0)
    • フラグ: --max-items NUMBER
  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

バケット CORS の設定

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットの CORS 構成を設定します。

• 使用法: ibmcloud cos bucket-cors-put --bucket BUCKET_NAME [--cors-configuration STRUCTURE] [--region REGION] [--output FORMAT]

• 指定するパラメーター:

  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オプション: ファイル内で JSON 構文を使用する構造。
    • フラグ: --cors-configuration STRUCTURE

    • JSON 構文: --cors-configuration file://<filename.json>

      --cors-configuration コマンドは、CORS 構成を記述する JSON 構造を取ります。 この例では、file:// 接頭部を使用して、指定したファイルから JSON 構造をロードします。

  	{
  	"CORSRules": [
  	{
    	"AllowedHeaders": ["string", ...],
    	"AllowedMethods": ["string", ...],
    	"AllowedOrigins": ["string", ...],
    	"ExposeHeaders": ["string", ...],
    	"MaxAgeSeconds": integer
  	}
  	...
  	]
  	}
  

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

オブジェクトの配置

• アクション: ユーザーの IBM Cloud Object Storage アカウント内のバケットにオブジェクトをアップロードします。

• 使用法: ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

• 指定するパラメーター:

  • バケットの名前。
    • フラグ: --bucket BUCKET_NAME
  • オブジェクトのキー。
    • フラグ: --key KEY
  • オプション: オブジェクトデータの場所 (FILE_PATH ）。
    • フラグ: --body FILE_PATH
  • オプション: 指定する CACHING_DIRECTIVES リクエストと応答のチェーン用。
    • フラグ: --cache-control CACHING_DIRECTIVES
  • オプション: プレゼンテーション情報を指定します（DIRECTIVES ）。
    • フラグ: --content-disposition DIRECTIVES
  • オプション: コンテンツのエンコーディングを指定します（CONTENT_ENCODING ) です。
    • フラグ: --content-encoding CONTENT_ENCODING
  • オプション: コンテンツの言語。
    • フラグ: --content-language LANGUAGE
  • オプション: 本文のサイズ（バイト単位）。 このパラメータは、ボディのサイズを自動的に決定できない場合に便利です。(デフォルト: 0)
    • フラグ: --content-length SIZE
  • オプション: のbase64-encoded128ビットMD5データのダイジェスト。
    • フラグ: --content-md5 MD5
  • オプション: オブジェクト データの形式を記述する標準 MIME タイプ。
    • フラグ: --content-type MIME
  • オプション: 保存するメタデータの MAP。
    • フラグ: --metadata MAP JSON 構文: --metadata フラグは、指定されたファイルから JSON 構造をロードするために使用される file:// 接頭部を取ります。

  {
    "file_name": "file_20xxxxxxxxxxxx45.zip",
    "label": "texas",
    "state": "Texas",
    "Date_to": "2019-11-09T16:00:00.000Z",
    "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
    "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
  }
  

  • オプション: バケットが存在する REGION。 このフラグを設定しなかった場合、プログラムは構成に指定されたデフォルト・オプションを使用します。
    • フラグ: --region REGION
  • オプション: 出力形式は json または text のみです。
    • フラグ: --output FORMAT

マルチパート・アップロードの手動制御

のIBMCloud Object StorageCLIは、ユーザーが複数の部分を使用して大きなファイルをアップロードする機能を提供します。AWSマルチパートアップロード機能。 新しいマルチパートアップロードを開始するには、multipart-upload-create コマンドは、新しいアップロードインスタンスのアップロード ID を返します。 アップロード・プロセスを続行するには、後続の各コマンドのためにアップロード ID を保存する必要があります。 このコマンドでは、 MD5 ハッシュを生成する必要があります。

{object data} | openssl dgst -md5 -binary | openssl enc -base64

multipart-upload-complete コマンドを実行した後、アップロードするファイル・パートごとに part-upload を実行します。 マルチパートアップロードの場合、各ファイル部分（最後の部分を除く）は少なくとも 5 MB である必要があります。 ファイルを別々のパートに分割するには、端末ウィンドウで split を実行します。 例えば、デスクトップ上に TESTFILE という名前の 13 MB のファイルがあり、それぞれ 5 MB のファイル・パートに分割する場合は、split -b 3m ~/Desktop/TESTFILE part-file- を実行できます。 このコマンドは、3 つのファイル・パート (それぞれ 5 MB の 2 つのファイル・パートと、1 つの 3 MB のファイル・パート) を part-file-aa、part-file-ab、および part-file-ac という名前で生成します。 As each file part is uploaded, the CLI print its ETag . You must save this ETag into a formatted JSON file, along with the part number. Use this template to create your own ETag JSON データ・ファイル。

{
    "Parts": [
    {
      "PartNumber": 1,
      "ETag": "The ETag of the first file part goes here."
    },
    {
      "PartNumber": 2,
      "ETag": "The ETag of the second file part goes here."
    }
    ]
}

必要に応じて、この JSON テンプレートにさらに項目を追加します。

マルチパートアップロードインスタンスのステータスを確認するには、いつでも part-list バケット名、キー、アップロード ID を指定してコマンドを実行します。 これは、マルチパートアップロードインスタンスに関する生の情報を出力します。 ファイルの各部分のアップロードが完了したら、multipart-upload-complete 必要なパラメータを指定したコマンド。 すべてが正常に行われた場合、ファイルが目的のバケットに正常にアップロードされたことを示す確認が返されます。

オブジェクト・ロック構成

ibmcloud cos object-lock-configuration-put --bucket bucket-name --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 30 }}}'

ibmcloud cos object-lock-configuration-get --bucket bucket-name --region us-south

オブジェクト保存

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --retention '{ "Mode": "COMPLIANCE", "RetainUntilDate": "2024-02-02T00:00:00"}’

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --region us-south

オブジェクトの訴訟ホールド

ibmcloud cos object-legal-hold-put --bucket bucket-name --key file-name.txt --legal-hold ‘{"Status": "ON"}’

ibmcloud cos object-retention-get --bucket bucket-name --key file-name.txt --region us-south

バケット複製の構成

複製されたバケットを構成するためのセットアップ。

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME --replication-configuration file://replication.json

 ibmcloud cos bucket-replication-get --bucket SOURCE-BUCKET-NAME

 ibmcloud cos bucket-replication-delete --bucket SOURCE-BUCKET-NAME

次のステップ

すべてのプロシージャーは常に計画どおりに実行されるため、 共通ヘッダーおよびエラー・コード は表示されていない可能性があります。 詳しくは、 API リファレンス を参照してください。