@alicloud/ecs20140526 4.1.1 → 4.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/client.d.ts CHANGED
@@ -23729,6 +23729,18 @@ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeN
23729
23729
  [key: string]: any;
23730
23730
  });
23731
23731
  }
23732
+ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeSupportedBootModes extends $tea.Model {
23733
+ supportedBootMode?: string[];
23734
+ static names(): {
23735
+ [key: string]: string;
23736
+ };
23737
+ static types(): {
23738
+ [key: string]: any;
23739
+ };
23740
+ constructor(map?: {
23741
+ [key: string]: any;
23742
+ });
23743
+ }
23732
23744
  export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType extends $tea.Model {
23733
23745
  baselineCredit?: number;
23734
23746
  cpuArchitecture?: string;
@@ -23767,6 +23779,7 @@ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType
23767
23779
  primaryEniQueueNumber?: number;
23768
23780
  queuePairNumber?: number;
23769
23781
  secondaryEniQueueNumber?: number;
23782
+ supportedBootModes?: DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeSupportedBootModes;
23770
23783
  totalEniQueueQuantity?: number;
23771
23784
  static names(): {
23772
23785
  [key: string]: string;
@@ -30232,19 +30245,20 @@ export default class Client extends OpenApi {
30232
30245
  */
30233
30246
  createCapacityReservation(request: CreateCapacityReservationRequest): Promise<CreateCapacityReservationResponse>;
30234
30247
  /**
30248
+ * ## [](#)Usage notes
30235
30249
  * * You can create commands of the following types:
30236
- * * RunBatScript: batch commands. These commands are applicable to Windows instances.
30237
- * * RunPowerShellScript: PowerShell commands. These commands are applicable to Windows instances.
30238
- * * RunShellScript: shell commands. These commands are applicable to Linux instances.
30239
- * * You can specify the TimeOut parameter to set the maximum timeout period for executions of a command on Elastic Compute Service (ECS) instances. If an execution times out, the Cloud Assistant client forcefully terminates the command process by canceling the process ID (PID) of the command. For more information, see [Install the Cloud Assistant client](~~64921~~).
30240
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30250
+ * * Batch commands (RunBatScript), applicable to Windows instances
30251
+ * * PowerShell commands (RunPowerShellScript), applicable to Windows instances
30252
+ * * Shell commands (RunShellScript), applicable to Linux instances
30253
+ * * You can specify the Timeout parameter to set the maximum timeout period for executions of a command on Elastic Compute Service (ECS) instances. If an execution times out, [Cloud Assistant Agent](~~64921~~) forcefully terminates the command process by canceling the process ID (PID) of the command.
30254
+ * * For a one-time task, when the execution times out, the state of the command ([InvokeRecordStatus](~~64845~~)) becomes Failed.
30241
30255
  * * For a scheduled task, take note of the following items:
30242
- * * The timeout period takes effect on each execution of the command.
30243
- * * When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30244
- * * The timeout of one execution does not affect the subsequent executions of the command.
30245
- * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region.
30246
- * * You can use the WorkingDir parameter to specify the execution directory of a Cloud Assistant command. For Linux instances, the default execution directory of a command is the home directory of the root user, which is `/root`. For Windows instances, the default execution directory of a command is the directory where the Cloud Assistant client process resides, such as `C:\\Windows\\System32`.
30247
- * * You can enable the custom parameter feature for a Cloud Assistant command by setting EnableParameter to true when you create the command. When you configure the CommandContent parameter, you can define custom parameters in the {{parameter}} format. Then, when the [InvokeCommand](~~64841~~) operation is called, the key-value pairs of custom parameters are passed in. For example, assume that the command content is `echo {{name}}`. You can use the Parameters parameter to pass in the `<name, Jack>` key-value pair when the InvokeCommand operation is called. The name key of the custom parameter is automatically replaced by the paired Jack value to generate a new command. Therefore, the `echo Jack` command is actually run.
30256
+ * * The timeout period takes effect on each execution.
30257
+ * * When an execution times out, the state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30258
+ * * The timeout of one execution does not affect the subsequent executions.
30259
+ * * You can retain up to 500 to 50,000 Cloud Assistant commands in each region. You can also apply for a quota increase. For information about how to query and increase quotas, see [Manage quotas](~~184116~~).
30260
+ * * You can use WorkingDir to specify the execution directory of a Cloud Assistant command. For Linux instances, the default execution directory of Cloud Assistant commands is the home directory of the root user, which is `/root`. For Windows instances, the default execution directory of Cloud Assistant commands is the directory where the Cloud Assistant Agent process resides, such as `C:\\Windows\\System32`.
30261
+ * * You can enable the custom parameter feature for a Cloud Assistant command by setting EnableParameter to true. When you set CommandContent, you can define custom parameters in the {{parameter}} format. Then, when the [InvokeCommand](~~64841~~) operation is called, the key-value pairs of custom parameters are passed in. For example, if a command is `echo {{name}}`, the Parameters parameter can be used to pass in the `<name, Jack>` key-value pair when the InvokeCommand operation is called. The name key of the custom parameter is automatically replaced by the paired Jack value to generate a new command. As a result, the `echo Jack` command is run.
30248
30262
  *
30249
30263
  * @param request CreateCommandRequest
30250
30264
  * @param runtime runtime options for this request RuntimeOptions
@@ -30252,19 +30266,20 @@ export default class Client extends OpenApi {
30252
30266
  */
30253
30267
  createCommandWithOptions(request: CreateCommandRequest, runtime: $Util.RuntimeOptions): Promise<CreateCommandResponse>;
30254
30268
  /**
30269
+ * ## [](#)Usage notes
30255
30270
  * * You can create commands of the following types:
30256
- * * RunBatScript: batch commands. These commands are applicable to Windows instances.
30257
- * * RunPowerShellScript: PowerShell commands. These commands are applicable to Windows instances.
30258
- * * RunShellScript: shell commands. These commands are applicable to Linux instances.
30259
- * * You can specify the TimeOut parameter to set the maximum timeout period for executions of a command on Elastic Compute Service (ECS) instances. If an execution times out, the Cloud Assistant client forcefully terminates the command process by canceling the process ID (PID) of the command. For more information, see [Install the Cloud Assistant client](~~64921~~).
30260
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30271
+ * * Batch commands (RunBatScript), applicable to Windows instances
30272
+ * * PowerShell commands (RunPowerShellScript), applicable to Windows instances
30273
+ * * Shell commands (RunShellScript), applicable to Linux instances
30274
+ * * You can specify the Timeout parameter to set the maximum timeout period for executions of a command on Elastic Compute Service (ECS) instances. If an execution times out, [Cloud Assistant Agent](~~64921~~) forcefully terminates the command process by canceling the process ID (PID) of the command.
30275
+ * * For a one-time task, when the execution times out, the state of the command ([InvokeRecordStatus](~~64845~~)) becomes Failed.
30261
30276
  * * For a scheduled task, take note of the following items:
30262
- * * The timeout period takes effect on each execution of the command.
30263
- * * When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30264
- * * The timeout of one execution does not affect the subsequent executions of the command.
30265
- * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region.
30266
- * * You can use the WorkingDir parameter to specify the execution directory of a Cloud Assistant command. For Linux instances, the default execution directory of a command is the home directory of the root user, which is `/root`. For Windows instances, the default execution directory of a command is the directory where the Cloud Assistant client process resides, such as `C:\\Windows\\System32`.
30267
- * * You can enable the custom parameter feature for a Cloud Assistant command by setting EnableParameter to true when you create the command. When you configure the CommandContent parameter, you can define custom parameters in the {{parameter}} format. Then, when the [InvokeCommand](~~64841~~) operation is called, the key-value pairs of custom parameters are passed in. For example, assume that the command content is `echo {{name}}`. You can use the Parameters parameter to pass in the `<name, Jack>` key-value pair when the InvokeCommand operation is called. The name key of the custom parameter is automatically replaced by the paired Jack value to generate a new command. Therefore, the `echo Jack` command is actually run.
30277
+ * * The timeout period takes effect on each execution.
30278
+ * * When an execution times out, the state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
30279
+ * * The timeout of one execution does not affect the subsequent executions.
30280
+ * * You can retain up to 500 to 50,000 Cloud Assistant commands in each region. You can also apply for a quota increase. For information about how to query and increase quotas, see [Manage quotas](~~184116~~).
30281
+ * * You can use WorkingDir to specify the execution directory of a Cloud Assistant command. For Linux instances, the default execution directory of Cloud Assistant commands is the home directory of the root user, which is `/root`. For Windows instances, the default execution directory of Cloud Assistant commands is the directory where the Cloud Assistant Agent process resides, such as `C:\\Windows\\System32`.
30282
+ * * You can enable the custom parameter feature for a Cloud Assistant command by setting EnableParameter to true. When you set CommandContent, you can define custom parameters in the {{parameter}} format. Then, when the [InvokeCommand](~~64841~~) operation is called, the key-value pairs of custom parameters are passed in. For example, if a command is `echo {{name}}`, the Parameters parameter can be used to pass in the `<name, Jack>` key-value pair when the InvokeCommand operation is called. The name key of the custom parameter is automatically replaced by the paired Jack value to generate a new command. As a result, the `echo Jack` command is run.
30268
30283
  *
30269
30284
  * @param request CreateCommandRequest
30270
30285
  * @return CreateCommandResponse
@@ -30642,6 +30657,7 @@ export default class Client extends OpenApi {
30642
30657
  * * If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
30643
30658
  * * An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
30644
30659
  * * When an ENI is detached from an instance and attached to another instance, the attributes of the ENI remain unchanged and network traffic is redirected to the new instance.
30660
+ * * When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
30645
30661
  * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 is enabled for the vSwitch with which you want to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30646
30662
  * * A quota is imposed on the number of ENIs that can be created per Alibaba Cloud region per account. You can view the quota in the ECS console. For more information, see [View and increase resource quotas](~~184115~~).
30647
30663
  * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
@@ -30658,6 +30674,7 @@ export default class Client extends OpenApi {
30658
30674
  * * If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
30659
30675
  * * An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
30660
30676
  * * When an ENI is detached from an instance and attached to another instance, the attributes of the ENI remain unchanged and network traffic is redirected to the new instance.
30677
+ * * When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
30661
30678
  * * If you want to assign IPv6 addresses when you create an ENI, make sure that IPv6 is enabled for the vSwitch with which you want to associate the ENI. For more information, see [What is an IPv6 gateway?](~~98896~~)
30662
30679
  * * A quota is imposed on the number of ENIs that can be created per Alibaba Cloud region per account. You can view the quota in the ECS console. For more information, see [View and increase resource quotas](~~184115~~).
30663
30680
  * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
@@ -32121,20 +32138,7 @@ export default class Client extends OpenApi {
32121
32138
  * @return DescribeInstanceStatusResponse
32122
32139
  */
32123
32140
  describeInstanceStatus(request: DescribeInstanceStatusRequest): Promise<DescribeInstanceStatusResponse>;
32124
- /**
32125
- * > The DescribeInstanceTopology operation is in invitational preview and is not commercially available.
32126
- *
32127
- * @param request DescribeInstanceTopologyRequest
32128
- * @param runtime runtime options for this request RuntimeOptions
32129
- * @return DescribeInstanceTopologyResponse
32130
- */
32131
32141
  describeInstanceTopologyWithOptions(request: DescribeInstanceTopologyRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceTopologyResponse>;
32132
- /**
32133
- * > The DescribeInstanceTopology operation is in invitational preview and is not commercially available.
32134
- *
32135
- * @param request DescribeInstanceTopologyRequest
32136
- * @return DescribeInstanceTopologyResponse
32137
- */
32138
32142
  describeInstanceTopology(request: DescribeInstanceTopologyRequest): Promise<DescribeInstanceTopologyResponse>;
32139
32143
  describeInstanceTypeFamiliesWithOptions(request: DescribeInstanceTypeFamiliesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceTypeFamiliesResponse>;
32140
32144
  describeInstanceTypeFamilies(request: DescribeInstanceTypeFamiliesRequest): Promise<DescribeInstanceTypeFamiliesResponse>;
@@ -32243,10 +32247,12 @@ export default class Client extends OpenApi {
32243
32247
  */
32244
32248
  describeInstancesFullStatus(request: DescribeInstancesFullStatusRequest): Promise<DescribeInstancesFullStatusResponse>;
32245
32249
  /**
32246
- * * After you run a command, the command may fail to run or may return unexpected results. You can call this operation to query the actual execution results.
32250
+ * ## [](#)Usage notes
32251
+ * * After you run a command, the command may fail to run or may return unexpected results. You can call this operation to query the execution results of a command.
32247
32252
  * * You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
32248
- * - Method 1: During a paged query, when you call the DescribeInvocationResults operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocationResults operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.
32249
- * - Method 2: Use PageSize to specify the number of entries to return on each page and then use PageNumber to specify the number of the page to return. You can use only one of the preceding methods. If you specify MaxResults or NextToken, the PageSize and PageNumber request parameters do not take effect and the TotalCount response parameter is invalid.
32253
+ * * You can use one of the following methods to check the responses:
32254
+ * * Method 1: During a paged query, when you call the DescribeInvocationResults operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocationResults operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32255
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page and then use `PageNumber` to specify the number of the page to return. You can use only one of the preceding methods. If you specify `MaxResults` or `NextToken`, the `PageSize` and `PageNumber` request parameters do not take effect and the `TotalCount` response parameter is invalid.
32250
32256
  *
32251
32257
  * @param request DescribeInvocationResultsRequest
32252
32258
  * @param runtime runtime options for this request RuntimeOptions
@@ -32254,10 +32260,12 @@ export default class Client extends OpenApi {
32254
32260
  */
32255
32261
  describeInvocationResultsWithOptions(request: DescribeInvocationResultsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInvocationResultsResponse>;
32256
32262
  /**
32257
- * * After you run a command, the command may fail to run or may return unexpected results. You can call this operation to query the actual execution results.
32263
+ * ## [](#)Usage notes
32264
+ * * After you run a command, the command may fail to run or may return unexpected results. You can call this operation to query the execution results of a command.
32258
32265
  * * You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
32259
- * - Method 1: During a paged query, when you call the DescribeInvocationResults operation to retrieve the first page of results, set MaxResults to specify the maximum number of entries to return in the call. The return value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocationResults operation to retrieve a new page of results, set NextToken to the NextToken value returned in the previous call and set MaxResults to specify the maximum number of entries to return in this call.
32260
- * - Method 2: Use PageSize to specify the number of entries to return on each page and then use PageNumber to specify the number of the page to return. You can use only one of the preceding methods. If you specify MaxResults or NextToken, the PageSize and PageNumber request parameters do not take effect and the TotalCount response parameter is invalid.
32266
+ * * You can use one of the following methods to check the responses:
32267
+ * * Method 1: During a paged query, when you call the DescribeInvocationResults operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you call the DescribeInvocationResults operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
32268
+ * * Method 2: Use `PageSize` to specify the number of entries to return on each page and then use `PageNumber` to specify the number of the page to return. You can use only one of the preceding methods. If you specify `MaxResults` or `NextToken`, the `PageSize` and `PageNumber` request parameters do not take effect and the `TotalCount` response parameter is invalid.
32261
32269
  *
32262
32270
  * @param request DescribeInvocationResultsRequest
32263
32271
  * @return DescribeInvocationResultsResponse
@@ -33438,17 +33446,17 @@ export default class Client extends OpenApi {
33438
33446
  * ## [](#)Usage notes
33439
33447
  * * The Elastic Compute Service (ECS) instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
33440
33448
  * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
33441
- * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
33449
+ * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent on an ECS instance](~~64921~~).
33442
33450
  * * Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
33443
33451
  * * You can configure the command to run only once on the instances.
33444
33452
  * * You can configure the command to run multiple times on the instances based on a schedule.
33445
33453
  * * The schedule is specified by the Frequency parameter. The results of each execution of the command do not affect the next execution of the command.
33446
- * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
33447
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
33454
+ * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instances meets your business requirements. For more information, see [Manage the time synchronization service](~~92803~~).[](~~51890~~)
33455
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a fixed interval, only once at a specific time, or at specific times based on a cron expression in a specified year or time zone. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
33448
33456
  * * Linux: 2.2.3.282
33449
33457
  * * Windows: 2.1.3.282
33450
- * * Commands may fail to run due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command fails to run, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
33451
- * * If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
33458
+ * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command execution fails, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
33459
+ * * If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
33452
33460
  * * Before you run the command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances. Run the command when the return value of CloudAssistantStatus is true.
33453
33461
  *
33454
33462
  * @param tmpReq InvokeCommandRequest
@@ -33460,17 +33468,17 @@ export default class Client extends OpenApi {
33460
33468
  * ## [](#)Usage notes
33461
33469
  * * The Elastic Compute Service (ECS) instances on which you want to run the Cloud Assistant command must meet the following requirements. If multiple ECS instances are specified and one of the instances does not meet the requirements for running the command, the call fails. You must specify instances that meet the requirements and call the InvokeCommand operation again.
33462
33470
  * * The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
33463
- * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
33471
+ * * Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent on an ECS instance](~~64921~~).
33464
33472
  * * Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
33465
33473
  * * You can configure the command to run only once on the instances.
33466
33474
  * * You can configure the command to run multiple times on the instances based on a schedule.
33467
33475
  * * The schedule is specified by the Frequency parameter. The results of each execution of the command do not affect the next execution of the command.
33468
- * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
33469
- * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. You can configure a command to run at a fixed interval based on a rate expression, run only once at a specified time, or run at designated times based on a cron expression. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
33476
+ * * If you use a cron expression to specify a schedule, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instances meets your business requirements. For more information, see [Manage the time synchronization service](~~92803~~).[](~~51890~~)
33477
+ * To ensure that scheduled tasks can run as expected, make sure that the version of Cloud Assistant Agent is not earlier than the following ones. A scheduled task can run a command at a fixed interval, only once at a specific time, or at specific times based on a cron expression in a specified year or time zone. If the ClientNeedUpgrade error code is returned, you must upgrade Cloud Assistant Agent to the latest version. For more information, see [Upgrade or disable upgrades for Cloud Assistant Agent](~~134383~~).
33470
33478
  * * Linux: 2.2.3.282
33471
33479
  * * Windows: 2.1.3.282
33472
- * * Commands may fail to run due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command fails to run, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
33473
- * * If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
33480
+ * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on Cloud Assistant Agent. If a command execution fails, no execution information is generated. For more information, see [Check execution results and troubleshoot common issues](~~87029~~).
33481
+ * * If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
33474
33482
  * * Before you run the command on instances, especially new instances, we recommend that you call the [DescribeCloudAssistantStatus](~~87346~~) operation to query the status of Cloud Assistant Agent on the instances. Run the command when the return value of CloudAssistantStatus is true.
33475
33483
  *
33476
33484
  * @param request InvokeCommandRequest
@@ -34324,18 +34332,21 @@ export default class Client extends OpenApi {
34324
34332
  */
34325
34333
  modifyInstanceVpcAttribute(request: ModifyInstanceVpcAttributeRequest): Promise<ModifyInstanceVpcAttributeResponse>;
34326
34334
  /**
34327
- * * You can modify the execution information of a command that is run in one of the following modes:
34328
- * * Period: The command is run on a schedule.
34329
- * * NextRebootOnly: The command is run the next time the instance starts.
34330
- * * EveryReboot: The command is run every time the instance starts.
34331
- * * You can modify the execution information of a command that is in one of the following status (For more information, see the [InvocationStatus](~~64840~~) response parameter of `DescribeInvocations`.):
34332
- * * Pending: The command is being verified or sent. When the execution status on at least one instance is Pending, the overall execution status is Pending.
34333
- * * Running: The command is being run on the instance. When the execution status on at least one instance is Running, the overall execution status is Running.
34334
- * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution status on at least one instance is Scheduled, the overall execution status is Scheduled.
34335
- * * Stopping: The command that is running is being stopped. When the execution status on at least one instance is Stopping, the overall execution status is Stopping.
34336
- * * The Cloud Assistant Agent version that is installed on the instance must be later than one of the following versions to support the ModifyInvocationAttribute operation. If the `ClientNeedUpgrade` error code is returned, update Cloud Assistant Agent to the latest version.
34335
+ * * You can modify the execution information of a task that runs a command in one of the following modes. To query the execution mode of a command, you can call the [DescribeInvocations](~~2679916~~) operation and check the `RepeatMode` value in the response.
34336
+ * * Period: The task runs the command on a schedule.
34337
+ * * NextRebootOnly: The task runs the command the next time the associated instances start.
34338
+ * * EveryReboot: The task runs the command every time the associated instances start.
34339
+ * * You can modify the execution information of a command task in one of the following execution states. To query the execution status of a command, you can call the [DescribeInvocations](~~2679916~~) operation and check the `InvocationStatus` value.
34340
+ * * Pending: The command is being verified or sent. When the execution state on at least one instance is Pending, the overall execution state is Pending.
34341
+ * * Running: The command is being run on instances. When the execution state on at least one instance is Running, the overall execution state is Running.
34342
+ * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution state on at least one instance is Scheduled, the overall execution state is Scheduled.
34343
+ * * Stopping: The command task is being stopped. When the execution state on at least one instance is Stopping, the overall execution state is Stopping.
34344
+ * * Before you modify the execution information of a scheduled task, such as the command content, custom parameters, and execution frequency, make sure that the version of Cloud Assistant Agent on the ECS instances or managed instances associated with the task is later than the following versions:
34337
34345
  * * Linux: 2.2.3.541
34338
34346
  * * Windows: 2.1.3.541
34347
+ * * If the `InvalidOperation.CloudAssistantVersionUnsupported` error code is returned in the response, update Cloud Assistant Agent to the latest version.
34348
+ * * You cannot modify `CommandContent` for a common Cloud Assistant command.
34349
+ * * If you modify the `CommandContent` value of a command and set `KeepCommand` to `true` when you call the [InvokeCommand](~~64841~~) or [RunCommand](~~141751~~) operation to run the command, a new command is added and retained. The new command consumes the quota for Cloud Assistant commands. You can retain up to 500 to 50,000 Cloud Assistant commands in each region. You can apply for a quota increase. For information about how to query and increase quotas, see [Manage quotas](~~184116~~).
34339
34350
  *
34340
34351
  * @param tmpReq ModifyInvocationAttributeRequest
34341
34352
  * @param runtime runtime options for this request RuntimeOptions
@@ -34343,18 +34354,21 @@ export default class Client extends OpenApi {
34343
34354
  */
34344
34355
  modifyInvocationAttributeWithOptions(tmpReq: ModifyInvocationAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInvocationAttributeResponse>;
34345
34356
  /**
34346
- * * You can modify the execution information of a command that is run in one of the following modes:
34347
- * * Period: The command is run on a schedule.
34348
- * * NextRebootOnly: The command is run the next time the instance starts.
34349
- * * EveryReboot: The command is run every time the instance starts.
34350
- * * You can modify the execution information of a command that is in one of the following status (For more information, see the [InvocationStatus](~~64840~~) response parameter of `DescribeInvocations`.):
34351
- * * Pending: The command is being verified or sent. When the execution status on at least one instance is Pending, the overall execution status is Pending.
34352
- * * Running: The command is being run on the instance. When the execution status on at least one instance is Running, the overall execution status is Running.
34353
- * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution status on at least one instance is Scheduled, the overall execution status is Scheduled.
34354
- * * Stopping: The command that is running is being stopped. When the execution status on at least one instance is Stopping, the overall execution status is Stopping.
34355
- * * The Cloud Assistant Agent version that is installed on the instance must be later than one of the following versions to support the ModifyInvocationAttribute operation. If the `ClientNeedUpgrade` error code is returned, update Cloud Assistant Agent to the latest version.
34357
+ * * You can modify the execution information of a task that runs a command in one of the following modes. To query the execution mode of a command, you can call the [DescribeInvocations](~~2679916~~) operation and check the `RepeatMode` value in the response.
34358
+ * * Period: The task runs the command on a schedule.
34359
+ * * NextRebootOnly: The task runs the command the next time the associated instances start.
34360
+ * * EveryReboot: The task runs the command every time the associated instances start.
34361
+ * * You can modify the execution information of a command task in one of the following execution states. To query the execution status of a command, you can call the [DescribeInvocations](~~2679916~~) operation and check the `InvocationStatus` value.
34362
+ * * Pending: The command is being verified or sent. When the execution state on at least one instance is Pending, the overall execution state is Pending.
34363
+ * * Running: The command is being run on instances. When the execution state on at least one instance is Running, the overall execution state is Running.
34364
+ * * Scheduled: The command that is set to run on a schedule is sent and waiting to be run. When the execution state on at least one instance is Scheduled, the overall execution state is Scheduled.
34365
+ * * Stopping: The command task is being stopped. When the execution state on at least one instance is Stopping, the overall execution state is Stopping.
34366
+ * * Before you modify the execution information of a scheduled task, such as the command content, custom parameters, and execution frequency, make sure that the version of Cloud Assistant Agent on the ECS instances or managed instances associated with the task is later than the following versions:
34356
34367
  * * Linux: 2.2.3.541
34357
34368
  * * Windows: 2.1.3.541
34369
+ * * If the `InvalidOperation.CloudAssistantVersionUnsupported` error code is returned in the response, update Cloud Assistant Agent to the latest version.
34370
+ * * You cannot modify `CommandContent` for a common Cloud Assistant command.
34371
+ * * If you modify the `CommandContent` value of a command and set `KeepCommand` to `true` when you call the [InvokeCommand](~~64841~~) or [RunCommand](~~141751~~) operation to run the command, a new command is added and retained. The new command consumes the quota for Cloud Assistant commands. You can retain up to 500 to 50,000 Cloud Assistant commands in each region. You can apply for a quota increase. For information about how to query and increase quotas, see [Manage quotas](~~184116~~).
34358
34372
  *
34359
34373
  * @param request ModifyInvocationAttributeRequest
34360
34374
  * @return ModifyInvocationAttributeResponse