chcloudaccountswift

chcloudaccountswift コマンドを使用して、(OpenStack Swift ストレージを使用する) クラウド・アカウントのパラメーターまたはモードを変更します。

構文


>>- chcloudaccountswift -- --+-----------------+-- ------------->
                             '- -name -- name -'      

>--+------------------------+-- -------------------------------->
   '- -keystone --+- yes -+-'      
                  '- no --'        

>--+-----------------------------------+-- --------------------->
   '- -endpoint -- https_endpoint_URL -'      

>--+--------------------------+-- ------------------------------>
   '- -username -- user_name -'      

>--+-------------------------+-- ------------------------------->
   '- -password -- password -'      

>--+---------------------------------------+-- ----------------->
   +- -certificate -- path_to_certificate -+      
   +- -------------------------------------+      
   '- -nocertificate ----------------------'      

>--+-------------------+-- --+-----------------------+-- ------->
   '- -ignorefailures -'     '- -mode  --+-import -+-'      
                                         '-normal -'        

>--+--------------------------------------+-- -- -refresh -- --->
   '- -importsystem  -- import_system_id -'                     

>--+---------------------+-- -- -------------------------------->
   '- -resetusagehistory-'         

>--+--------------------------------------------------+-- ------>
   '- -downbandwidthmbits-- downbandwidth_limit_in_mb-'      

>--+----------------------------------------------+-- ---------->
   '- -upbandwidthmbits-- upbandwidth_limit_in_mb-'      

>--+--------------------------+--------------------------------><
   '-+- cloud_account_id ---+-'   
     '- cloud_account_name -'

パラメーター

-name name: (オプション) クラウド・アカウント・ストレージにアクセスするのに使用する必要がある新規または変更済みの OpenStack 名を指定します。値は、英数字値であることが必要です。
-keystone yes | no: (オプション) keystone 認証を使用することを指定します。値は yes または no です。
-endpoint https_endpoint_URL: (オプション) クラウド・アカウントの変更する URL (システムがオブジェクト・ストレージにアクセスするのに使用する) を指定します。OpenStack Keystone 認証が使用される場合、指定される URL は、Keystone 認証用の URL でなければなりません。Keystone 認証が使用されない場合、指定される URL は、Swift アカウント用の URL でなければなりません。この値は、8 文字から 128 文字で、有効な URL アドレスであることが必要です。
-username user_name: (オプション) システムがクラウド・アカウント・ストレージへのアクセスに使用する必要がある OpenStack ユーザー名を指定します。
-password password: (オプション) クラウド・ストレージに対して認証するのに使用するパスワード値を指定します。IBM® SoftLayer® アカウントの場合、このパスワードはアプリケーション・プログラミング・インターフェース (API) 鍵です。この値は 1 文字から 64 文字の英数字であることが必要で、先頭や末尾にスペースがあってはなりません。
-certificate path_to_certificate: (オプション) 新規または変更されるクラウド・アカウント・ストレージに対する認証時に使用する SSL 証明書のパスを指定します。この値は、1 文字から 255 文字の英数字ストリング (base64 でエンコードされた PEM 形式) であることが必要です。
-nocertificate: (オプション) 新規または変更されるクラウド・アカウント・ストレージに対する認証に使用されたカスタム SSL 証明書を、システムを停止するために使用することを指定します。
-ignorefailures: (オプション) 新しいアクセス・キーが機能するかどうかにかかわらず、アクセス・キーが変更されることを指定します。
-mode import | normal: (オプション) 新規または変更されるクラウド・アカウント・モードを指定します。値は、import または normal です。
-importsystem import_system_id: (オプション) システムのデータがインポートされることを指定します。
注: 最初に -mode import を指定する必要があります。
-refresh: (オプション) システム・インポート候補のリフレッシュを指定します。アカウントが import モードである場合、これは、インポートに使用可能なデータのリフレッシュを指定します。
-downbandwidthmbits downbandwidth_limit_in_mb: (オプション) ダウンロード帯域幅の制限をメガバイト/秒 (Mbps) で指定します。この値は 1 から 10240 までの数値でなければなりません。
-upbandwidthmbits upbandwidth_limit_in_mb: (オプション) アップロード帯域幅の制限をメガバイト/秒 (Mbps) で指定します。この値は 1 から 10240 までの数値でなければなりません。
-resetusagehistory: (オプション) 使用履歴を (0 に) リセットします。クラウド・アカウントで使用されるスペースを表すストレージ使用量は累積します。つまり、現在の日の行 (0th 行) にとどまります。
cloud_account_id | cloud_account_name: (必須) 変更するクラウド・アカウント ID または名前を指定します。ID の値は数値、名前の値は英数字ストリングでなければなりません。

説明

このコマンドは、OpenStack Swift ストレージを使用するクラウド・アカウント (mklcloudaccountswift コマンドを使用して作成されたもの) のパラメーターを変更します。

少なくとも 1 つのパラメーターを設定する必要があります。

-mode パラメーター、-refresh パラメーター、およびいずれかのユーザー資格情報パラメーター・グループは同時に指定できません。資格情報には次のものがあります。

-keystone
-endpoint
-username
-password
-certificate または nocertificate

指定された認証資格情報が失敗する場合、このコマンドは失敗します。例えば、ネットワークがダウンすると、システムは、secretaccesskey が有効であることを確認できません (コマンドは失敗します)。これをオーバーライドするには、-ignorefailures を指定します。誤った資格情報と -ignorefailures パラメーターを指定すると、オンラインのアカウントがオフラインになり、認証の失敗を記述するエラーがログに生成されます。

パスワードは、機密のシステム情報として扱われます。暗号化形式で保管され、システム・ダンプでは使用できません。監査ログでは、6 つのハッシュ (「#」) シンボルで置き換えられます。

証明書が提供され、コマンドが成功すると、証明書ファイルはローカル・ファイル・システムから削除されます。

オフライン・アカウントに対してこのコマンドを指定し、これらの新しい詳細情報により、アカウントが機能し始める場合 (例えば、期限切れのパスワードを入力すると)、アカウントがオンラインになります。

アカウントがシステム・ボリュームで使用されていない場合、モードを変更できます。モードの変更には、アカウントがオンラインであり、システムがクラウド・サーバーと通信できることが必要です。

注: 最大で以下のものを備えることができます。

クラスター化システム (システム) あたり 1 つのクラウド・アカウント
クラウド・スナップショットが有効になった 1024 個のボリューム
ボリュームあたり 256 個のクラウド・スナップショット
512 ボリューム・グループ

呼び出し例

chcloudaccountswift -certificate /tmp/new-cert.pem -ignorefailures myswift

結果出力:

No feedback

呼び出し例

chcloudaccountswift -mode import -importsystem 000002007D40A162 0

結果出力:

No feedback

呼び出し例

chcloudaccountawss3 -username newuser -password simpsons 0

結果出力:

No feedback

呼び出し例

chcloudaccountswift -upbandwidthmbits 100 -downbandwidthmbits 100 cloudaccount0

結果出力:

No feedback