CreateCommand - 创建云助手命令

地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

命令名称，支持全字符集。长度不得超过 128 个字符。

命令描述，支持全字符集。长度不得超过 512 个字符。

命令的类型。取值范围：

• RunBatScript：创建一个在 Windows 实例中运行的 Bat 脚本。

• RunPowerShellScript：创建一个在 Windows 实例中运行的 PowerShell 脚本。

• RunShellScript：创建一个在 Linux 实例中运行的 Shell 脚本。

命令 Base64 编码后的内容。

• 该参数的值必须使用 Base64 编码后传输，且脚本内容的大小在 Base64 编码之后不能超过 18 KB。

• 命令内容支持使用自定义参数形式，具体通过指定参数EnableParameter=true启用自定义参数功能：

  • 自定义参数用{{}}包含的方式定义，在{{}}内参数名前后的空格以及换行符会被忽略。

  • 自定义参数个数不能超过 20 个。

  • 自定义参数名允许 a-zA-Z0-9-_的组合，不支持 acs::前缀指定非内置环境参数，不支持其余字符，参数名不区分大小写。

  • 单个参数名不能超过 64 字节。

• 您可以指定内置环境参数作为自定义参数，执行命令时无需手动对参数赋值，云助手将为您自动替换为环境中对应的值。支持指定以下内置环境参数：

  • {{ACS::RegionId}}：地域 ID。

  • {{ACS::AccountId}}：阿里云主账号 UID。

  • {{ACS::InstanceId}}：实例 ID。命令下发到多个实例时，如需指定{{ACS::InstanceId}}作为内置环境参数，需确保云助手 Agent 不低于以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

  • {{ACS::InstanceName}}：实例名称。命令下发到多个实例时，如需指定{{ACS::InstanceName}}作为内置环境参数，需确保云助手 Agent 不低于以下版本：

    • Linux：2.2.3.344

    • Windows：2.1.3.344

  • {{ACS::InvokeId}}：命令执行 ID。如需指定{{ACS::InvokeId}}作为内置环境参数，需确保云助手 Agent 不低于以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

  • {{ACS::CommandId}} ：命令 ID。通过调用 RunCommand 接口执行命令时，如需指定{{ACS::CommandId}}作为内置环境参数，需确保云助手 Agent 不低于以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

您创建的命令在 ECS 实例中运行的目录。长度不得超过 200 个字符。

默认值：

• Linux 实例：管理员 root 用户的 home 目录下，具体为/root目录。

• Windows 实例：云助手 Agent 进程所在目录，例如C:\Windows\System32。

您创建的命令在 ECS 实例中执行时最大的超时时间，单位为秒。当因为某种原因无法运行您创建的命令时，会出现超时现象。超时后，会强制终止命令进程，即取消命令的 PID。

默认值：60。

创建的命令是否使用自定义参数。

默认值：false。

命令内容（CommandContent）的编码方式。取值范围：

• PlainText：不编码，采用明文传输。

• Base64：Base64 编码。

默认值：Base64。

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。

命令所属的资源组 ID。

脚本执行的引导程序。长度不能超过 1 KB。