开发者社区 问答 正文

命令行工具 CLI:命令行结构和参数:全局参数说明



命令行工具在执行时,支持全局参数的临时设置,您可以根据需要调整。目前支持的全局参数如下:


  • AccessKeyId:指定当前命令执行时,API 请求中的 Access Key Id。如果不指定或者值为空,则使用默认的全局 Access Key Id。

  • AccessKeySecret:指定当前命令执行时,API 请求中的 Access Key Secret。如果不指定或者值为空,则使用默认的全局 Access Key Secret。

  • RegionId:指定当前命令执行时,API 请求对应的 Region。如果不指定,则会用全局的 RegionId。

  • output:指定当前命令执行时要显示的格式。

  • profile:指定当前命令执行时采用的账户信息。如果指定的账户信息不存在,不会选择默认账户信息。另外,如果profile 和其他全局参数同时出现时,优先级低于其他全局参数。例如 profile 和 AccessKeyId 同时出现,优先选择AccessKeyId 作为 Access Key。

  • version:指定当前命令执行时采用的产品开放 API 版本信息。如果没有配置,那么执行命令时会选择当前系统安装的最新的版本去执行。
      注意:若此参数直接跟在 aliyuncli 之后,那么会显示当前命令行工具的版本。

展开
收起
行者武松 2017-10-20 15:33:34 2052 分享 版权
阿里云 AI 助理回答

在命令行工具中临时设置全局参数,以便于按需调整API请求的配置,可以遵循以下指导进行操作:

  1. AccessKeyId:

    • 作用: 指定当前命令执行时使用的Access Key Id。
    • 使用方法: 通过命令行参数直接指定,如不指定,则默认采用全局配置中的Access Key Id。
    • 示例: --access-key-id=<your_access_key_id>
  2. AccessKeySecret:

    • 作用: 指定当前命令执行时的Access Key Secret。
    • 使用方法: 同AccessKeyId,直接在命令中指定,否则使用全局默认值。
    • 示例: --access-key-secret=<your_access_key_secret>
  3. RegionId:

    • 作用: 确定API请求的目标区域。
    • 使用方法: 若未指定,将采用系统默认的RegionId。
    • 示例: --region-id=<your_region_id>
  4. output:

    • 作用: 设置命令输出格式。
    • 使用方法: 直接在命令后添加以指定输出格式。
    • 示例: --output=json--output=text
  5. profile:

    • 作用: 选择特定账户信息执行命令。
    • 注意: 当与其它全局参数(如AccessKeyId)同时出现时,优先级较低。
    • 示例: --profile=my_profile
  6. version:

    • 作用: 指定使用的API版本。
    • 特别说明: 若直接跟在命令行工具名后,将显示工具版本而非设置版本。
    • 示例: 使用于命令中为 --version=<api_version>;查看工具版本则为 aliyuncli --version

重要提示: - 确保在使用上述参数时,替换<your_access_key_id><your_access_key_secret><your_region_id>等占位符为实际值。 - 使用这些参数能够灵活地控制单次命令行操作的认证信息和行为模式,无需修改全局配置文件。

以上步骤和说明可帮助您根据具体需求,在命令行工具执行时动态调整全局参数。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
API
问答地址: