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 Cloud™ 帳戶而言,這個密碼是應用程式設計介面 (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 來建立)的參數。
必須至少設定一個參數。
-mode 參數、-refresh 參數及任何使用者認證參數群組都是互斥的。認證包括:
- -keystone
- -endpoint
- -username
- -password
- -certificate 或 nocertificate
如果提供的鑑別認證不成功,這個指令會失敗。比方說,如果網路中斷,則系統無法確認 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
