InvokeCommand

为一台或多台ECS实例触发一条云助手命令。

接口说明

在一个阿里云地域下，您每天能调用 500 次 InvokeCommand 接口。如果您想调整调用次数上限，请提交工单申请。
目标实例的网络类型必须是专有网络VPC。
目标实例的状态必须为运行中（Running）。
目标实例必须预先安装云助手客户端。
执行类型为 PowerShell 的命令时，您需要确保目标 ECS Windows实例已经配置了 PowerShell 模块。
对于单次执行（Timed=False），只执行一次命令。
对于周期执行（Timed=True），云助手将根据参数 Frequency 指定的时间频率定时执行。上次的执行结果不对下一次执行产生任何影响。
周期执行的时间设置基准为UTC +08:00，且该时间以实例的系统时间为准，您需要确保您的 ECS 实例的时间或者时区与您预期的时间一致。更多关于时区的详情，Linux 实例请参阅时间设置：设置Linux实例时区和NTP服务，Windows 实例请参阅时间设置：设置Windows实例NTP服务。
您可以选择多台ECS实例，若其中某台实例不满足执行条件时，您需要重新选择。
命令的执行可能会因为目标实例的状态异常、网络异常或云助手客户端异常而出现无法执行的情况，无法执行时不会生成执行信息。

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数


名称	类型	是否必选	示例值	描述
CommandId	String	是	c-e996287206324975b5fbe1dxxxxxxxxx	命令 ID。您可以通过接口 DescribeCommands 查询所有可用的 CommandId。
InstanceId.N	RepeatList	是	i-bp185dy2o3o6nxxxxxxx	需要执行命令的实例列表，最多能指定 50 台实例 ID。N 的取值范围为1~50。
RegionId	String	是	cn-hangzhou	地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
Action	String	否	InvokeCommand	系统规定参数。取值：InvokeCommand
Frequency	String	否	0 /20 * * *	周期任务的执行周期，两次周期任务的时间间隔不能低于10秒。当参数 Timed 的值为 True 时，参数 Frequency 为必需参数。该参数取值遵循Cron表达式，参阅 Cron 表达式。
OwnerAccount	String	否	ECSforCloud@Alibaba.com	RAM 用户的账号登录名称。
Timed	Boolean	否	true	命令是否为周期执行。默认值：False

返回参数


名称	类型	示例值	描述
InvokeId	String	t-7d2a745b412b4601b2d47f6a768d3a14	命令执行ID
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求 ID

示例

请求示例


https://ecs.aliyuncs.com/?Action=InvokeCommand
&CommandId=c-e996287206324975b5fbe1dxxxxxxxxx
&InstanceId.1=i-bp185dy2o3o6nxxxxxxx
&RegionId=cn-hangzhou
&Timed=true
&Frequency=0 */20 * * * *
&<公共请求参数>

正常返回示例

XML 格式

<InvokeCommandResponse>
  <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
  <InvokeId>t-7d2a745b412b4601b2d47f6a768d3a14</InvokeId>
</InvokeCommandResponse>

JSON 格式

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

错误码


HttpCode	错误码	错误信息	描述
500	InternalError.Dispatch	An error occurred when you dispatched the request.	发生未知错误。
404	InvalidInstance.NotFound	The specified instance does not exist.	指定的实例不存在。
403	MissingParam.Frequency	The frequency must be specified when you create a timed task.	请为周期任务设置执行频率。

查看本产品错误码

发布者：佚, 佚名，转转请注明出处：https://www.cms2.cn/aliyun/1862.html

接口说明

调试

请求参数

返回参数

示例

错误码

相关推荐

DescribeTags

ModifyAutoSnapshotPolicyEx

注意事项

Linux 格式化数据盘

OperationProgressType

DescribeHpcClusters

发表评论