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
(選用)指定新的或已修改的雲端帳戶模式。值為 importnormal
-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
  • -certificatenocertificate

比方說,如果網路中斷,則系統無法確認新的機密存取金鑰有效,這個指令會失敗。請指定 -ignorefailures 來改寫這個特性。如果您指定無效認證,但指定 -ignorefailures,則線上帳戶會變成離線,錯誤日誌中會產生錯誤來說明鑑別失敗。

機密存取金鑰是機密的系統資訊,以加密形式儲存。它不會出現在系統傾出中,在審核日誌中會取代為六個井字符號 ("#")。

如果您對離線帳戶指定這個指令,而這些新的詳細資料讓帳戶開始運作 (例如,您輸入到期密碼),則帳戶會變成線上。

如果沒有任何系統磁區使用帳戶,則您必須變更模式。帳戶必須在線上,且系統必須能夠與雲端伺服器通訊,才能變更模式。

註: 您最多可以有:
  • 每個系統有一個雲端帳戶。
  • 1024 個已啟用雲端 Snapshot 的磁區。
  • 每個磁區 256 個雲端 Snapshot。
  • 512 個磁區群組。

呼叫範例

chcloudaccountawss3 -name myamazon cloudaccount0

結果輸出:

No feedback

呼叫範例

chcloudaccountawss3 -mode import -importsystem 000002007D40A162 0

結果輸出:

No feedback

呼叫範例

chcloudaccountawss3 -upbandwidthmbits 100 -downbandwidthmbits 100 cloudaccount0

結果輸出:

No feedback