tccli-intl-en 3.0.1248.1__py2.py3-none-any.whl → 3.0.1282.1__py2.py3-none-any.whl

tccli/services/cvm/v20170312/api.json

@@ -1,7 +1,7 @@
 {
   "actions": {
     "AllocateHosts": {
-      "document": "This API is used to create CDH instances with specified configuration.\n* When HostChargeType is PREPAID, the HostChargePrepaid parameter must be specified.",
+      "document": "This API is used to create CDH instances with specified configuration.",
       "input": "AllocateHostsRequest",
       "name": "Creates CDH instances",
       "output": "AllocateHostsResponse",
@@ -343,6 +343,20 @@
       "output": "InquirePricePurchaseReservedInstancesOfferingResponse",
       "status": "online"
     },
+    "InquiryPriceModifyInstancesChargeType": {
+      "document": "This API is used to inquire about the price for switching billing modes of instance.\n\n\nThis API is used to indicate that instances with no charge when shut down, instances of the model families Batch Computing BC1 and Batch Computing BS1, instances of scheduled termination, and spot instances do not support this operation.",
+      "input": "InquiryPriceModifyInstancesChargeTypeRequest",
+      "name": "Modify the instance billing mode price inquiry",
+      "output": "InquiryPriceModifyInstancesChargeTypeResponse",
+      "status": "online"
+    },
+    "InquiryPriceRenewInstances": {
+      "document": "This API is used to inquire about the price for renewing a monthly subscription instance.\n\nThis API is used to query the renewal price of monthly subscription instances.",
+      "input": "InquiryPriceRenewInstancesRequest",
+      "name": "Renewal instance inquiry",
+      "output": "InquiryPriceRenewInstancesResponse",
+      "status": "online"
+    },
     "InquiryPriceResetInstance": {
       "document": "This API is used to inquire about the price for reinstalling an instance.\n\n* If you have specified the parameter `ImageId`, inquire about the price for reinstallation by using the specified image. Otherwise, inquire about the price for reinstallation based on the image currently used by the instance.\n* Currently, only instances with a [system disk type](https://intl.cloud.tencent.com/document/api/213/15753?from_cn_redirect=1#SystemDisk) of `CLOUD_BSSD`, `CLOUD_PREMIUM`, or `CLOUD_SSD` are supported for inquiring about the price for reinstallation caused by switching between `Linux` and `Windows` operating systems through this API.\n* Currently, instances in regions outside the Chinese mainland are not supported for inquiring about the price for reinstallation caused by switching between `Linux` and `Windows` operating systems through this API.",
       "input": "InquiryPriceResetInstanceRequest",
@@ -414,12 +428,26 @@
       "status": "online"
     },
     "ModifyInstancesAttribute": {
-      "document": "The API is used to modify the attributes of an instance. Only the name and the associated security groups can be modified for now.\n\n* An attribute must be specified in the request.\n* \"Instance name\" is a custom name for easier management. Tencent Cloud does not use the name for online support or instance management.\n* Batch operations are supported. Each request can modify up to 100 instances.\n* When you modify the security groups associated with an instance is modified, the original security groups are disassociated.\n* You can use the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5) to query the instance operation result. If the 'LatestOperationState' in the response is **SUCCESS**, the operation is successful.",
+      "document": "This API is used to modify instance attributes.\n\nThis API is used to modify one attribute of the instance per request. The attribute must be specified.\nThe instance name is only for user convenience in management. Tencent Cloud does not use this name as the basis for online support or to perform instance management operations.\nThis API is used to support batch operations. The maximum of 100 batch instances per request is supported.\nThis API is used to modify the security group association. The originally associated security group of the instance will be unbound.\n* You can query the result of the instance operation by calling the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5). If the latest operation status (LatestOperationState) of the instance is **SUCCESS**, the operation is successful.\nThis API is used to modify the hostname. The instance restarts immediately after hostname modification, and the new hostname takes effect after restart.",
       "input": "ModifyInstancesAttributeRequest",
       "name": "Modifies instance attributes",
       "output": "ModifyInstancesAttributeResponse",
       "status": "online"
     },
+    "ModifyInstancesChargeType": {
+      "document": "This API is used to switch the billing mode of an instance.\n\nThis API is used to perform operations that do not support instances with no charge when shut down, instances of the model families Batch Compute BC1 and Batch Compute BS1, or instances of scheduled termination.\n* You can query the result of the instance operation by calling the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5). If the latest operation status (LatestOperationState) of the instance is **SUCCESS**, the operation is successful.",
+      "input": "ModifyInstancesChargeTypeRequest",
+      "name": "Modify the instance billing mode",
+      "output": "ModifyInstancesChargeTypeResponse",
+      "status": "online"
+    },
+    "ModifyInstancesDisasterRecoverGroup": {
+      "document": "This API is used to adjust the placement group of an instance.\n* Currently only basic networks or Virtual Private Cloud (VPC) instances are supported.",
+      "input": "ModifyInstancesDisasterRecoverGroupRequest",
+      "name": "Adjust the distributed placement group of an instance",
+      "output": "ModifyInstancesDisasterRecoverGroupResponse",
+      "status": "online"
+    },
     "ModifyInstancesProject": {
       "document": "This API is used to change the project to which an instance is assigned.\n\n* Project is a virtual concept. You can create multiple projects under one account, manage different resources in each project, and assign different instances to different projects. You may use the [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1) API to query instances and use the project ID to filter the results.\n* You cannot modify the project of an instance that is bound to a load balancer. You need to unbind the load balancer from the instance by using the [DeregisterInstancesFromLoadBalancer](https://intl.cloud.tencent.com/document/api/214/1258?from_cn_redirect=1) API before using this API.\n* Batch operations are supported. Up to 100 instances per request is allowed.\n* You can use the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5) to query the operation result. If the `LatestOperationState` in the response is `SUCCESS`, the operation is successful.",
       "input": "ModifyInstancesProjectRequest",
@@ -483,6 +511,13 @@
       "output": "RemoveChcDeployVpcResponse",
       "status": "online"
     },
+    "RenewInstances": {
+      "document": "This API is used to renew annual and monthly subscription instances.\n\nThis API is used to operate on monthly subscription instances only.\nThis API is used to ensure your account balance is sufficient for renewal. You can check the balance via the DescribeAccountBalance API (https://www.tencentcloud.comom/document/product/555/20253?from_cn_redirect=1).\n* You can query the result of the instance operation by calling the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5). If the latest operation status (LatestOperationState) of the instance is **SUCCESS**, the operation is successful.",
+      "input": "RenewInstancesRequest",
+      "name": "Renew an instance",
+      "output": "RenewInstancesResponse",
+      "status": "online"
+    },
     "ResetInstance": {
       "document": "This API (ResetInstance) is used to reinstall the operating system on a specified instance.\n\n\n\n* If you have specified the parameter `ImageId`, use the specified image for reinstallation. Otherwise, perform reinstallation based on the image currently used by the instance.\n* The system disk will be formatted and reset. Ensure that there are no important files in the system disk.\n* If you do not specify a password, a random password will be sent via Message Center.\n* Currently, only instances with a [system disk type](https://intl.cloud.tencent.com/document/api/213/9452?from_cn_redirect=1#SystemDisk) of `CLOUD_BASIC`, `CLOUD_PREMIUM`, `CLOUD_SSD`, or `CLOUD_BSSD` are supported for implementing operating system switching through this API.\n* You can query the result of the instance operation by calling the API [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1#.E7.A4.BA.E4.BE.8B3-.E6.9F.A5.E8.AF.A2.E5.AE.9E.E4.BE.8B.E7.9A.84.E6.9C.80.E6.96.B0.E6.93.8D.E4.BD.9C.E6.83.85.E5.86.B5). If the latest operation status (LatestOperationState) of the instance is **SUCCESS**, the operation is successful.",
       "input": "ResetInstanceRequest",
@@ -655,7 +690,7 @@
         },
         {
           "disabled": false,
-          "document": "Configuration of prepaid instances. You can use the parameter to specify the attributes of prepaid instances, such as the subscription period and the auto-renewal plan. This parameter is required for prepaid instances.",
+          "document": "Not supported. Configuration of prepaid instances. You can use the parameter to specify the attributes of prepaid instances, such as the subscription period and the auto-renewal plan. This parameter is required for prepaid instances.",
           "example": "无",
           "member": "ChargePrepaid",
           "name": "HostChargePrepaid",
@@ -664,7 +699,7 @@
         },
         {
           "disabled": false,
-          "document": "Instance billing model, only monthly or yearly subscription supported. Default value: `PREPAID'.",
+          "document": "Instance [billing type](https://intl.cloud.tencent.com/document/product/213/2180?from_cn_redirect=1). <br><li>`POSTPAID_BY_HOUR`: Hourly-based pay-as-you-go <br>",
           "example": "PREPAID",
           "member": "string",
           "name": "HostChargeType",
@@ -2280,7 +2315,7 @@
         },
         {
           "disabled": false,
-          "document": "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>",
+          "document": "Specifies the data disk type. for restrictions on data disk types, refer to [storage overview](https://www.tencentcloud.com/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.",
           "example": "CLOUD_SSD",
           "member": "string",
           "name": "DiskType",
@@ -2335,7 +2370,7 @@
         },
         {
           "disabled": false,
-          "document": "Custom CMK's corresponding ID, with a value of UUID or something similar to kms - abcd1234. used for encrypting cloud disks.\n\nThis parameter is currently only used for the `RunInstances` api.",
+          "document": "Custom CMK ID, value is UUID or similar to kms-abcd1234. used for encrypted cloud disk.\n\nThis parameter is currently only used for the `RunInstances` api.\nNote: This field may return null, indicating that no valid value is found.",
           "example": "kms-abcd1234",
           "member": "string",
           "name": "KmsKeyId",
@@ -2346,7 +2381,7 @@
         },
         {
           "disabled": false,
-          "document": "Specifies the cloud disk performance (unit: MiB/s). using this parameter allows you to purchase additional performance for the cloud disk.\nCurrently only supports ultra-fast CLOUD disk (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).",
+          "document": "Cloud disk performance (unit: MiB/s). specifies additional performance for cloud disks.\nCurrently only supports extreme cbs (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD).\nNote: This field may return null, indicating that no valid value is found.",
           "example": "20",
           "member": "int64",
           "name": "ThroughputPerformance",
@@ -2357,7 +2392,7 @@
         },
         {
           "disabled": false,
-          "document": "Specifies the exclusive cluster ID it belongs to.",
+          "document": "Specifies the dedicated cluster ID belonging to.\nNote: This field may return null, indicating that no valid value is found.",
           "example": "cdc-1648zauv",
           "member": "string",
           "name": "CdcId",
@@ -2368,7 +2403,7 @@
         },
         {
           "disabled": false,
-          "document": "Burst performance.\n\n<B>Note: this feature is in beta test.</b>.",
+          "document": "Burstable performance.\n\n<B>Note: this field is in beta test.</b>.",
           "example": "false",
           "member": "bool",
           "name": "BurstPerformance",
@@ -3104,9 +3139,10 @@
         {
           "disabled": false,
           "document": "List of instance model families",
-          "example": "",
+          "example": "无",
           "member": "InstanceFamilyConfig",
           "name": "InstanceFamilyConfigSet",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -3195,7 +3231,7 @@
         {
           "disabled": false,
           "document": "The maximum number of times you can modify the instance configurations (degrading the configurations)",
-          "example": "[     {         \"Operation\": \"INSTANCE_DEGRADE\",         \"InstanceId\": \"ins-r8hr2upy\",         \"CurrentCount\": 0,         \"LimitCount\": 5     } ]",
+          "example": "无",
           "member": "OperationCountLimit",
           "name": "InstanceOperationLimitSet",
           "output_required": true,
@@ -4151,7 +4187,7 @@
         {
           "disabled": false,
           "document": "Instance ID Needs to Enter Rescue Mode",
-          "example": "'ins-abcdefg'",
+          "example": "ins-abcdefg",
           "member": "string",
           "name": "InstanceId",
           "required": true,
@@ -4160,7 +4196,7 @@
         {
           "disabled": false,
           "document": "System Password in Rescue Mode",
-          "example": "'hello123456789'",
+          "example": "hello123456789",
           "member": "string",
           "name": "Password",
           "required": true,
@@ -4169,20 +4205,29 @@
         {
           "disabled": false,
           "document": "System Username in Rescue Mode",
-          "example": "'root'",
+          "example": "root",
           "member": "string",
           "name": "Username",
           "required": false,
           "type": "string"
         },
         {
-          "disabled": false,
+          "disabled": true,
           "document": "Whether to perform forced shutdown.",
-          "example": "False",
+          "example": "false",
           "member": "bool",
           "name": "ForceStop",
           "required": false,
           "type": "bool"
+        },
+        {
+          "disabled": false,
+          "document": "",
+          "example": "HARD",
+          "member": "string",
+          "name": "StopType",
+          "required": false,
+          "type": "string"
         }
       ],
       "type": "object"
@@ -4205,7 +4250,7 @@
         {
           "disabled": false,
           "document": "Instance ID Exiting Rescue Mode",
-          "example": "instance_Id",
+          "example": "ins-axzc12s",
           "member": "string",
           "name": "InstanceId",
           "required": true,
@@ -4395,7 +4440,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "Number of GPUs. \nNote: this field may return `null`, indicating that no valid value can be found.",
+          "document": "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.",
           "example": "1",
           "member": "float",
           "name": "GPUCount",
@@ -4405,7 +4450,7 @@
         },
         {
           "disabled": false,
-          "document": "GPU address\nNote: this field may return `null`, indicating that no valid value can be found.",
+          "document": "Specifies the GPU address of the instance.",
           "example": "['0000:18:00.0','0000:18:00.1']",
           "member": "string",
           "name": "GPUId",
@@ -4415,7 +4460,7 @@
         },
         {
           "disabled": false,
-          "document": "GPU type of the instance.\nNote: this field may return `null`, indicating that no valid value can be found.",
+          "document": "Specifies the GPU type of the instance.",
           "example": "NVIDIA T4",
           "member": "string",
           "name": "GPUType",
@@ -5143,6 +5188,134 @@
       ],
       "type": "object"
     },
+    "InquiryPriceModifyInstancesChargeTypeRequest": {
+      "document": "InquiryPriceModifyInstancesChargeType request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "One or more instance IDs to be operated. You can obtain the instance ID through the `InstanceId` in the return value from the API [DescribeInstances](https://www.tencentcloud.com/document/api/213/15728?from_cn_redirect=1). The maximum number of instances per request is 100.",
+          "example": "[\"ins-r8hr2upy\"]",
+          "member": "string",
+          "name": "InstanceIds",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Modified instance [billing type](https://www.tencentcloud.com/document/product/213/2180?from_cn_redirect=1). <br><li>`PREPAID`: monthly subscription.</li>\n\n**Note:** Only supports converting pay-as-you-go instances to annual and monthly subscription instances.\n\ndefault value: `PREPAID`",
+          "example": "PREPAID",
+          "member": "string",
+          "name": "InstanceChargeType",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Prepaid mode, parameter settings related to monthly/annual subscription. through this parameter, specify the purchase duration of annual and monthly subscription instances, whether to enable auto-renewal, and other attributes. ",
+          "example": "无",
+          "member": "InstanceChargePrepaid",
+          "name": "InstanceChargePrepaid",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "Whether to switch the billing mode of elastic data cloud disks simultaneously. valid values: <br><li>true: means switching the billing mode of elastic data cloud disks</li><li>false: means not switching the billing mode of elastic data cloud disks</li><br>default value: false.",
+          "example": "false",
+          "member": "bool",
+          "name": "ModifyPortableDataDisk",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "InquiryPriceModifyInstancesChargeTypeResponse": {
+      "document": "InquiryPriceModifyInstancesChargeType response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "This parameter indicates the price for switching the billing mode of the corresponding configuration instance.",
+          "example": "无",
+          "member": "Price",
+          "name": "Price",
+          "output_required": true,
+          "type": "object",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "InquiryPriceRenewInstancesRequest": {
+      "document": "InquiryPriceRenewInstances request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "One or more instance IDs to be operated. You can obtain the instance ID through the `InstanceId` in the return value from the API [DescribeInstances](https://www.tencentcloud.comom/document/api/213/15728?from_cn_redirect=1). The maximum number of instances per request is 100.",
+          "example": "[\"ins-2zvpghhc\"]",
+          "member": "string",
+          "name": "InstanceIds",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Prepaid mode, that is, monthly subscription-related parameter settings. You can specify attributes of a monthly subscription instance, such as purchase duration and whether to set auto-renewal, through this parameter.",
+          "example": "无",
+          "member": "InstanceChargePrepaid",
+          "name": "InstanceChargePrepaid",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "Trial run, for testing purposes, does not execute specific logic. valid values: <li>`true`: skip execution logic</li> <li>`false`: execute logic</li>  default value: `false`.",
+          "example": "false",
+          "member": "bool",
+          "name": "DryRun",
+          "required": false,
+          "type": "bool"
+        },
+        {
+          "disabled": false,
+          "document": "Whether to renew the elastic data disk. valid values:<br><li>true: indicates renewing the annual and monthly subscription instance and its mounted elastic data disk simultaneously</li><li>false: indicates renewing the annual and monthly subscription instance while no longer renewing its mounted elastic data disk</li><br>default value: true.",
+          "example": "false",
+          "member": "bool",
+          "name": "RenewPortableDataDisk",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "InquiryPriceRenewInstancesResponse": {
+      "document": "InquiryPriceRenewInstances response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "This parameter indicates the price for the corresponding configuration instance.",
+          "example": "无",
+          "member": "Price",
+          "name": "Price",
+          "output_required": true,
+          "type": "object",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "InquiryPriceResetInstanceRequest": {
       "document": "InquiryPriceResetInstance request structure.",
       "members": [
@@ -5190,6 +5363,15 @@
           "name": "EnhancedService",
           "required": false,
           "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "",
+          "example": "TXlVc2VyRGF0YQo",
+          "member": "string",
+          "name": "UserData",
+          "required": false,
+          "type": "string"
         }
       ],
       "type": "object"
@@ -5422,7 +5604,7 @@
         },
         {
           "disabled": false,
-          "document": "The instance model. Different resource specifications are specified for different models. For specific values, call [DescribeInstanceTypeConfigs](https://intl.cloud.tencent.com/document/api/213/15749?from_cn_redirect=1) to retrieve the latest specification list or refer to [Instance Types](https://intl.cloud.tencent.com/document/product/213/11518?from_cn_redirect=1). If the parameter is not specified, `S1.SMALL1` will be used by default.",
+          "document": "Instance model. Different instance models specify different resource specifications.\n<br><li>For instances created with the payment modes PREPAID or POSTPAID_BY_HOUR, specifies the specific values obtained BY calling the [DescribeInstanceTypeConfigs](https://www.tencentcloud.comom/document/api/213/15749?from_cn_redirect=1) api for the latest specification table or referring to [instance specifications](https://www.tencentcloud.comom/document/product/213/11518?from_cn_redirect=1). if not specified, the system will dynamically assign a default model based on the current resource sales situation in a region.</li><br><li>for instances created with the payment mode CDHPAID, indicates this parameter uses the prefix \"CDH_\" and is generated based on CPU and memory configuration. the specific format is: CDH_XCXG. for example, for creating a CDH instance with 1 CPU core and 1 gb memory, this parameter should be CDH_1C1G.</li>.",
           "example": "S5.MEDIUM2",
           "member": "string",
           "name": "InstanceType",
@@ -5476,7 +5658,7 @@
         },
         {
           "disabled": false,
-          "document": "Instance name.<br><li>If this parameter is not specified, \"Unnamed\" will be displayed by default.</li><li>If you purchase multiple instances and specify a pattern string `{R:x}`, numbers `[x, x+n-1]` will be generated, where `n` represents the number of instances purchased. For example, you specify a pattern string `server_{R:3}`. If you purchase only one instance, the instance will be named `server_3`; if you purchase two, they will be named `server_3` and `server_4`. You can specify multiple pattern strings in the format of `{R:x}`.</li><li>If you purchase multiple instances without specifying a pattern string, the instance names will be suffixed with `1, 2...n`, where `n` represents the number of instances purchased. For example, if you purchase two instances with the name `server_`, the instance names will be `server_1` and `server_2`.</li><li>This parameter can contain up to 60 characters (including pattern strings).</li>",
+          "document": "Instance display name. <li>if no instance display name is specified, it will display 'unnamed' by default.</li> <li>when purchasing multiple instances, if the pattern string `{R:x}` is specified, it means generating numbers `[x, x+n-1]`, where `n` represents the number of purchased instances. for example, `server_{R:3}`: when purchasing 1 instance, the instance display name is `server_3`; when purchasing 2 instances, the instance display names are `server_3` and `server_4` respectively. supports specifying multiple pattern strings `{R:x}`.</li> <li>when purchasing multiple instances without specifying a pattern string, suffixes `1, 2...n` will be added to the instance display name, where `n` represents the number of purchased instances. for example, `server_`: when purchasing 2 instances, the instance display names are `server_1` and `server_2` respectively.</li> <li>supports up to 128 characters (including pattern strings).</li>.",
           "example": "myInstance",
           "member": "string",
           "name": "InstanceName",
@@ -5494,7 +5676,7 @@
         },
         {
           "disabled": false,
-          "document": "Security groups to which the instance belongs. To obtain the security group IDs, you can call [DescribeSecurityGroups](https://intl.cloud.tencent.com/document/api/215/15808) and look for the `sgld` fields in the response. If this parameter is not specified, the instance will not be associated with any security group by default.",
+          "document": "Security group to which an instance belongs. obtain this parameter by calling the `SecurityGroupId` field in the return value of [DescribeSecurityGroups](https://www.tencentcloud.comom/document/api/215/15808?from_cn_redirect=1). if not specified, bind the default security group under the designated project. if the default security group does not exist, automatically create it.\n",
           "example": "[\"sg-efil73jd\"]",
           "member": "string",
           "name": "SecurityGroupIds",
@@ -5513,7 +5695,7 @@
         {
           "disabled": false,
           "document": "A unique string supplied by the client to ensure that the request is idempotent. Its maximum length is 64 ASCII characters. If this parameter is not specified, the idempotency of the request cannot be guaranteed.<br>For more information, see Ensuring Idempotency.",
-          "example": "无",
+          "example": "a521b4e4-c903-4d37-9de6-8096e3ad8eb7",
           "member": "string",
           "name": "ClientToken",
           "required": false,
@@ -5546,6 +5728,15 @@
           "required": false,
           "type": "object"
         },
+        {
+          "disabled": false,
+          "document": "Custom metadata, supports creating key-value pairs of custom metadata when creating a CVM.\n\n**Note: this field is in beta test.**.",
+          "example": "无",
+          "member": "Metadata",
+          "name": "Metadata",
+          "required": false,
+          "type": "object"
+        },
         {
           "disabled": false,
           "document": "HPC cluster ID.",
@@ -5643,7 +5834,7 @@
         },
         {
           "disabled": false,
-          "document": "Memory capacity; unit: `GB`.",
+          "document": "Instance memory capacity. unit: GiB.",
           "example": "1",
           "member": "int64",
           "name": "Memory",
@@ -5653,7 +5844,7 @@
         },
         {
           "disabled": false,
-          "document": "Instance status. Valid values: <br><li>NORMAL: instance is normal. <br><li>EXPIRED: instance expired. <br><li>PROTECTIVELY_ISOLATED: instance is protectively isolated.",
+          "document": "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>.",
           "example": "NORMAL",
           "member": "string",
           "name": "RestrictState",
@@ -5753,7 +5944,7 @@
         },
         {
           "disabled": false,
-          "document": "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.\n<br><li>Note: this parameter is `null` for postpaid instances.",
+          "document": "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.\nNote: this field is null in postpaid mode.",
           "example": "NOTIFY_AND_MANUAL_RENEW",
           "member": "string",
           "name": "RenewFlag",
@@ -5813,7 +6004,7 @@
         },
         {
           "disabled": false,
-          "document": "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>",
+          "document": "Instance status. for specific status types, see the  [instance status table](https://www.tencentcloud.com/document/product/213/15753#instancestatus)",
           "example": "RUNNING",
           "member": "string",
           "name": "InstanceState",
@@ -5833,7 +6024,7 @@
         },
         {
           "disabled": false,
-          "document": "Instance billing method after shutdown.\nValid 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>",
+          "document": "Shutdown billing mode of an instance.\n\nValid 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>.",
           "example": "NOT_APPLICABLE",
           "member": "string",
           "name": "StopChargingMode",
@@ -5863,7 +6054,7 @@
         },
         {
           "disabled": false,
-          "document": "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",
+          "document": "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>.\nNote: This field may return null, indicating that no valid value is found.",
           "example": "SUCCESS",
           "member": "string",
           "name": "LatestOperationState",
@@ -5883,7 +6074,7 @@
         },
         {
           "disabled": false,
-          "document": "ID of a spread placement group.\nNote: this field may return null, indicating that no valid value is obtained.",
+          "document": "Spread placement group ID.",
           "example": "ps-l7sdunxx",
           "member": "string",
           "name": "DisasterRecoverGroupId",
@@ -5913,7 +6104,7 @@
         },
         {
           "disabled": false,
-          "document": "HPC cluster ID.\nNote: this field may return null, indicating that no valid value was found.",
+          "document": "High-performance computing cluster ID.",
           "example": "hpc-4dxxetpt",
           "member": "string",
           "name": "HpcClusterId",
@@ -5933,7 +6124,7 @@
         },
         {
           "disabled": false,
-          "document": "",
+          "document": "Dedicated cluster ID where the instance is located.",
           "example": "cluster-du3jken",
           "member": "string",
           "name": "DedicatedClusterId",
@@ -5943,7 +6134,7 @@
         },
         {
           "disabled": false,
-          "document": "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>\nNote: this field may return null, indicating that no valid value was found.",
+          "document": "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>.",
           "example": "NOTISOLATED",
           "member": "string",
           "name": "IsolatedSource",
@@ -5953,7 +6144,7 @@
         },
         {
           "disabled": false,
-          "document": "GPU information. This field is only returned for GPU instances.\nNote: this field may return null, indicating that no valid value was found.",
+          "document": "GPU information. if it is a gpu type instance, this value will be returned. for other type instances, it does not return.",
           "example": "无",
           "member": "GPUInfo",
           "name": "GPUInfo",
@@ -5973,7 +6164,7 @@
         },
         {
           "disabled": false,
-          "document": "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`.",
+          "document": "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.",
           "example": "false",
           "member": "bool",
           "name": "DisableApiTermination",
@@ -6013,7 +6204,17 @@
         },
         {
           "disabled": false,
-          "document": "Public IPv6 address of the instance.\nNote: this field may return null, indicating that no valid value was found.",
+          "document": "Custom metadata. this parameter corresponds to the metadata information specified when creating a CVM. **note: in beta test**.",
+          "example": "无",
+          "member": "Metadata",
+          "name": "Metadata",
+          "output_required": false,
+          "type": "object",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Specifies the public IPv6 address bound to the instance.",
           "example": "[\"240d:c000:f000:ac00:5460:6340:16aa:6\"]",
           "member": "string",
           "name": "PublicIPv6Addresses",
@@ -6084,20 +6285,20 @@
         {
           "disabled": false,
           "document": "Full name of the model family.",
-          "example": "",
+          "example": "高IO型I1",
           "member": "string",
           "name": "InstanceFamilyName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Acronym of the model family.",
-          "example": "",
+          "example": "I1",
           "member": "string",
           "name": "InstanceFamily",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         }
@@ -6138,7 +6339,7 @@
         {
           "disabled": false,
           "document": "Instance `ID`.",
-          "example": "无",
+          "example": "ins-g4c6xxxx",
           "member": "string",
           "name": "InstanceId",
           "output_required": true,
@@ -6148,7 +6349,7 @@
         {
           "disabled": false,
           "document": "Instance status. 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 up.<br></li><li>STOPPING: Shutting down.<br></li><li>REBOOTING: Restarting.<br></li><li>SHUTDOWN: Shut down and to be terminated.<br></li><li>TERMINATING: Terminating.<br></li><li>ENTER_RESCUE_MODE: Entering the rescue mode.<br></li><li>RESCUE_MODE: In the rescue mode.<br></li><li>EXIT_RESCUE_MODE: Exiting the rescue mode.<br></li><li>ENTER_SERVICE_LIVE_MIGRATE: Entering online service migration.<br></li><li>SERVICE_LIVE_MIGRATE: In online service migration.<br></li><li>EXIT_SERVICE_LIVE_MIGRATE: Exiting online service migration.<br></li>",
-          "example": "无",
+          "example": "RUNNING",
           "member": "string",
           "name": "InstanceState",
           "output_required": true,
@@ -6443,7 +6644,7 @@
         },
         {
           "disabled": false,
-          "document": "Describes the line type. for details, refer to [EIP IP address types](https://www.tencentcloud.com/zh/document/product/213/5733). default value: `BGP`.\n <li>BGP Default: BGP</li>\nFor a user who has activated the static single-line IP allowlist, possible values are:\n <li>CMCC: China Mobile</li> <li>CTCC: China Telecom</li> <li>CUCC: China Unicom</li>\nNote: Only certain regions support static single-line IP addresses.",
+          "document": "Line type. for details on various types of lines and supported regions, refer to [EIP IP address types](https://cloud.tencent.com/document/product/1199/41646). default value: BGP.\n<Li>BGP: specifies the general bgp line.</li>.\nFor a user with static single-line IP allowlist enabled, valid values include:.\n<Li>CMCC: china mobile.</li>.\n<Li>CTCC: china telecom</li>.\n<Li>CUCC: china unicom</li>.\nNote: The static single-line IP is only supported in some regions.\n\n",
           "example": "BGP",
           "member": "string",
           "name": "InternetServiceProvider",
@@ -6454,7 +6655,7 @@
         },
         {
           "disabled": false,
-          "document": "Type of public IP address.\n\n<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> \nSpecify 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.\nThis feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).",
+          "document": "Specifies the public IP type.\n\n<Li>WanIP: specifies the public ip address.</li>.\n<Li>HighQualityEIP: specifies a high quality ip. high quality ip is only supported in Singapore and hong kong (china).</li>.\n<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>.\nIf needed, assign a public IPv4 address to the resource by specifying the IPv4 address type.\n\nThis feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.",
           "example": "WanIP",
           "member": "string",
           "name": "IPv4AddressType",
@@ -6465,7 +6666,7 @@
         },
         {
           "disabled": false,
-          "document": "Indicates the type of EIPv6. Valid values:\n\n<li>EIPv6: common IPv6</li>\n<li>HighQualityEIPv6: High Quality EIPv6</li>\nNote: Contact the product team to enable the dedicated IPv6 allowlist. The dedicated IPv6 is only supported in some regions. \n\nDefault: `EIPv6`\n\nThis feature is currently in gradually released phase. To access it, please [contact us](https://console.tencentcloud.com/workorder).",
+          "document": "Indicates the type of elastic public IPv6.\n<Li>EIPv6: elastic ip version 6.</li>.\n<Li>HighQualityEIPv6: specifies the high quality ipv6. highqualityeipv6 is only supported in hong kong (china).</li>.\nIf needed, assign an elastic IPv6 address for resource allocation.\n\nThis feature is in beta test in selected regions. submit a ticket for consultation (https://console.cloud.tencent.com/workorder/category) if needed.",
           "example": "EIPv6",
           "member": "string",
           "name": "IPv6AddressType",
@@ -6476,7 +6677,7 @@
         },
         {
           "disabled": false,
-          "document": "Anti-DDoS service package ID. This is required when you want to request an Anti-DDoS IP.",
+          "document": "DDoS protection package unique ID. this field is required when applying for a ddos protection IP.\n",
           "example": "bgp-00000000",
           "member": "string",
           "name": "AntiDDoSPackageId",
@@ -7345,7 +7546,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "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).\n",
+          "document": "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.",
           "example": "\"key\"",
           "member": "string",
           "name": "Key",
@@ -7356,7 +7557,7 @@
         },
         {
           "disabled": false,
-          "document": "Specifies a custom metadata value. it supports any data . The size is &le; 256 KB. it is case-sensitive.",
+          "document": "Custom metadata value. The upper limit of message size is 256 KB.",
           "example": "\"value\"",
           "member": "string",
           "name": "Value",
@@ -7482,7 +7683,7 @@
         {
           "disabled": false,
           "document": "CDH instance ID(s).",
-          "example": "[\"host-ey16rkyg\\n\"]",
+          "example": "[\"host-ey16rkyg\"]",
           "member": "string",
           "name": "HostIds",
           "required": true,
@@ -7652,7 +7853,7 @@
         },
         {
           "disabled": false,
-          "document": "The instance name, which can not exceed 60 characters\n<dx-alert infotype=\"explain\" title=\"\">Either `InstanceName` or `SecurityGroups` must be specified, but they can not be both specified.</dx-alert>",
+          "document": "Modified instance name. can be named as required but should not exceed 128 characters.",
           "example": "MyInsName",
           "member": "string",
           "name": "InstanceName",
@@ -7670,7 +7871,7 @@
         },
         {
           "disabled": false,
-          "document": "IDs of security groups associated with the specified instance. You can associate with a security group by adding its ID, or cancel the association with a security group by removing its ID. <dx-alert infotype=\"explain\" title=\"\">Either `InstanceName` or `SecurityGroups` must be specified, but they cannot be both set.</dx-alert>",
+          "document": "Specifies the security group Id list of the specified instance after modification. the instance will reassociate with the security groups in the specified list, and the associated security group will be unbound.",
           "example": "[\"sg-rf6ogz49\"]",
           "member": "string",
           "name": "SecurityGroups",
@@ -7706,7 +7907,7 @@
         },
         {
           "disabled": false,
-          "document": "The role type, which is used in conjunction with `CamRoleName`. The value is obtained in `RoleType` field, returning by `CAM DescribeRoleList` and `GetRole` APIs. Valid value: `user`, `system` and `service_linked`.\nFor example, when `LinkedRoleIn` is contained in `CamRoleName` (such as `TKE_QCSLinkedRoleInPrometheusService`), the returned `RoleType` of `DescribeRoleList` and `GetRoleis` is `service_linked`, and the `CamRoleType` `service_linked`.\nWhen the value obtained in `RoleType` is `user` (default) or `system`, `CamRoleType` can be left empty.",
+          "document": "Role type, used in conjunction with CamRoleName. this value can be obtained from the RoleType field in the API response of CAM [DescribeRoleList](https://www.tencentcloud.comom/document/product/598/36223?from_cn_redirect=1) or [GetRole](https://www.tencentcloud.comom/document/product/598/36221?from_cn_redirect=1). currently, only user, system, and service_linked types are accepted.\nFor example, when CamRoleName contains \"LinkedRoleIn\" (such as TKE_QCSLinkedRoleInPrometheusService), DescribeRoleList and GetRole return RoleType as service_linked, this parameter must also transmit service_linked.\nThe parameter default value is user. this parameter can be omitted if CameRoleName is not of the service_linked kind.",
           "example": "user",
           "member": "string",
           "name": "CamRoleType",
@@ -7737,6 +7938,105 @@
       ],
       "type": "object"
     },
+    "ModifyInstancesChargeTypeRequest": {
+      "document": "ModifyInstancesChargeType request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "One or more instance ids to be operated. you can obtain the instance ID through the `InstanceId` in the return value from the api [DescribeInstances](https://www.tencentcloud.com/document/api/213/15728?from_cn_redirect=1). the maximum number of instances per request is 30.",
+          "example": "[\"ins-r8hr2upy\"]",
+          "member": "string",
+          "name": "InstanceIds",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Modified instance [billing type](https://www.tencentcloud.com/document/product/213/2180?from_cn_redirect=1). <li>`PREPAID`: monthly subscription.</li> \n**Note:** Only supports converting pay-as-you-go instances to annual and monthly subscription instances.\n\ndefault value: `PREPAID`",
+          "example": "PREPAID",
+          "member": "string",
+          "name": "InstanceChargeType",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Modified prepaid mode, parameter settings related to monthly/annual subscription. by specifying this parameter, you can specify the purchase duration of annual and monthly subscription instances, whether to enable auto-renewal, and other attributes. ",
+          "example": "无",
+          "member": "InstanceChargePrepaid",
+          "name": "InstanceChargePrepaid",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "Whether to switch the billing mode of elastic data cloud disks simultaneously. valid values: <li> true: means switching the billing mode of elastic data cloud disks</li><li> false: means not switching the billing mode of elastic data cloud disks</li>default value: false.",
+          "example": "false",
+          "member": "bool",
+          "name": "ModifyPortableDataDisk",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "ModifyInstancesChargeTypeResponse": {
+      "document": "ModifyInstancesChargeType response structure.",
+      "members": [
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ModifyInstancesDisasterRecoverGroupRequest": {
+      "document": "ModifyInstancesDisasterRecoverGroup request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "One or more instance ids to be operated. you can obtain the instance ID through the `InstanceId` in the return value from the api [DescribeInstances](https://www.tencentcloud.com/zh/document/api/213/33258). the maximum number of instances per request is 100.",
+          "example": "[\"ins-r8hr2upy\"]",
+          "member": "string",
+          "name": "InstanceIds",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Spread placement group ID. obtain through the api [DescribeDisasterRecoverGroups](https://www.tencentcloud.com/zh/document/api/213/33261).",
+          "example": "ps-a66w6rlb",
+          "member": "string",
+          "name": "DisasterRecoverGroupId",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Whether to forcibly change instance hosts. value range:<br><li>true: indicates that the instance is allowed to change hosts, allowing the instance to reboot. local disk machine does not support specifying this parameter.</li><br><li>false: does not allow the instance to change hosts. instances can only be added to the placement group on the current host. this may result in a failure to change the placement group.</li><br><br>default value: false.",
+          "example": "false",
+          "member": "bool",
+          "name": "Force",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "ModifyInstancesDisasterRecoverGroupResponse": {
+      "document": "ModifyInstancesDisasterRecoverGroup response structure.",
+      "members": [
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "ModifyInstancesProjectRequest": {
       "document": "ModifyInstancesProject request structure.",
       "members": [
@@ -7950,40 +8250,40 @@
         {
           "disabled": false,
           "document": "Instance operation. Valid values: <br><li>`INSTANCE_DEGRADE`: downgrade an instance<br><li>`INTERNET_CHARGE_TYPE_CHANGE`: modify the billing plan of the network connection",
-          "example": "",
+          "example": "INSTANCE_DEGRADE",
           "member": "string",
           "name": "Operation",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Instance ID.",
-          "example": "",
+          "example": "ins-xxxxx",
           "member": "string",
           "name": "InstanceId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of operations already performed. If it returns `-1`, it means there is no limit on the times of the operation.",
-          "example": "",
+          "example": "1",
           "member": "int64",
           "name": "CurrentCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Maximum number of times you can perform an operation. If it returns `-1`, it means there is no limit on the times of the operation. If it returns `0`, it means that configuration modification is not supported.",
-          "example": "",
+          "example": "5",
           "member": "int64",
           "name": "LimitCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -8042,7 +8342,7 @@
         },
         {
           "disabled": false,
-          "document": "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.",
+          "document": "Instance'S project ID. obtain this parameter by calling the `ProjectId` field in the return value of [DescribeProject](https://www.tencentcloud.com/document/product/651/54679). default value 0 means default project.",
           "example": "0",
           "member": "int64",
           "name": "ProjectId",
@@ -8053,7 +8353,7 @@
         },
         {
           "disabled": false,
-          "document": "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.",
+          "document": "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.com/document/product/213/33279?lang=en).",
           "example": "[\"host-o5i742go\"]",
           "member": "string",
           "name": "HostIds",
@@ -8307,6 +8607,51 @@
       ],
       "type": "object"
     },
+    "RenewInstancesRequest": {
+      "document": "RenewInstances request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "One or more instance IDs to be operated. You can obtain the instance ID through the `InstanceId` in the return value from the API [DescribeInstances](https://www.tencentcloud.comom/document/api/213/15728?from_cn_redirect=1). The maximum number of instances per request is 100.",
+          "example": "[\"ins-r8hr2upy\"]",
+          "member": "string",
+          "name": "InstanceIds",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Prepaid mode, that is, parameter settings related to monthly/annual subscription. specifies attributes of a monthly subscription instance, such as renewal duration and whether to enable auto-renewal, by specifying this parameter. <dx-alert infotype=\"explain\" title=\"\">.\nAnnual and monthly subscription instances. this parameter is a required parameter.</dx-alert>.",
+          "example": "无",
+          "member": "InstanceChargePrepaid",
+          "name": "InstanceChargePrepaid",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "Whether to renew the elastic data disk. valid values:<br><li>true: indicates renewing the annual and monthly subscription instance and its mounted elastic data disk simultaneously</li><li>false: indicates renewing the annual and monthly subscription instance while no longer renewing its mounted elastic data disk</li><br>default value: true.",
+          "example": "false",
+          "member": "bool",
+          "name": "RenewPortableDataDisk",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "RenewInstancesResponse": {
+      "document": "RenewInstances response structure.",
+      "members": [
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "ReservedInstanceConfigInfoItem": {
       "document": "Static configurations of the reserved instance.",
       "members": [
@@ -9178,7 +9523,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "Instance ID. To obtain the instance IDs, you can call [`DescribeInstances`](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1) and look for `InstanceId` in the response.",
+          "document": "Instance ID to be operated. can be obtained from the `InstanceId` in the return value from the DescribeInstances api (https://www.tencentcloud.comom/document/api/213/15728?from_cn_redirect=1).",
           "example": "ins-r8hr2upy",
           "member": "string",
           "name": "InstanceId",
@@ -9187,7 +9532,7 @@
         },
         {
           "disabled": false,
-          "document": "Configuration information of a data disk to be expanded. Only inelastic data disks (with `Portable` being `false` in the return values of [DescribeDisks](https://intl.cloud.tencent.com/document/api/362/16315?from_cn_redirect=1)) can be expanded. The unit of data disk capacity is GB. The minimum expansion step is 10 GB. For more information about data disk types, refer to [Disk Product Introduction](https://intl.cloud.tencent.com/document/product/362/2353?from_cn_redirect=1). The available data disk type is restricted by the instance type `InstanceType`. Additionally, the maximum allowable capacity for expansion varies by data disk type.\n<dx-alert infotype=\"explain\" title=\"\">You should specify either DataDisks or SystemDisk, but you cannot specify both at the same time.</dx-alert>",
+          "document": "Specifies the configuration information of the data disk to be expanded, only supporting specifying the target capacity of the disk to be expanded. only non-elastic data disks (with `Portable` being `false` in the return values of [DescribeDisks](https://www.tencentcloud.comom/document/api/362/16315?from_cn_redirect=1)) can be expanded. the unit of data disk capacity is GiB. the minimum expansion step is 10 GiB. for data disk type selection, refer to [disk product introduction](https://www.tencentcloud.comom/document/product/362/2353?from_cn_redirect=1). the available data disk type is restricted by the instance type `InstanceType`. additionally, the maximum allowable capacity for expansion varies by data disk type.\n<dx-alert infotype=\"explain\" title=\"\">You should specify either DataDisks or SystemDisk, but you cannot specify both at the same time.</dx-alert>",
           "example": "无",
           "member": "DataDisk",
           "name": "DataDisks",
@@ -9196,7 +9541,7 @@
         },
         {
           "disabled": false,
-          "document": "Whether to forcibly shut down a running instance. It is recommended to manually shut down a running instance first and then reset the user password. Valid values:<br><li>true: Forcibly shut down an instance after a normal shutdown fails.</li><br><li>false: Do not forcibly shut down an instance after a normal shutdown fails.</li><br><br>Default value: false.<br><br>Forced shutdown is equivalent to turning off a physical computer's power switch. Forced shutdown may cause data loss or file system corruption and should only be used when a server cannot be shut down normally.",
+          "document": "Specifies whether to forcibly shut down a running instance. it is recommended to manually shut down a running instance first and then expand the instance disk. valid values:<br><li>true: forcibly shut down an instance after a normal shutdown fails.</li><br><li>false: do not forcibly shut down an instance after a normal shutdown fails.</li><br><br>default value: false.<br><br>forced shutdown is equivalent to turning off a physical computer's power switch. forced shutdown may cause data loss or file system corruption and should only be used when a server cannot be shut down normally.",
           "example": "true",
           "member": "bool",
           "name": "ForceStop",
@@ -9205,7 +9550,7 @@
         },
         {
           "disabled": false,
-          "document": "Configuration information of a system disk to be expanded. Only cloud disks can be expanded.\n\n<dx-alert infotype=\"explain\" title=\"\">You should specify either DataDisks or SystemDisk, but you cannot specify both at the same time.</dx-alert>",
+          "document": "System disk configuration information to be expanded. only supports specifying the purpose capacity of the disk to be expanded. only supports cloud disk expansion.\n<dx-alert infotype=\"explain\" title=\"\">You should specify either DataDisks or SystemDisk, but you cannot specify both at the same time.</dx-alert>",
           "example": "无",
           "member": "SystemDisk",
           "name": "SystemDisk",
@@ -9348,7 +9693,16 @@
         },
         {
           "disabled": false,
-          "document": "Instance name.<br><li>If this parameter is not specified, \"Unnamed\" will be displayed by default.</li><li>If you purchase multiple instances and specify a pattern string `{R:x}`, numbers `[x, x+n-1]` will be generated, where `n` represents the number of instances purchased. For example, you specify a pattern string `server_{R:3}`. If you purchase only one instance, the instance will be named `server_3`; if you purchase two, they will be named `server_3` and `server_4`. You can specify multiple pattern strings in the format of `{R:x}`.</li><li>If you purchase multiple instances without specifying a pattern string, the instance names will be suffixed with `1, 2...n`, where `n` represents the number of instances purchased. For example, if you purchase two instances with the name `server_`, the instance names will be `server_1` and `server_2`.</li><li>This parameter can contain up to 60 characters (including pattern strings).</li>",
+          "document": "Specifies the minimum number of instances to create. value range: positive integer not greater than InstanceCount.\nSpecifies the minimum purchasable quantity, guarantees to create at least MinCount instances, and creates InstanceCount instances as much as possible.\nInsufficient inventory to meet the minimum purchasable quantity will trigger an error info indicating insufficient stock.\nOnly applicable to accounts, regions, and billing modes (annual/monthly subscription, pay-as-you-go, spot instance, exclusive sales) with partial support.",
+          "example": "1",
+          "member": "int64",
+          "name": "MinCount",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Instance display name. <li>if no instance display name is specified, it will display 'unnamed' by default.</li> <li>when purchasing multiple instances, if the pattern string `{R:x}` is specified, it means generating numbers `[x, x+n-1]`, where `n` represents the number of purchased instances. for example, `server_{R:3}`: when purchasing 1 instance, the instance display name is `server_3`; when purchasing 2 instances, the instance display names are `server_3` and `server_4` respectively. supports specifying multiple pattern strings `{R:x}`.</li> <li>when purchasing multiple instances without specifying a pattern string, suffixes `1, 2...n` will be added to the instance display name, where `n` represents the number of purchased instances. for example, `server_`: when purchasing 2 instances, the instance display names are `server_1` and `server_2` respectively.</li> <li>supports up to 128 characters (including pattern strings).</li>.",
           "example": "server_{R:3}",
           "member": "string",
           "name": "InstanceName",
@@ -9366,7 +9720,7 @@
         },
         {
           "disabled": false,
-          "document": "Security groups to which the instance belongs. To obtain the security group IDs, you can call [DescribeSecurityGroups](https://intl.cloud.tencent.com/document/api/215/15808) and look for the `sgld` fields in the response. If this parameter is not specified, the instance will be associated with default security groups.",
+          "document": "Security group to which an instance belongs. obtain this parameter by calling the `SecurityGroupId` field in the return value of [DescribeSecurityGroups](https://www.tencentcloud.com/document/product/215/15808?from_search=1). if not specified, bind the default security group under the designated project. if the default security group does not exist, automatically create it.",
           "example": "[\"sg-ajhn9qtq\"]",
           "member": "string",
           "name": "SecurityGroupIds",
@@ -9412,7 +9766,7 @@
         {
           "disabled": false,
           "document": "Placement group ID. You can only specify one.",
-          "example": "['ps-3p88qhfo']",
+          "example": "[\"sg-efil73jd\"]",
           "member": "string",
           "name": "DisasterRecoverGroupIds",
           "required": false,
@@ -9447,7 +9801,7 @@
         },
         {
           "disabled": false,
-          "document": "",
+          "document": "Custom metadata. specifies the support for creating custom metadata key-value pairs when creating a CVM.\n**Note: this field is in beta test.**.",
           "example": "无",
           "member": "Metadata",
           "name": "Metadata",
@@ -9528,7 +9882,7 @@
         },
         {
           "disabled": false,
-          "document": "",
+          "document": "Whether the instance enables jumbo frames. valid values:<br><li/> true: means the instance enables jumbo frames. only models supporting jumbo frames can be set to true.<br><li/> false: means the instance disables jumbo frames. only models supporting jumbo frames can be set to false.<br> instance specifications supporting jumbo frames: [instance specifications](https://www.tencentcloud.com/document/product/213/11518?lang=en&pg=).",
           "example": "false",
           "member": "bool",
           "name": "EnableJumboFrame",
@@ -9544,7 +9898,7 @@
         {
           "disabled": false,
           "document": "If you use this API to create instance(s), this parameter will be returned, representing one or more instance IDs. Retuning the instance ID list does not necessarily mean that the instance(s) were created successfully. To check whether the instance(s) were created successfully, you can call [DescribeInstances](https://intl.cloud.tencent.com/document/api/213/15728?from_cn_redirect=1) and check the status of the instances in `InstancesSet` in the response. If the status of an instance changes from \"PENDING\" to \"RUNNING\", it means that the instance has been created successfully.",
-          "example": "['ins-rn99mzt1']",
+          "example": "[\"ins-rn79mzt1\"]",
           "member": "string",
           "name": "InstanceIdSet",
           "output_required": true,
@@ -9724,7 +10078,7 @@
           "type": "list"
         },
         {
-          "disabled": false,
+          "disabled": true,
           "document": "(Disused. Please use `StopType` instead.) Whether to forcibly shut down an instance after a normal shutdown fails. Valid values: <br><li>`TRUE`: yes;<br><li>`FALSE`: no<br><br>Default value: `FALSE`. ",
           "example": "false",
           "member": "bool",
@@ -9926,7 +10280,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "Specifies the system disk type. for the restrictions on the system disk type, refer to [storage overview](https://intl.cloud.tencent.com/document/product/213/4952?from_cn_redirect=1). value range:<br>\n<li>LOCAL_BASIC: Local SATA disk</li>\n<li>LOCAL_SSD: Local NVMe SSD</li>\n<li>CLOUD_BASIC: Cloud SATA disk</li>\n<li>CLOUD_SSD: Cloud SSD</li>\n<li>CLOUD_PREMIUM: Premium SSD</li>\n<li>CLOUD_BSSD: Balanced SSD</li>\n<li>CLOUD_HSSD: Enhanced SSD</li>\n<li>CLOUD_TSSD: Tremendous SSD</li>\nDefault value: Current disk types with inventory available.",
+          "document": "Specifies the system disk type. for the restrictions on the system disk type, refer to [storage overview](https://www.tencentcloud.com/document/product/362/31636). value range:<br>\n<li>LOCAL_BASIC: Local SATA disk</li>\n<li>LOCAL_SSD: Local NVMe SSD</li>\n<li>CLOUD_BASIC: Cloud SATA disk</li>\n<li>CLOUD_SSD: Cloud SSD</li>\n<li>CLOUD_PREMIUM: Premium SSD</li>\n<li>CLOUD_BSSD: Balanced SSD</li>\n<li>CLOUD_HSSD: Enhanced SSD</li>\n<li>CLOUD_TSSD: Tremendous SSD</li>\nDefault value: Current disk types with inventory available.",
           "example": "CLOUD_HSSD",
           "member": "string",
           "name": "DiskType",
@@ -9937,8 +10291,8 @@
         },
         {
           "disabled": false,
-          "document": "Specifies the system disk ID.\nThis 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`.",
-          "example": "disk-xyzw1234",
+          "document": "System disk ID.\nCurrently, this parameter is only used for response parameters in query apis such as [DescribeInstances](https://www.tencentcloud.com/document/api/213/33258) and is not applicable to request parameters in write apis such as [RunInstances](https://www.tencentcloud.com/document/api/213/33237).",
+          "example": "disk-xyzw1a3x",
           "member": "string",
           "name": "DiskId",
           "output_required": false,
@@ -9959,7 +10313,7 @@
         },
         {
           "disabled": false,
-          "document": "Specifies the exclusive cluster ID it belongs to.",
+          "document": "Specifies the dedicated cluster ID belonging to.\nNote: This field may return null, indicating that no valid value is found.",
           "example": "cdc-xxxxxx",
           "member": "string",
           "name": "CdcId",
@@ -10015,7 +10369,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "Tag-Bound resource type. \"instance\" for cloud virtual machine, \"host\" for cdh, \"image\" for mirror, and \"keypair\" for key.",
+          "document": "Specifies the resource type for Tag binding. valid values: \"instance\" (cloud virtual machine), \"host\" (cdh), \"image\" (mirror), \"keypair\" (key), \"ps\" (placement group), \"hpc\" (hyper computing cluster).",
           "example": "instance",
           "member": "string",
           "name": "ResourceType",
@@ -10114,7 +10468,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "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.",
+          "document": "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.com/document/product/215/15778?lang=en) 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.",
           "example": "vpc-2ij",
           "member": "string",
           "name": "VpcId",
@@ -10125,7 +10479,7 @@
         },
         {
           "disabled": false,
-          "document": "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.",
+          "document": "vpc subnet ID, in the form of `subnet-xxx`. valid vpc subnet ids can be queried by logging in to the [console](https://console.tencentcloud.com/vpc/subnet); or they can be obtained from the `SubnetId` field in the API response by calling the [DescribeSubnets](https://www.tencentcloud.com/document/product/215/15784) API . if SubnetId and VpcId are both input as `DEFAULT` when creating an instance, the DEFAULT vpc network will be forcibly used.",
           "example": "subnet-2ks",
           "member": "string",
           "name": "SubnetId",