@alicloud/ecs20140526 4.1.0 → 4.1.2

package/src/client.ts

@@ -12113,6 +12113,8 @@ export class DescribeDedicatedHostsRequest extends $tea.Model {
   dedicatedHostName?: string;
   dedicatedHostType?: string;
   lockReason?: string;
+  maxResults?: number;
+  nextToken?: string;
   ownerAccount?: string;
   ownerId?: number;
   pageNumber?: number;
@@ -12132,6 +12134,8 @@ export class DescribeDedicatedHostsRequest extends $tea.Model {
       dedicatedHostName: 'DedicatedHostName',
       dedicatedHostType: 'DedicatedHostType',
       lockReason: 'LockReason',
+      maxResults: 'MaxResults',
+      nextToken: 'NextToken',
       ownerAccount: 'OwnerAccount',
       ownerId: 'OwnerId',
       pageNumber: 'PageNumber',
@@ -12154,6 +12158,8 @@ export class DescribeDedicatedHostsRequest extends $tea.Model {
       dedicatedHostName: 'string',
       dedicatedHostType: 'string',
       lockReason: 'string',
+      maxResults: 'number',
+      nextToken: 'string',
       ownerAccount: 'string',
       ownerId: 'number',
       pageNumber: 'number',
@@ -12176,6 +12182,7 @@ export class DescribeDedicatedHostsRequest extends $tea.Model {
 
 export class DescribeDedicatedHostsResponseBody extends $tea.Model {
   dedicatedHosts?: DescribeDedicatedHostsResponseBodyDedicatedHosts;
+  nextToken?: string;
   pageNumber?: number;
   pageSize?: number;
   requestId?: string;
@@ -12183,6 +12190,7 @@ export class DescribeDedicatedHostsResponseBody extends $tea.Model {
   static names(): { [key: string]: string } {
     return {
       dedicatedHosts: 'DedicatedHosts',
+      nextToken: 'NextToken',
       pageNumber: 'PageNumber',
       pageSize: 'PageSize',
       requestId: 'RequestId',
@@ -12193,6 +12201,7 @@ export class DescribeDedicatedHostsResponseBody extends $tea.Model {
   static types(): { [key: string]: any } {
     return {
       dedicatedHosts: DescribeDedicatedHostsResponseBodyDedicatedHosts,
+      nextToken: 'string',
       pageNumber: 'number',
       pageSize: 'number',
       requestId: 'string',
@@ -15976,11 +15985,16 @@ export class DescribeInstanceTypeFamiliesResponse extends $tea.Model {
 
 export class DescribeInstanceTypesRequest extends $tea.Model {
   cpuArchitecture?: string;
+  cpuArchitectures?: string[];
   GPUSpec?: string;
+  gpuSpecs?: string[];
+  instanceCategories?: string[];
   instanceCategory?: string;
   instanceFamilyLevel?: string;
+  instanceTypeFamilies?: string[];
   instanceTypeFamily?: string;
   instanceTypes?: string[];
+  localStorageCategories?: string[];
   localStorageCategory?: string;
   maxResults?: number;
   maximumCpuCoreCount?: number;
@@ -16014,16 +16028,22 @@ export class DescribeInstanceTypesRequest extends $tea.Model {
   ownerAccount?: string;
   ownerId?: number;
   physicalProcessorModel?: string;
+  physicalProcessorModels?: string[];
   resourceOwnerAccount?: string;
   resourceOwnerId?: number;
   static names(): { [key: string]: string } {
     return {
       cpuArchitecture: 'CpuArchitecture',
+      cpuArchitectures: 'CpuArchitectures',
       GPUSpec: 'GPUSpec',
+      gpuSpecs: 'GpuSpecs',
+      instanceCategories: 'InstanceCategories',
       instanceCategory: 'InstanceCategory',
       instanceFamilyLevel: 'InstanceFamilyLevel',
+      instanceTypeFamilies: 'InstanceTypeFamilies',
       instanceTypeFamily: 'InstanceTypeFamily',
       instanceTypes: 'InstanceTypes',
+      localStorageCategories: 'LocalStorageCategories',
       localStorageCategory: 'LocalStorageCategory',
       maxResults: 'MaxResults',
       maximumCpuCoreCount: 'MaximumCpuCoreCount',
@@ -16057,6 +16077,7 @@ export class DescribeInstanceTypesRequest extends $tea.Model {
       ownerAccount: 'OwnerAccount',
       ownerId: 'OwnerId',
       physicalProcessorModel: 'PhysicalProcessorModel',
+      physicalProcessorModels: 'PhysicalProcessorModels',
       resourceOwnerAccount: 'ResourceOwnerAccount',
       resourceOwnerId: 'ResourceOwnerId',
     };
@@ -16065,11 +16086,16 @@ export class DescribeInstanceTypesRequest extends $tea.Model {
   static types(): { [key: string]: any } {
     return {
       cpuArchitecture: 'string',
+      cpuArchitectures: { 'type': 'array', 'itemType': 'string' },
       GPUSpec: 'string',
+      gpuSpecs: { 'type': 'array', 'itemType': 'string' },
+      instanceCategories: { 'type': 'array', 'itemType': 'string' },
       instanceCategory: 'string',
       instanceFamilyLevel: 'string',
+      instanceTypeFamilies: { 'type': 'array', 'itemType': 'string' },
       instanceTypeFamily: 'string',
       instanceTypes: { 'type': 'array', 'itemType': 'string' },
+      localStorageCategories: { 'type': 'array', 'itemType': 'string' },
       localStorageCategory: 'string',
       maxResults: 'number',
       maximumCpuCoreCount: 'number',
@@ -16103,6 +16129,7 @@ export class DescribeInstanceTypesRequest extends $tea.Model {
       ownerAccount: 'string',
       ownerId: 'number',
       physicalProcessorModel: 'string',
+      physicalProcessorModels: { 'type': 'array', 'itemType': 'string' },
       resourceOwnerAccount: 'string',
       resourceOwnerId: 'number',
     };
@@ -44733,6 +44760,25 @@ export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeNetworkCa
   }
 }
 
+export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeSupportedBootModes extends $tea.Model {
+  supportedBootMode?: string[];
+  static names(): { [key: string]: string } {
+    return {
+      supportedBootMode: 'SupportedBootMode',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      supportedBootMode: { 'type': 'array', 'itemType': 'string' },
+    };
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType extends $tea.Model {
   baselineCredit?: number;
   cpuArchitecture?: string;
@@ -44771,6 +44817,7 @@ export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType extends
   primaryEniQueueNumber?: number;
   queuePairNumber?: number;
   secondaryEniQueueNumber?: number;
+  supportedBootModes?: DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeSupportedBootModes;
   totalEniQueueQuantity?: number;
   static names(): { [key: string]: string } {
     return {
@@ -44811,6 +44858,7 @@ export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType extends
       primaryEniQueueNumber: 'PrimaryEniQueueNumber',
       queuePairNumber: 'QueuePairNumber',
       secondaryEniQueueNumber: 'SecondaryEniQueueNumber',
+      supportedBootModes: 'SupportedBootModes',
       totalEniQueueQuantity: 'TotalEniQueueQuantity',
     };
   }
@@ -44854,6 +44902,7 @@ export class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType extends
       primaryEniQueueNumber: 'number',
       queuePairNumber: 'number',
       secondaryEniQueueNumber: 'number',
+      supportedBootModes: DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeSupportedBootModes,
       totalEniQueueQuantity: 'number',
     };
   }
@@ -58273,19 +58322,20 @@ export default class Client extends OpenApi {
   }
 
   /**
+    * ## [](#)Usage notes
     * *   You can create commands of the following types:
-    *     *   RunBatScript: batch commands. These commands are applicable to Windows instances.
-    *     *   RunPowerShellScript: PowerShell commands. These commands are applicable to Windows instances.
-    *     *   RunShellScript: shell commands. These commands are applicable to Linux instances.
-    * *   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~~).
-    *     *   When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
+    *     *   Batch commands (RunBatScript), applicable to Windows instances
+    *     *   PowerShell commands (RunPowerShellScript), applicable to Windows instances
+    *     *   Shell commands (RunShellScript), applicable to Linux instances
+    * *   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.
+    *     *   For a one-time task, when the execution times out, the state of the command ([InvokeRecordStatus](~~64845~~)) becomes Failed.
     *     *   For a scheduled task, take note of the following items:
-    *         *   The timeout period takes effect on each execution of the command.
-    *         *   When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
-    *         *   The timeout of one execution does not affect the subsequent executions of the command.
-    * *   You can retain up to 500 to 10,000 Cloud Assistant commands in each region.
-    * *   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`.
-    * *   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.
+    *         *   The timeout period takes effect on each execution.
+    *         *   When an execution times out, the state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
+    *         *   The timeout of one execution does not affect the subsequent executions.
+    * *   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~~).
+    * *   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`.
+    * *   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.
     *
     * @param request CreateCommandRequest
     * @param runtime runtime options for this request RuntimeOptions
@@ -58376,19 +58426,20 @@ export default class Client extends OpenApi {
   }
 
   /**
+    * ## [](#)Usage notes
     * *   You can create commands of the following types:
-    *     *   RunBatScript: batch commands. These commands are applicable to Windows instances.
-    *     *   RunPowerShellScript: PowerShell commands. These commands are applicable to Windows instances.
-    *     *   RunShellScript: shell commands. These commands are applicable to Linux instances.
-    * *   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~~).
-    *     *   When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
+    *     *   Batch commands (RunBatScript), applicable to Windows instances
+    *     *   PowerShell commands (RunPowerShellScript), applicable to Windows instances
+    *     *   Shell commands (RunShellScript), applicable to Linux instances
+    * *   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.
+    *     *   For a one-time task, when the execution times out, the state of the command ([InvokeRecordStatus](~~64845~~)) becomes Failed.
     *     *   For a scheduled task, take note of the following items:
-    *         *   The timeout period takes effect on each execution of the command.
-    *         *   When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
-    *         *   The timeout of one execution does not affect the subsequent executions of the command.
-    * *   You can retain up to 500 to 10,000 Cloud Assistant commands in each region.
-    * *   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`.
-    * *   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.
+    *         *   The timeout period takes effect on each execution.
+    *         *   When an execution times out, the state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
+    *         *   The timeout of one execution does not affect the subsequent executions.
+    * *   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~~).
+    * *   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`.
+    * *   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.
     *
     * @param request CreateCommandRequest
     * @return CreateCommandResponse
@@ -60608,6 +60659,7 @@ export default class Client extends OpenApi {
     * *   If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
     * *   An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
     * *   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.
+    * *   When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
     * *   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~~)
     * *   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~~).
     * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
@@ -60771,6 +60823,7 @@ export default class Client extends OpenApi {
     * *   If NetworkInterfaceId is empty in the response, no ENI is created. Call the operation again to create an ENI.
     * *   An ENI can be attached only to a single instance that resides in a virtual private cloud (VPC).
     * *   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.
+    * *   When you call this operation to create an ENI, you can assign up to 49 secondary private IP addresses to the ENI.
     * *   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~~)
     * *   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~~).
     * **For information about examples on how to call this operation, see** [Create an ENI](~~471552~~).
@@ -66059,6 +66112,14 @@ export default class Client extends OpenApi {
       query["LockReason"] = request.lockReason;
     }
 
+    if (!Util.isUnset(request.maxResults)) {
+      query["MaxResults"] = request.maxResults;
+    }
+
+    if (!Util.isUnset(request.nextToken)) {
+      query["NextToken"] = request.nextToken;
+    }
+
     if (!Util.isUnset(request.ownerAccount)) {
       query["OwnerAccount"] = request.ownerAccount;
     }
@@ -68889,13 +68950,6 @@ export default class Client extends OpenApi {
     return await this.describeInstanceStatusWithOptions(request, runtime);
   }
 
-  /**
-    * > The DescribeInstanceTopology operation is in invitational preview and is not commercially available.
-    *
-    * @param request DescribeInstanceTopologyRequest
-    * @param runtime runtime options for this request RuntimeOptions
-    * @return DescribeInstanceTopologyResponse
-   */
   async describeInstanceTopologyWithOptions(request: DescribeInstanceTopologyRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceTopologyResponse> {
     Util.validateModel(request);
     let query = { };
@@ -68936,12 +68990,6 @@ export default class Client extends OpenApi {
     return $tea.cast<DescribeInstanceTopologyResponse>(await this.callApi(params, req, runtime), new DescribeInstanceTopologyResponse({}));
   }
 
-  /**
-    * > The DescribeInstanceTopology operation is in invitational preview and is not commercially available.
-    *
-    * @param request DescribeInstanceTopologyRequest
-    * @return DescribeInstanceTopologyResponse
-   */
   async describeInstanceTopology(request: DescribeInstanceTopologyRequest): Promise<DescribeInstanceTopologyResponse> {
     let runtime = new $Util.RuntimeOptions({ });
     return await this.describeInstanceTopologyWithOptions(request, runtime);
@@ -69015,10 +69063,22 @@ export default class Client extends OpenApi {
       query["CpuArchitecture"] = request.cpuArchitecture;
     }
 
+    if (!Util.isUnset(request.cpuArchitectures)) {
+      query["CpuArchitectures"] = request.cpuArchitectures;
+    }
+
     if (!Util.isUnset(request.GPUSpec)) {
       query["GPUSpec"] = request.GPUSpec;
     }
 
+    if (!Util.isUnset(request.gpuSpecs)) {
+      query["GpuSpecs"] = request.gpuSpecs;
+    }
+
+    if (!Util.isUnset(request.instanceCategories)) {
+      query["InstanceCategories"] = request.instanceCategories;
+    }
+
     if (!Util.isUnset(request.instanceCategory)) {
       query["InstanceCategory"] = request.instanceCategory;
     }
@@ -69027,6 +69087,10 @@ export default class Client extends OpenApi {
       query["InstanceFamilyLevel"] = request.instanceFamilyLevel;
     }
 
+    if (!Util.isUnset(request.instanceTypeFamilies)) {
+      query["InstanceTypeFamilies"] = request.instanceTypeFamilies;
+    }
+
     if (!Util.isUnset(request.instanceTypeFamily)) {
       query["InstanceTypeFamily"] = request.instanceTypeFamily;
     }
@@ -69035,6 +69099,10 @@ export default class Client extends OpenApi {
       query["InstanceTypes"] = request.instanceTypes;
     }
 
+    if (!Util.isUnset(request.localStorageCategories)) {
+      query["LocalStorageCategories"] = request.localStorageCategories;
+    }
+
     if (!Util.isUnset(request.localStorageCategory)) {
       query["LocalStorageCategory"] = request.localStorageCategory;
     }
@@ -69167,6 +69235,10 @@ export default class Client extends OpenApi {
       query["PhysicalProcessorModel"] = request.physicalProcessorModel;
     }
 
+    if (!Util.isUnset(request.physicalProcessorModels)) {
+      query["PhysicalProcessorModels"] = request.physicalProcessorModels;
+    }
+
     if (!Util.isUnset(request.resourceOwnerAccount)) {
       query["ResourceOwnerAccount"] = request.resourceOwnerAccount;
     }
@@ -69613,10 +69685,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * *   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.
+    * ## [](#)Usage notes
+    * *   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.
     * *   You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
-    *     - 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. 
-    *     - 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.
+    * *   You can use one of the following methods to check the responses:
+    *     *   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.
+    *     *   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.
     *
     * @param request DescribeInvocationResultsRequest
     * @param runtime runtime options for this request RuntimeOptions
@@ -69715,10 +69789,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * *   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.
+    * ## [](#)Usage notes
+    * *   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.
     * *   You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
-    *     - 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. 
-    *     - 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.
+    * *   You can use one of the following methods to check the responses:
+    *     *   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.
+    *     *   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.
     *
     * @param request DescribeInvocationResultsRequest
     * @return DescribeInvocationResultsResponse
@@ -69729,10 +69805,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * - After you run a command, the command may not succeed or return the expected result. You can call this operation to query the execution result.
-    * - You can query information about command executions within the last four weeks. A maximum of 100,000 entries of execution information can be retained.
-    *   - Method 1: During a paged query, when you call the DescribeInvocations 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 DescribeInvocations 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. 
-    *   - 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.
+    * ## [](#)Usage notes
+    * *   After you run a command, the command may not succeed or return the expected results. You can call this operation to query the execution results.
+    * *   You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
+    * *   You can use one of the following methods to check the responses:
+    *     *   Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, use `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which you can use in the next request to retrieve a new page of results. When you call the DescribeInvocations 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.
+    *     *   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.
     *
     * @param request DescribeInvocationsRequest
     * @param runtime runtime options for this request RuntimeOptions
@@ -69847,10 +69925,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * - After you run a command, the command may not succeed or return the expected result. You can call this operation to query the execution result.
-    * - You can query information about command executions within the last four weeks. A maximum of 100,000 entries of execution information can be retained.
-    *   - Method 1: During a paged query, when you call the DescribeInvocations 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 DescribeInvocations 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. 
-    *   - 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.
+    * ## [](#)Usage notes
+    * *   After you run a command, the command may not succeed or return the expected results. You can call this operation to query the execution results.
+    * *   You can query information about command executions within the last four weeks. Up to 100,000 pieces of execution information can be retained.
+    * *   You can use one of the following methods to check the responses:
+    *     *   Method 1: During a paged query, when you call the DescribeInvocations operation to retrieve the first page of results, use `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token, which you can use in the next request to retrieve a new page of results. When you call the DescribeInvocations 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.
+    *     *   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.
     *
     * @param request DescribeInvocationsRequest
     * @return DescribeInvocationsResponse
@@ -75554,17 +75634,17 @@ export default class Client extends OpenApi {
     * ## [](#)Usage notes
     * *   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.
     *     *   The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
-    *     *   Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
+    *     *   Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent on an ECS instance](~~64921~~).
     *     *   Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
     * *   You can configure the command to run only once on the instances.
     * *   You can configure the command to run multiple times on the instances based on a schedule.
     *     *   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.
-    *     *   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~~).
-    *     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~~).
+    *     *   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~~)
+    *     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~~).
     *     *   Linux: 2.2.3.282
     *     *   Windows: 2.1.3.282
-    * *   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~~).
-    * *   If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
+    * *   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~~).
+    * *   If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
     * *   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.
     *
     * @param tmpReq InvokeCommandRequest
@@ -75685,17 +75765,17 @@ export default class Client extends OpenApi {
     * ## [](#)Usage notes
     * *   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.
     *     *   The instances are in the Running (`Running`) state. You can call the [DescribeInstances](~~25506~~) operation to query the status of instances.
-    *     *   Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent](~~64921~~).
+    *     *   Cloud Assistant Agent is installed on the instances. For more information, see [Install Cloud Assistant Agent on an ECS instance](~~64921~~).
     *     *   Before you run PowerShell commands on the instances, make sure that the instances have the PowerShell module configured.
     * *   You can configure the command to run only once on the instances.
     * *   You can configure the command to run multiple times on the instances based on a schedule.
     *     *   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.
-    *     *   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~~).
-    *     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~~).
+    *     *   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~~)
+    *     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~~).
     *     *   Linux: 2.2.3.282
     *     *   Windows: 2.1.3.282
-    * *   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~~).
-    * *   If you enabled the custom parameter feature when you created the command, you must specify custom parameters (`Parameters`) to run the command.
+    * *   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~~).
+    * *   If you enable the custom parameter feature when you create the command, you must specify custom parameters (`Parameters`) to run the command.
     * *   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.
     *
     * @param request InvokeCommandRequest
@@ -79445,18 +79525,21 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * *   You can modify the execution information of a command that is run in one of the following modes:
-    *     *   Period: The command is run on a schedule.
-    *     *   NextRebootOnly: The command is run the next time the instance starts.
-    *     *   EveryReboot: The command is run every time the instance starts.
-    * *   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`.):
-    *     *   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.
-    *     *   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.
-    *     *   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.
-    *     *   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.
-    * *   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.
+    * *   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.
+    *     *   Period: The task runs the command on a schedule.
+    *     *   NextRebootOnly: The task runs the command the next time the associated instances start.
+    *     *   EveryReboot: The task runs the command every time the associated instances start.
+    * *   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.
+    *     *   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.
+    *     *   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.
+    *     *   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.
+    *     *   Stopping: The command task is being stopped. When the execution state on at least one instance is Stopping, the overall execution state is Stopping.
+    * *   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:
     *     *   Linux: 2.2.3.541
     *     *   Windows: 2.1.3.541
+    *     *   If the `InvalidOperation.CloudAssistantVersionUnsupported` error code is returned in the response, update Cloud Assistant Agent to the latest version.
+    * *   You cannot modify `CommandContent` for a common Cloud Assistant command.
+    * *   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~~).
     *
     * @param tmpReq ModifyInvocationAttributeRequest
     * @param runtime runtime options for this request RuntimeOptions
@@ -79541,18 +79624,21 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * *   You can modify the execution information of a command that is run in one of the following modes:
-    *     *   Period: The command is run on a schedule.
-    *     *   NextRebootOnly: The command is run the next time the instance starts.
-    *     *   EveryReboot: The command is run every time the instance starts.
-    * *   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`.):
-    *     *   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.
-    *     *   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.
-    *     *   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.
-    *     *   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.
-    * *   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.
+    * *   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.
+    *     *   Period: The task runs the command on a schedule.
+    *     *   NextRebootOnly: The task runs the command the next time the associated instances start.
+    *     *   EveryReboot: The task runs the command every time the associated instances start.
+    * *   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.
+    *     *   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.
+    *     *   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.
+    *     *   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.
+    *     *   Stopping: The command task is being stopped. When the execution state on at least one instance is Stopping, the overall execution state is Stopping.
+    * *   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:
     *     *   Linux: 2.2.3.541
     *     *   Windows: 2.1.3.541
+    *     *   If the `InvalidOperation.CloudAssistantVersionUnsupported` error code is returned in the response, update Cloud Assistant Agent to the latest version.
+    * *   You cannot modify `CommandContent` for a common Cloud Assistant command.
+    * *   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~~).
     *
     * @param request ModifyInvocationAttributeRequest
     * @return ModifyInvocationAttributeResponse
@@ -80745,12 +80831,13 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * In the security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
-    * When you modify the rules of a security group by specifying the rule IDs, take note of the following limits:
-    * *   A security group authorization object can be one of the following types: IP address or CIDR block, security group, or prefix list. The type of an existing security group authorization object cannot be changed. If the original authorization object is an IP address, you can change it to another IP address or a CIDR block, but not to a security group or prefix list.
-    * *   The IP address family of the authorization object cannot be changed. For example, if the original authorization object is an IPv4 CIDR block, you cannot change it to an IPv6 CIDR block. If the original authorization object is a prefix list of an IPv4 address family, you cannot change it to a prefix list of an IPv6 address family.
-    * *   The modified security group rule cannot be the same as other existing rules.
-    * *   You cannot delete the value of a non-empty parameter. We recommend that you create a new rule and delete the original rule.
+    * ## [](#)Usage notes
+    * In security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
+    * Take note of the following items:
+    * *   An authorization object in a security group rule can be one of the following types: IP address or CIDR block, security group, or prefix list. You cannot call this operation to change the type of an existing authorization object. For example, if an authorization object is an IP address, you can change the authorization object to another IP address or a CIDR block, but you cannot change the authorization object to a security group or prefix list.
+    * *   You cannot change the IP address family of an existing authorization object. For example, if an authorization object is an IPv4 CIDR block, you cannot change the authorization object to an IPv6 CIDR block. If an authorization object is a prefix list of the IPv4 address family, you cannot change the authorization object to a prefix list of the IPv6 address family.
+    * *   The new security group rule after modification cannot be the same as other existing rules.
+    * *   You cannot delete the value of a non-empty parameter. If you want to delete the values of non-empty parameters, we recommend that you create another rule and delete the original rule.
     *
     * @param request ModifySecurityGroupRuleRequest
     * @param runtime runtime options for this request RuntimeOptions
@@ -80873,12 +80960,13 @@ export default class Client extends OpenApi {
   }
 
   /**
-    * In the security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
-    * When you modify the rules of a security group by specifying the rule IDs, take note of the following limits:
-    * *   A security group authorization object can be one of the following types: IP address or CIDR block, security group, or prefix list. The type of an existing security group authorization object cannot be changed. If the original authorization object is an IP address, you can change it to another IP address or a CIDR block, but not to a security group or prefix list.
-    * *   The IP address family of the authorization object cannot be changed. For example, if the original authorization object is an IPv4 CIDR block, you cannot change it to an IPv6 CIDR block. If the original authorization object is a prefix list of an IPv4 address family, you cannot change it to a prefix list of an IPv6 address family.
-    * *   The modified security group rule cannot be the same as other existing rules.
-    * *   You cannot delete the value of a non-empty parameter. We recommend that you create a new rule and delete the original rule.
+    * ## [](#)Usage notes
+    * In security group-related API documents, inbound traffic refers to the traffic that is sent by the source device and received at the destination device.
+    * Take note of the following items:
+    * *   An authorization object in a security group rule can be one of the following types: IP address or CIDR block, security group, or prefix list. You cannot call this operation to change the type of an existing authorization object. For example, if an authorization object is an IP address, you can change the authorization object to another IP address or a CIDR block, but you cannot change the authorization object to a security group or prefix list.
+    * *   You cannot change the IP address family of an existing authorization object. For example, if an authorization object is an IPv4 CIDR block, you cannot change the authorization object to an IPv6 CIDR block. If an authorization object is a prefix list of the IPv4 address family, you cannot change the authorization object to a prefix list of the IPv6 address family.
+    * *   The new security group rule after modification cannot be the same as other existing rules.
+    * *   You cannot delete the value of a non-empty parameter. If you want to delete the values of non-empty parameters, we recommend that you create another rule and delete the original rule.
     *
     * @param request ModifySecurityGroupRuleRequest
     * @return ModifySecurityGroupRuleResponse