All Products
Search
Document Center

Elastic Compute Service:RunCommand

Last Updated:Sep 17, 2026

Creates and executes a Cloud Assistant command on one or more ECS instances. This operation supports Shell, PowerShell, and Bat scripts, and provides features such as scheduled execution, custom parameters, and in-container execution.

Operation description

This is an asynchronous operation. After the request is sent, you can call DescribeInvocations or DescribeInvocationResults with the returned command ID or invocation ID to query the execution results.

Before you begin

  • The target instances must be in the running state (Running). You can call DescribeInstances to query instance status.

  • The target instances must have Cloud Assistant Agent pre-installed. You can install it by calling InstallCloudAssistant and query the installation status by calling DescribeCloudAssistantStatus.
    Note

    ECS instances created from public images after December 1, 2017 have Cloud Assistant Agent pre-installed by default.

  • To run PowerShell commands, make sure the PowerShell module is configured on the Windows operating system of the target ECS instances.

Precautions

  • In a single region, you can retain 500 to 50,000 Cloud Assistant commands. You can also request a quota increase. For more information, see Quota management.

  • Cloud Assistant Agent must be at or above the following versions to support new features for scheduled tasks (execution at fixed intervals, one-time execution at a specified time, and specifying a year or time zone for Cron-based scheduled execution). If the ClientNeedUpgrade error code is returned, see Upgrade or disable upgrades for Cloud Assistant Agent to update the agent to the latest version.

    - Linux: 2.2.3.282
    - Windows: 2.1.3.282
    
  • When you run a Cron-based scheduled task with a specified time zone, the scheduled execution time is based on the specified time zone. When you do not specify a time zone, the scheduled execution time is based on the system time zone of the ECS instance, and the execution time is determined by the instance system time. Make sure the time or time zone of the ECS instance matches your expectations. For more information about time zones, see Configure the time zone and NTP service for a Linux instance or Configure the NTP service for a Windows instance.

Recommendations

  • Timeout settings: You can set the maximum timeout period for command execution on an ECS instance by specifying the Timeout parameter. When a command times out, Cloud Assistant Agent forcefully stops the process.
    • After a one-time execution times out, the execution status (InvokeRecordStatus) changes to execution fault (Failed).

    • For scheduled executions, the timeout period applies to each execution record. A timeout in the previous execution does not affect the next execution. After a timeout occurs, the execution status (InvokeRecordStatus) changes to execution fault (Failed).

  • Execution failures: Commands may fail to execute due to abnormal target instance status, network exceptions, or Cloud Assistant Agent exceptions. In such cases, no execution information is generated. For more information, see Common errors and solutions for execution failures.

  • Custom parameters: When EnableParameter=true, the custom parameter feature is enabled. You can define custom parameters in the format {{parameter}} in CommandContent, and pass in custom parameter key-value pairs when executing the command.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ecs:RunCommand

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

  • ecs:CommandRunAs
None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID. You can call DescribeRegions to query the most recent region list.

cn-hangzhou

ResourceGroupId

string

No

The resource group ID for the command execution. When this parameter is specified:

  • If the ECS instance specified by InstanceId belongs to a non-default resource group, the ECS instance must belong to this resource group.

  • You can filter the corresponding command execution results by specifying this parameter (by calling DescribeInvocations or DescribeInvocationResults).

rg-bp67acfmxazb4p****

Name

string

No

The command name. All character sets are supported. The name can be up to 128 characters in length.

testName

Description

string

No

The command description. All character sets are supported. The description can be up to 512 characters in length.

testDescription

Type

string

Yes

The command type. Valid values:

  • RunBatScript: Bat command for Windows instances.

  • RunPowerShellScript: PowerShell command for Windows instances.

  • RunShellScript: Shell command for Linux instances.

RunShellScript

CommandContent

string

Yes

The command content. The command content can be plaintext or Base64-encoded. Note the following items:

  • The command content cannot exceed 24 KB after Base64 encoding. You can use KeepCommand to specify whether to retain the command.

  • If the command content is Base64-encoded, you must set ContentEncoding=Base64.

  • Set EnableParameter=true to enable the custom parameter feature in the command content:

    • Define custom parameters by enclosing them in {{}}. Spaces and line breaks before and after the parameter name within {{}} are ignored.

    • The number of custom parameters cannot exceed 20.

    • Custom parameter names can contain a-zA-Z0-9-_ combinations. The acs:: prefix for specifying non-built-in environment parameters is not supported. Other characters are not supported. Parameter names are case-insensitive.

    • Each custom parameter name cannot exceed 64 bytes.

  • You can specify built-in environment parameters as custom parameters. When running the command, you do not need to manually assign values to these parameters because Cloud Assistant automatically replaces them with the corresponding environment values. The following built-in environment parameters are supported:

    • {{ACS::RegionId}}: The region ID.

    • {{ACS::AccountId}}: The Alibaba Cloud account ID.

    • {{ACS::InstanceId}}: The instance ID. When a command is sent to multiple instances and you want to use {{ACS::InstanceId}} as a built-in environment parameter, make sure Cloud Assistant Agent is at or above the following versions:
      • Linux: 2.2.3.309

      • Windows: 2.1.3.309

    • {{ACS::InstanceName}}: The instance name. When a command is sent to multiple instances and you want to use {{ACS::InstanceName}} as a built-in environment parameter, make sure Cloud Assistant Agent is at or above the following versions:
      • Linux: 2.2.3.344

      • Windows: 2.1.3.344

    • {{ACS::InvokeId}}: The invocation ID. To use {{ACS::InvokeId}} as a built-in environment parameter, make sure Cloud Assistant Agent is at or above the following versions:
      • Linux: 2.2.3.309

      • Windows: 2.1.3.309

    • {{ACS::CommandId}}: The command ID. When calling this operation to run a command and you want to use {{ACS::CommandId}} as a built-in environment parameter, make sure Cloud Assistant Agent is at or above the following versions:
      • Linux: 2.2.3.309

      • Windows: 2.1.3.309

ZWNobyAxMjM=

WorkingDir

string

No

The working directory of the command on the ECS instance. The directory can be up to 200 characters in length.

Default values:

  • For Linux instances, the default directory is the home directory of the administrator (root user): /root.

  • For Windows instances, the default directory is the directory where the Cloud Assistant Agent process is located, such as C:\Windows\System32.

/home/user

Timeout

integer

No

The timeout period for command execution. Unit: seconds.

When a command cannot run due to process issues, missing modules, or missing Cloud Assistant Agent, a timeout occurs. When a timeout occurs, the command process is forcefully terminated.

Default value: 60.

3600

EnableParameter

boolean

No

Specifies whether the command contains custom parameters.

Default value: false.

false

RepeatMode

string

No

The execution mode of the command. Valid values:

  • Once: Runs the command immediately.

  • Period: Runs the command on a schedule. When this parameter is set to Period, you must also specify the Frequency parameter.

  • NextRebootOnly: Automatically runs the command the next time the instance starts.

  • EveryReboot: Automatically runs the command every time the instance starts.

  • DryRun: Only performs a dry run of the request. The command is not actually executed. The dry run checks request parameters, instance execution environment, and Cloud Assistant Agent status.

Default values:

  • When the Frequency parameter is not specified, the default value is Once.

  • When the Frequency parameter is specified, the value is treated as Period regardless of whether this parameter is set.

Precautions:

  • You can call StopInvocation to stop pending or scheduled commands.

  • When this parameter is set to Period or EveryReboot, you can call DescribeInvocationResults and specify IncludeHistory=true to view the execution history of scheduled commands.

Once

Timed

boolean

No

[Deprecated] This parameter is deprecated. Specifying this parameter has no effect.

true

Frequency

string

No

The schedule for running the command. Three scheduling methods are supported: execution at fixed intervals (based on Rate expressions), one-time execution at a specified time, and clock-based scheduled execution (based on Cron expressions).

  • Execution at fixed intervals: Based on Rate expressions, the command is executed at the specified interval. The interval can be specified in seconds (s), minutes (m), hours (h), or days (d). This method is suitable for scenarios that require execution at fixed intervals. Format: rate(<interval value><interval unit>). For example, to execute every 5 minutes, use rate(5m). The following limits apply to fixed-interval execution:

    • The interval cannot exceed 7 days or be less than 60 seconds, and must be greater than the timeout period of the scheduled task.

    • The interval is based on a fixed frequency and is not related to the actual execution time of the task. For example, if the command is set to execute every 5 minutes and the task takes 2 minutes to complete, the next execution starts 3 minutes after the task completes.

    • The task is not executed immediately upon creation. For example, if the command is set to execute every 5 minutes, the first execution starts 5 minutes after the task is created.

  • One-time execution at a specified time: The command is executed once at the specified time zone and time. Format: at(yyyy-MM-dd HH:mm:ss <time zone>). If no time zone is specified, the default is UTC. The time zone supports the following three formats:

    • Full time zone name: such as Asia/Shanghai (China/Shanghai time) or America/Los_Angeles (US/Los Angeles time).

    • GMT offset from Greenwich Mean Time: such as GMT+8:00 (UTC+8) or GMT-7:00 (UTC-7). When using the GMT format, leading zeros are not supported for the hour value.

    • Time zone abbreviation: Only UTC (Coordinated Universal Time) is supported.

    For example, to execute once at 13:15:30 on June 6, 2022 in China/Shanghai time, use: at(2022-06-06 13:15:30 Asia/Shanghai). To execute once at 13:15:30 on June 6, 2022 in UTC-7, use: at(2022-06-06 13:15:30 GMT-7:00).

  • Clock-based scheduled execution (based on Cron expressions): Based on Cron expressions, the command is executed according to the specified schedule. Format: <seconds> <minutes> <hours> <day of month> <month> <day of week> <year (optional)> <time zone>, that is, <Cron expression> <time zone>. The scheduled execution time is calculated based on the Cron expression in the specified time zone. If no time zone is specified, the system time zone of the instance running the scheduled task is used. For more information about Cron expressions, see Cron expressions. The time zone supports the following three formats:

    • Full time zone name: such as Asia/Shanghai (China/Shanghai time) or America/Los_Angeles (US/Los Angeles time).

    • GMT offset from Greenwich Mean Time: such as GMT+8:00 (UTC+8) or GMT-7:00 (UTC-7). When using the GMT format, leading zeros are not supported for the hour value.

    • Time zone abbreviation: Only UTC (Coordinated Universal Time) is supported. For example, to execute once at 10:15 every day in 2022 in China/Shanghai time, use 0 15 10 ? * * 2022 Asia/Shanghai. To execute every 30 minutes from 10:00 to 11:30 every day in 2022 in UTC+8, use 0 0/30 10-11 * * ? 2022 GMT+8:00. To execute every 5 minutes from 14:00 to 14:55 every day in October every two years starting from 2022 in UTC, use 0 0/5 14 * 10 ? 2022/2 UTC.

    Note

    The minimum interval must be greater than or equal to the timeout period of the scheduled task and no less than 10 seconds.

0 */20 * * * ?

Parameters

object

No

The key-value pairs of custom parameters to pass in when the command contains custom parameters. For example, if the command content is echo {{name}}, you can pass in the key-value pair {"name":"Jack"} through the Parameter parameter. The custom parameter automatically replaces the variable value name, resulting in a new command that actually executes echo Jack.

The number of custom parameters ranges from 0 to 10. Note the following items:

  • Keys cannot be empty strings and can be up to 64 characters in length.

  • Values can be empty strings.

  • After custom parameters and the original command content are Base64-encoded, the total size of the command content cannot exceed 24 KB. You can use KeepCommand to specify whether to retain the command.

  • The set of custom parameter names must be a subset of the parameter set defined when the command was created. For parameters that are not passed in, you can use empty strings as substitutes.

Default value: empty, which disables custom parameters.

{"name":"Jack", "accessKey":"LTAI*************"}

KeepCommand

boolean

No

Specifies whether to retain the command after execution. Valid values:

  • true: Retains the command. The command can be executed again by calling InvokeCommand. This counts toward the Cloud Assistant command retention quota.

  • false: Does not retain the command. The command is automatically deleted after execution and does not count toward the Cloud Assistant command retention quota.

Default value: false.

false

ContentEncoding

string

No

The encoding method of the command content (CommandContent). Valid values (case-insensitive):

  • PlainText: no encoding. The content is transmitted in plaintext.

  • Base64: Base64 encoding.

Default value: PlainText. Invalid values are treated as PlainText.

Base64

Username

string

No

The username for executing the command on the ECS instance. The username can be up to 255 characters in length.

  • For Linux ECS instances, commands are executed as the root user by default.

  • For Windows ECS instances, commands are executed as the System user by default.

You can also specify another existing user on the instance to execute the command. Executing Cloud Assistant commands as a regular user is more secure. For more information, see Configure a regular user to run Cloud Assistant commands.

test

WindowsPasswordName

string

No

The name of the password for the user that executes the command on a Windows instance. The name can be up to 255 characters in length.

When you want to execute a command on a Windows instance as a non-default user (System), you must specify both Username and this parameter. To reduce the risk of password leaks, store the plaintext password in the parameter repository of CloudOps Orchestration Service and pass in only the password name here. For more information, see Encryption parameters and Configure a regular user to run Cloud Assistant commands.

Note

When you use the root user on a Linux instance or the System user on a Windows instance to execute commands, you do not need to specify this parameter.

axtSecretPassword

InstanceId

array

No

The array of ECS instance IDs. Array length: 1 to 100.

If any of the specified instances does not meet the execution conditions, you must reselect the instances.

You can also request a quota increase in Quota Center (quota name: Maximum number of instances supported for command execution).

i-bp185dy2o3o6neg****

string

No

The ECS instance ID.

i-bp185dy2o3o6neg****

Tag

array<object>

No

The tags. Array length: 0 to 20.

object

No

The tag.

Key

string

No

The tag key for the command execution. If this value is specified, it cannot be an empty string.

When you use a single tag to filter resources, the resource count under that tag cannot exceed 1,000. When you use multiple tags to filter resources, the resource count of resources that are attached with all specified tags cannot exceed 1,000. If the resource count exceeds 1,000, use the ListTagResources operation to query resources.

The tag key can be up to 64 characters in length and cannot start with aliyun or acs:, or contain http:// or https://.

TestKey

Value

string

No

The tag value for the command execution. The value can be an empty string.

The tag value can be up to 128 characters in length and cannot contain http:// or https://.

TestValue

ContainerId

string

No

The container ID. Only 64-bit hexadecimal strings are supported. You can use the docker://, containerd://, or cri-o:// prefix to explicitly specify the container runtime.

Precautions:

  • If this parameter is specified, Cloud Assistant executes the script in the specified container of the instance.

  • If this parameter is specified, the command can only run on Linux instances with Cloud Assistant Agent version 2.2.3.344 or later.

  • If this parameter is specified, the Username and WorkingDir parameters do not take effect. Commands can only be executed by the default container user in the default working directory of the container. For more information, see Use Cloud Assistant to run commands in containers.

Note

Only Shell scripts are supported in Linux containers. You cannot use a format such as #!/usr/bin/python at the beginning of the script to specify an interpreter. For more information, see Use Cloud Assistant to run commands in containers.

ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****

ContainerName

string

No

The container name.

Precautions:

  • If this parameter is specified, Cloud Assistant executes the script in the specified container of the instance.

  • If this parameter is specified, the command can only run on Linux instances with Cloud Assistant Agent version 2.2.3.344 or later.

  • If this parameter is specified, the Username and WorkingDir parameters do not take effect. Commands can only be executed by the default container user in the default working directory of the container. For more information, see Use Cloud Assistant to run commands in containers.

Note

Only Shell scripts are supported in Linux containers. You cannot use a format such as #!/usr/bin/python at the beginning of the script to specify an interpreter. For more information, see Use Cloud Assistant to run commands in containers.

test-container

ClientToken

string

No

The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure the token is unique among different requests. ClientToken can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

123e4567-e89b-12d3-a456-426655440000

OssOutputDelivery

string

No

The OSS delivery configuration for command execution output.

  • Format: oss://${BucketName}/${Prefix}, where ${BucketName} is the name of the destination OSS bucket and ${Prefix} is the directory prefix for delivery.

oss://testBucket/testPrefix

ResourceTag

array<object>

No

The tags used to filter instances. Array length: 0 to 20. You can run commands in batch on instances with the same tags without specifying InstanceId.

object

No

The tag used to filter instances. You can run commands in batch on instances with the same tags without specifying InstanceId.

Key

string

No

The tag key used to filter instances.

Precautions:

  • This parameter conflicts with the InstanceId parameter. You cannot specify both parameters at the same time.

  • If this value is specified, it cannot be an empty string.

  • The number of instances under the tag cannot exceed the limit of InstanceId.N. If the number of instances exceeds the limit, control the number of instances by adding batch tags, such as batch: b1.

  • The tag key can be up to 64 characters in length and cannot start with aliyun or acs:, or contain http:// or https://.

TestKey

Value

string

No

The tag value used to filter instances.

Precautions:

  • The value can be an empty string.

  • The tag value can be up to 128 characters in length and cannot contain http:// or https://.

TestValue

TerminationMode

string

No

The mode for stopping a task (manual stop or timeout interruption). Valid values:

  • Process: Stops the current script process.

  • ProcessTree: Stops the current process tree (the collection of the script process and all child processes it created).

ProcessTree

Launcher

string

No

The bootstrap program for script execution. The length cannot exceed 1 KB.

python3 -u {{ACS::ScriptFileName|Ext(".py")}}

Response elements

Element

Type

Description

Example

object

CommandId

string

The command ID.

c-7d2a745b412b4601b2d47f6a768d****

InvokeId

string

The invocation ID.

t-7d2a745b412b4601b2d47f6a768d****

RequestId

string

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Examples

Success response

JSON format

{
  "CommandId": "c-7d2a745b412b4601b2d47f6a768d****",
  "InvokeId": "t-7d2a745b412b4601b2d47f6a768d****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 RegionId.ApiNotSupported The api is not supported in this region. The API operation cannot be called in the specified region. Check whether the specified RegionId parameter is valid.
400 ResourceBusy.SlrCreation The ServiceLinkedRole is still being created or has not taken effect yet. Please try again later.
400 MissingParam.InstanceId The parameter instanceId is missing or empty. The instance ID is empty.
400 NumberExceed.Tags Ensure the number of tag parameters is not greater than 20. The number of tags exceeds the maximum limit. You can specify up to 20 tags for this operation.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. The specified tag value is invalid.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. The specified tag key already exists. Tag keys must be unique.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. The specified Tag.N.Key parameter is invalid.
400 MissingParameter.TagKey You must specify Tag.N.Key. The tag key is not specified.
400 InvalidContainerId.Malformed The specified parameter ContainerId is not valid. The specified container ID is invalid.
400 InvalidContainerName.Malformed The specified parameter ContainerName is not valid. The specified container name is invalid.
400 InvalidClientToken.Malformed The specified parameter clientToken is not valid. The specified idempotent parameter is invalid.
400 CmdParam.EmptyKey Command parameters can not be empty.
400 CmdParam.InvalidParamName A command parameter name is invalid.
400 CmdContent.DecodeError The CommandContent can not be base64 decoded. The specified CommandContent parameter value cannot be Base64-decoded. Check whether the parameter value is correct.
400 InvalidInstance.NotMatch The specified instance type does not match the command.
400 MissingParam.Frequency The frequency must be specified when you create a timed task.
400 InvalidParam.Frequency The specified frequency is invalid.
400 ParameterKey.Duplicate The parameter may not contain duplicate keys. Parameter names cannot be duplicated. Verify the names and try again.
400 Parameter.NotMatched The parameters of creation do not match those of invocation. The custom parameters passed in do not match the custom parameters defined when the command was created.
400 WindowsPasswordName.Missed WindowsPasswordName must be specified when you create a Windows task.
400 Parameter.Disabled Parameters should not be passed when CreateCommand.EnableParameter is false. Do not pass custom parameters when the custom parameter feature of the command is disabled.
400 InvalidParameter.WorkingDir The specified parameter WorkingDir is not valid. The specified WorkingDir parameter is invalid.
400 NumberExceed.ResourceTags The maximum number of ResourceTags is exceeded.
400 MissingParameter.ResourceTagKey You must specify ResourceTag.N.Key.
400 InvalidResourceTagKey.Malformed The specified ResourceTag key is not valid.
400 InvalidResourceTagValue.Malformed The specified ResourceTag value is not valid.
400 Duplicate.ResourceTagKey The ResourceTag contains duplicate keys.
400 InvalidResourceTag.InstanceNotFound InstanceIds are not found by the specified ResourceTag.
400 InvalidResourceTag.ConflictWithInstanceIds The specified param ResourceTag conflicts with InstanceId.
400 InvalidOssOutputDelivery.BucketInOtherRegion The OSS bucket specified in the parameter OssOutputDelivery is in another region. The OSS bucket specified in the parameter OssOutputDelivery is in another region.
400 InvalidParameter.OssOutputDelivery The specified parameter OssOutputDelivery is not valid. The specified parameter OssOutputDelivery is not valid.
400 InvalidOssOutputDelivery.KeyPrefixMalformed The prefix of the OSS key specified in the parameter OssOutputDelivery is not valid. The prefix of the OSS key specified in the parameter OssOutputDelivery is not valid.
500 InternalError.Dispatch An error occurred when you dispatched the request. An error occurred while the request is being sent. Try again later.
403 InvalidOssOutputDelivery.BucketAccessDenied The error message returned by the OSS API is: %s
403 CmdContent.ExceedLimit The length of the command content exceeds the upper limit. The length of command content exceeds the upper limit.
403 CmdName.ExceedLimit The length of the command name exceeds the upper limit. The length of the command name exceeds the upper limit.
403 CmdDesc.ExceedLimit The length of the command description exceeds the upper limit. The length of the command description exceeds the upper limit.
403 CmdCount.ExceedQuota The total number of commands in the current region exceeds the quota. The maximum number of Cloud Assistant commands in the current region has been exceeded.
403 CmdParamCount.ExceedLimit You've reached the limit on the count of command parameters.
403 CmdParamName.ExceedLimit The length of the command parameter name exceeds the limit. The parameter name of your custom parameter exceeds the length limit.
403 InstanceIds.ExceedLimit The number of instance IDs exceeds the upper limit. The number of specified instance IDs exceeds the upper limit.
403 Invocation.ExceedQuota The invocation quota in the current region has been reached for today. The maximum daily number of commands that can be run in the specified region has been reached.
403 ParameterCount.ExceedLimit The number of command parameters exceeds the maximum number that can be set. The number of parameters exceeds the maximum allowed.
403 ParameterKey.ExceedLimit The length of the specified parameter key exceeds the maximum length that can be set. The length of the specified parameter key exceeds the maximum allowed length.
403 ParameterType.NotSupported The type of parameter value is not supported.
403 Username.ExceedLimit The length of the username exceeds the upper limit. The length of the username exceeds the upper limit.
403 WindowsPasswordName.ExceedLimit The length of the WindowsPasswordName exceeds the upper limit. The length of the specified WindowsPasswordName parameter exceeds the upper limit.
403 ParameterStore.NotSupported Parameter Store is not supported in this region.
403 TemporaryAccessKey.Error The temporary accessKey is invalid.
403 ParameterStore.InvalidParameters The parameter is invalid in Parameter Store. The parameter specified by {{oos:?}} in the command content was not found.
403 ParameterStore.NoPermission You have no access to Parameter Store.
403 OperationDenied.BidOwnResource Bid user can not own resource.
403 Operation.Forbidden The operation is not permitted. The operation is not supported.
403 IdempotentParameterMismatch The specified parameter has changed while using an already used clientToken. The request parameters do not match those of the request with the same ClientToken.
403 IdempotentProcessing The previous idempotent request(s) is still processing. A previous idempotent request is being processed. Try again later.
403 InvalidStatus.ResourceGroup You cannot perform an operation on a resource group that is being created or deleted. Operation not allowed while resource group is being created or deleted.
403 InvalidParameterCharacter.CommandName The command Name contains illegal characters. The command Name contains illegal characters.
403 InvalidParameterCharacter.CommandDescription The command Description contains illegal characters. The command Description contains illegal characters.
403 InvalidParameterCharacter.CommandWorkingDir The command WorkingDir contains illegal characters. The command WorkingDir contains illegal characters.
403 InvalidLauncher.LengthLimitExceeded The length of the parameter Launcher exceeds the limit of 1 KB characters. The length of the argument Launcher exceeds the limit of 1 KB characters.
403 InvalidParameterCharset.Parameters The parameter Parameters contains illegal charset. The command parameter contains an illegal character set.
403 CreateServiceLinkedRole.NoPermission You do not have permission to create ServiceLinkedRole for output delivery. You do not have permission to create ServiceLinkedRole for output delivery.
403 InvalidTimeout.ExceedLimit The specified parameter Timeout exceeds the upper limit.
404 InvalidCmdType.NotFound The specified command type does not exist.
404 InvalidRepeatMode.NotFound The specified repeat mode does not exist. The specified command execution mode does not exist.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. Region information error
404 InvalidInstance.NotFound The specified instance does not exist. The specified instance does not exist.
404 InvalidCmdId.NotFound The specified command ID does not exist. The specified CommandId parameter is invalid. Check the parameter value. You can call the DescribeCommands operation to query all available command IDs.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. The specified resource group does not exist.
404 InvalidTerminationMode.NotFound The specified parameter TerminationMode does not exist. The specified parameter TerminationMode does not exist.
404 InvalidOssOutputDelivery.BucketNotFound The OSS bucket specified in the parameter OssOutputDelivery does not exist. The OSS bucket specified in the parameter OssOutputDelivery does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.