ストレージ管理情報の登録コマンド(Google Cloud Storage)

Google Cloud Storageでの配信ストレージ管理情報または集信ストレージ管理情報をクラウドストレージDBに登録します。

ストレージ管理情報の登録コマンド

utlgsinfoadd [COMMON-OPTIONS] -t {snd|rcv} --id ID [MANAGEMENT-OPTIONS]

パラメータ説明

[COMMON-OPTIONS]

ユーティリティで共通のオプションです。

-r, --replace

置換(省略可)

既存の配信ストレージ管理情報または集信ストレージ管理情報を上書きします。

このオプションを指定しないで既存のストレージ管理情報を上書きしようとした場合は、エラーとなります。

注意

既存の配信ストレージ管理情報または集信ストレージ管理情報に上書きする場合、すでに設定されている値は[MANAGEMENT-OPTIONS]で指定してください。

設定済みの情報を再指定しなかった場合、未設定(Use the default value.)で上書きされます。

-f, --force

確認の省略(省略可)

登録する情報の確認を行わずに情報が登録されます。

既存の配信ストレージ管理情報または集信ストレージ管理情報が指定された場合、「-r」または「--replace」が指定されていなくても情報が上書きされます。

省略すると、配信ストレージ管理情報または集信ストレージ管理情報を登録する前に以下の確認のメッセージが表示されます。

Are you sure to register? [y/n]:

“y”または”Y”を入力すると、コマンドで指定した配信ストレージ管理情報または集信ストレージ管理情報が登録されます。

“y”または”Y”以外を入力した場合、エラーで終了されます。

[REQUIRED]

省略できないパラメータです。

-t, --type {snd|rcv}

管理情報の種別(省略不可)

登録したいストレージ管理情報の種別を指定します。

snd

: 配信ストレージ管理情報

rcv

: 集信ストレージ管理情報

--id ID

ID(省略不可)

転送するストレージを認識するためのIDです。

配信ストレージ管理情報の情報を登録する場合は、配信ストレージ管理情報IDを指定します。

集信ストレージ管理情報の情報を登録する場合は、集信ストレージ管理情報IDを指定します。

3バイトから63バイトまでのASCII印字可能文字で指定します。

半角スペース、「/」、「*」の文字が含まれていた場合はエラーとなります。

= 備考 =

配信ストレージ管理情報IDには、バケット名を指定することをお勧めします。配信履歴には、配信管理情報のファイル名に指定した配信ストレージ管理情報IDつまりバケット名が表示されます。

集信ストレージ管理情報IDには、バケット名を指定することをお勧めします。集信履歴には、集信管理情報のファイル名に指定した集信ストレージ管理情報IDつまりバケット名が表示されます。

[MANAGEMENT-OPTIONS]

配信ストレージ管理情報または集信ストレージ管理情報を設定するオプションです。

--bucket BUCKET

バケット名(省略可)

転送ファイルのアップロード先またはダウンロード元のバケット名を指定します。 バケット名は、「--id」でストレージ管理情報IDとして指定し、「--bucket」では指定しないことをお勧めします。同一のバケット名に対して、別の転送設定を行いたい場合などに指定してください。

3バイトから255バイトまでのASCII印字可能文字で指定します。

省略すると、未設定(Use the default value.)となります。未設定の場合、転送時には「--id」で指定したストレージ管理情報IDがバケット名として使用されます。

--timeout SEC

ストレージタイムアウト(秒)(省略可)

HTTPリクエストのタイムアウトになるまでの時間を指定します。

"10"~"259200"の範囲または"999999"で指定します。"999999"を指定すると無限待ちとなります。

省略すると、未設定(Use the default value.)となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

--parallels NUM

1転送あたりの最⼤並列数(省略可)

1つのファイル転送で並列アップロードまたは並列ダウンロードできる最大数を指定します。

ストレージ管理情報の種別に集信ストレージ管理情報を指定した場合は並列アップロードの最大数を指定します。配信ストレージ管理情報を指定した場合は並列ダウンロードの最大数を指定します。

"2"~"999"の範囲で指定します。

省略すると、未設定(Use the default value.)となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

= 備考 =

1転送あたりの最大並列数は、以下のとおりクラウドストレージ動作環境設定の全体並列数に制限されます。

  • クラウドストレージシステム動作環境設定のアップロード全体並列数より大きい値を設定しても、このアップロード全体並列数に制限されます。アップロード全体並列数以下になるように設定してください。

  • クラウドストレージシステム動作環境設定のダウンロード全体並列数より大きい値を設定しても、このダウンロード全体並列数に制限されます。ダウンロード全体並列数以下になるように設定してください。

--partsize MBYTES

パートサイズ(MB)(省略可)

1回の並列アップロードまたは並列ダウンロードあたりのパートのサイズを指定します。

"5"~"100"の範囲で指定します。

省略すると、未設定(Use the default value.)となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

注意

パートサイズを、未設定の場合の値の“5”を超えた値に変更すると、動作環境によってはシステムに高負荷がかかる場合があります。パートサイズを変更する場合は、ご注意ください。

--auth-id ID

ストレージ認証情報ID(省略可)

配信ストレージ管理情報まはた集信ストレージ管理情報に紐づけたいストレージ認証情報のIDを指定します。

3バイトから63バイトまでのASCII印字可能文字で指定します。

半角スペース、「/」、「*」の文字が含まれていた場合はエラーとなります。

省略すると、未設定(Use the default value.)となります。未設定の場合、転送時には配信ストレージ管理情報または集信ストレージ管理情報のデフォルト情報の設定値が使用されます。

補足

  • 以下のように、パラメータと設定値の間にはスペースまたはイコール(=)のどちらでも指定できます。

      --parameter Value
      --parameter=Value

  • パラメータに「-h」または「--help」を指定すると、Usageが表示されます。