@alicloud/ecs20140526 7.8.4 → 7.8.6

package/src/models/ImportImageRequest.ts

@@ -5,9 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   /**
    * @remarks
-   * The device name of disk N in the custom image.
+   * The device name of DiskDeviceMapping.N.Device in the custom image.
    * 
-   * >  This parameter will be removed in the future. We recommend that you do not use this parameter to ensure future compatibility.
+   * > This parameter will be deprecated. For better compatibility, do not use this parameter.
    * 
    * @example
    * null
@@ -15,16 +15,16 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   device?: string;
   /**
    * @remarks
-   * The size of disk N in the custom image. Unit: GiB.
+   * The size of the custom image. Unit: GiB.
    * 
-   * You can use this parameter to specify the sizes of the system disk and data disks in the custom image. When you specify the size of the system disk, make sure that the specified size is greater than or equal to the size of the imported image file. Unit: GiB. Valid values:
+   * The size includes the system disk and data disks. Make sure that the system disk space is greater than or equal to the size of the imported image file. Valid values:
    * 
-   * *   When the N value is 1, this parameter specifies the size of the system disk in the custom image. Valid values: 1 to 2048.
-   * *   When the N value is an integer in the range of 2 to 17, this parameter specifies the size of a data disk in the custom image. Valid values: 1 to 2048.
+   * - When N is 1, the value specifies the system disk size. Valid values: 1 to 2048.
+   * - When N is 2 to 17, the value specifies the data disk size. Valid values: 1 to 2048.
    * 
-   * After the image file is uploaded to an OSS bucket, you can view the size of the image file in the OSS bucket.
+   * After you upload the source image file to OSS, you can view the image file size in the OSS bucket.
    * 
-   * >  This parameter will be removed in the future. We recommend that you use `DiskDeviceMapping.N.DiskImageSize` to ensure future compatibility.
+   * > This parameter will be deprecated. For better compatibility, use `DiskDeviceMapping.N.DiskImageSize`.
    * 
    * @example
    * 80
@@ -32,14 +32,14 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   diskImSize?: number;
   /**
    * @remarks
-   * The size of disk N in the custom image after the source image is imported.
+   * The size of the custom image after the image is imported.
    * 
-   * You can use this parameter to specify the sizes of the system disk and data disks in the custom image. When you specify the size of the system disk, make sure that the specified size is greater than or equal to the size of the imported image file. Unit: GiB. Valid values:
+   * The size includes the system disk and data disks. Make sure that the system disk space is greater than or equal to the size of the imported image file. Valid values:
    * 
-   * *   When the N value is 1, this parameter specifies the size of the system disk in the custom image. Valid values: 1 to 2048.
-   * *   When the N value is an integer in the range of 2 to 17, this parameter specifies the size of a data disk in the custom image. Valid values: 1 to 2048.
+   * - When N is 1, the value specifies the system disk size. Valid values: 1 to 2048. Unit: GiB.
+   * - When N is 2 to 17, the value specifies the data disk size. Valid values: 1 to 2048. Unit: GiB.
    * 
-   * After the image file is uploaded to an OSS bucket, you can view the size of the image file in the OSS bucket.
+   * After you upload the source image file to OSS, you can view the image file size in the OSS bucket.
    * 
    * @example
    * 80
@@ -47,14 +47,14 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   diskImageSize?: number;
   /**
    * @remarks
-   * The format of the source image. Valid values:
+   * The image format. Valid values:
    * 
-   * *   RAW
-   * *   VHD
-   * *   QCOW2
-   * *   VMDK (invitational preview)
+   * - RAW.
+   * - VHD.
+   * - QCOW2.
+   * - VMDK (in invitational preview).
    * 
-   * This parameter is empty by default, which indicates that the system checks the image format and uses the check result as the value of this parameter.
+   * Default value: null, which indicates that Alibaba Cloud automatically detects the image format. The detected format prevails.
    * 
    * @example
    * QCOW2
@@ -62,9 +62,9 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   format?: string;
   /**
    * @remarks
-   * The Object Storage Service (OSS) bucket where the image file is stored.
+   * The OSS bucket where the image file is stored.
    * 
-   * >  Before you import images for the first time, you must use RAM to authorize ECS to access your OSS buckets. If ECS is not authorized to access your OSS buckets, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. For more information, see **Usage notes**.
+   * > Before you import an image to this OSS bucket for the first time, add the RAM authorization policy as described in the **Operation description** section of this topic. Otherwise, the `NoSetRoletoECSServiceAccount` error is returned.
    * 
    * @example
    * ecsimageos
@@ -72,7 +72,7 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
   OSSBucket?: string;
   /**
    * @remarks
-   * The name (key) of the object that the image file is stored as in the OSS bucket.
+   * The file name (key) of the image file stored in the OSS bucket after the image is uploaded to OSS.
    * 
    * @example
    * CentOS_5.4_32.raw
@@ -112,10 +112,9 @@ export class ImportImageRequestDiskDeviceMapping extends $dara.Model {
 export class ImportImageRequestFeatures extends $dara.Model {
   /**
    * @remarks
-   * The metadata access mode version of the image. Valid values:
-   * 
-   * *   v1: You cannot set the metadata access mode to security hardening when you create instances from the image.
-   * *   v2: You can set the metadata access mode to security hardening when you create instances from the image.
+   * The metadata access mode of the image. Valid values:
+   * - v1: When you create an ECS instance from this image, you cannot set the metadata access mode to hardened mode only.
+   * - v2: When you create an ECS instance from this image, you can set the metadata access mode to hardened mode only.
    * 
    * Default value: v1.
    * 
@@ -125,10 +124,10 @@ export class ImportImageRequestFeatures extends $dara.Model {
   imdsSupport?: string;
   /**
    * @remarks
-   * Specifies whether the image supports the Non-Volatile Memory Express (NVMe) protocol. Valid values:
+   * Specifies whether the image supports NVMe. Valid values:
    * 
-   * *   supported: The image supports the NVMe protocol. Instances created from the image also support the NVMe protocol.
-   * *   unsupported: The image does not support the NVMe protocol. Instances created from the image do not support the NVMe protocol.
+   *  - supported: Instances created from this image support NVMe.
+   *  - unsupported: Instances created from this image do not support NVMe.
    * 
    * @example
    * supported
@@ -160,7 +159,7 @@ export class ImportImageRequestFeatures extends $dara.Model {
 export class ImportImageRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N of the image. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot contain `http://` or `https://`. The tag key cannot start with `acs:` or `aliyun`.
+   * The key of the image tag. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.
    * 
    * @example
    * TestKey
@@ -168,7 +167,7 @@ export class ImportImageRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N of the image. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain `http://` or `https://`. The tag value cannot start with `acs:`.
+   * The value of the image tag. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with `acs:`. It cannot contain `http://` or `https://`.
    * 
    * @example
    * TestValue
@@ -200,11 +199,11 @@ export class ImportImageRequestTag extends $dara.Model {
 export class ImportImageRequest extends $dara.Model {
   /**
    * @remarks
-   * The system architecture. Valid values:
+   * The system architecture. Valid values: 
    * 
-   * *   i386
-   * *   x86_64
-   * *   arm64
+   * - i386.
+   * - x86_64.
+   * - arm64.
    * 
    * Default value: x86_64.
    * 
@@ -216,12 +215,16 @@ export class ImportImageRequest extends $dara.Model {
    * @remarks
    * The boot mode of the image. Valid values:
    * 
-   * *   BIOS
-   * *   UEFI
+   * - BIOS: BIOS boot mode.
+   * - UEFI: UEFI boot mode.
+   * 
+   * Default value: BIOS. If `Architecture=arm64`, the default value is UEFI, and only UEFI is supported.
    * 
-   * Default value: BIOS. If you set `Architecture` to arm64, set this parameter to UEFI.
+   * <notice>
    * 
-   * > Make sure that you are aware of the boot modes supported by the specified image, as thehe modified boot mode needs to be supported by the image. This way, instances that use this image can start.
+   * To prevent instances from failing to start due to an unsupported boot mode, make sure that you understand the boot mode supported by the target image before you set this parameter. For more information about image boot modes, see [Image boot modes](~~2244655#b9caa9b8bb1wf~~).
+   * 
+   * </notice>.
    * 
    * @example
    * BIOS
@@ -229,7 +232,7 @@ export class ImportImageRequest extends $dara.Model {
   bootMode?: string;
   /**
    * @remarks
-   * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. **The token can contain 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).
+   * 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. The **ClientToken** value can contain 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
@@ -237,7 +240,7 @@ export class ImportImageRequest extends $dara.Model {
   clientToken?: string;
   /**
    * @remarks
-   * The image description. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.
+   * The description of the image. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.
    * 
    * @example
    * TestDescription
@@ -245,9 +248,9 @@ export class ImportImageRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The mode in which to check the image. If you do not specify this parameter, the image is not checked. Only the standard check mode is supported.
+   * The image detection strategy. If this parameter is not specified, detection is not triggered. Only the Standard detection mode is supported.
    * 
-   * >  This parameter is supported for most Linux and Windows operating system versions. For more information about image check items and operating system limits for image check, see [Overview](https://help.aliyun.com/document_detail/439819.html) and [Operating system limits for image check](https://help.aliyun.com/document_detail/475800.html).
+   * > Most Linux and Windows versions are supported. For more information about image detection items and operating system limitations, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html) and [Operating system limitations for image detection](https://help.aliyun.com/document_detail/475800.html).
    * 
    * @example
    * Standard
@@ -255,15 +258,15 @@ export class ImportImageRequest extends $dara.Model {
   detectionStrategy?: string;
   /**
    * @remarks
-   * Details about the custom images.
+   * The information list of the custom image to create.
    */
   diskDeviceMapping?: ImportImageRequestDiskDeviceMapping[];
   /**
    * @remarks
-   * Specifies whether to perform only a dry run, without performing the actual request. Valid values:
+   * Specifies whether to perform only a dry run. Valid values:
    * 
-   * *   true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized RAM users, and missing parameter values. If the request fails the dry run, an error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned.
-   * *   false: performs a dry run and performs the actual request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.
+   * - true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized RAM users, and missing parameter values. If the request fails the dry run, the corresponding error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned.
+   * - false: performs a dry run and sends the request. If the request passes the dry run, a 2XX HTTP status code is returned and the resource status is queried.
    * 
    * Default value: false.
    * 
@@ -273,12 +276,12 @@ export class ImportImageRequest extends $dara.Model {
   dryRun?: boolean;
   /**
    * @remarks
-   * The attributes of the image.
+   * The image feature-related properties.
    */
   features?: ImportImageRequestFeatures;
   /**
    * @remarks
-   * The image name. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `acs:` or `aliyun`. The name cannot contain `http://` or `https://`. The name can contain letters, digits, periods (.), colons (:), underscores (_), and hyphens (-).
+   * The name of the image. The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`. It can contain digits, periods (.), colons (:), underscores (_), or hyphens (-).
    * 
    * @example
    * ImageTestName
@@ -286,24 +289,22 @@ export class ImportImageRequest extends $dara.Model {
   imageName?: string;
   /**
    * @remarks
-   * The type of the license used to activate the operating system after the image is imported. Valid values:
-   * 
-   * *   Auto: ECS checks the operating system of the image and allocates a license to the operating system. ECS first checks whether the operating system distribution specified by `Platform` has a license allocated through an official Alibaba Cloud channel. If yes, the allocated license is used. If no, the license that comes with the source operating system is used.
-   * *   Aliyun: The license allocated through an official Alibaba Cloud channel is used for the operating system distribution specified by `Platform`.
-   * *   BYOL: The license that comes with the source operating system is used. In this case, make sure that your license key is eligible for use in Alibaba Cloud.
+   * The license type. This parameter specifies the authorization mode when instances are created by calling [RunInstances](https://help.aliyun.com/document_detail/2679677.html) with the image. This value takes effect only for Windows Server images. Valid values:
+   * - Aliyun: Use the Alibaba Cloud official license. After the instance starts, the system attempts to automatically connect to the Alibaba Cloud KMS server for activation. The billing for the instance includes the Windows Server license fee.
+   * - BYOL: Bring Your Own License. After the instance starts, Alibaba Cloud does not automatically activate it. You must manually activate it by using your own valid license key. The billing for the instance does not include the Windows Server license fee.
    * 
-   * Default value: Auto.
+   * Default value: Aliyun.
    * 
    * @example
-   * Auto
+   * BYOL
    */
   licenseType?: string;
   /**
    * @remarks
-   * The operating system platform. Valid values:
+   * The operating system type. Valid values: 
    * 
-   * *   windows
-   * *   linux
+   * - windows. You must also set `LicenseType`.
+   * - linux.
    * 
    * Default value: linux.
    * 
@@ -314,34 +315,34 @@ export class ImportImageRequest extends $dara.Model {
   ownerId?: number;
   /**
    * @remarks
-   * The operating system distribution. Valid values:
-   * 
-   * *   Aliyun
-   * *   Anolis
-   * *   CentOS
-   * *   Ubuntu
-   * *   CoreOS
-   * *   SUSE
-   * *   Debian
-   * *   OpenSUSE
-   * *   FreeBSD
-   * *   RedHat
-   * *   Kylin
-   * *   UOS
-   * *   Fedora
-   * *   Fedora CoreOS
-   * *   CentOS Stream
-   * *   AlmaLinux
-   * *   Rocky Linux
-   * *   Gentoo
-   * *   Customized Linux
-   * *   Others Linux
-   * *   Windows Server 2022
-   * *   Windows Server 2019
-   * *   Windows Server 2016
-   * *   Windows Server 2012
-   * *   Windows Server 2008
-   * *   Windows Server 2003
+   * The operating system version. Valid values: 
+   * - Aliyun
+   * - Anolis
+   * - CentOS
+   * - Ubuntu
+   * - CoreOS
+   * - SUSE
+   * - Debian
+   * - OpenSUSE
+   * - FreeBSD
+   * - RedHat
+   * - Kylin
+   * - UOS
+   * - Fedora
+   * - Fedora CoreOS
+   * - CentOS Stream
+   * - AlmaLinux
+   * - Rocky Linux
+   * - Gentoo
+   * - Customized Linux
+   * - Others Linux
+   * - Windows Server 2022
+   * - Windows Server 2019
+   * - Windows Server 2016
+   * - Windows Server 2012
+   * - Windows Server 2008
+   * - Windows Server 2003
+   * - Other Windows
    * 
    * Default value: Others Linux.
    * 
@@ -351,7 +352,7 @@ export class ImportImageRequest extends $dara.Model {
   platform?: string;
   /**
    * @remarks
-   * The region ID of the source image. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
+   * The region ID of the source custom image. You can call [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) to query the most recent region list.
    * 
    * This parameter is required.
    * 
@@ -361,7 +362,7 @@ export class ImportImageRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group to which to assign the image.
+   * The ID of the enterprise resource group to which the imported image belongs.
    * 
    * @example
    * rg-bp67acfmxazb4p****
@@ -379,11 +380,11 @@ export class ImportImageRequest extends $dara.Model {
   roleName?: string;
   /**
    * @remarks
-   * The Alibaba Cloud Resource Name (ARN) of the cloud box, which is used to uniquely identify a storage location in the cloud.
+   * The Alibaba Cloud Resource Name (ARN) of the CloudBox, which is used to uniquely identify the cloud storage location.
    * 
-   * >  Specify this parameter only if you import an image from OSS on CloudBox. Otherwise, you do not need to specify this parameter. For more information, see [What is OSS on CloudBox?](https://help.aliyun.com/document_detail/430190.html)
+   * > You need to specify this parameter only when you import an image file from OSS on CloudBox. If you do not use OSS on CloudBox, do not set this parameter. For more information, see [What is OSS on CloudBox](https://help.aliyun.com/document_detail/430190.html).
    * 
-   * The ARN must be in the following format: `arn:acs:cloudbox:{RegionId}:{AliUid}:cloudbox/{CloudBoxId}`. Replace `{RegionId}` with the region ID of the cloud box, `{AliUid}` with the ID of the Alibaba Cloud account to which the cloud box belongs, and `{CloudBoxId}` with the ID of the cloud box.
+   * The ARN must follow this format: `arn:acs:cloudbox:{RegionId}:{AliUid}:cloudbox/{CloudBoxId}`, where `{RegionId}` is the region ID of the CloudBox, `{AliUid}` is the Alibaba Cloud account ID, and `{CloudBoxId}` is the CloudBox ID.
    * 
    * @example
    * arn:acs:cloudbox:cn-hangzhou:123456:cloudbox/cb-xx***123
@@ -391,7 +392,7 @@ export class ImportImageRequest extends $dara.Model {
   storageLocationArn?: string;
   /**
    * @remarks
-   * The image tags.
+   * The tags of the image.
    */
   tag?: ImportImageRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/ImportImageResponseBody.ts

@@ -29,7 +29,7 @@ export class ImportImageResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The image import task ID.
+   * The ID of the image import task.
    * 
    * @example
    * t-bp67acfmxazb4p****

package/src/models/ImportKeyPairRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ImportKeyPairRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of tag N to add to the key pair. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot contain [http:// or https://](http://https://。). The tag key cannot start with acs: or aliyun.
+   * The key of tag N of the key pair. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with aliyun or acs: and cannot contain http:// or https://.
    * 
    * @example
    * TestKey
@@ -13,7 +13,7 @@ export class ImportKeyPairRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of tag N to add to the key pair. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain [http:// or https://](http://https://。). The tag value cannot start with acs:.
+   * The value of tag N of the key pair. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length. It cannot contain http:// or https://.
    * 
    * @example
    * TestValue
@@ -45,7 +45,7 @@ export class ImportKeyPairRequestTag extends $dara.Model {
 export class ImportKeyPairRequest extends $dara.Model {
   /**
    * @remarks
-   * The name of the key pair. The name must be unique. It must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
+   * The name of the key pair. The name must be unique. The name must be 2 to 128 characters in length and must start with a letter or Chinese character. It cannot start with http:// or https://. The name can contain characters that are categorized as letter in Unicode, including letters, Chinese characters, and digits. The name can contain colons (:), underscores (_), periods (.), or hyphens (-).
    * 
    * This parameter is required.
    * 
@@ -66,7 +66,7 @@ export class ImportKeyPairRequest extends $dara.Model {
   publicKeyBody?: string;
   /**
    * @remarks
-   * The region ID. 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.
    * 
@@ -86,7 +86,7 @@ export class ImportKeyPairRequest extends $dara.Model {
   resourceOwnerId?: number;
   /**
    * @remarks
-   * The tags to add to the key pair.
+   * The tags.
    */
   tag?: ImportKeyPairRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/ImportKeyPairResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ImportKeyPairResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The fingerprint of the key pair. The MD5 message-digest algorithm is used based on the public key fingerprint format defined in RFC 4716.
+   * The fingerprint of the key pair. The public key fingerprint format is defined in RFC 4716 and uses the MD5 message digest algorithm.
    * 
    * @example
    * 89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**