CreateCommand

描述

• 您可以创建以下类型的命令：
  • Windows 实例适用的 Bat 脚本（RunBatScript）
  • Windows 实例适用的 PowerShell 脚本（RunPowerShellScript）
  • Linux 实例适用的 Shell 脚本（RunShellScript）
• 您可以通过指定参数 TimeOut 为命令设置在 ECS 实例中执行时最大的超时时间，命令执行超时后，云助手客户端 会强制终止命令进程，即取消命令的 PID。
  • 对于单次执行，超时后，该命令针对指定的 ECS 实例的执行状态（InvokeRecordStatus）变为 执行失败（Failed）。
  • 对于周期执行：
    • 周期执行的超时时间对每一次执行记录均有效。
    • 某次执行超时后，该次执行记录的状态（InvokeRecordStatus）变为 执行失败（Failed）。
    • 上次执行超时与否不影响下一次执行。
• 您可以通过指定参数 WorkingDir 为命令指定执行路径。对于 Linux 实例，默认在管理员 root 用户的 home 目录下，具体为 /root 目录。对于 Windows 实例，默认在云助手客户端进程所在目录，例如，C:\ProgramData\aliyun\assist\$(version)。
• 在一个地域下，您最多能创建 100 条云助手命令。
  说明 如果您想调整调用次数上限，请 提交工单 申请。

请求参数

返回参数

示例

https://ecs.aliyuncs.com/?Action=CreateCommand
&RegionId=cn-hangzhou
&Name=Test
&Type=RunShellScript
&CommandContent=ZWNobyAxMjM=
&<公共请求参数>

XML 格式

<CreateCommandResponse>
    <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
    <CommandId>c-7d2a745b412b4601b2d47f6a768d3a14</CommandId>
</CreateCommandResponse>

{
    "RequestId":"E69EF3CC-94CD-42E7-8926-F133B86387C0",
    "CommandId":"c-7d2a745b412b4601b2d47f6a768d3a14"
}

<Error>
    <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
    <HostId>ecs.aliyuncs.com</HostId>
    <Code>MissingParameter.Name</Code>
    <Message>The input parameter “Name” that is mandatory for processing this request is not supplied.</Message>
</Error>

{
    "RequestId": "E69EF3CC-94CD-42E7-8926-F133B86387C0",
    "HostId": "ecs.aliyuncs.com"
    "Code": "MissingParameter.Name"
    "Message": "The input parameter “Name” that is mandatory for processing this request is not supplied."
}

错误码