ModifyInvocationAttribute

The region ID.

The execution ID of the task to modify.

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

• The size of the command content after Base64 encoding cannot exceed 24 KB.

• If the command content is Base64-encoded, 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 only a-z, A-Z, 0-9, hyphens (-), and underscores (_). 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 the command is executed, Cloud Assistant automatically replaces them with the corresponding values in the environment without manual assignment. The following built-in environment parameters are supported:

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

  • {{ACS::AccountId}}: The UID of the Alibaba Cloud account.

  • {{ACS::InstanceId}}: The instance ID. When the command is sent to multiple instances, to use {{ACS::InstanceId}} as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

  • {{ACS::InstanceName}}: The instance name. When the command is sent to multiple instances, to use {{ACS::InstanceName}} as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:

    • Linux: 2.2.3.344

    • Windows: 2.1.3.344

  • {{ACS::InvokeId}}: The command execution ID. To use {{ACS::InvokeId}} as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

  • {{ACS::CommandId}}: The command ID. When you call this operation to execute a command, to use {{ACS::CommandId}} as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

Specifies whether the command contains custom parameters.

• When you enable custom parameters or modify the custom parameters Parameters, set this parameter to true.

• When you do not modify the custom parameters Parameters, do not set this parameter or set it to false.

The key-value pairs of custom parameters to modify when the command contains custom parameters.

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

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

• Values can be empty strings.

• After the custom parameters and original command content are Base64-encoded, the total size of the command content cannot exceed 24 KB.

• 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 indicates that no custom parameter key-value pairs are modified.

The modified scheduled execution frequency. This parameter takes effect only when RepeatMode is set to Period. Three types of scheduled execution are supported: execution at fixed intervals (based on a Rate expression), one-time execution at a specified time, and clock-based scheduled execution (based on a Cron expression).

• Execution at fixed intervals: Based on a Rate expression, the command is executed at the specified interval. The interval can be specified in seconds (s), minutes (m), hours (h), or days (d). This is applicable to scenarios where tasks are executed at fixed intervals. Format: rate(<interval value><interval unit>). For example, to execute every 5 minutes, use rate(5m). The following limits apply to execution at fixed intervals:

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

  • The execution 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 round of execution starts 3 minutes after the task is completed.

  • The next execution time is calculated based on the task creation time (see CreationTime returned by DescribeInvocations, note that this is not the modification time) and the modified execution interval.

• 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>), which is at(year-month-day hour:minute:second <time zone>). If no time zone is specified, UTC is used by default. The time zone supports the following three formats:

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

  • Time zone offset from Greenwich Mean Time: such as GMT+8:00 (UTC+8) and 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 a Cron expression): Based on a Cron expression, the command is executed according to the scheduled task settings. Format: <seconds> <minutes> <hours> <day of month> <month> <day of week> <year (optional)> <time zone>, which is <Cron expression> <time zone>. The scheduled task execution time is calculated based on the Cron expression in the specified time zone. If no time zone is specified, the system internal time zone of the instance running the scheduled task is used by default. 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) and America/Los_Angeles (US/Los Angeles time).

  • Time zone offset from Greenwich Mean Time: such as GMT+8:00 (UTC+8) and 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 specified when the scheduled task was created, and must be at least 10 seconds.

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

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

• Base64: Base64 encoding.

Default value: PlainText. If an invalid value is specified, it is treated as PlainText.

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 that 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.