tencentcloud-sdk-python-intl-en 3.0.1285__py2.py3-none-any.whl → 3.0.1287__py2.py3-none-any.whl

tencentcloud/cvm/v20170312/models.py

@@ -3281,7 +3281,7 @@ class DataDisk(AbstractModel):
         r"""
         :param _DiskSize: Data disk size, unit: GiB. the minimum adjustment step size is 10 GiB. the value ranges of different data disk types vary. for specific limitations, see the storage overview (https://intl.cloud.tencent.com/document/product/213/4952?from_cn_redirect=1). the default value is 0, which means no data disk purchase. for more restrictions, see the product document.
         :type DiskSize: int
-        :param _DiskType: Data disk type. For the detailed restrictions on the data disk type, refer to [Storage Overview](https://cloud.tencent.com/document/product/213/4952). Valid values: <br /><li>LOCAL_BASIC: Local Disk <br /><li>LOCAL_SSD: Local SSD <br /><li>LOCAL_NVME: Local NVMe Disk, which is strongly related with InstanceType and can not be specified <br /><li>LOCAL_PRO: Local HDD, which is strongly related with InstanceType and can not be specified <br /><li>CLOUD_BASIC: Basic Cloud Disk <br /><li>CLOUD_PREMIUM: Premium Disk <br /><li>CLOUD_SSD: Cloud SSD <br /><li>CLOUD_HSSD: Enhanced SSD <br /><li>CLOUD_TSSD: Tremendous SSD <br /><li>CLOUD_BSSD: Balanced SSD <br /><br />Default value: LOCAL_BASIC. <br /><br />This parameter is invalid for the `ResizeInstanceDisk` API.</li></li></li> </li> </li></li></li></li></li></li>
+        :param _DiskType: Specifies the data disk type. for restrictions on data disk types, refer to [storage overview](https://www.tencentcloud.comom/document/product/213/4952?from_cn_redirect=1). valid values: <br /><li>LOCAL_BASIC: LOCAL disk</li> <li>LOCAL_SSD: LOCAL SSD</li><li>LOCAL_NVME: LOCAL NVME disk, which is closely related to InstanceType and cannot be specified</li><li>LOCAL_PRO: LOCAL HDD, which is closely related to InstanceType and cannot be specified</li><li>cloud_BASIC: BASIC cloud disk</li><li>cloud_PREMIUM: high-performance cloud block storage</li><li>cloud_SSD: SSD cloud disk</li><li>cloud_HSSD: enhanced SSD cloud disk</li> <li>cloud_TSSD: ultra-fast SSD cbs</li><li>cloud_BSSD: universal SSD cloud disk</li><br />default: LOCAL_BASIC.<br/><br />this parameter is invalid for the `ResizeInstanceDisk` api.
         :type DiskType: str
         :param _DiskId: Specifies the data disk ID.
 This parameter currently only serves as a response parameter for query apis such as `DescribeInstances`, and cannot be used as an input parameter for write apis such as `RunInstances`.
@@ -3292,18 +3292,21 @@ This parameter currently only serves as a response parameter for query apis such
         :type SnapshotId: str
         :param _Encrypt: Specifies whether the data disk is encrypted. value range: <li>true: encrypted</li> <li>false: unencrypted</li><br/> default value: false<br/> this parameter is currently only used for the `RunInstances` api.
         :type Encrypt: bool
-        :param _KmsKeyId: Custom CMK's corresponding ID, with a value of UUID or something similar to kms - abcd1234. used for encrypting cloud disks.
+        :param _KmsKeyId: Custom CMK ID, value is UUID or similar to kms-abcd1234. used for encrypted cloud disk.
 
 This parameter is currently only used for the `RunInstances` api.
+Note: This field may return null, indicating that no valid value is found.
         :type KmsKeyId: str
-        :param _ThroughputPerformance: Specifies the cloud disk performance (unit: MiB/s). using this parameter allows you to purchase additional performance for the cloud disk.
-Currently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).
+        :param _ThroughputPerformance: Cloud disk performance (unit: MiB/s). specifies additional performance for cloud disks.
+Currently only supports extreme cbs (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).
+Note: This field may return null, indicating that no valid value is found.
         :type ThroughputPerformance: int
-        :param _CdcId: Specifies the exclusive cluster ID it belongs to.
+        :param _CdcId: Specifies the dedicated cluster ID belonging to.
+Note: This field may return null, indicating that no valid value is found.
         :type CdcId: str
-        :param _BurstPerformance: Burst performance.
+        :param _BurstPerformance: Burstable performance.
 
-<B>Note: this feature is in beta test.</b>.
+<B>Note: this field is in beta test.</b>.
         :type BurstPerformance: bool
         :param _DiskName: Disk name, with a length not exceeding 128 characters.
         :type DiskName: str
@@ -3333,7 +3336,7 @@ Currently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOU
 
     @property
     def DiskType(self):
-        r"""Data disk type. For the detailed restrictions on the data disk type, refer to [Storage Overview](https://cloud.tencent.com/document/product/213/4952). Valid values: <br /><li>LOCAL_BASIC: Local Disk <br /><li>LOCAL_SSD: Local SSD <br /><li>LOCAL_NVME: Local NVMe Disk, which is strongly related with InstanceType and can not be specified <br /><li>LOCAL_PRO: Local HDD, which is strongly related with InstanceType and can not be specified <br /><li>CLOUD_BASIC: Basic Cloud Disk <br /><li>CLOUD_PREMIUM: Premium Disk <br /><li>CLOUD_SSD: Cloud SSD <br /><li>CLOUD_HSSD: Enhanced SSD <br /><li>CLOUD_TSSD: Tremendous SSD <br /><li>CLOUD_BSSD: Balanced SSD <br /><br />Default value: LOCAL_BASIC. <br /><br />This parameter is invalid for the `ResizeInstanceDisk` API.</li></li></li> </li> </li></li></li></li></li></li>
+        r"""Specifies the data disk type. for restrictions on data disk types, refer to [storage overview](https://www.tencentcloud.comom/document/product/213/4952?from_cn_redirect=1). valid values: <br /><li>LOCAL_BASIC: LOCAL disk</li> <li>LOCAL_SSD: LOCAL SSD</li><li>LOCAL_NVME: LOCAL NVME disk, which is closely related to InstanceType and cannot be specified</li><li>LOCAL_PRO: LOCAL HDD, which is closely related to InstanceType and cannot be specified</li><li>cloud_BASIC: BASIC cloud disk</li><li>cloud_PREMIUM: high-performance cloud block storage</li><li>cloud_SSD: SSD cloud disk</li><li>cloud_HSSD: enhanced SSD cloud disk</li> <li>cloud_TSSD: ultra-fast SSD cbs</li><li>cloud_BSSD: universal SSD cloud disk</li><br />default: LOCAL_BASIC.<br/><br />this parameter is invalid for the `ResizeInstanceDisk` api.
         :rtype: str
         """
         return self._DiskType
@@ -3389,9 +3392,10 @@ This parameter currently only serves as a response parameter for query apis such
 
     @property
     def KmsKeyId(self):
-        r"""Custom CMK's corresponding ID, with a value of UUID or something similar to kms - abcd1234. used for encrypting cloud disks.
+        r"""Custom CMK ID, value is UUID or similar to kms-abcd1234. used for encrypted cloud disk.
 
 This parameter is currently only used for the `RunInstances` api.
+Note: This field may return null, indicating that no valid value is found.
         :rtype: str
         """
         return self._KmsKeyId
@@ -3402,8 +3406,9 @@ This parameter is currently only used for the `RunInstances` api.
 
     @property
     def ThroughputPerformance(self):
-        r"""Specifies the cloud disk performance (unit: MiB/s). using this parameter allows you to purchase additional performance for the cloud disk.
-Currently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).
+        r"""Cloud disk performance (unit: MiB/s). specifies additional performance for cloud disks.
+Currently only supports extreme cbs (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).
+Note: This field may return null, indicating that no valid value is found.
         :rtype: int
         """
         return self._ThroughputPerformance
@@ -3414,7 +3419,8 @@ Currently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOU
 
     @property
     def CdcId(self):
-        r"""Specifies the exclusive cluster ID it belongs to.
+        r"""Specifies the dedicated cluster ID belonging to.
+Note: This field may return null, indicating that no valid value is found.
         :rtype: str
         """
         return self._CdcId
@@ -3425,9 +3431,9 @@ Currently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOU
 
     @property
     def BurstPerformance(self):
-        r"""Burst performance.
+        r"""Burstable performance.
 
-<B>Note: this feature is in beta test.</b>.
+<B>Note: this field is in beta test.</b>.
         :rtype: bool
         """
         return self._BurstPerformance
@@ -7755,14 +7761,11 @@ class GPUInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _GPUCount: Number of GPUs. 
-Note: this field may return `null`, indicating that no valid value can be found.
+        :param _GPUCount: Specifies the GPU count of the instance. a value less than 1 indicates VGPU type, and a value larger than 1 indicates GPU passthrough type.
         :type GPUCount: float
-        :param _GPUId: GPU address
-Note: this field may return `null`, indicating that no valid value can be found.
+        :param _GPUId: Specifies the GPU address of the instance.
         :type GPUId: list of str
-        :param _GPUType: GPU type of the instance.
-Note: this field may return `null`, indicating that no valid value can be found.
+        :param _GPUType: Specifies the GPU type of the instance.
         :type GPUType: str
         """
         self._GPUCount = None
@@ -7771,8 +7774,7 @@ Note: this field may return `null`, indicating that no valid value can be found.
 
     @property
     def GPUCount(self):
-        r"""Number of GPUs. 
-Note: this field may return `null`, indicating that no valid value can be found.
+        r"""Specifies the GPU count of the instance. a value less than 1 indicates VGPU type, and a value larger than 1 indicates GPU passthrough type.
         :rtype: float
         """
         return self._GPUCount
@@ -7783,8 +7785,7 @@ Note: this field may return `null`, indicating that no valid value can be found.
 
     @property
     def GPUId(self):
-        r"""GPU address
-Note: this field may return `null`, indicating that no valid value can be found.
+        r"""Specifies the GPU address of the instance.
         :rtype: list of str
         """
         return self._GPUId
@@ -7795,8 +7796,7 @@ Note: this field may return `null`, indicating that no valid value can be found.
 
     @property
     def GPUType(self):
-        r"""GPU type of the instance.
-Note: this field may return `null`, indicating that no valid value can be found.
+        r"""Specifies the GPU type of the instance.
         :rtype: str
         """
         return self._GPUType
@@ -10274,9 +10274,9 @@ class Instance(AbstractModel):
         :type InstanceType: str
         :param _CPU: Number of CPU cores of the instance; unit: core
         :type CPU: int
-        :param _Memory: Memory capacity; unit: `GB`.
+        :param _Memory: Instance memory capacity. unit: GiB.
         :type Memory: int
-        :param _RestrictState: Instance status. Valid values: <br><li>NORMAL: instance is normal. <br><li>EXPIRED: instance expired. <br><li>PROTECTIVELY_ISOLATED: instance is protectively isolated.
+        :param _RestrictState: Instance business status. valid values:<br><li>NORMAL: indicates an instance in the NORMAL state</li><li>EXPIRED: indicates an EXPIRED instance</li><li>PROTECTIVELY_ISOLATED: PROTECTIVELY ISOLATED instance</li>.
         :type RestrictState: str
         :param _InstanceName: Instance name
         :type InstanceName: str
@@ -10297,8 +10297,8 @@ Note: This field may return null, indicating that no valid value is found.
         :type VirtualPrivateCloud: :class:`tencentcloud.cvm.v20170312.models.VirtualPrivateCloud`
         :param _ImageId: `ID` of the image used to create the instance.
         :type ImageId: str
-        :param _RenewFlag: Auto renewal flag. Valid values: <br><li>`NOTIFY_AND_MANUAL_RENEW`: notify upon expiration, but do not renew automatically <br><li>`NOTIFY_AND_AUTO_RENEW`: notify upon expiration and renew automatically <br><li>`DISABLE_NOTIFY_AND_MANUAL_RENEW`: do not notify upon expiration and do not renew automatically.
-<br><li>Note: this parameter is `null` for postpaid instances.
+        :param _RenewFlag: AUTO-Renewal flag. valid values:<br><li>`NOTIFY_AND_MANUAL_RENEW`: indicates that a notification of impending expiration is made but AUTO-renewal is not performed</li><li>`NOTIFY_AND_AUTO_RENEW`: indicates that a notification of impending expiration is made AND AUTO-renewal is performed</li><li>`DISABLE_NOTIFY_AND_MANUAL_RENEW`: indicates that notification that it is about to expire is not made AND AUTO-renewal is not performed.
+Note: this field is null in postpaid mode.
         :type RenewFlag: str
         :param _CreatedTime: Creation time following the `ISO8601` standard and using `UTC` time in the format of `YYYY-MM-DDThh:mm:ssZ`.
         :type CreatedTime: str
@@ -10310,23 +10310,24 @@ Note: This field may return null, indicating that no valid value is found.
         :type SecurityGroupIds: list of str
         :param _LoginSettings: Login settings of the instance. Currently only the key associated with the instance is returned.
         :type LoginSettings: :class:`tencentcloud.cvm.v20170312.models.LoginSettings`
-        :param _InstanceState: Instance state. Valid values: <br><li>PENDING: creating <br></li><li>LAUNCH_FAILED: creation failed <br></li><li>RUNNING: running <br></li><li>STOPPED: shut down <br></li><li>STARTING: starting <br></li><li>STOPPING: shutting down <br></li><li>REBOOTING: rebooting <br></li><li>SHUTDOWN: shut down and to be terminated <br></li><li>TERMINATING: terminating. <br></li>
+        :param _InstanceState: Instance status. for specific status types, see the instance status table (https://www.tencentcloud.comom/document/api/213/15753?from_cn_redirect=1#InstanceStatus).
         :type InstanceState: str
         :param _Tags: List of tags associated with the instance.
         :type Tags: list of Tag
-        :param _StopChargingMode: Instance billing method after shutdown.
-Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown <br><li>STOP_CHARGING: billing stops after shutdown <li>NOT_APPLICABLE: the instance is not shut down or stopping billing after shutdown is not applicable to the instance. <br>
+        :param _StopChargingMode: Shutdown billing mode of an instance.
+
+Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown</li><li>STOP_CHARGING: billing stops after shutdown</li><li>NOT_APPLICABLE: the instance is NOT shut down or stopping billing after shutdown is NOT APPLICABLE to the instance</li>.
         :type StopChargingMode: str
         :param _Uuid: Globally unique ID of the instance.
         :type Uuid: str
         :param _LatestOperation: Last operation of the instance, such as StopInstances or ResetInstance.
         :type LatestOperation: str
-        :param _LatestOperationState: The latest operation status of the instance. Valid values:<br><li>SUCCESS: operation succeeded<br><li>OPERATING: operation in progress<br><li>FAILED: operation failed
+        :param _LatestOperationState: The latest operation status of the instance. valid values:<br><li>SUCCESS: indicates that the operation succeeded</li><li>OPERATING: indicates that the operation is in progress</li><li>FAILED: indicates that the operation FAILED</li>.
+Note: This field may return null, indicating that no valid value is found.
         :type LatestOperationState: str
         :param _LatestOperationRequestId: Unique request ID for the last operation of the instance.
         :type LatestOperationRequestId: str
-        :param _DisasterRecoverGroupId: ID of a spread placement group.
-Note: this field may return null, indicating that no valid value is obtained.
+        :param _DisasterRecoverGroupId: Spread placement group ID.
         :type DisasterRecoverGroupId: str
         :param _IPv6Addresses: IPv6 address of the instance.
 Note: this field may return null, indicating that no valid value is obtained.
@@ -10334,23 +10335,20 @@ Note: this field may return null, indicating that no valid value is obtained.
         :param _CamRoleName: CAM role name.
 Note: this field may return null, indicating that no valid value is obtained.
         :type CamRoleName: str
-        :param _HpcClusterId: HPC cluster ID.
-Note: this field may return null, indicating that no valid value was found.
+        :param _HpcClusterId: High-performance computing cluster ID.
         :type HpcClusterId: str
         :param _RdmaIpAddresses: IP list of HPC cluster.
 Note: this field may return null, indicating that no valid value was found.
         :type RdmaIpAddresses: list of str
-        :param _DedicatedClusterId: 
+        :param _DedicatedClusterId: Dedicated cluster ID where the instance is located.
         :type DedicatedClusterId: str
-        :param _IsolatedSource: The isolation status of the instance. Valid values:<br><li>`ARREAR`: isolated due to overdue payment;<br></li><li>`EXPIRE`: isolated upon expiration;<br></li><li>`MANMADE`: isolated after manual returning;<br></li><li>`NOTISOLATED`: not isolated<br></li>
-Note: this field may return null, indicating that no valid value was found.
+        :param _IsolatedSource: Instance isolation type. valid values:<br><li>ARREAR: indicates arrears isolation<br></li><li>EXPIRE: indicates isolation upon expiration<br></li><li>MANMADE: indicates voluntarily refunded isolation<br></li><li>NOTISOLATED: indicates unisolated<br></li>.
         :type IsolatedSource: str
-        :param _GPUInfo: GPU information. This field is only returned for GPU instances.
-Note: this field may return null, indicating that no valid value was found.
+        :param _GPUInfo: GPU information. if it is a gpu type instance, this value will be returned. for other type instances, it does not return.
         :type GPUInfo: :class:`tencentcloud.cvm.v20170312.models.GPUInfo`
         :param _LicenseType: Instance OS license type. Default value: `TencentCloud`
         :type LicenseType: str
-        :param _DisableApiTermination: Whether the termination protection is enabled. Values: <br><li>`TRUE`: Enable instance protection, which means that this instance can not be deleted by an API action.<br><li>`FALSE`: Do not enable the instance protection.<br><br>Default value: `FALSE`.
+        :param _DisableApiTermination: Instance destruction protection flag indicates whether an instance is allowed to be deleted through an api. value ranges from:<br><li>true: indicates that instance protection is enabled, deletion through apis is not allowed</li><li>false: indicates that instance protection is disabled, allow passage</li><br>default value: false.
         :type DisableApiTermination: bool
         :param _DefaultLoginUser: Default login user
         :type DefaultLoginUser: str
@@ -10359,8 +10357,9 @@ Note: this field may return null, indicating that no valid value was found.
         :param _LatestOperationErrorMsg: Latest operation errors of the instance.
 Note: This field may return `null`, indicating that no valid values can be obtained.
         :type LatestOperationErrorMsg: str
-        :param _PublicIPv6Addresses: Public IPv6 address of the instance.
-Note: this field may return null, indicating that no valid value was found.
+        :param _Metadata: Custom metadata. this parameter corresponds to the metadata information specified when creating a CVM. **note: in beta test**.
+        :type Metadata: :class:`tencentcloud.cvm.v20170312.models.Metadata`
+        :param _PublicIPv6Addresses: Specifies the public IPv6 address bound to the instance.
         :type PublicIPv6Addresses: list of str
         """
         self._Placement = None
@@ -10404,6 +10403,7 @@ Note: this field may return null, indicating that no valid value was found.
         self._DefaultLoginUser = None
         self._DefaultLoginPort = None
         self._LatestOperationErrorMsg = None
+        self._Metadata = None
         self._PublicIPv6Addresses = None
 
     @property
@@ -10452,7 +10452,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def Memory(self):
-        r"""Memory capacity; unit: `GB`.
+        r"""Instance memory capacity. unit: GiB.
         :rtype: int
         """
         return self._Memory
@@ -10463,7 +10463,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def RestrictState(self):
-        r"""Instance status. Valid values: <br><li>NORMAL: instance is normal. <br><li>EXPIRED: instance expired. <br><li>PROTECTIVELY_ISOLATED: instance is protectively isolated.
+        r"""Instance business status. valid values:<br><li>NORMAL: indicates an instance in the NORMAL state</li><li>EXPIRED: indicates an EXPIRED instance</li><li>PROTECTIVELY_ISOLATED: PROTECTIVELY ISOLATED instance</li>.
         :rtype: str
         """
         return self._RestrictState
@@ -10574,8 +10574,8 @@ Note: This field may return null, indicating that no valid value is found.
 
     @property
     def RenewFlag(self):
-        r"""Auto renewal flag. Valid values: <br><li>`NOTIFY_AND_MANUAL_RENEW`: notify upon expiration, but do not renew automatically <br><li>`NOTIFY_AND_AUTO_RENEW`: notify upon expiration and renew automatically <br><li>`DISABLE_NOTIFY_AND_MANUAL_RENEW`: do not notify upon expiration and do not renew automatically.
-<br><li>Note: this parameter is `null` for postpaid instances.
+        r"""AUTO-Renewal flag. valid values:<br><li>`NOTIFY_AND_MANUAL_RENEW`: indicates that a notification of impending expiration is made but AUTO-renewal is not performed</li><li>`NOTIFY_AND_AUTO_RENEW`: indicates that a notification of impending expiration is made AND AUTO-renewal is performed</li><li>`DISABLE_NOTIFY_AND_MANUAL_RENEW`: indicates that notification that it is about to expire is not made AND AUTO-renewal is not performed.
+Note: this field is null in postpaid mode.
         :rtype: str
         """
         return self._RenewFlag
@@ -10641,7 +10641,7 @@ Note: This field may return null, indicating that no valid value is found.
 
     @property
     def InstanceState(self):
-        r"""Instance state. Valid values: <br><li>PENDING: creating <br></li><li>LAUNCH_FAILED: creation failed <br></li><li>RUNNING: running <br></li><li>STOPPED: shut down <br></li><li>STARTING: starting <br></li><li>STOPPING: shutting down <br></li><li>REBOOTING: rebooting <br></li><li>SHUTDOWN: shut down and to be terminated <br></li><li>TERMINATING: terminating. <br></li>
+        r"""Instance status. for specific status types, see the instance status table (https://www.tencentcloud.comom/document/api/213/15753?from_cn_redirect=1#InstanceStatus).
         :rtype: str
         """
         return self._InstanceState
@@ -10663,8 +10663,9 @@ Note: This field may return null, indicating that no valid value is found.
 
     @property
     def StopChargingMode(self):
-        r"""Instance billing method after shutdown.
-Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown <br><li>STOP_CHARGING: billing stops after shutdown <li>NOT_APPLICABLE: the instance is not shut down or stopping billing after shutdown is not applicable to the instance. <br>
+        r"""Shutdown billing mode of an instance.
+
+Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown</li><li>STOP_CHARGING: billing stops after shutdown</li><li>NOT_APPLICABLE: the instance is NOT shut down or stopping billing after shutdown is NOT APPLICABLE to the instance</li>.
         :rtype: str
         """
         return self._StopChargingMode
@@ -10697,7 +10698,8 @@ Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown <br><li>ST
 
     @property
     def LatestOperationState(self):
-        r"""The latest operation status of the instance. Valid values:<br><li>SUCCESS: operation succeeded<br><li>OPERATING: operation in progress<br><li>FAILED: operation failed
+        r"""The latest operation status of the instance. valid values:<br><li>SUCCESS: indicates that the operation succeeded</li><li>OPERATING: indicates that the operation is in progress</li><li>FAILED: indicates that the operation FAILED</li>.
+Note: This field may return null, indicating that no valid value is found.
         :rtype: str
         """
         return self._LatestOperationState
@@ -10719,8 +10721,7 @@ Valid values: <br><li>KEEP_CHARGING: billing continues after shutdown <br><li>ST
 
     @property
     def DisasterRecoverGroupId(self):
-        r"""ID of a spread placement group.
-Note: this field may return null, indicating that no valid value is obtained.
+        r"""Spread placement group ID.
         :rtype: str
         """
         return self._DisasterRecoverGroupId
@@ -10755,8 +10756,7 @@ Note: this field may return null, indicating that no valid value is obtained.
 
     @property
     def HpcClusterId(self):
-        r"""HPC cluster ID.
-Note: this field may return null, indicating that no valid value was found.
+        r"""High-performance computing cluster ID.
         :rtype: str
         """
         return self._HpcClusterId
@@ -10779,7 +10779,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def DedicatedClusterId(self):
-        r"""
+        r"""Dedicated cluster ID where the instance is located.
         :rtype: str
         """
         return self._DedicatedClusterId
@@ -10790,8 +10790,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def IsolatedSource(self):
-        r"""The isolation status of the instance. Valid values:<br><li>`ARREAR`: isolated due to overdue payment;<br></li><li>`EXPIRE`: isolated upon expiration;<br></li><li>`MANMADE`: isolated after manual returning;<br></li><li>`NOTISOLATED`: not isolated<br></li>
-Note: this field may return null, indicating that no valid value was found.
+        r"""Instance isolation type. valid values:<br><li>ARREAR: indicates arrears isolation<br></li><li>EXPIRE: indicates isolation upon expiration<br></li><li>MANMADE: indicates voluntarily refunded isolation<br></li><li>NOTISOLATED: indicates unisolated<br></li>.
         :rtype: str
         """
         return self._IsolatedSource
@@ -10802,8 +10801,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def GPUInfo(self):
-        r"""GPU information. This field is only returned for GPU instances.
-Note: this field may return null, indicating that no valid value was found.
+        r"""GPU information. if it is a gpu type instance, this value will be returned. for other type instances, it does not return.
         :rtype: :class:`tencentcloud.cvm.v20170312.models.GPUInfo`
         """
         return self._GPUInfo
@@ -10825,7 +10823,7 @@ Note: this field may return null, indicating that no valid value was found.
 
     @property
     def DisableApiTermination(self):
-        r"""Whether the termination protection is enabled. Values: <br><li>`TRUE`: Enable instance protection, which means that this instance can not be deleted by an API action.<br><li>`FALSE`: Do not enable the instance protection.<br><br>Default value: `FALSE`.
+        r"""Instance destruction protection flag indicates whether an instance is allowed to be deleted through an api. value ranges from:<br><li>true: indicates that instance protection is enabled, deletion through apis is not allowed</li><li>false: indicates that instance protection is disabled, allow passage</li><br>default value: false.
         :rtype: bool
         """
         return self._DisableApiTermination
@@ -10868,10 +10866,20 @@ Note: This field may return `null`, indicating that no valid values can be obtai
     def LatestOperationErrorMsg(self, LatestOperationErrorMsg):
         self._LatestOperationErrorMsg = LatestOperationErrorMsg
 
+    @property
+    def Metadata(self):
+        r"""Custom metadata. this parameter corresponds to the metadata information specified when creating a CVM. **note: in beta test**.
+        :rtype: :class:`tencentcloud.cvm.v20170312.models.Metadata`
+        """
+        return self._Metadata
+
+    @Metadata.setter
+    def Metadata(self, Metadata):
+        self._Metadata = Metadata
+
     @property
     def PublicIPv6Addresses(self):
-        r"""Public IPv6 address of the instance.
-Note: this field may return null, indicating that no valid value was found.
+        r"""Specifies the public IPv6 address bound to the instance.
         :rtype: list of str
         """
         return self._PublicIPv6Addresses
@@ -10945,6 +10953,9 @@ Note: this field may return null, indicating that no valid value was found.
         self._DefaultLoginUser = params.get("DefaultLoginUser")
         self._DefaultLoginPort = params.get("DefaultLoginPort")
         self._LatestOperationErrorMsg = params.get("LatestOperationErrorMsg")
+        if params.get("Metadata") is not None:
+            self._Metadata = Metadata()
+            self._Metadata._deserialize(params.get("Metadata"))
         self._PublicIPv6Addresses = params.get("PublicIPv6Addresses")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
@@ -11623,29 +11634,34 @@ class InternetAccessible(AbstractModel):
         :type PublicIpAssigned: bool
         :param _BandwidthPackageId: Bandwidth package ID. it can be obtained through the `BandwidthPackageId` in the return value from the DescribeBandwidthPackages api. this parameter is used as an input parameter only in the RunInstances api.
         :type BandwidthPackageId: str
-        :param _InternetServiceProvider: Describes the line type. for details, refer to [EIP IP address types](https://www.tencentcloud.com/zh/document/product/213/5733). default value: `BGP`.
- <li>BGP Default: BGP</li>
-For a user who has activated the static single-line IP allowlist, possible values are:
- <li>CMCC: China Mobile</li> <li>CTCC: China Telecom</li> <li>CUCC: China Unicom</li>
-Note: Only certain regions support static single-line IP addresses.
-        :type InternetServiceProvider: str
-        :param _IPv4AddressType: Type of public IP address.
+        :param _InternetServiceProvider: Line type. for details on various types of lines and supported regions, refer to [EIP IP address types](https://www.tencentcloud.comom/document/product/1199/41646?from_cn_redirect=1). default value: BGP.
+<Li>BGP: specifies the general bgp line.</li>.
+For a user with static single-line IP allowlist enabled, valid values include:.
+<Li>CMCC: china mobile.</li>.
+<Li>CTCC: china telecom</li>.
+<Li>CUCC: china unicom</li>.
+Note: The static single-line IP is only supported in some regions.
 
-<li> WanIP: Ordinary public IP address. </li> <li> HighQualityEIP: High Quality EIP is supported only in Singapore and Hong Kong. </li> <li> AntiDDoSEIP: Anti-DDoS IP is supported only in specific regions. For details, see [EIP Product Overview](https://www.tencentcloud.com/zh/document/product/213/5733). </li> 
-Specify the type of public IPv4 address to assign a public IPv4 address to the resource. HighQualityEIP and AntiDDoSEIP features are gradually released in select regions.
-This feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).
-        :type IPv4AddressType: str
-        :param _IPv6AddressType: Indicates the type of EIPv6. Valid values:
 
-<li>EIPv6: common IPv6</li>
-<li>HighQualityEIPv6: High Quality EIPv6</li>
-Note: Contact the product team to enable the dedicated IPv6 allowlist. The dedicated IPv6 is only supported in some regions. 
+        :type InternetServiceProvider: str
+        :param _IPv4AddressType: Specifies the public IP type.
 
-Default: `EIPv6`
+<Li>WanIP: specifies the public ip address.</li>.
+<Li>HighQualityEIP: specifies a high quality ip. high quality ip is only supported in Singapore and hong kong (china).</li>.
+<li> AntiDDoSEIP: specifies the anti-ddos eip. only partial regions support anti-ddos eip. details visible in the [elastic IP product overview](https://www.tencentcloud.comom/document/product/1199/41646?from_cn_redirect=1).</li>.
+If needed, assign a public IPv4 address to the resource by specifying the IPv4 address type.
 
-This feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).
+This feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.
+        :type IPv4AddressType: str
+        :param _IPv6AddressType: Indicates the type of elastic public IPv6.
+<Li>EIPv6: elastic ip version 6.</li>.
+<Li>HighQualityEIPv6: specifies the high quality ipv6. highqualityeipv6 is only supported in hong kong (china).</li>.
+If needed, assign an elastic IPv6 address for resource allocation.
+
+This feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.
         :type IPv6AddressType: str
-        :param _AntiDDoSPackageId: Anti-DDoS service package ID. This is required when you want to request an Anti-DDoS IP.
+        :param _AntiDDoSPackageId: DDoS protection package unique ID. this field is required when applying for a ddos protection IP.
+
         :type AntiDDoSPackageId: str
         """
         self._InternetChargeType = None
@@ -11706,11 +11722,15 @@ This feature is currently in gradually released phase. To access it, please [con
 
     @property
     def InternetServiceProvider(self):
-        r"""Describes the line type. for details, refer to [EIP IP address types](https://www.tencentcloud.com/zh/document/product/213/5733). default value: `BGP`.
- <li>BGP Default: BGP</li>
-For a user who has activated the static single-line IP allowlist, possible values are:
- <li>CMCC: China Mobile</li> <li>CTCC: China Telecom</li> <li>CUCC: China Unicom</li>
-Note: Only certain regions support static single-line IP addresses.
+        r"""Line type. for details on various types of lines and supported regions, refer to [EIP IP address types](https://www.tencentcloud.comom/document/product/1199/41646?from_cn_redirect=1). default value: BGP.
+<Li>BGP: specifies the general bgp line.</li>.
+For a user with static single-line IP allowlist enabled, valid values include:.
+<Li>CMCC: china mobile.</li>.
+<Li>CTCC: china telecom</li>.
+<Li>CUCC: china unicom</li>.
+Note: The static single-line IP is only supported in some regions.
+
+
         :rtype: str
         """
         return self._InternetServiceProvider
@@ -11721,11 +11741,14 @@ Note: Only certain regions support static single-line IP addresses.
 
     @property
     def IPv4AddressType(self):
-        r"""Type of public IP address.
+        r"""Specifies the public IP type.
 
-<li> WanIP: Ordinary public IP address. </li> <li> HighQualityEIP: High Quality EIP is supported only in Singapore and Hong Kong. </li> <li> AntiDDoSEIP: Anti-DDoS IP is supported only in specific regions. For details, see [EIP Product Overview](https://www.tencentcloud.com/zh/document/product/213/5733). </li> 
-Specify the type of public IPv4 address to assign a public IPv4 address to the resource. HighQualityEIP and AntiDDoSEIP features are gradually released in select regions.
-This feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).
+<Li>WanIP: specifies the public ip address.</li>.
+<Li>HighQualityEIP: specifies a high quality ip. high quality ip is only supported in Singapore and hong kong (china).</li>.
+<li> AntiDDoSEIP: specifies the anti-ddos eip. only partial regions support anti-ddos eip. details visible in the [elastic IP product overview](https://www.tencentcloud.comom/document/product/1199/41646?from_cn_redirect=1).</li>.
+If needed, assign a public IPv4 address to the resource by specifying the IPv4 address type.
+
+This feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.
         :rtype: str
         """
         return self._IPv4AddressType
@@ -11736,15 +11759,12 @@ This feature is currently in gradually released phase. To access it, please [con
 
     @property
     def IPv6AddressType(self):
-        r"""Indicates the type of EIPv6. Valid values:
-
-<li>EIPv6: common IPv6</li>
-<li>HighQualityEIPv6: High Quality EIPv6</li>
-Note: Contact the product team to enable the dedicated IPv6 allowlist. The dedicated IPv6 is only supported in some regions. 
-
-Default: `EIPv6`
+        r"""Indicates the type of elastic public IPv6.
+<Li>EIPv6: elastic ip version 6.</li>.
+<Li>HighQualityEIPv6: specifies the high quality ipv6. highqualityeipv6 is only supported in hong kong (china).</li>.
+If needed, assign an elastic IPv6 address for resource allocation.
 
-This feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).
+This feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.
         :rtype: str
         """
         return self._IPv6AddressType
@@ -11755,7 +11775,8 @@ This feature is currently in gradually released phase. To access it, please [con
 
     @property
     def AntiDDoSPackageId(self):
-        r"""Anti-DDoS service package ID. This is required when you want to request an Anti-DDoS IP.
+        r"""DDoS protection package unique ID. this field is required when applying for a ddos protection IP.
+
         :rtype: str
         """
         return self._AntiDDoSPackageId
@@ -13324,10 +13345,9 @@ class MetadataItem(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Key: Custom metadata key. it must comply with the regular expression ^[a-zA-Z0-9_-]+$. the length is less than or equal to 128 bytes (case-sensitive).
-
+        :param _Key: Custom metadata key, consisting of uppercase letters (A-Z), lowercase letters (A-Z), digits (0-9), underscores (_), or hyphens (-), with a size limit of 128 bytes.
         :type Key: str
-        :param _Value: Specifies a custom metadata value. it supports any data . The size is &le; 256 KB. it is case-sensitive.
+        :param _Value: Custom metadata value. The upper limit of message size is 256 KB.
         :type Value: str
         """
         self._Key = None
@@ -13335,8 +13355,7 @@ class MetadataItem(AbstractModel):
 
     @property
     def Key(self):
-        r"""Custom metadata key. it must comply with the regular expression ^[a-zA-Z0-9_-]+$. the length is less than or equal to 128 bytes (case-sensitive).
-
+        r"""Custom metadata key, consisting of uppercase letters (A-Z), lowercase letters (A-Z), digits (0-9), underscores (_), or hyphens (-), with a size limit of 128 bytes.
         :rtype: str
         """
         return self._Key
@@ -13347,7 +13366,7 @@ class MetadataItem(AbstractModel):
 
     @property
     def Value(self):
-        r"""Specifies a custom metadata value. it supports any data . The size is &le; 256 KB. it is case-sensitive.
+        r"""Custom metadata value. The upper limit of message size is 256 KB.
         :rtype: str
         """
         return self._Value
@@ -14920,9 +14939,9 @@ class Placement(AbstractModel):
         r"""
         :param _Zone: ID of the availability zone where the instance resides. You can call the [DescribeZones](https://intl.cloud.tencent.com/document/product/213/35071) API and obtain the ID in the returned `Zone` field.
         :type Zone: str
-        :param _ProjectId: ID of the project to which the instance belongs. This parameter can be obtained from the `projectId` returned by [DescribeProject](https://intl.cloud.tencent.com/document/api/651/78725?from_cn_redirect=1). If this is left empty, the default project is used.
+        :param _ProjectId: Instance'S project ID. obtain this parameter by calling the `ProjectId` field in the return value of [DescribeProject](https://www.tencentcloud.comom/document/api/651/78725?from_cn_redirect=1). default value 0 means default project.
         :type ProjectId: int
-        :param _HostIds: ID list of CDHs from which the instance can be created. If you have purchased CDHs and specify this parameter, the instances you purchase will be randomly deployed on the CDHs.
+        :param _HostIds: Specifies the dedicated host ID list for instance ownership, only used for input parameters. if you purchase a dedicated host and specify this parameter, instances you purchase will be randomly deployed on these dedicated hosts. obtain this parameter by calling the `HostId` field in the return value of [DescribeHosts](https://www.tencentcloud.comom/document/api/213/16474?from_cn_redirect=1).
         :type HostIds: list of str
         :param _HostId: The ID of the CDH to which the instance belongs, only used as an output parameter.
         :type HostId: str
@@ -14945,7 +14964,7 @@ class Placement(AbstractModel):
 
     @property
     def ProjectId(self):
-        r"""ID of the project to which the instance belongs. This parameter can be obtained from the `projectId` returned by [DescribeProject](https://intl.cloud.tencent.com/document/api/651/78725?from_cn_redirect=1). If this is left empty, the default project is used.
+        r"""Instance'S project ID. obtain this parameter by calling the `ProjectId` field in the return value of [DescribeProject](https://www.tencentcloud.comom/document/api/651/78725?from_cn_redirect=1). default value 0 means default project.
         :rtype: int
         """
         return self._ProjectId
@@ -14956,7 +14975,7 @@ class Placement(AbstractModel):
 
     @property
     def HostIds(self):
-        r"""ID list of CDHs from which the instance can be created. If you have purchased CDHs and specify this parameter, the instances you purchase will be randomly deployed on the CDHs.
+        r"""Specifies the dedicated host ID list for instance ownership, only used for input parameters. if you purchase a dedicated host and specify this parameter, instances you purchase will be randomly deployed on these dedicated hosts. obtain this parameter by calling the `HostId` field in the return value of [DescribeHosts](https://www.tencentcloud.comom/document/api/213/16474?from_cn_redirect=1).
         :rtype: list of str
         """
         return self._HostIds
@@ -18643,12 +18662,13 @@ class SystemDisk(AbstractModel):
 <li>CLOUD_TSSD: Tremendous SSD</li>
 Default value: Current disk types with inventory available.
         :type DiskType: str
-        :param _DiskId: Specifies the system disk ID.
-This parameter currently only serves as a response parameter for query apis such as `DescribeInstances`, and cannot be used as an input parameter for write apis such as `RunInstances`.
+        :param _DiskId: System disk ID.
+Currently, this parameter is only used for response parameters in query apis such as [DescribeInstances](https://www.tencentcloud.comom/document/product/213/15728?from_cn_redirect=1) and is not applicable to request parameters in write apis such as [RunInstances](https://www.tencentcloud.comom/document/product/213/15730?from_cn_redirect=1).
         :type DiskId: str
         :param _DiskSize: System disk size; unit: GiB; default value: 50 GiB.
         :type DiskSize: int
-        :param _CdcId: Specifies the exclusive cluster ID it belongs to.
+        :param _CdcId: Specifies the dedicated cluster ID belonging to.
+Note: This field may return null, indicating that no valid value is found.
         :type CdcId: str
         :param _DiskName: Disk name, which specifies a length not exceeding 128 characters.
         :type DiskName: str
@@ -18681,8 +18701,8 @@ Default value: Current disk types with inventory available.
 
     @property
     def DiskId(self):
-        r"""Specifies the system disk ID.
-This parameter currently only serves as a response parameter for query apis such as `DescribeInstances`, and cannot be used as an input parameter for write apis such as `RunInstances`.
+        r"""System disk ID.
+Currently, this parameter is only used for response parameters in query apis such as [DescribeInstances](https://www.tencentcloud.comom/document/product/213/15728?from_cn_redirect=1) and is not applicable to request parameters in write apis such as [RunInstances](https://www.tencentcloud.comom/document/product/213/15730?from_cn_redirect=1).
         :rtype: str
         """
         return self._DiskId
@@ -18704,7 +18724,8 @@ This parameter currently only serves as a response parameter for query apis such
 
     @property
     def CdcId(self):
-        r"""Specifies the exclusive cluster ID it belongs to.
+        r"""Specifies the dedicated cluster ID belonging to.
+Note: This field may return null, indicating that no valid value is found.
         :rtype: str
         """
         return self._CdcId
@@ -19008,7 +19029,7 @@ class VirtualPrivateCloud(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _VpcId: VPC ID in the format of `vpc-xxx`. To obtain valid VPC IDs, you can log in to the [console](https://console.cloud.tencent.com/vpc/vpc?rid=1) or call the [DescribeVpcs](https://www.tencentcloud.com/document/product/215/15778) API and look for the `unVpcId` fields in the response. If you specify `DEFAULT` for both `VpcId` and `SubnetId` when creating an instance, the default VPC will be used.
+        :param _VpcId: vpc ID, such as `vpc-xxx`. valid vpc ids can be queried by logging in to the console (https://console.cloud.tencent.com/vpc/vpc?rid=1) or by calling the API [DescribeVpcs](https://www.tencentcloud.comom/document/product/215/15778?from_cn_redirect=1) and obtaining the `VpcId` field from the API response. if both VpcId and SubnetId are input as `DEFAULT` when creating an instance, the DEFAULT vpc network will be forcibly used.
         :type VpcId: str
         :param _SubnetId: vpc subnet ID, in the form of `subnet-xxx`. valid vpc subnet ids can be queried by logging in to the console (https://console.cloud.tencent.com/vpc/subnet?rid=1); or they can be obtained from the `SubnetId` field in the API response by calling the DescribeSubnets API (https://intl.cloud.tencent.com/document/product/215/15784?from_cn_redirect=1). if SubnetId and VpcId are both input as `DEFAULT` when creating an instance, the DEFAULT vpc network will be forcibly used.
         :type SubnetId: str
@@ -19028,7 +19049,7 @@ If IPv6AddressType is specified under InternetAccessible, this parameter must no
 
     @property
     def VpcId(self):
-        r"""VPC ID in the format of `vpc-xxx`. To obtain valid VPC IDs, you can log in to the [console](https://console.cloud.tencent.com/vpc/vpc?rid=1) or call the [DescribeVpcs](https://www.tencentcloud.com/document/product/215/15778) API and look for the `unVpcId` fields in the response. If you specify `DEFAULT` for both `VpcId` and `SubnetId` when creating an instance, the default VPC will be used.
+        r"""vpc ID, such as `vpc-xxx`. valid vpc ids can be queried by logging in to the console (https://console.cloud.tencent.com/vpc/vpc?rid=1) or by calling the API [DescribeVpcs](https://www.tencentcloud.comom/document/product/215/15778?from_cn_redirect=1) and obtaining the `VpcId` field from the API response. if both VpcId and SubnetId are input as `DEFAULT` when creating an instance, the DEFAULT vpc network will be forcibly used.
         :rtype: str
         """
         return self._VpcId