@alicloud/ecs20140526 7.8.5 → 7.9.0

package/src/models/CreateActivationResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateActivationResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The value of the activation code. The value is returned only once after the CreateActivation operation is called and cannot be queried afterward. Properly save the return value.
+   * The value of the activation code. The code is returned only once when you call this operation and cannot be queried afterward. Store the return value properly.
    * 
    * @example
    * a-hz0ch3SwhOlE1234+Xo32lAZC****
@@ -13,7 +13,7 @@ export class CreateActivationResponseBody extends $dara.Model {
   activationCode?: string;
   /**
    * @remarks
-   * The ID of the activation code.
+   * The activation code ID.
    * 
    * @example
    * 4ECEEE12-56F1-4FBC-9AB1-890F1234****
@@ -21,7 +21,7 @@ export class CreateActivationResponseBody extends $dara.Model {
   activationId?: string;
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * 4ECEEE12-56F1-4FBC-9AB1-890F1234****

package/src/models/CreateCommandRequest.ts

@@ -5,11 +5,11 @@ import * as $dara from '@darabonba/typescript';
 export class CreateCommandRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N. Valid values of N: 1 to 20. The tag key cannot be an empty string.
+   * The tag key of the command. Valid values of N: 1 to 20. The tag key cannot be an empty string.
    * 
-   * If a single tag is specified to query resources, up to 1,000 resources that have this tag added can be displayed in the response. If multiple tags are specified to query resources, up to 1,000 resources that have all these tags added can be displayed in the response. To query more than 1,000 resources that have specified tags, call [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation.
+   * If you use a single tag to filter resources, the resource count with the specified tag cannot exceed 1,000. If you use multiple tags to filter resources, the resource count of resources that have all specified tags attached cannot exceed 1,000. If the resource count exceeds 1,000, use the [ListTagResources](https://help.aliyun.com/document_detail/110425.html) operation to query resources.
    * 
-   * The tag key can be up to 64 characters in length and cannot start with `acs:` or `aliyun`. It cannot contain `http://` or `https://`.
+   * The tag key can be up to 64 characters in length and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.
    * 
    * @example
    * TestKey
@@ -17,9 +17,9 @@ export class CreateCommandRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N. Valid values of N: 1 to 20. The tag value can be an empty string.
+   * The tag value of the command. Valid values of N: 1 to 20. The tag value can be an empty string.
    * 
-   * It can be up to 128 characters in length and cannot contain `http://` or `https://`.
+   * The tag value can be up to 128 characters in length and cannot contain `http://` or `https://`.
    * 
    * @example
    * TestValue
@@ -51,7 +51,7 @@ export class CreateCommandRequestTag extends $dara.Model {
 export class CreateCommandRequest extends $dara.Model {
   /**
    * @remarks
-   * Ensures the idempotence of the request. Generate a unique value for this parameter from your client to guarantee uniqueness across different requests. **ClientToken** supports only ASCII characters and cannot exceed 64 characters. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
+   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that the token is unique among different requests. **ClientToken** supports only ASCII characters and cannot exceed 64 characters in length. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
    * 
    * @example
    * 123e4567-e89b-12d3-a456-426655440000
@@ -59,49 +59,32 @@ export class CreateCommandRequest extends $dara.Model {
   clientToken?: string;
   /**
    * @remarks
-   * The Base64-encoded content of the command. Take note of the following items:
-   * 
-   * - The value must be Base64-encoded and cannot exceed 18 KB in size.
-   * 
-   * - You can use custom parameters in the command content. To enable the custom parameter feature, you must set `EnableParameter` to true.
-   * 
-   *   - Custom parameters are defined in the `{{}}` format. Within `{{}}`, the spaces and line feeds before and after the parameter names are ignored.
-   * 
-   *   - You can specify up to 20 custom parameters.
-   * 
-   *   - A custom parameter name can contain only letters, digits, underscores (_), and hyphens (-). The name is case-insensitive. The ACS:: prefix cannot be used to specify non-built-in environment parameters.
-   * 
-   *   - Each custom parameter name can be up to 64 bytes in length.
-   * 
-   * - You can specify built-in environment parameters as custom parameters in a command. When you run the command, Cloud Assistant automatically uses the environment parameter values for the custom parameters. You can specify the following built-in environment variables:
-   * 
-   *   - `{{ACS::RegionId}}`: the region ID.
-   * 
-   *   - `{{ACS::AccountId}}`: the UID of the Alibaba Cloud account.
-   * 
-   *   - `{{ACS::InstanceId}}`: the instance ID. If you want to run the command on multiple instances and specify `{{ACS::InstanceId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:
-   * 
-   *     - Linux: 2.2.3.309
-   * 
-   *     - Windows: 2.1.3.309
-   * 
-   *   - `{{ACS::InstanceName}}`: the instance name. If you want to run the command on multiple instances and specify `{{ACS::InstanceName}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:
-   * 
-   *     - Linux: 2.2.3.344
-   * 
-   *     - Windows: 2.1.3.344
-   * 
-   *   - `{{ACS::InvokeId}}`: the ID of the task. If you want to specify `{{ACS::InvokeId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:
-   * 
-   *     - Linux: 2.2.3.309
-   * 
-   *     - Windows: 2.1.3.309
-   * 
-   *   - `{{ACS::CommandId}}`: the command ID. If you want to call the [RunCommand](https://help.aliyun.com/document_detail/141751.html) operation to run the command and specify `{{ACS::CommandId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than the following versions:
-   * 
-   *     - Linux: 2.2.3.309
-   * 
-   *     - Windows: 2.1.3.309
+   * The Base64-encoded content of the command.
+   * 
+   * - The value of this parameter must be Base64-encoded, and the script content cannot exceed 18 KB in size after Base64 encoding.
+   * - The command content supports custom parameters. To enable the custom parameter feature, set `EnableParameter=true`:
+   *     - Custom parameters are defined by enclosing them in `{{}}`. Spaces and line breaks before and after the parameter name within `{{}}` are ignored.
+   *     - The number of custom parameters cannot exceed 20.
+   *     - Custom parameter names can contain letters (a-z, A-Z), digits (0-9), hyphens (-), and underscores (_). The acs:: prefix for specifying non-built-in environment parameters is not supported. Other characters are not supported. Parameter names are case-insensitive.
+   *     - Each parameter name cannot exceed 64 bytes in length.
+   * 
+   * - You can specify built-in environment parameters as custom parameters. When the command is run, Cloud Assistant automatically replaces them with the corresponding values from the environment without requiring manual assignment. The following built-in environment parameters are supported:
+   *     - `{{ACS::RegionId}}`: the region ID.
+   *     - `{{ACS::AccountId}}`: the UID of the Alibaba Cloud account.
+   *     - `{{ACS::InstanceId}}`: the instance ID. When a command is sent to multiple instances and you want to use `{{ACS::InstanceId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than:
+   *         - Linux: 2.2.3.309
+   *         - Windows: 2.1.3.309
+   *     - `{{ACS::InstanceName}}`: the instance name. When a command is sent to multiple instances and you want to use `{{ACS::InstanceName}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than:
+   *         - Linux: 2.2.3.344
+   *         - Windows: 2.1.3.344
+   * 
+   *     - `{{ACS::InvokeId}}`: the command execution ID. To use `{{ACS::InvokeId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than:
+   *         - Linux: 2.2.3.309
+   *         - Windows: 2.1.3.309
+   *      
+   *     - `{{ACS::CommandId}}`: the command ID. When you run a command by calling the [RunCommand](https://help.aliyun.com/document_detail/141751.html) operation and want to use `{{ACS::CommandId}}` as a built-in environment parameter, make sure that the Cloud Assistant Agent version is not earlier than:
+   *         - Linux: 2.2.3.309
+   *         - Windows: 2.1.3.309.
    * 
    * This parameter is required.
    * 
@@ -113,13 +96,13 @@ export class CreateCommandRequest extends $dara.Model {
    * @remarks
    * The encoding mode of the command content (CommandContent). Valid values:
    * 
-   * - PlainText: The command content is not encoded.
+   * - PlainText: no encoding. The content is transmitted in plaintext.
    * 
-   * - Base64: The command content is Base64-encoded.
+   * - Base64: Base64 encoding.
    * 
    * Default value: Base64.
    * 
-   * > If the specified value of this parameter is invalid, Base64 is used by default.
+   * > If an invalid value is specified, it is treated as Base64.
    * 
    * @example
    * PlainText
@@ -127,7 +110,7 @@ export class CreateCommandRequest extends $dara.Model {
   contentEncoding?: string;
   /**
    * @remarks
-   * The description of the command. The description supports all character sets and can be up to 512 characters in length.
+   * The command description. All character sets are supported. The description cannot exceed 512 characters in length.
    * 
    * @example
    * testDescription
@@ -135,7 +118,7 @@ export class CreateCommandRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * Specifies whether to use custom parameters in the command.
+   * Specifies whether the command uses custom parameters.
    * 
    * Default value: false.
    * 
@@ -145,7 +128,7 @@ export class CreateCommandRequest extends $dara.Model {
   enableParameter?: boolean;
   /**
    * @remarks
-   * The launcher for script execution. The value cannot exceed 1 KB in length.
+   * The bootstrap program for script execution. The value cannot exceed 1 KB in length.
    * 
    * @example
    * python3 -u {{ACS::ScriptFileName|Ext(".py")}}
@@ -153,7 +136,7 @@ export class CreateCommandRequest extends $dara.Model {
   launcher?: string;
   /**
    * @remarks
-   * The name of the command. The name supports all character sets and can be up to 128 characters in length.
+   * The command name. All character sets are supported. The name cannot exceed 128 characters in length.
    * 
    * This parameter is required.
    * 
@@ -165,7 +148,7 @@ export class CreateCommandRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The ID of the region in which to create the command. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
+   * The region ID. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -175,7 +158,7 @@ export class CreateCommandRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group to which to assign the command.
+   * The ID of the resource group to which the command belongs.
    * 
    * @example
    * rg-123******
@@ -185,12 +168,12 @@ export class CreateCommandRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The tags to add to the command.
+   * The list of tags.
    */
   tag?: CreateCommandRequestTag[];
   /**
    * @remarks
-   * he maximum timeout period for the command execution on the instance. Unit: seconds. When a command that you created cannot be run, the command times out. When a command execution times out, Cloud Assistant Agent forcefully terminates the command process by canceling the PID.
+   * The maximum timeout period for the command to run on the ECS instance. Unit: seconds. If the command cannot be run for any reason, a timeout occurs. After the timeout, the command process is forcefully terminated by canceling the PID of the command.
    * 
    * Default value: 60.
    * 
@@ -200,13 +183,11 @@ export class CreateCommandRequest extends $dara.Model {
   timeout?: number;
   /**
    * @remarks
-   * The command type. Valid values:
-   * 
-   * - RunBatScript: batch commands. These commands are applicable to Windows instances.
+   * The type of the command. Valid values: 
    * 
-   * - RunPowerShellScript: PowerShell commands. These commands are applicable to Windows instances.
-   * 
-   * - RunShellScript: shell commands. These commands are applicable to Linux instances.
+   * - RunBatScript: creates a Bat script to run on Windows instances.
+   * - RunPowerShellScript: creates a PowerShell script to run on Windows instances.
+   * - RunShellScript: creates a Shell script to run on Linux instances.
    * 
    * This parameter is required.
    * 
@@ -216,15 +197,13 @@ export class CreateCommandRequest extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The execution path of the command on ECS instances. The value can be up to 200 characters in length.
-   * 
-   * Default values:
-   * 
-   * - For Linux instance, the default value is the home directory of the root user, which is the `/root` directory.
+   * The directory where the command is run on the ECS instance. The value cannot exceed 200 characters in length.
    * 
-   * - For Windows instances, the default value is the directory where the Cloud Assistant Agent process resides, such as `C:\\Windows\\System32\\`.
+   * Default value: 
+   * - Linux instances: the home directory of the root user, which is `/root`.  
+   * - Windows instances: the directory where the Cloud Assistant Agent process is located, such as `C:\\Windows\\System32`.
    * 
-   * > If you set WorkingDir to a directory other than default ones, make sure that the directory exists on the instances.
+   * > If you set this parameter to a different directory, make sure that the directory exists on the instance.
    * 
    * @example
    * /home/user

package/src/models/CreateCommandResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateCommandResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the command.
+   * The command ID.
    * 
    * @example
    * c-7d2a745b412b4601b2d47f6a768d****
@@ -13,7 +13,7 @@ export class CreateCommandResponseBody extends $dara.Model {
   commandId?: string;
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****