chcloudaccountawss3
chcloudaccountawss3 コマンドは、(Amazon S3 ストレージを使用する) クラウド・アカウントのパラメーターまたはモードを変更するために使用します。
構文
>>- chcloudaccountawss3 -- --+-----------------+-- -------------> '- -name -- name -' >--+-------------------------------------+-- -------------------> '- -accesskeyid -- aws_access_key_id -' >--+---------------------------------------------+-- -----------> '- -secretaccesskey -- aws_secret_access_key -' >--+-------------------+-- -------------------------------------> '- -ignorefailures -' >--+--------------------------------------+-- ------------------> +- -mode --+- import -+---------------+ | '- normal -' | '- -importsystem -- import_system_id -' >--+---------------------------------------+-- -- -refresh -----> +- -certificate -- path_to_certificate -+ '- -nocertificate ----------------------' >-- --+----------------------------------------------+-- -------> '- -upbandwidthmbits-- upbandwidth_limit_in_mb-' >--+--------------------------------------------------+-- ------> '- -downbandwidthmbits-- downbandwidth_limit_in_mb-' >--+---------------------+-- --+--------------------------+---->< '- -resetusagehistory-' '-+- cloud_account_id ---+-' '- cloud_account_name -'
パラメーター
- -name name
- (オプション) 新規または変更されるクラウド・アカウント名を指定します。値は、英数字値であることが必要です。
- -accesskeyid aws_access_key_id
- (オプション) Amazon Web Services (AWS) アクセス・キーのパブリック部分の値を指定します。 このアクセス・キーを使用してクラウド・ストレージにアクセスします。
- -secretaccesskey aws_secret_access_key
- (オプション) Amazon Web Services (AWS) アクセス・キーのプライベート部分の値を指定します。 このアクセス・キーは、システムがクラウド・ストレージへのアクセスに使用する AWS ユーザー用です。
- -ignorefailures
- (オプション) 新しいアクセス・キーが機能するかどうかにかかわらず、アクセス・キーを変更します。
- -mode import | normal
- (オプション) 新規または変更されるクラウド・アカウント・モードを指定します。値は、import または normal です。
- -importsystem import_system_id
- (オプション) システムのデータがインポートされることを指定します。注: 最初に -mode import を指定する必要があります。
- -certificate path_to_certificate
- (オプション) 新規または変更されたクラウド・アカウント・ストレージに対する認証時に使用する SSL 証明書のパスを指定します。この値は、1 文字から 255 文字の英数字ストリング (base64 でエンコードされた PEM 形式) であることが必要です。
- -nocertificate
- (オプション) 新規または変更されるクラウド・アカウント・ストレージに対する認証に使用されたカスタム SSL 証明書を、システムを停止するために使用することを指定します。
- -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 の値は数値、名前の値は英数字ストリングでなければなりません。
説明
このコマンドは、Amazon S3 ストレージを使用する (mklcloudaccountawss3 を使用して作成された) クラウド・アカウントのパラメーターを変更します。
-mode パラメーター、-refresh パラメーター、およびいずれかのユーザー資格情報パラメーター・グループは同時に指定できません。
このコマンドは、提供した資格情報で認証が得られない場合は失敗し、何も変更されません。資格情報には次のものがあります。
- -accesskeyid
- -secretaccesskey
- -certificate または nocertificate
例えば、ネットワークがダウンすると、システムは、新しい秘密アクセス・キーが有効であることを確認できず、コマンドは失敗します。この機能を上書きするには、-ignorefailures を指定します。無効な資格情報を指定するときに、-ignorefailures を指定すると、オンラインのアカウントがオフラインになり、認証の失敗を記述するエラーがエラー・ログに生成されます。
秘密アクセス・キーは重要なシステム情報であり、暗号化形式で保管されます。システム・ダンプで使用不可であり、監査ログでは、6 つのハッシュ (「#」) シンボルで置き換えられます。
オフライン・アカウントに対してこのコマンドを指定し、これらの新しい詳細情報により、アカウントが機能し始める場合 (例えば、期限切れのパスワードを入力すると)、アカウントがオンラインになります。
アカウントがシステム・ボリュームで使用されていない場合のみ、モードを変更できます。モードの変更には、アカウントがオンラインであり、システムがクラウド・サーバーと通信できることが必要です。
注: 最大で以下のものを備えることができます。
- クラスター化システム (システム) あたり 1 つのクラウド・アカウント
- クラウド・スナップショットが有効になった 1024 個のボリューム
- ボリュームあたり 256 個のクラウド・スナップショット
- 512 ボリューム・グループ
呼び出し例
chcloudaccountawss3 -name myamazon cloudaccount0結果出力:
No feedback呼び出し例
chcloudaccountawss3 -mode import -importsystem 000002007D40A162 0結果出力:
No feedback呼び出し例
chcloudaccountawss3 -upbandwidthmbits 100 -downbandwidthmbits 100 cloudaccount0結果出力:
No feedback