How to trigger a cloud assistant command for one or multiple ECS instances

The content of this article is about how to trigger a cloud assistant command for one or more ECS instances. It has certain reference value. Friends in need can refer to it. I hope it will be helpful to you.

InvokeCommand

Description

When you use this interface, please note:

In a In the Alibaba Cloud region, you can run up to 500 cloud assistant commands per day.

The network type of the target instance must be VPC.

The status of the target instance must be Running.

The target instance must have the Cloud Assistant client installed in advance.

When executing a command of type PowerShell, you need to ensure that the target ECS Windows instance has been configured with the PowerShell module.

For single execution (Timed=False), the command is only executed once.

For periodic execution (Timed=True), the cloud assistant will execute regularly according to the time frequency specified by the parameter Frequency. The result of the last execution will not have any impact on the next execution.

The time base for periodic execution is UTC 08:00, and this time is based on the system time of the instance. You need to ensure that the time or time zone of your ECS instance is consistent with your expected time.

For more details about time zones, for Linux instances, please refer to Modifying the ECS Linux Instance Time Zone and Setting the NTP Service. For Windows instances, please refer to Synchronizing the Clock of a Windows Instance.

You can select multiple ECS instances. If one of the instances does not meet the execution conditions, you need to select again.

The execution of the command may fail due to abnormal status of the target instance, network abnormality, or cloud assistant client abnormality. If the command cannot be executed, no execution information will be generated.

Request parameters

##Return parameters

Example

Request Example

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 * * ?
&<公共请求参数>

Normal return example

XML format

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

JSON format

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

Exception return example

XML format

<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 format

{
    "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."
}

Error code

The following are error codes unique to this interface. For more error codes, please visit the API Error Center.

The above is the detailed content of How to trigger a cloud assistant command for one or multiple ECS instances. For more information, please follow other related articles on the PHP Chinese website!