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 个字符的字母数字字符串(基本 64 位编码的 PEM 格式)。
-nocertificate
(可选)指定用于向新的或修改后的云帐户存储器(用于停止系统)进行认证的定制 SSL 证书。
-refresh
(可选)指定刷新系统导入候选项。如果帐户处于 import 方式,那么该参数指定刷新可供导入的数据。
-downbandwidthmbits downbandwidth_limit_in_mb
(可选)指定下载带宽限制,以兆位/秒 (Mbps) 为单位。该值必须是 1 到 10240 之间的数字。
-upbandwidthmbits upbandwidth_limit_in_mb
(可选)指定上载带宽限制,以兆位/秒 (Mbps) 为单位。该值必须是 1 到 10240 之间的数字。
-resetusagehistory
(可选)重置使用情况历史记录(重置为 0)。反映云帐户上已消耗空间的存储器消耗情况是累计的,这表示其仍保留在当前行(第 0 行)。
cloud_account_id | cloud_account_name
(可选)指定要修改的云帐户标识或名称。标识值必须为数字,名称值必须为字母数字字符串。

描述

该命令可修改使用 Amazon S3 存储器的云帐户(使用 mklcloudaccountawss3 创建)的参数。

-mode 参数、-refresh 参数以及任何用户凭证参数组都是互斥的。

如果提供的凭证不提供认证,那么该命令将失败并且不执行任何更改。 凭证包括:
  • -accesskeyid
  • -secretaccesskey
  • -certificatenocertificate

例如,如果网络中断,那么系统将无法确认新的秘密访问密钥是否有效,命令将会失败。指定 -ignorefailures 以覆盖此功能。 如果指定了无效的凭证和 -ignorefailures,那么联机帐户会变为脱机,并且会在错误日志中生成一条错误来描述该认证失败情况。

秘密访问密钥是敏感系统信息,以加密形式存储。它在系统转储中不可用,并且在审计日志中被替换为六个散列(“#”)符号。

如果对脱机帐户指定此命令,并且这些新的详细信息使帐户开始生效(例如,输入已过期的密码),那么该帐户将变为联机。

如果帐户未被任何系统卷使用,那么必须更改方式。帐户必须处于联机状态并且系统能够与云服务器通信,才能更改方式。

注: 您最多可拥有:
  • 每个系统一个云帐户。
  • 1024 个已启用云快照的卷。
  • 每个卷 256 个云快照。
  • 512 个卷组。

调用示例

chcloudaccountawss3 -name myamazon cloudaccount0

生成的输出:

无反馈

调用示例

chcloudaccountawss3 -mode import -importsystem 000002007D40A162 0

生成的输出:

无反馈

调用示例

chcloudaccountawss3 -upbandwidthmbits 100 -downbandwidthmbits 100 cloudaccount0

生成的输出:

无反馈