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 鑑別。值為 yesno
-endpoint https_endpoint_URL
(選用)針對雲端帳戶,指定要變更的 URL(系統用來存取物件儲存體)。如果使用 OpenStack Keystone 鑑別,則指定的 URL 必須是 Keystone 鑑別的 URL。如果未使用 Keystone 鑑別,則指定的 URL 必須是 Swift 帳戶的 URL。值必須是 8 - 128 個字元,且必須是有效的 URL 位址。
-username user_name
(選用)指定 OpenStack 使用者名稱,系統必須利用它來存取雲端帳戶儲存體。
-password password
(選用)指定用來向雲端儲存體鑑別的密碼值。以 IBM Cloud™ 帳戶而言,這個密碼是應用程式設計介面 (API) 金鑰。值必須是 1 - 64 個英數字元,且開頭或結尾不能是空格。
-certificate path_to_certificate
(選用)指定向新的或已修改的雲端帳戶儲存體鑑別時,所要使用之 SSL 憑證的路徑。值必須是 1 - 255 個字元的英數字串(base64 編碼 PEM 格式)。
-nocertificate
(選用)指定使用自訂 SSL 憑證來停止系統,而該憑證先前用於向新的或已修改的雲端帳戶儲存體鑑別。
-ignorefailures
(選用)指定不論新的存取金鑰是否有效,一律變更存取金鑰。
-mode import | normal
(選用)指定新的或已修改的雲端帳戶模式。值為 importnormal
-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 來建立)的參數。

必須至少設定一個參數。

-mode 參數、-refresh 參數及任何使用者認證參數群組都是互斥的。認證包括:
  • -keystone
  • -endpoint
  • -username
  • -password
  • -certificatenocertificate

如果提供的鑑別認證不成功,這個指令會失敗。比方說,如果網路中斷,則系統無法確認 secretaccesskey 是否有效(指令會失敗)。請指定 -ignorefailures 來置換這個特性。如果您指定不正確的認證,但指定 -ignorefailures 參數,則線上帳戶會變成離線,日誌中會產生錯誤來說明鑑別失敗。

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

如果提供憑證,且指令成功,則會從本端檔案系統中刪除憑證檔。

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

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

註: 您最多可以有:
  • 每個系統一個雲端帳戶
  • 1024 個已啟用雲端 Snapshot 的磁區
  • 每一磁區 256 個雲端 Snapshot
  • 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