如何为一台或多台ECS实例触发一条云助手命令
InvokeCommand
描述
当您使用该接口时,请注意:
在一个阿里云地域下,您每天最多能运行500次云助手命令。
目标实例的网络类型必须是专有网络VPC。
目标实例的状态必须为 运行中(Running)。
目标实例必须预先安装 云助手客户端。
执行类型为PowerShell的命令时,您需要确保目标ECS Windows实例已经配置了PowerShell模块。
对于单次执行(Timed=False),只执行一次命令。
对于周期执行(Timed=True),云助手将根据参数Frequency指定的时间频率定时执行。上次的执行结果不对下一次执行产生任何影响。
周期执行的时间设置基准为UTC +08:00,且该时间以实例的系统时间为准,您需要确保您的ECS实例的时间或者时区与您预期的时间一致。
更多关于时区的详情,Linux 实例请参阅 修改 ECS Linux 实例时区与设置 NTP 服务,Windows 实例请参阅 同步 Windows 实例的时钟。
您可以选择多台ECS实例,若其中某台实例不满足执行条件时,您需要重新选择。
命令的执行可能会因为目标实例的状态异常、网络异常或云助手客户端异常而出现无法执行的情况,无法执行时不会生成执行信息。
请求参数
返回参数
示例
请求示例
https://ecs.aliyuncs.com/?Action=InvokeCommand &RegionId=cn-hangzhou &InstanceId.1=i-bp185dy2o3o6nxxxxxxx &InstanceId.2=i-bsdn5dy2o845sxxxxxxx &CommandId=c-e996287206324975b5fbe1dxxxxxxxxx &Timed=true&Frequency=0 0-5 14 * * ? &<公共请求参数>
正常返回示例
XML格式
<InvokeCommandResponse> <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId> <InvokeId>t-7d2a745b412b4601b2d47f6a768d3a14</InvokeId> </InvokeCommandResponse>
JSON格式
{ "RequestId":"E69EF3CC-94CD-42E7-8926-F133B86387C0", "InvokeId":"t-7d2a745b412b4601b2d47f6a768d3a14" }
异常返回示例
XML格式
<Error> <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId> <HostId>ecs.aliyuncs.com</HostId> <Code>MissingParameter.CommandId</Code> <Message>The input parameter “CommandId” that is mandatory for processing this request is not supplied.</Message> </Error>
JSON格式
{ "RequestId": "E69EF3CC-94CD-42E7-8926-F133B86387C0", "HostId": "ecs.aliyuncs.com" "Code": "MissingParameter.CommandId" "Message": "The input parameter “CommandId” that is mandatory for processing this request is not supplied." }
错误码
以下为本接口特有的错误码。更多错误码,请访问 API 错误中心。
以上就是如何为一台或多台ECS实例触发一条云助手命令的详细内容,更多请关注其它相关文章!
上一篇: Photoshop制作带有光斑的梦幻蓝紫色光束心形
下一篇: 一致性Hash