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
