diff --git a/.changelog/3451.txt b/.changelog/3451.txt new file mode 100644 index 0000000000..96a760c000 --- /dev/null +++ b/.changelog/3451.txt @@ -0,0 +1,7 @@ +```release-note:enhancement +resource/tencentcloud_instance: support AntiDDos Eip +``` + +```release-note:enhancement +resource/tencentcloud_as_scaling_config: support AntiDDos Eip +``` diff --git a/go.mod b/go.mod index 8aee59d124..538ca6b546 100644 --- a/go.mod +++ b/go.mod @@ -30,7 +30,7 @@ require ( github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/api v1.0.285 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/apigateway v1.0.763 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/apm v1.0.825 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1164 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1211 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/bi v1.0.824 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cam v1.0.1071 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cat v1.0.825 @@ -46,8 +46,8 @@ require ( github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/clb v1.0.1107 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cloudaudit v1.0.1033 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cls v1.0.1148 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1196 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1211 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1206 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cwp v1.0.762 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cynosdb v1.0.1161 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/dayu v1.0.335 diff --git a/go.sum b/go.sum index 7b02307c36..86c6614593 100644 --- a/go.sum +++ b/go.sum @@ -835,6 +835,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1078 h1:61WsmpY github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1078/go.mod h1:PC3PuWjgDqScMDrVXe9+QEH/r95FHd4p560GjkDf2rk= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1164 h1:XsqO8lrHWTphz8jmgkU09gcX+V6XnPN2QMOiZezrISk= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1164/go.mod h1:hEhWTzJLNl5WkKi4cIWi9rtEAectaRY02RqYqC4Twi4= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1211 h1:KLzI3CUZCNqflU0FRWI31dcWBIgBaBMoRgML9wNZ70U= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1211/go.mod h1:IBzy/+ZfDywz9Ln6tzRP9SiyPONBBTya/TiHaVvNonY= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/bi v1.0.824 h1:DVKvZ6h+qd7tadUrCjVAkCCmE3TsbK2ZmwGd3AJcpWc= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/bi v1.0.824/go.mod h1:DvBpDX/qdJG4KKLeULmRvhAjPYiw8za0HeTSu2y/lFw= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cam v1.0.1071 h1:2CeivXYc7PtD2kgZEJXk9/SDQA9dzLejH5FmNzAW3QU= @@ -991,6 +993,10 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1191 h1:Zj8 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1191/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1196 h1:2pRWolqipwF5RBtpSKp9YAg9cIvIPnhFCkj5FFhv8V8= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1196/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1206 h1:RVM/x8Sx4XL7zda5IRE1HL3czh9wLAdl+UbrbVPcf2k= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1206/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1211 h1:Y97J0JA6dYIhsMeswB1G6RCiTH8qUIBEBrng9onSl60= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1211/go.mod h1:r5r4xbfxSaeR04b166HGsBa/R4U3SueirEUpXGuw+Q0= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/controlcenter v1.0.993 h1:WlPgXldQCxt7qi5Xrc6j6zTrsXWzN5BcOGs7Irq7fwQ= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/controlcenter v1.0.993/go.mod h1:Z9U8zNtyuyKhjS0698wqsrG/kLx1TQ5CEixXBwVe7xY= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/csip v1.0.860 h1:F3esKBIT3HW9+7Gt8cVgf8X06VdGIczpgLBUECzSEzU= @@ -999,6 +1005,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1128 h1:qoSzTK github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1128/go.mod h1:hVNSxeomc/AQsJphdbPnPINsO0cMLcVAA6kituTD2g0= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153 h1:ENSIHfoHuFw4IQrkPvUyBFEvE++QVdIxY3lSFo9jho0= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153/go.mod h1:lBiTrRc+WW71B71du+uodZRhpa+QlnsqwT4sVSEaPac= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1206 h1:tx8L5srClwK2T5dte7yw3N8PfxqtuHbT8fWfUZMOUwk= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1206/go.mod h1:zkdrFNYxTFX7E3QRgNVayQi7fq/A1TYRKLkGE8NS0lQ= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cwp v1.0.762 h1:2egy69SP/wPsmnfozcQVZ6tUY6F6N/TpEe/7xtXrc/8= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cwp v1.0.762/go.mod h1:1XylIfNUbAzmNqi4XMhwcM3VhmUHdu1OYybOeaJ4sOw= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cynosdb v1.0.1111 h1:Y7LLIZEQh8OAbnBWppUopu2PjPaQOO9Jzhp8LZO7adI= diff --git a/tencentcloud/services/as/resource_tc_as_scaling_config.go b/tencentcloud/services/as/resource_tc_as_scaling_config.go index 76544f0bf9..805e5093ef 100644 --- a/tencentcloud/services/as/resource_tc_as_scaling_config.go +++ b/tencentcloud/services/as/resource_tc_as_scaling_config.go @@ -156,6 +156,29 @@ func ResourceTencentCloudAsScalingConfig() *schema.Resource { Optional: true, Description: "Specify whether to assign an Internet IP address.", }, + "bandwidth_package_id": { + Type: schema.TypeString, + Optional: true, + Description: "Bandwidth package ID.", + }, + "ipv4_address_type": { + Type: schema.TypeString, + Optional: true, + Computed: true, + ValidateFunc: tccommon.ValidateAllowedStringValue([]string{"WanIP", "HighQualityEIP", "AntiDDoSEIP"}), + Description: "AddressType. Default value: WanIP. For beta users of dedicated IP. the value can be: HighQualityEIP: Dedicated IP. Note that dedicated IPs are only available in partial regions. For beta users of Anti-DDoS IP, the value can be: AntiDDoSEIP: Anti-DDoS EIP. Note that Anti-DDoS IPs are only available in partial regions.", + }, + "anti_ddos_package_id": { + Type: schema.TypeString, + Optional: true, + Description: "Anti-DDoS service package ID. This is required when you want to request an AntiDDoS IP.", + }, + "is_keep_eip": { + Type: schema.TypeBool, + Optional: true, + Computed: true, + Description: "Whether to delete the bound EIP when the instance is destroyed. Range of values: True: retain the EIP; False: not retain the EIP. Note that when the IPv4AddressType field specifies the EIP type, the default behavior is not to retain the EIP. WanIP is unaffected by this field and will always be deleted with the instance. Changing this field configuration will take effect immediately for resources already bound to a scaling group.", + }, "password": { Type: schema.TypeString, Optional: true, @@ -370,6 +393,18 @@ func resourceTencentCloudAsScalingConfigCreate(d *schema.ResourceData, meta inte publicIpAssigned := v.(bool) request.InternetAccessible.PublicIpAssigned = &publicIpAssigned } + if v, ok := d.GetOk("bandwidth_package_id"); ok { + request.InternetAccessible.BandwidthPackageId = helper.String(v.(string)) + } + if v, ok := d.GetOk("ipv4_address_type"); ok { + request.InternetAccessible.IPv4AddressType = helper.String(v.(string)) + } + if v, ok := d.GetOk("anti_ddos_package_id"); ok { + request.InternetAccessible.AntiDDoSPackageId = helper.String(v.(string)) + } + if v, ok := d.GetOkExists("is_keep_eip"); ok { + request.InternetAccessible.IsKeepEIP = helper.Bool(v.(bool)) + } request.LoginSettings = &as.LoginSettings{} if v, ok := d.GetOk("password"); ok { @@ -610,6 +645,24 @@ func resourceTencentCloudAsScalingConfigRead(d *schema.ResourceData, meta interf _ = d.Set("cam_role_name", *config.CamRoleName) + if config.InternetAccessible != nil { + if config.InternetAccessible.BandwidthPackageId != nil { + _ = d.Set("bandwidth_package_id", config.InternetAccessible.BandwidthPackageId) + } + + if config.InternetAccessible.IPv4AddressType != nil { + _ = d.Set("ipv4_address_type", config.InternetAccessible.IPv4AddressType) + } + + if config.InternetAccessible.AntiDDoSPackageId != nil { + _ = d.Set("anti_ddos_package_id", config.InternetAccessible.AntiDDoSPackageId) + } + + if config.InternetAccessible.IsKeepEIP != nil { + _ = d.Set("is_keep_eip", config.InternetAccessible.IsKeepEIP) + } + } + if config.HostNameSettings != nil { isEmptySettings := true settings := map[string]interface{}{} @@ -749,7 +802,8 @@ func resourceTencentCloudAsScalingConfigUpdate(d *schema.ResourceData, meta inte } } - if d.HasChange("internet_charge_type") || d.HasChange("internet_max_bandwidth_out") || d.HasChange("public_ip_assigned") { + if d.HasChange("internet_charge_type") || d.HasChange("internet_max_bandwidth_out") || d.HasChange("public_ip_assigned") || + d.HasChange("bandwidth_package_id") || d.HasChange("ipv4_address_type") || d.HasChange("anti_ddos_package_id") || d.HasChange("is_keep_eip") { request.InternetAccessible = &as.InternetAccessible{} if v, ok := d.GetOk("internet_charge_type"); ok { request.InternetAccessible.InternetChargeType = helper.String(v.(string)) @@ -761,6 +815,18 @@ func resourceTencentCloudAsScalingConfigUpdate(d *schema.ResourceData, meta inte publicIpAssigned := v.(bool) request.InternetAccessible.PublicIpAssigned = &publicIpAssigned } + if v, ok := d.GetOk("bandwidth_package_id"); ok { + request.InternetAccessible.BandwidthPackageId = helper.String(v.(string)) + } + if v, ok := d.GetOk("ipv4_address_type"); ok { + request.InternetAccessible.IPv4AddressType = helper.String(v.(string)) + } + if v, ok := d.GetOk("anti_ddos_package_id"); ok { + request.InternetAccessible.AntiDDoSPackageId = helper.String(v.(string)) + } + if v, ok := d.GetOkExists("is_keep_eip"); ok { + request.InternetAccessible.IsKeepEIP = helper.Bool(v.(bool)) + } } if d.HasChange("security_group_ids") { diff --git a/tencentcloud/services/as/resource_tc_as_scaling_config.md b/tencentcloud/services/as/resource_tc_as_scaling_config.md index 7e960dfedd..d118a10d4b 100644 --- a/tencentcloud/services/as/resource_tc_as_scaling_config.md +++ b/tencentcloud/services/as/resource_tc_as_scaling_config.md @@ -50,7 +50,7 @@ resource "tencentcloud_as_scaling_config" "example" { } ``` -Using `SPOTPAID` charge type +Using SPOTPAID charge type ```hcl data "tencentcloud_images" "example" { @@ -177,6 +177,57 @@ resource "tencentcloud_as_scaling_config" "example" { } ``` +Create configuration with AntiDDos Eip + +```hcl +data "tencentcloud_images" "example" { + image_type = ["PUBLIC_IMAGE"] + os_name = "TencentOS Server 4 for x86_64" +} + +resource "tencentcloud_as_scaling_config" "example" { + configuration_name = "tf-example" + image_id = data.tencentcloud_images.example.images.0.image_id + instance_types = ["SA5.MEDIUM4"] + project_id = 0 + system_disk_type = "CLOUD_PREMIUM" + system_disk_size = "50" + + data_disk { + disk_type = "CLOUD_PREMIUM" + disk_size = 50 + } + + + internet_charge_type = "BANDWIDTH_PACKAGE" + internet_max_bandwidth_out = 10 + public_ip_assigned = true + bandwidth_package_id = "bwp-4ocyia9s" + ipv4_address_type = "AntiDDoSEIP" + anti_ddos_package_id = "bgp-xxxxxxx" + is_keep_eip = true + password = "Test@123#" + enhanced_security_service = false + enhanced_monitor_service = false + enhanced_automation_tools_service = false + user_data = "dGVzdA==" + + host_name_settings { + host_name = "host-name" + host_name_style = "UNIQUE" + } + + instance_tags = { + tag = "example" + } + + tags = { + "createdBy" = "Terraform" + "owner" = "tf" + } +} +``` + Import AutoScaling Configuration can be imported using the id, e.g. diff --git a/tencentcloud/services/cvm/resource_tc_instance.go b/tencentcloud/services/cvm/resource_tc_instance.go index eff9031df5..2969722574 100644 --- a/tencentcloud/services/cvm/resource_tc_instance.go +++ b/tencentcloud/services/cvm/resource_tc_instance.go @@ -197,6 +197,21 @@ func ResourceTencentCloudInstance() *schema.Resource { ForceNew: true, Description: "Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.", }, + "ipv4_address_type": { + Type: schema.TypeString, + Optional: true, + ForceNew: true, + Computed: true, + ValidateFunc: tccommon.ValidateAllowedStringValue([]string{"WanIP", "HighQualityEIP", "AntiDDoSEIP"}), + Description: "AddressType. Default value: WanIP. For beta users of dedicated IP. the value can be: HighQualityEIP: Dedicated IP. Note that dedicated IPs are only available in partial regions. For beta users of Anti-DDoS IP, the value can be: AntiDDoSEIP: Anti-DDoS EIP. Note that Anti-DDoS IPs are only available in partial regions.", + }, + "anti_ddos_package_id": { + Type: schema.TypeString, + Optional: true, + ForceNew: true, + Computed: true, + Description: "Anti-DDoS service package ID. This is required when you want to request an AntiDDoS IP.", + }, // vpc "vpc_id": { Type: schema.TypeString, @@ -654,6 +669,16 @@ func resourceTencentCloudInstanceCreate(d *schema.ResourceData, meta interface{} netWorkFlag = true } + if v, ok := d.GetOk("ipv4_address_type"); ok { + internetAccessible.IPv4AddressType = helper.String(v.(string)) + netWorkFlag = true + } + + if v, ok := d.GetOk("anti_ddos_package_id"); ok { + internetAccessible.AntiDDoSPackageId = helper.String(v.(string)) + netWorkFlag = true + } + if netWorkFlag { request.InternetAccessible = &internetAccessible } @@ -1162,6 +1187,16 @@ func resourceTencentCloudInstanceRead(d *schema.ResourceData, meta interface{}) _ = d.Set("allocate_public_ip", len(instance.PublicIpAddresses) > 0) } + if instance.InternetAccessible != nil { + if instance.InternetAccessible.IPv4AddressType != nil { + _ = d.Set("ipv4_address_type", instance.InternetAccessible.IPv4AddressType) + } + + if instance.InternetAccessible.AntiDDoSPackageId != nil { + _ = d.Set("anti_ddos_package_id", instance.InternetAccessible.AntiDDoSPackageId) + } + } + tagService := svctag.NewTagService(client) tags, err := tagService.DescribeResourceTags(ctx, "cvm", "instance", client.Region, d.Id()) diff --git a/tencentcloud/services/cvm/resource_tc_instance.md b/tencentcloud/services/cvm/resource_tc_instance.md index aa71eebf7f..57a4688952 100644 --- a/tencentcloud/services/cvm/resource_tc_instance.md +++ b/tencentcloud/services/cvm/resource_tc_instance.md @@ -8,6 +8,8 @@ Provides a CVM instance resource. ~> **NOTE:** When creating a CVM instance using a `launch_template_id`, if you set other parameter values ​​at the same time, the template definition values ​​will be overwritten. +~> **NOTE:** It is recommended to use resource `tencentcloud_eip` to create a AntiDDos Eip, and then call resource `tencentcloud_eip_association` to bind it to resource `tencentcloud_instance`. + Example Usage Create a general POSTPAID_BY_HOUR CVM instance @@ -243,6 +245,37 @@ resource "tencentcloud_instance" "example" { } ``` +Create CVM instance with AntiDDos Eip + +```hcl +resource "tencentcloud_instance" "example" { + instance_name = "tf-example" + availability_zone = "ap-guangzhou-6" + image_id = "img-eb30mz89" + instance_type = "S5.MEDIUM4" + system_disk_type = "CLOUD_HSSD" + system_disk_size = 50 + hostname = "user" + project_id = 0 + vpc_id = "vpc-i5yyodl9" + subnet_id = "subnet-hhi88a58" + internet_charge_type = "BANDWIDTH_PACKAGE" + bandwidth_package_id = "bwp-4ocyia9s" + ipv4_address_type = "AntiDDoSEIP" + anti_ddos_package_id = "bgp-xxxxxxx" + + data_disks { + data_disk_type = "CLOUD_HSSD" + data_disk_size = 100 + encrypt = false + } + + tags = { + tagKey = "tagValue" + } +} +``` + Import CVM instance can be imported using the id, e.g. diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/client.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/client.go index 5315b7c2fb..9e5549e841 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/client.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/client.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -494,6 +494,7 @@ func NewCreateAutoScalingGroupResponse() (response *CreateAutoScalingGroupRespon // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SIZE = "InvalidParameterValue.Size" // INVALIDPARAMETERVALUE_SUBNETIDS = "InvalidParameterValue.SubnetIds" +// INVALIDPARAMETERVALUE_SUBNETNOTINDEDICATEDCLUSTER = "InvalidParameterValue.SubnetNotInDedicatedCluster" // INVALIDPARAMETERVALUE_TARGETPORTDUPLICATED = "InvalidParameterValue.TargetPortDuplicated" // INVALIDPARAMETERVALUE_TOOLONG = "InvalidParameterValue.TooLong" // INVALIDPARAMETERVALUE_ZONEMISMATCHREGION = "InvalidParameterValue.ZoneMismatchRegion" @@ -545,6 +546,7 @@ func (c *Client) CreateAutoScalingGroup(request *CreateAutoScalingGroupRequest) // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SIZE = "InvalidParameterValue.Size" // INVALIDPARAMETERVALUE_SUBNETIDS = "InvalidParameterValue.SubnetIds" +// INVALIDPARAMETERVALUE_SUBNETNOTINDEDICATEDCLUSTER = "InvalidParameterValue.SubnetNotInDedicatedCluster" // INVALIDPARAMETERVALUE_TARGETPORTDUPLICATED = "InvalidParameterValue.TargetPortDuplicated" // INVALIDPARAMETERVALUE_TOOLONG = "InvalidParameterValue.TooLong" // INVALIDPARAMETERVALUE_ZONEMISMATCHREGION = "InvalidParameterValue.ZoneMismatchRegion" @@ -708,11 +710,11 @@ func NewCreateLaunchConfigurationResponse() (response *CreateLaunchConfiguration // // // -// * 启动配置，可以通过 `ModifyLaunchConfigurationAttributes` 修改少量字段。如需使用新的启动配置，建议重新创建启动配置。 +// * 启动配置，可以通过 [ModifyLaunchConfigurationAttributes](https://cloud.tencent.com/document/api/377/31298) 修改少量字段。如需使用新的启动配置，建议重新创建启动配置。 // // // -// * 每个项目最多只能创建20个启动配置，详见[使用限制](https://cloud.tencent.com/document/product/377/3120)。 +// * 每个地域默认只能创建50个启动配置，详见[使用限制](https://cloud.tencent.com/document/product/377/3120)。 // // 可能返回的错误码: // INTERNALERROR_CALLSTSERROR = "InternalError.CallStsError" @@ -765,11 +767,11 @@ func (c *Client) CreateLaunchConfiguration(request *CreateLaunchConfigurationReq // // // -// * 启动配置，可以通过 `ModifyLaunchConfigurationAttributes` 修改少量字段。如需使用新的启动配置，建议重新创建启动配置。 +// * 启动配置，可以通过 [ModifyLaunchConfigurationAttributes](https://cloud.tencent.com/document/api/377/31298) 修改少量字段。如需使用新的启动配置，建议重新创建启动配置。 // // // -// * 每个项目最多只能创建20个启动配置，详见[使用限制](https://cloud.tencent.com/document/product/377/3120)。 +// * 每个地域默认只能创建50个启动配置，详见[使用限制](https://cloud.tencent.com/document/product/377/3120)。 // // 可能返回的错误码: // INTERNALERROR_CALLSTSERROR = "InternalError.CallStsError" @@ -873,15 +875,15 @@ func NewCreateLifecycleHookResponse() (response *CreateLifecycleHookResponse) { // // "ActivityId": "asa-fznnvrja", // -// "AutoScalingGroupId": "asg-rrrrtttt", +// "AutoScalingGroupId": "asg-ft6y7u8n", // -// "LifecycleHookId": "ash-xxxxyyyy", +// "LifecycleHookId": "ash-p9i7y6t5", // // "LifecycleHookName": "my-hook", // // "LifecycleActionToken": "3080e1c9-0efe-4dd7-ad3b-90cd6618298f", // -// "InstanceId": "ins-aaaabbbb", +// "InstanceId": "ins-y6dr5e43", // // "LifecycleTransition": "INSTANCE_LAUNCHING", // @@ -942,15 +944,15 @@ func (c *Client) CreateLifecycleHook(request *CreateLifecycleHookRequest) (respo // // "ActivityId": "asa-fznnvrja", // -// "AutoScalingGroupId": "asg-rrrrtttt", +// "AutoScalingGroupId": "asg-ft6y7u8n", // -// "LifecycleHookId": "ash-xxxxyyyy", +// "LifecycleHookId": "ash-p9i7y6t5", // // "LifecycleHookName": "my-hook", // // "LifecycleActionToken": "3080e1c9-0efe-4dd7-ad3b-90cd6618298f", // -// "InstanceId": "ins-aaaabbbb", +// "InstanceId": "ins-y6dr5e43", // // "LifecycleTransition": "INSTANCE_LAUNCHING", // @@ -2625,6 +2627,7 @@ func NewDetachLoadBalancersResponse() (response *DetachLoadBalancersResponse) { // LIMITEXCEEDED_AFTERATTACHLBLIMITEXCEEDED = "LimitExceeded.AfterAttachLbLimitExceeded" // MISSINGPARAMETER_INSCENARIO = "MissingParameter.InScenario" // RESOURCENOTFOUND_AUTOSCALINGGROUPNOTFOUND = "ResourceNotFound.AutoScalingGroupNotFound" +// RESOURCENOTFOUND_CLASSICLOADBALANCERNOTFOUND = "ResourceNotFound.ClassicLoadBalancerNotFound" // RESOURCENOTFOUND_LISTENERNOTFOUND = "ResourceNotFound.ListenerNotFound" // RESOURCENOTFOUND_LOADBALANCERNOTFOUND = "ResourceNotFound.LoadBalancerNotFound" // RESOURCENOTFOUND_LOADBALANCERNOTINAUTOSCALINGGROUP = "ResourceNotFound.LoadBalancerNotInAutoScalingGroup" @@ -2656,6 +2659,7 @@ func (c *Client) DetachLoadBalancers(request *DetachLoadBalancersRequest) (respo // LIMITEXCEEDED_AFTERATTACHLBLIMITEXCEEDED = "LimitExceeded.AfterAttachLbLimitExceeded" // MISSINGPARAMETER_INSCENARIO = "MissingParameter.InScenario" // RESOURCENOTFOUND_AUTOSCALINGGROUPNOTFOUND = "ResourceNotFound.AutoScalingGroupNotFound" +// RESOURCENOTFOUND_CLASSICLOADBALANCERNOTFOUND = "ResourceNotFound.ClassicLoadBalancerNotFound" // RESOURCENOTFOUND_LISTENERNOTFOUND = "ResourceNotFound.ListenerNotFound" // RESOURCENOTFOUND_LOADBALANCERNOTFOUND = "ResourceNotFound.LoadBalancerNotFound" // RESOURCENOTFOUND_LOADBALANCERNOTINAUTOSCALINGGROUP = "ResourceNotFound.LoadBalancerNotInAutoScalingGroup" @@ -3142,6 +3146,7 @@ func NewModifyAutoScalingGroupResponse() (response *ModifyAutoScalingGroupRespon // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SIZE = "InvalidParameterValue.Size" // INVALIDPARAMETERVALUE_SUBNETIDS = "InvalidParameterValue.SubnetIds" +// INVALIDPARAMETERVALUE_SUBNETNOTINDEDICATEDCLUSTER = "InvalidParameterValue.SubnetNotInDedicatedCluster" // INVALIDPARAMETERVALUE_TOOLONG = "InvalidParameterValue.TooLong" // LIMITEXCEEDED = "LimitExceeded" // LIMITEXCEEDED_MAXSIZELIMITEXCEEDED = "LimitExceeded.MaxSizeLimitExceeded" @@ -3181,6 +3186,7 @@ func (c *Client) ModifyAutoScalingGroup(request *ModifyAutoScalingGroupRequest) // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SIZE = "InvalidParameterValue.Size" // INVALIDPARAMETERVALUE_SUBNETIDS = "InvalidParameterValue.SubnetIds" +// INVALIDPARAMETERVALUE_SUBNETNOTINDEDICATEDCLUSTER = "InvalidParameterValue.SubnetNotInDedicatedCluster" // INVALIDPARAMETERVALUE_TOOLONG = "InvalidParameterValue.TooLong" // LIMITEXCEEDED = "LimitExceeded" // LIMITEXCEEDED_MAXSIZELIMITEXCEEDED = "LimitExceeded.MaxSizeLimitExceeded" @@ -3302,8 +3308,6 @@ func NewModifyLaunchConfigurationAttributesResponse() (response *ModifyLaunchCon // // * 修改启动配置后，已经使用该启动配置扩容的存量实例不会发生变更，此后使用该启动配置的新增实例会按照新的配置进行扩容。 // -// * 本接口支持修改部分简单类型。 -// // 可能返回的错误码: // INTERNALERROR_CALLEEERROR = "InternalError.CalleeError" // INVALIDPARAMETER_ACTIONNOTFOUND = "InvalidParameter.ActionNotFound" @@ -3353,8 +3357,6 @@ func (c *Client) ModifyLaunchConfigurationAttributes(request *ModifyLaunchConfig // // * 修改启动配置后，已经使用该启动配置扩容的存量实例不会发生变更，此后使用该启动配置的新增实例会按照新的配置进行扩容。 // -// * 本接口支持修改部分简单类型。 -// // 可能返回的错误码: // INTERNALERROR_CALLEEERROR = "InternalError.CalleeError" // INVALIDPARAMETER_ACTIONNOTFOUND = "InvalidParameter.ActionNotFound" diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/errors.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/errors.go index 3e0442ffc1..80bd10696f 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/errors.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/errors.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -290,6 +290,9 @@ const ( // 子网信息不合法。 INVALIDPARAMETERVALUE_SUBNETIDS = "InvalidParameterValue.SubnetIds" + // 子网不在指定本地专用集群中。 + INVALIDPARAMETERVALUE_SUBNETNOTINDEDICATEDCLUSTER = "InvalidParameterValue.SubnetNotInDedicatedCluster" + // 负载均衡器四层监听器的后端端口重复。 INVALIDPARAMETERVALUE_TARGETPORTDUPLICATED = "InvalidParameterValue.TargetPortDuplicated" @@ -401,6 +404,9 @@ const ( // 指定的带宽包ID不存在。 RESOURCENOTFOUND_BANDWIDTHPACKAGEIDNOTFOUND = "ResourceNotFound.BandwidthPackageIdNotFound" + // 指定的传统型负载均衡器ID不存在。 + RESOURCENOTFOUND_CLASSICLOADBALANCERNOTFOUND = "ResourceNotFound.ClassicLoadBalancerNotFound" + // 指定的 CMQ queue 不存在。 RESOURCENOTFOUND_CMQQUEUENOTFOUND = "ResourceNotFound.CmqQueueNotFound" diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/models.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/models.go index 19bc94e8d3..a2cf838fc1 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/models.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419/models.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -58,13 +58,13 @@ type Activity struct { // 伸缩活动描述。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // 伸缩活动开始时间。 + // 伸缩活动开始时间，为 `UTC` 标准时间。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 伸缩活动结束时间。 + // 伸缩活动结束时间，为 `UTC` 标准时间。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 伸缩活动创建时间。 + // 伸缩活动创建时间，为 `UTC` 标准时间。 CreatedTime *string `json:"CreatedTime,omitnil,omitempty" name:"CreatedTime"` // 该参数已废弃，请勿使用。 @@ -186,26 +186,26 @@ func (r *AttachInstancesResponse) FromJsonString(s string) error { // Predefined struct for user type AttachLoadBalancersRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统型负载均衡器ID列表，每个伸缩组绑定传统型负载均衡器数量上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统型负载均衡器ID列表，每个伸缩组绑定传统型负载均衡器数量上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器列表，每个伸缩组绑定应用型负载均衡器数量上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，每个伸缩组绑定应用型负载均衡器数量上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` } type AttachLoadBalancersRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统型负载均衡器ID列表，每个伸缩组绑定传统型负载均衡器数量上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统型负载均衡器ID列表，每个伸缩组绑定传统型负载均衡器数量上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器列表，每个伸缩组绑定应用型负载均衡器数量上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，每个伸缩组绑定应用型负载均衡器数量上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` } @@ -331,16 +331,21 @@ type AutoScalingGroup struct { // 子网ID列表 SubnetIdSet []*string `json:"SubnetIdSet,omitnil,omitempty" name:"SubnetIdSet"` - // 销毁策略 + // 销毁策略。取值范围如下： + //
  • OLDEST_INSTANCE：优先销毁伸缩组中最旧的实例，默认取值。
    • + //
  • NEWEST_INSTANCE：优先销毁伸缩组中最新的实例。
    • TerminationPolicySet []*string `json:"TerminationPolicySet,omitnil,omitempty" name:"TerminationPolicySet"` - // VPC标识 + // 私有网络ID。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 可用区列表 ZoneSet []*string `json:"ZoneSet,omitnil,omitempty" name:"ZoneSet"` - // 重试策略 + // 重试策略，部分成功的伸缩活动判定为一次失败活动。取值范围如下： + //
  • IMMEDIATE_RETRY：默认取值，表示立即重试，在较短时间内快速重试，连续失败超过一定次数（5次）后不再重试。
    • + //
  • INCREMENTAL_INTERVALS：间隔递增重试，随着连续失败次数的增加，重试间隔逐渐增大。前 10 次重试为快速重试，后续重试间隔逐步递增至 10 分钟、30 分钟、60 分钟、一天。
    • + //
  • NO_RETRY，不进行重试，直到再次收到用户调用或者告警信息后才会重试。
    • RetryPolicy *string `json:"RetryPolicy,omitnil,omitempty" name:"RetryPolicy"` // 伸缩组是否处于伸缩活动中，`IN_ACTIVITY`表示处于伸缩活动中，`NOT_IN_ACTIVITY`表示不处于伸缩活动中。 @@ -352,7 +357,7 @@ type AutoScalingGroup struct { // 服务设置 ServiceSettings *ServiceSettings `json:"ServiceSettings,omitnil,omitempty" name:"ServiceSettings"` - // 实例具有IPv6地址数量的配置 + // 实例具有IPv6地址数量的配置，取值包括0、1。默认值为 0，表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络，需在子网中开启 IPv6 CIDR，其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 Ipv6AddressCount *int64 `json:"Ipv6AddressCount,omitnil,omitempty" name:"Ipv6AddressCount"` // 多可用区/子网策略。 @@ -365,7 +370,8 @@ type AutoScalingGroup struct { //
  • CLB：根据 CLB 的健康检查状态判断实例是否处于不健康状态，CLB健康检查原理可参考[健康检查](https://cloud.tencent.com/document/product/214/6097)
    • HealthCheckType *string `json:"HealthCheckType,omitnil,omitempty" name:"HealthCheckType"` - // CLB健康检查宽限期 + // CLB健康检查宽限期.当扩容的实例进入IN_SERVICE后，在宽限期时间范围内将不会被标记为不健康CLB_UNHEALTHY。 + // 默认值：0。取值范围[0, 7200]，单位：秒。 LoadBalancerHealthCheckGracePeriod *uint64 `json:"LoadBalancerHealthCheckGracePeriod,omitnil,omitempty" name:"LoadBalancerHealthCheckGracePeriod"` // 实例分配策略，取值包括 LAUNCH_CONFIGURATION 和 SPOT_MIXED。 @@ -401,19 +407,30 @@ type AutoScalingNotification struct { // 用户组ID列表。 NotificationUserGroupIds []*string `json:"NotificationUserGroupIds,omitnil,omitempty" name:"NotificationUserGroupIds"` - // 通知事件列表。 + // 通知事件列表。取值范围如下: + //
  • SCALE_OUT_SUCCESSFUL：扩容成功
    • + //
  • SCALE_OUT_FAILED：扩容失败
    • + //
  • SCALE_IN_SUCCESSFUL：缩容成功
    • + //
  • SCALE_IN_FAILED：缩容失败
    • + //
  • REPLACE_UNHEALTHY_INSTANCE_SUCCESSFUL：替换不健康子机成功
    • + //
  • REPLACE_UNHEALTHY_INSTANCE_FAILED：替换不健康子机失败
    • NotificationTypes []*string `json:"NotificationTypes,omitnil,omitempty" name:"NotificationTypes"` // 事件通知ID。 AutoScalingNotificationId *string `json:"AutoScalingNotificationId,omitnil,omitempty" name:"AutoScalingNotificationId"` - // 通知接收端类型。 + // 通知接收端类型。取值范围如下： + // USER_GROUP：用户组 + // TDMQ_CMQ_TOPIC：TDMQ CMQ 主题 + // TDMQ_CMQ_QUEUE：TDMQ CMQ 队列 + // CMQ_QUEUE：CMQ 队列，[CMQ 接口已下线](https://cloud.tencent.com/document/product/1496/83970)，已无法选用 + // CMQ_TOPIC：CMQ 主题，[CMQ 接口已下线](https://cloud.tencent.com/document/product/1496/83970)，已无法选用 TargetType *string `json:"TargetType,omitnil,omitempty" name:"TargetType"` - // CMQ 队列名。 + // TDMQ CMQ 队列名。 QueueName *string `json:"QueueName,omitnil,omitempty" name:"QueueName"` - // CMQ 主题名。 + // TDMQ CMQ 主题名。 TopicName *string `json:"TopicName,omitnil,omitempty" name:"TopicName"` } @@ -594,32 +611,38 @@ func (r *ClearLaunchConfigurationAttributesResponse) FromJsonString(s string) er // Predefined struct for user type CompleteLifecycleActionRequestParams struct { - // 生命周期挂钩ID + // 生命周期挂钩ID。可以通过调用接口 [DescribeLifecycleHooks](https://cloud.tencent.com/document/api/377/34452) ，取返回信息中的 LifecycleHookId 获取生命周期挂钩ID。 LifecycleHookId *string `json:"LifecycleHookId,omitnil,omitempty" name:"LifecycleHookId"` - // 生命周期动作的结果，取值范围为“CONTINUE”或“ABANDON” + // 生命周期动作的结果，取值范围如下： + //
  • CONTINUE: 默认值，表示继续执行扩缩容活动
    • + //
  • ABANDON: 针对扩容挂钩，挂钩超时或 LifecycleCommand 执行失败的 CVM 实例会直接释放或移出；而针对缩容挂钩，会继续执行缩容活动。
    • LifecycleActionResult *string `json:"LifecycleActionResult,omitnil,omitempty" name:"LifecycleActionResult"` - // 实例ID，“InstanceId”和“LifecycleActionToken”必须填充其中一个 + // 实例ID，`InstanceId` 和 `LifecycleActionToken` 参数必须填写其中一个。可通过登录 [控制台](https://console.cloud.tencent.com/cvm/index) 或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // “InstanceId”和“LifecycleActionToken”必须填充其中一个 + // 生命周期动作令牌，`InstanceId` 和 `LifecycleActionToken` 必须填充其中一个。 + // 该参数获取方式如下：配置 `NotificationTarget ` 参数的挂钩被触发时，向 `NotificationTarget ` 参数中指定的消息队列投递包含令牌的消息，消息队列的消费者可从消息中获取令牌。 LifecycleActionToken *string `json:"LifecycleActionToken,omitnil,omitempty" name:"LifecycleActionToken"` } type CompleteLifecycleActionRequest struct { *tchttp.BaseRequest - // 生命周期挂钩ID + // 生命周期挂钩ID。可以通过调用接口 [DescribeLifecycleHooks](https://cloud.tencent.com/document/api/377/34452) ，取返回信息中的 LifecycleHookId 获取生命周期挂钩ID。 LifecycleHookId *string `json:"LifecycleHookId,omitnil,omitempty" name:"LifecycleHookId"` - // 生命周期动作的结果，取值范围为“CONTINUE”或“ABANDON” + // 生命周期动作的结果，取值范围如下： + //
  • CONTINUE: 默认值，表示继续执行扩缩容活动
    • + //
  • ABANDON: 针对扩容挂钩，挂钩超时或 LifecycleCommand 执行失败的 CVM 实例会直接释放或移出；而针对缩容挂钩，会继续执行缩容活动。
    • LifecycleActionResult *string `json:"LifecycleActionResult,omitnil,omitempty" name:"LifecycleActionResult"` - // 实例ID，“InstanceId”和“LifecycleActionToken”必须填充其中一个 + // 实例ID，`InstanceId` 和 `LifecycleActionToken` 参数必须填写其中一个。可通过登录 [控制台](https://console.cloud.tencent.com/cvm/index) 或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // “InstanceId”和“LifecycleActionToken”必须填充其中一个 + // 生命周期动作令牌，`InstanceId` 和 `LifecycleActionToken` 必须填充其中一个。 + // 该参数获取方式如下：配置 `NotificationTarget ` 参数的挂钩被触发时，向 `NotificationTarget ` 参数中指定的消息队列投递包含令牌的消息，消息队列的消费者可从消息中获取令牌。 LifecycleActionToken *string `json:"LifecycleActionToken,omitnil,omitempty" name:"LifecycleActionToken"` } @@ -672,16 +695,16 @@ type CreateAutoScalingGroupFromInstanceRequestParams struct { // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 实例ID + // 实例ID。可通过登录[控制台](https://console.cloud.tencent.com/cvm/index)或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *int64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *int64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 期望实例数，大小介于最小实例数和最大实例数之间。 + // 期望实例数，取值范围 [0,2000]，默认值等于当前 MinSize，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *int64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` // 是否继承实例标签，默认值为False @@ -694,16 +717,16 @@ type CreateAutoScalingGroupFromInstanceRequest struct { // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 实例ID + // 实例ID。可通过登录[控制台](https://console.cloud.tencent.com/cvm/index)或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *int64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *int64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 期望实例数，大小介于最小实例数和最大实例数之间。 + // 期望实例数，取值范围 [0,2000]，默认值等于当前 MinSize，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *int64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` // 是否继承实例标签，默认值为False @@ -764,34 +787,34 @@ type CreateAutoScalingGroupRequestParams struct { // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 启动配置ID + // 启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // VPC ID，基础网络则填空字符串 + // 私有网络ID。有效的VpcId可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询；也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ，从接口返回中的VpcId字段获取。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` - // 默认冷却时间，单位秒，默认值为300 + // 默认冷却时间，单位秒，默认值为300。取值范围为 [0,3600]。 DefaultCooldown *uint64 `json:"DefaultCooldown,omitnil,omitempty" name:"DefaultCooldown"` - // 期望实例数，大小介于最小实例数和最大实例数之间 + // 期望实例数，取值范围 [0,2000]，默认值等于当前 MinSize，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 伸缩组内实例所属项目ID。不填为默认项目。 + // 伸缩组内实例所属项目ID。默认值为0，表示使用默认项目。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 应用型负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` - // 子网ID列表，VPC场景下必须指定子网。多个子网以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。 + // 子网ID列表，VPC场景下必须指定子网。多个子网以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询；也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ，从接口返回中的SubnetId字段获取。 SubnetIds []*string `json:"SubnetIds,omitnil,omitempty" name:"SubnetIds"` // 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE，默认取值为 OLDEST_INSTANCE。 @@ -816,13 +839,13 @@ type CreateAutoScalingGroupRequestParams struct { // 如果 Zones/SubnetIds 中可用区或者子网不存在，则无论 ZonesCheckPolicy 采用何种取值，都会校验报错。 ZonesCheckPolicy *string `json:"ZonesCheckPolicy,omitnil,omitempty" name:"ZonesCheckPolicy"` - // 标签描述列表。通过指定该参数可以支持绑定标签到伸缩组。同时绑定标签到相应的资源实例。每个伸缩组最多支持30个标签。 + // 标签描述列表。通过指定该参数可以支持绑定标签到伸缩组。同时绑定标签到相应的资源实例。每个伸缩组最多支持30个标签。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，根据回参获取已有的标签键值对信息。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` // 服务设置，包括云监控不健康替换等服务设置。 ServiceSettings *ServiceSettings `json:"ServiceSettings,omitnil,omitempty" name:"ServiceSettings"` - // 实例具有IPv6地址数量的配置，取值包括 0、1，默认值为0。 + // 实例具有IPv6地址数量的配置，取值包括0、1。默认值为 0，表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络，需在子网中开启 IPv6 CIDR，其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 Ipv6AddressCount *int64 `json:"Ipv6AddressCount,omitnil,omitempty" name:"Ipv6AddressCount"` // 多可用区/子网策略，取值包括 PRIORITY 和 EQUALITY，默认为 PRIORITY。 @@ -869,34 +892,34 @@ type CreateAutoScalingGroupRequest struct { // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 启动配置ID + // 启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // VPC ID，基础网络则填空字符串 + // 私有网络ID。有效的VpcId可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询；也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ，从接口返回中的VpcId字段获取。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` - // 默认冷却时间，单位秒，默认值为300 + // 默认冷却时间，单位秒，默认值为300。取值范围为 [0,3600]。 DefaultCooldown *uint64 `json:"DefaultCooldown,omitnil,omitempty" name:"DefaultCooldown"` - // 期望实例数，大小介于最小实例数和最大实例数之间 + // 期望实例数，取值范围 [0,2000]，默认值等于当前 MinSize，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 伸缩组内实例所属项目ID。不填为默认项目。 + // 伸缩组内实例所属项目ID。默认值为0，表示使用默认项目。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 应用型负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` - // 子网ID列表，VPC场景下必须指定子网。多个子网以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。 + // 子网ID列表，VPC场景下必须指定子网。多个子网以填写顺序为优先级，依次进行尝试，直至可以成功创建实例。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询；也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ，从接口返回中的SubnetId字段获取。 SubnetIds []*string `json:"SubnetIds,omitnil,omitempty" name:"SubnetIds"` // 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE，默认取值为 OLDEST_INSTANCE。 @@ -921,13 +944,13 @@ type CreateAutoScalingGroupRequest struct { // 如果 Zones/SubnetIds 中可用区或者子网不存在，则无论 ZonesCheckPolicy 采用何种取值，都会校验报错。 ZonesCheckPolicy *string `json:"ZonesCheckPolicy,omitnil,omitempty" name:"ZonesCheckPolicy"` - // 标签描述列表。通过指定该参数可以支持绑定标签到伸缩组。同时绑定标签到相应的资源实例。每个伸缩组最多支持30个标签。 + // 标签描述列表。通过指定该参数可以支持绑定标签到伸缩组。同时绑定标签到相应的资源实例。每个伸缩组最多支持30个标签。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，根据回参获取已有的标签键值对信息。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` // 服务设置，包括云监控不健康替换等服务设置。 ServiceSettings *ServiceSettings `json:"ServiceSettings,omitnil,omitempty" name:"ServiceSettings"` - // 实例具有IPv6地址数量的配置，取值包括 0、1，默认值为0。 + // 实例具有IPv6地址数量的配置，取值包括0、1。默认值为 0，表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络，需在子网中开启 IPv6 CIDR，其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 Ipv6AddressCount *int64 `json:"Ipv6AddressCount,omitnil,omitempty" name:"Ipv6AddressCount"` // 多可用区/子网策略，取值包括 PRIORITY 和 EQUALITY，默认为 PRIORITY。 @@ -1044,7 +1067,7 @@ type CreateLaunchConfigurationRequestParams struct { // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-8toqc6s3`。镜像Id与镜像族名称，二者必填一个且只能填写一个。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` - // 启动配置所属项目ID。不填为默认项目。 + // 启动配置所属项目ID。默认值为0，表示使用默认项目。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。 // 注意：伸缩组内实例所属项目ID取伸缩组项目ID，与这里取值无关。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` @@ -1084,13 +1107,13 @@ type CreateLaunchConfigurationRequestParams struct { InstanceMarketOptions *InstanceMarketOptionsRequest `json:"InstanceMarketOptions,omitnil,omitempty" name:"InstanceMarketOptions"` // 实例机型列表，不同实例机型指定了不同的资源规格，最多支持10种实例机型。 - // `InstanceType`和`InstanceTypes`参数互斥，二者必填一个且只能填写一个。 + // `InstanceType`和`InstanceTypes`参数互斥，二者必填一个且只能填写一个。具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格描述](https://cloud.tencent.com/document/product/213/11518)。 InstanceTypes []*string `json:"InstanceTypes,omitnil,omitempty" name:"InstanceTypes"` - // CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 + // CAM角色名称。可通过[DescribeRoleList](https://cloud.tencent.com/document/product/598/36223)接口返回值中的roleName获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 实例类型校验策略，取值包括 ALL 和 ANY，默认取值为ANY。 + // 实例类型校验策略，取值包括 ALL 和 ANY，默认取值为ANY。该参数仅在 InstanceTypes 入参包含多个机型时生效。 //
  • ALL，所有实例类型（InstanceType）都可用则通过校验，否则校验报错。
    • //
  • ANY，存在任何一个实例类型（InstanceType）可用则通过校验，否则校验报错。
    • // @@ -1119,7 +1142,7 @@ type CreateLaunchConfigurationRequestParams struct { //
  • AUTOMATIC：自动选择当前可用的云盘类型
    • DiskTypePolicy *string `json:"DiskTypePolicy,omitnil,omitempty" name:"DiskTypePolicy"` - // 高性能计算集群ID。
    + // 高性能计算集群ID。可通过调用[DescribeHpcClusters](https://cloud.tencent.com/document/product/213/83220)接口获取该参数。 // 注意：此字段默认为空。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` @@ -1129,10 +1152,10 @@ type CreateLaunchConfigurationRequestParams struct { // 置放群组id，仅支持指定一个。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` - // 镜像族名称。镜像Id与镜像族名称，二者必填一个且只能填写一个。 + // 镜像族名称。镜像Id与镜像族名称，二者必填一个且只能填写一个。可通过调用[DescribeImages](https://cloud.tencent.com/document/product/213/15715)接口获取该参数。 ImageFamily *string `json:"ImageFamily,omitnil,omitempty" name:"ImageFamily"` - // 本地专用集群ID。 + // 本地专用集群ID。可通过 [DescribeDedicatedClusters](https://cloud.tencent.com/document/product/1346/73758) 接口获取该参数。 DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` // 自定义metadata。 @@ -1148,7 +1171,7 @@ type CreateLaunchConfigurationRequest struct { // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-8toqc6s3`。镜像Id与镜像族名称，二者必填一个且只能填写一个。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` - // 启动配置所属项目ID。不填为默认项目。 + // 启动配置所属项目ID。默认值为0，表示使用默认项目。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。 // 注意：伸缩组内实例所属项目ID取伸缩组项目ID，与这里取值无关。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` @@ -1188,13 +1211,13 @@ type CreateLaunchConfigurationRequest struct { InstanceMarketOptions *InstanceMarketOptionsRequest `json:"InstanceMarketOptions,omitnil,omitempty" name:"InstanceMarketOptions"` // 实例机型列表，不同实例机型指定了不同的资源规格，最多支持10种实例机型。 - // `InstanceType`和`InstanceTypes`参数互斥，二者必填一个且只能填写一个。 + // `InstanceType`和`InstanceTypes`参数互斥，二者必填一个且只能填写一个。具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格描述](https://cloud.tencent.com/document/product/213/11518)。 InstanceTypes []*string `json:"InstanceTypes,omitnil,omitempty" name:"InstanceTypes"` - // CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 + // CAM角色名称。可通过[DescribeRoleList](https://cloud.tencent.com/document/product/598/36223)接口返回值中的roleName获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 实例类型校验策略，取值包括 ALL 和 ANY，默认取值为ANY。 + // 实例类型校验策略，取值包括 ALL 和 ANY，默认取值为ANY。该参数仅在 InstanceTypes 入参包含多个机型时生效。 //
  • ALL，所有实例类型（InstanceType）都可用则通过校验，否则校验报错。
    • //
  • ANY，存在任何一个实例类型（InstanceType）可用则通过校验，否则校验报错。
    • // @@ -1223,7 +1246,7 @@ type CreateLaunchConfigurationRequest struct { //
  • AUTOMATIC：自动选择当前可用的云盘类型
    • DiskTypePolicy *string `json:"DiskTypePolicy,omitnil,omitempty" name:"DiskTypePolicy"` - // 高性能计算集群ID。
    + // 高性能计算集群ID。可通过调用[DescribeHpcClusters](https://cloud.tencent.com/document/product/213/83220)接口获取该参数。 // 注意：此字段默认为空。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` @@ -1233,10 +1256,10 @@ type CreateLaunchConfigurationRequest struct { // 置放群组id，仅支持指定一个。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` - // 镜像族名称。镜像Id与镜像族名称，二者必填一个且只能填写一个。 + // 镜像族名称。镜像Id与镜像族名称，二者必填一个且只能填写一个。可通过调用[DescribeImages](https://cloud.tencent.com/document/product/213/15715)接口获取该参数。 ImageFamily *string `json:"ImageFamily,omitnil,omitempty" name:"ImageFamily"` - // 本地专用集群ID。 + // 本地专用集群ID。可通过 [DescribeDedicatedClusters](https://cloud.tencent.com/document/product/1346/73758) 接口获取该参数。 DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` // 自定义metadata。 @@ -1316,62 +1339,76 @@ func (r *CreateLaunchConfigurationResponse) FromJsonString(s string) error { // Predefined struct for user type CreateLifecycleHookRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可以通过如下方式获取可用的伸缩组ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
    • + //
  • 通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 生命周期挂钩名称。名称仅支持中文、英文、数字、下划线（_）、短横线（-）、小数点（.），最大长度不能超128个字节。 LifecycleHookName *string `json:"LifecycleHookName,omitnil,omitempty" name:"LifecycleHookName"` - // 进行生命周期挂钩的场景，取值范围包括 INSTANCE_LAUNCHING 和 INSTANCE_TERMINATING + // 进行生命周期挂钩的场景，取值范围如下: + //
  • INSTANCE_LAUNCHING: 扩容生命周期挂钩
    • + //
  • INSTANCE_TERMINATING: 缩容生命周期挂钩
    • LifecycleTransition *string `json:"LifecycleTransition,omitnil,omitempty" name:"LifecycleTransition"` - // 定义伸缩组在生命周期挂钩超时的情况下应采取的操作，取值范围是 CONTINUE 或 ABANDON，默认值为 CONTINUE + // 定义伸缩组在生命周期挂钩超时或 LifecycleCommand 执行失败时应采取的操作，取值范围如下： + //
  • CONTINUE: 默认值，表示继续执行扩缩容活动
    • + //
  • ABANDON: 针对扩容挂钩，挂钩超时或 LifecycleCommand 执行失败的 CVM 实例会直接释放或移出；而针对缩容挂钩，会继续执行缩容活动。
    • DefaultResult *string `json:"DefaultResult,omitnil,omitempty" name:"DefaultResult"` // 生命周期挂钩超时之前可以经过的最长时间（以秒为单位），范围从30到7200秒，默认值为300秒 HeartbeatTimeout *int64 `json:"HeartbeatTimeout,omitnil,omitempty" name:"HeartbeatTimeout"` - // 弹性伸缩向通知目标发送的附加信息，配置通知时使用,默认值为空字符串""。最大长度不能超过1024个字节。 + // 弹性伸缩向通知目标发送的附加信息，配置通知时使用，默认值为空字符串，最长不超过 1024 字符。NotificationMetadata 和 LifecycleCommand参数互斥，二者不可同时指定。 NotificationMetadata *string `json:"NotificationMetadata,omitnil,omitempty" name:"NotificationMetadata"` // 通知目标。NotificationTarget和LifecycleCommand参数互斥，二者不可同时指定。 NotificationTarget *NotificationTarget `json:"NotificationTarget,omitnil,omitempty" name:"NotificationTarget"` - // 进行生命周期挂钩的场景类型，取值范围包括NORMAL 和 EXTENSION。说明：设置为EXTENSION值，在AttachInstances、DetachInstances、RemoveInstaces接口时会触发生命周期挂钩操作，值为NORMAL则不会在这些接口中触发生命周期挂钩。 + // 进行生命周期挂钩的场景类型，取值范围包括 NORMAL 和 EXTENSION，默认值为 NORMAL。 + // 说明：设置为EXTENSION值，在 [AttachInstances](https://cloud.tencent.com/document/api/377/20441)、[DetachInstances](https://cloud.tencent.com/document/api/377/20436)、[RemoveInstaces](https://cloud.tencent.com/document/api/377/20431)、[StopAutoScalingInstances](https://cloud.tencent.com/document/api/377/40286)、[StartAutoScalingInstances](https://cloud.tencent.com/document/api/377/40287)、[StartInstanceRefresh](https://cloud.tencent.com/document/api/377/99172) 接口时会触发生命周期挂钩操作，值为NORMAL则不会在这些接口中触发生命周期挂钩。 LifecycleTransitionType *string `json:"LifecycleTransitionType,omitnil,omitempty" name:"LifecycleTransitionType"` - // 远程命令执行对象。NotificationTarget和LifecycleCommand参数互斥，二者不可同时指定。 + // 远程命令执行对象。通知相关参数（NotificationTarget、NotificationMetadata）与该参数互斥，二者不可同时指定。 LifecycleCommand *LifecycleCommand `json:"LifecycleCommand,omitnil,omitempty" name:"LifecycleCommand"` } type CreateLifecycleHookRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可以通过如下方式获取可用的伸缩组ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
    • + //
  • 通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 生命周期挂钩名称。名称仅支持中文、英文、数字、下划线（_）、短横线（-）、小数点（.），最大长度不能超128个字节。 LifecycleHookName *string `json:"LifecycleHookName,omitnil,omitempty" name:"LifecycleHookName"` - // 进行生命周期挂钩的场景，取值范围包括 INSTANCE_LAUNCHING 和 INSTANCE_TERMINATING + // 进行生命周期挂钩的场景，取值范围如下: + //
  • INSTANCE_LAUNCHING: 扩容生命周期挂钩
    • + //
  • INSTANCE_TERMINATING: 缩容生命周期挂钩
    • LifecycleTransition *string `json:"LifecycleTransition,omitnil,omitempty" name:"LifecycleTransition"` - // 定义伸缩组在生命周期挂钩超时的情况下应采取的操作，取值范围是 CONTINUE 或 ABANDON，默认值为 CONTINUE + // 定义伸缩组在生命周期挂钩超时或 LifecycleCommand 执行失败时应采取的操作，取值范围如下： + //
  • CONTINUE: 默认值，表示继续执行扩缩容活动
    • + //
  • ABANDON: 针对扩容挂钩，挂钩超时或 LifecycleCommand 执行失败的 CVM 实例会直接释放或移出；而针对缩容挂钩，会继续执行缩容活动。
    • DefaultResult *string `json:"DefaultResult,omitnil,omitempty" name:"DefaultResult"` // 生命周期挂钩超时之前可以经过的最长时间（以秒为单位），范围从30到7200秒，默认值为300秒 HeartbeatTimeout *int64 `json:"HeartbeatTimeout,omitnil,omitempty" name:"HeartbeatTimeout"` - // 弹性伸缩向通知目标发送的附加信息，配置通知时使用,默认值为空字符串""。最大长度不能超过1024个字节。 + // 弹性伸缩向通知目标发送的附加信息，配置通知时使用，默认值为空字符串，最长不超过 1024 字符。NotificationMetadata 和 LifecycleCommand参数互斥，二者不可同时指定。 NotificationMetadata *string `json:"NotificationMetadata,omitnil,omitempty" name:"NotificationMetadata"` // 通知目标。NotificationTarget和LifecycleCommand参数互斥，二者不可同时指定。 NotificationTarget *NotificationTarget `json:"NotificationTarget,omitnil,omitempty" name:"NotificationTarget"` - // 进行生命周期挂钩的场景类型，取值范围包括NORMAL 和 EXTENSION。说明：设置为EXTENSION值，在AttachInstances、DetachInstances、RemoveInstaces接口时会触发生命周期挂钩操作，值为NORMAL则不会在这些接口中触发生命周期挂钩。 + // 进行生命周期挂钩的场景类型，取值范围包括 NORMAL 和 EXTENSION，默认值为 NORMAL。 + // 说明：设置为EXTENSION值，在 [AttachInstances](https://cloud.tencent.com/document/api/377/20441)、[DetachInstances](https://cloud.tencent.com/document/api/377/20436)、[RemoveInstaces](https://cloud.tencent.com/document/api/377/20431)、[StopAutoScalingInstances](https://cloud.tencent.com/document/api/377/40286)、[StartAutoScalingInstances](https://cloud.tencent.com/document/api/377/40287)、[StartInstanceRefresh](https://cloud.tencent.com/document/api/377/99172) 接口时会触发生命周期挂钩操作，值为NORMAL则不会在这些接口中触发生命周期挂钩。 LifecycleTransitionType *string `json:"LifecycleTransitionType,omitnil,omitempty" name:"LifecycleTransitionType"` - // 远程命令执行对象。NotificationTarget和LifecycleCommand参数互斥，二者不可同时指定。 + // 远程命令执行对象。通知相关参数（NotificationTarget、NotificationMetadata）与该参数互斥，二者不可同时指定。 LifecycleCommand *LifecycleCommand `json:"LifecycleCommand,omitnil,omitempty" name:"LifecycleCommand"` } @@ -1429,7 +1466,7 @@ func (r *CreateLifecycleHookResponse) FromJsonString(s string) error { // Predefined struct for user type CreateNotificationConfigurationRequestParams struct { - // 伸缩组ID。 + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 通知类型，即为需要订阅的通知类型集合，取值范围如下： @@ -1441,30 +1478,30 @@ type CreateNotificationConfigurationRequestParams struct { //
  • REPLACE_UNHEALTHY_INSTANCE_FAILED：替换不健康子机失败
    • NotificationTypes []*string `json:"NotificationTypes,omitnil,omitempty" name:"NotificationTypes"` - // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。 + // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。该参数仅在 TargetType 为 USER_GROUP 时生效。 NotificationUserGroupIds []*string `json:"NotificationUserGroupIds,omitnil,omitempty" name:"NotificationUserGroupIds"` - // 通知接收端类型，取值如下 - //
  • USER_GROUP：用户组 - //
  • CMQ_QUEUE：CMQ 队列 - //
  • CMQ_TOPIC：CMQ 主题 - //
  • TDMQ_CMQ_TOPIC：TDMQ CMQ 主题 - //
  • TDMQ_CMQ_QUEUE：TDMQ CMQ 队列 + // 通知接收端类型，取值如下： + //
  • USER_GROUP：用户组
    • + //
  • TDMQ_CMQ_TOPIC：TDMQ CMQ 主题
    • + //
  • TDMQ_CMQ_QUEUE：TDMQ CMQ 队列
    • + //
  • CMQ_QUEUE：CMQ 队列，[CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。
    • + //
  • CMQ_TOPIC：CMQ 主题，[CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。
    • // // 默认值为：`USER_GROUP`。 TargetType *string `json:"TargetType,omitnil,omitempty" name:"TargetType"` - // CMQ 队列名称，如 TargetType 取值为 `CMQ_QUEUE` 或 `TDMQ_CMQ_QUEUE` 时，该字段必填。 + // TDMQ CMQ 队列名，如 TargetType 取值为 `TDMQ_CMQ_QUEUE` ，该字段必填。 QueueName *string `json:"QueueName,omitnil,omitempty" name:"QueueName"` - // CMQ 主题名称，如 TargetType 取值为 `CMQ_TOPIC` 或 `TDMQ_CMQ_TOPIC` 时，该字段必填。 + // TDMQ CMQ 主题名，如 TargetType 取值为 `TDMQ_CMQ_TOPIC` ，该字段必填。 TopicName *string `json:"TopicName,omitnil,omitempty" name:"TopicName"` } type CreateNotificationConfigurationRequest struct { *tchttp.BaseRequest - // 伸缩组ID。 + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 通知类型，即为需要订阅的通知类型集合，取值范围如下： @@ -1476,23 +1513,23 @@ type CreateNotificationConfigurationRequest struct { //
  • REPLACE_UNHEALTHY_INSTANCE_FAILED：替换不健康子机失败
    • NotificationTypes []*string `json:"NotificationTypes,omitnil,omitempty" name:"NotificationTypes"` - // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。 + // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。该参数仅在 TargetType 为 USER_GROUP 时生效。 NotificationUserGroupIds []*string `json:"NotificationUserGroupIds,omitnil,omitempty" name:"NotificationUserGroupIds"` - // 通知接收端类型，取值如下 - //
  • USER_GROUP：用户组 - //
  • CMQ_QUEUE：CMQ 队列 - //
  • CMQ_TOPIC：CMQ 主题 - //
  • TDMQ_CMQ_TOPIC：TDMQ CMQ 主题 - //
  • TDMQ_CMQ_QUEUE：TDMQ CMQ 队列 + // 通知接收端类型，取值如下： + //
  • USER_GROUP：用户组
    • + //
  • TDMQ_CMQ_TOPIC：TDMQ CMQ 主题
    • + //
  • TDMQ_CMQ_QUEUE：TDMQ CMQ 队列
    • + //
  • CMQ_QUEUE：CMQ 队列，[CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。
    • + //
  • CMQ_TOPIC：CMQ 主题，[CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。
    • // // 默认值为：`USER_GROUP`。 TargetType *string `json:"TargetType,omitnil,omitempty" name:"TargetType"` - // CMQ 队列名称，如 TargetType 取值为 `CMQ_QUEUE` 或 `TDMQ_CMQ_QUEUE` 时，该字段必填。 + // TDMQ CMQ 队列名，如 TargetType 取值为 `TDMQ_CMQ_QUEUE` ，该字段必填。 QueueName *string `json:"QueueName,omitnil,omitempty" name:"QueueName"` - // CMQ 主题名称，如 TargetType 取值为 `CMQ_TOPIC` 或 `TDMQ_CMQ_TOPIC` 时，该字段必填。 + // TDMQ CMQ 主题名，如 TargetType 取值为 `TDMQ_CMQ_TOPIC` ，该字段必填。 TopicName *string `json:"TopicName,omitnil,omitempty" name:"TopicName"` } @@ -1547,19 +1584,24 @@ func (r *CreateNotificationConfigurationResponse) FromJsonString(s string) error // Predefined struct for user type CreateScalingPolicyRequestParams struct { - // 伸缩组ID。 + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 告警触发策略名称。 + // 告警策略名称，在您账号中必须唯一。名称长度不能超过60，名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点。 ScalingPolicyName *string `json:"ScalingPolicyName,omitnil,omitempty" name:"ScalingPolicyName"` - // 告警触发策略类型，默认类型为SIMPLE。取值范围：
  • SIMPLE：简单策略
  • TARGET_TRACKING：目标追踪策略
    • + // 告警触发策略类型，默认类型为SIMPLE。取值范围： + //
  • SIMPLE：简单策略
    • + //
  • TARGET_TRACKING：目标追踪策略
    • ScalingPolicyType *string `json:"ScalingPolicyType,omitnil,omitempty" name:"ScalingPolicyType"` - // 告警触发后，期望实例数修改方式，仅适用于简单策略。取值范围：
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
  • EXACT_CAPACITY：调整至指定期望实例数
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • + // 告警触发后，期望实例数修改方式，仅适用于简单策略，在简单策略场景下必填。取值范围： + //
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
    • + //
  • EXACT_CAPACITY：调整至指定期望实例数
    • + //
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • AdjustmentType *string `json:"AdjustmentType,omitnil,omitempty" name:"AdjustmentType"` - // 告警触发后，期望实例数的调整值，仅适用于简单策略。 + // 告警触发后，期望实例数的调整值，仅适用于简单策略，在简单策略场景下必填。 //
  • 当 AdjustmentType 为 CHANGE_IN_CAPACITY 时，AdjustmentValue 为正数表示告警触发后增加实例，为负数表示告警触发后减少实例
    • //
  • 当 AdjustmentType 为 EXACT_CAPACITY 时，AdjustmentValue 的值即为告警触发后新的期望实例数，需要大于或等于0
    • //
  • 当 AdjustmentType 为 PERCENT_CHANGE_IN_CAPACITY 时，AdjusmentValue 为正数表示告警触发后按百分比增加实例，为负数表示告警触发后按百分比减少实例，单位是：%。
    • @@ -1568,10 +1610,10 @@ type CreateScalingPolicyRequestParams struct { // 冷却时间，单位为秒，仅适用于简单策略。默认冷却时间300秒。 Cooldown *uint64 `json:"Cooldown,omitnil,omitempty" name:"Cooldown"` - // 告警监控指标，仅适用于简单策略。 + // 告警监控指标，仅适用于简单策略，在简单策略场景下必填。 MetricAlarm *MetricAlarm `json:"MetricAlarm,omitnil,omitempty" name:"MetricAlarm"` - // 预定义监控项，仅适用于目标追踪策略。取值范围： + // 预定义监控项，仅适用于目标追踪策略，在目标追踪策略场景下必填。取值范围： //
  • ASG_AVG_CPU_UTILIZATION：平均CPU使用率
    • //
  • ASG_AVG_LAN_TRAFFIC_OUT：平均内网出带宽
    • //
  • ASG_AVG_LAN_TRAFFIC_IN：平均内网入带宽
    • @@ -1579,7 +1621,7 @@ type CreateScalingPolicyRequestParams struct { //
  • ASG_AVG_WAN_TRAFFIC_IN：平均外网入带宽
    • PredefinedMetricType *string `json:"PredefinedMetricType,omitnil,omitempty" name:"PredefinedMetricType"` - // 目标值，仅适用于目标追踪策略。 + // 目标值，仅适用于目标追踪策略，在目标追踪策略场景下必填。 //
  • ASG_AVG_CPU_UTILIZATION：[1, 100)，单位：%
    • //
  • ASG_AVG_LAN_TRAFFIC_OUT：>0，单位：Mbps
    • //
  • ASG_AVG_LAN_TRAFFIC_IN：>0，单位：Mbps
    • @@ -1603,19 +1645,24 @@ type CreateScalingPolicyRequestParams struct { type CreateScalingPolicyRequest struct { *tchttp.BaseRequest - // 伸缩组ID。 + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 告警触发策略名称。 + // 告警策略名称，在您账号中必须唯一。名称长度不能超过60，名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点。 ScalingPolicyName *string `json:"ScalingPolicyName,omitnil,omitempty" name:"ScalingPolicyName"` - // 告警触发策略类型，默认类型为SIMPLE。取值范围：
  • SIMPLE：简单策略
  • TARGET_TRACKING：目标追踪策略
    • + // 告警触发策略类型，默认类型为SIMPLE。取值范围： + //
  • SIMPLE：简单策略
    • + //
  • TARGET_TRACKING：目标追踪策略
    • ScalingPolicyType *string `json:"ScalingPolicyType,omitnil,omitempty" name:"ScalingPolicyType"` - // 告警触发后，期望实例数修改方式，仅适用于简单策略。取值范围：
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
  • EXACT_CAPACITY：调整至指定期望实例数
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • + // 告警触发后，期望实例数修改方式，仅适用于简单策略，在简单策略场景下必填。取值范围： + //
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
    • + //
  • EXACT_CAPACITY：调整至指定期望实例数
    • + //
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • AdjustmentType *string `json:"AdjustmentType,omitnil,omitempty" name:"AdjustmentType"` - // 告警触发后，期望实例数的调整值，仅适用于简单策略。 + // 告警触发后，期望实例数的调整值，仅适用于简单策略，在简单策略场景下必填。 //
  • 当 AdjustmentType 为 CHANGE_IN_CAPACITY 时，AdjustmentValue 为正数表示告警触发后增加实例，为负数表示告警触发后减少实例
    • //
  • 当 AdjustmentType 为 EXACT_CAPACITY 时，AdjustmentValue 的值即为告警触发后新的期望实例数，需要大于或等于0
    • //
  • 当 AdjustmentType 为 PERCENT_CHANGE_IN_CAPACITY 时，AdjusmentValue 为正数表示告警触发后按百分比增加实例，为负数表示告警触发后按百分比减少实例，单位是：%。
    • @@ -1624,10 +1671,10 @@ type CreateScalingPolicyRequest struct { // 冷却时间，单位为秒，仅适用于简单策略。默认冷却时间300秒。 Cooldown *uint64 `json:"Cooldown,omitnil,omitempty" name:"Cooldown"` - // 告警监控指标，仅适用于简单策略。 + // 告警监控指标，仅适用于简单策略，在简单策略场景下必填。 MetricAlarm *MetricAlarm `json:"MetricAlarm,omitnil,omitempty" name:"MetricAlarm"` - // 预定义监控项，仅适用于目标追踪策略。取值范围： + // 预定义监控项，仅适用于目标追踪策略，在目标追踪策略场景下必填。取值范围： //
  • ASG_AVG_CPU_UTILIZATION：平均CPU使用率
    • //
  • ASG_AVG_LAN_TRAFFIC_OUT：平均内网出带宽
    • //
  • ASG_AVG_LAN_TRAFFIC_IN：平均内网入带宽
    • @@ -1635,7 +1682,7 @@ type CreateScalingPolicyRequest struct { //
  • ASG_AVG_WAN_TRAFFIC_IN：平均外网入带宽
    • PredefinedMetricType *string `json:"PredefinedMetricType,omitnil,omitempty" name:"PredefinedMetricType"` - // 目标值，仅适用于目标追踪策略。 + // 目标值，仅适用于目标追踪策略，在目标追踪策略场景下必填。 //
  • ASG_AVG_CPU_UTILIZATION：[1, 100)，单位：%
    • //
  • ASG_AVG_LAN_TRAFFIC_OUT：>0，单位：Mbps
    • //
  • ASG_AVG_LAN_TRAFFIC_IN：>0，单位：Mbps
    • @@ -1830,13 +1877,14 @@ type DataDisk struct { //
  • CLOUD_SSD：SSD云硬盘
    • //
  • CLOUD_HSSD：增强型SSD云硬盘
    • //
  • CLOUD_TSSD：极速型SSD云硬盘
    • + //
  • CLOUD_BSSD：通用型SSD云硬盘
    • // 默认取值与系统盘类型（SystemDisk.DiskType）保持一致。 DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` - // 数据盘大小，单位：GB。最小调整步长为10G，不同数据盘类型取值范围不同，具体限制详见：[CVM实例配置](https://cloud.tencent.com/document/product/213/2177)。默认值为0，表示不购买数据盘。更多限制详见产品文档。 + // 数据盘大小，单位：GB。不同数据盘类型取值范围不同，具体限制详见：[CVM实例配置](https://cloud.tencent.com/document/product/213/2177)。默认值为0，表示不购买数据盘。更多限制详见[产品文档](https://cloud.tencent.com/document/product/362/5145)。 DiskSize *uint64 `json:"DiskSize,omitnil,omitempty" name:"DiskSize"` - // 数据盘快照 ID，类似 `snap-l8psqwnt`。 + // 数据盘快照 ID，可通过 [DescribeSnapshots](https://cloud.tencent.com/document/product/362/15647) 接口获取该参数。 // 注意：此字段可能返回 null，表示取不到有效值。 SnapshotId *string `json:"SnapshotId,omitnil,omitempty" name:"SnapshotId"` @@ -1857,8 +1905,7 @@ type DataDisk struct { // 注意：此字段可能返回 null，表示取不到有效值。 ThroughputPerformance *uint64 `json:"ThroughputPerformance,omitnil,omitempty" name:"ThroughputPerformance"` - // 突发性能。是否开启突发性能，默认取值为 false。 - // + // 突发性能。是否开启突发性能，默认取值为 false。当前该参数仅支持极速型云盘（CLOUD_TSSD）和增强型SSD云硬盘（CLOUD_HSSD）且需容量 > 460GB。 // 注：内测中，需提单申请后使用。 // 注意：此字段可能返回 null，表示取不到有效值。 BurstPerformance *bool `json:"BurstPerformance,omitnil,omitempty" name:"BurstPerformance"` @@ -1866,14 +1913,14 @@ type DataDisk struct { // Predefined struct for user type DeleteAutoScalingGroupRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } type DeleteAutoScalingGroupRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } @@ -1920,14 +1967,14 @@ func (r *DeleteAutoScalingGroupResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteLaunchConfigurationRequestParams struct { - // 需要删除的启动配置ID。 + // 需要删除的启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` } type DeleteLaunchConfigurationRequest struct { *tchttp.BaseRequest - // 需要删除的启动配置ID。 + // 需要删除的启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` } @@ -2028,14 +2075,14 @@ func (r *DeleteLifecycleHookResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteNotificationConfigurationRequestParams struct { - // 待删除的通知ID。 + // 待删除的通知ID，目前为必填参数。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeNotificationConfigurations](https://cloud.tencent.com/document/api/377/33183) ，取返回信息中的 AutoScalingNotificationId 获取通知ID。 AutoScalingNotificationId *string `json:"AutoScalingNotificationId,omitnil,omitempty" name:"AutoScalingNotificationId"` } type DeleteNotificationConfigurationRequest struct { *tchttp.BaseRequest - // 待删除的通知ID。 + // 待删除的通知ID，目前为必填参数。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeNotificationConfigurations](https://cloud.tencent.com/document/api/377/33183) ，取返回信息中的 AutoScalingNotificationId 获取通知ID。 AutoScalingNotificationId *string `json:"AutoScalingNotificationId,omitnil,omitempty" name:"AutoScalingNotificationId"` } @@ -2082,14 +2129,14 @@ func (r *DeleteNotificationConfigurationResponse) FromJsonString(s string) error // Predefined struct for user type DeleteScalingPolicyRequestParams struct { - // 待删除的告警策略ID。 + // 待删除的告警策略ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) ，取返回信息中的 AutoScalingPolicyId 获取告警策略ID。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` } type DeleteScalingPolicyRequest struct { *tchttp.BaseRequest - // 待删除的告警策略ID。 + // 待删除的告警策略ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) ，取返回信息中的 AutoScalingPolicyId 获取告警策略ID。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` } @@ -2256,11 +2303,9 @@ type DescribeAutoScalingActivitiesRequestParams struct { // 按照一个或者多个伸缩活动ID查询。伸缩活动ID形如：`asa-5l2ejpfo`。每次请求的上限为100。参数不支持同时指定`ActivityIds`和`Filters`。 ActivityIds []*string `json:"ActivityIds,omitnil,omitempty" name:"ActivityIds"` - // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • - //
  • activity-status-code - String - 是否必填：否 -（过滤条件）按照伸缩活动状态过滤。（INIT：初始化中|RUNNING：运行中|SUCCESSFUL：活动成功|PARTIALLY_SUCCESSFUL：活动部分成功|FAILED：活动失败|CANCELLED：活动取消）
    • - //
  • activity-type - String - 是否必填：否 -（过滤条件）按照伸缩活动类型过滤。（SCALE_OUT：扩容活动|SCALE_IN：缩容活动|ATTACH_INSTANCES：添加实例|REMOVE_INSTANCES：销毁实例|DETACH_INSTANCES：移出实例|TERMINATE_INSTANCES_UNEXPECTEDLY：实例在CVM控制台被销毁|REPLACE_UNHEALTHY_INSTANCE：替换不健康实例|UPDATE_LOAD_BALANCERS：更新负载均衡器）
    • - //
  • activity-id - String - 是否必填：否 -（过滤条件）按照伸缩活动ID过滤。
    • + // 过滤条件。过滤字段取值范围如下： + // // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`ActivityIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2283,11 +2328,9 @@ type DescribeAutoScalingActivitiesRequest struct { // 按照一个或者多个伸缩活动ID查询。伸缩活动ID形如：`asa-5l2ejpfo`。每次请求的上限为100。参数不支持同时指定`ActivityIds`和`Filters`。 ActivityIds []*string `json:"ActivityIds,omitnil,omitempty" name:"ActivityIds"` - // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • - //
  • activity-status-code - String - 是否必填：否 -（过滤条件）按照伸缩活动状态过滤。（INIT：初始化中|RUNNING：运行中|SUCCESSFUL：活动成功|PARTIALLY_SUCCESSFUL：活动部分成功|FAILED：活动失败|CANCELLED：活动取消）
    • - //
  • activity-type - String - 是否必填：否 -（过滤条件）按照伸缩活动类型过滤。（SCALE_OUT：扩容活动|SCALE_IN：缩容活动|ATTACH_INSTANCES：添加实例|REMOVE_INSTANCES：销毁实例|DETACH_INSTANCES：移出实例|TERMINATE_INSTANCES_UNEXPECTEDLY：实例在CVM控制台被销毁|REPLACE_UNHEALTHY_INSTANCE：替换不健康实例|UPDATE_LOAD_BALANCERS：更新负载均衡器）
    • - //
  • activity-id - String - 是否必填：否 -（过滤条件）按照伸缩活动ID过滤。
    • + // 过滤条件。过滤字段取值范围如下： + // // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`ActivityIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2358,14 +2401,14 @@ func (r *DescribeAutoScalingActivitiesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeAutoScalingAdvicesRequestParams struct { - // 待查询的伸缩组列表，上限100。 + // 待查询的伸缩组列表，上限100。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` } type DescribeAutoScalingAdvicesRequest struct { *tchttp.BaseRequest - // 待查询的伸缩组列表，上限100。 + // 待查询的伸缩组列表，上限100。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` } @@ -2415,7 +2458,7 @@ func (r *DescribeAutoScalingAdvicesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeAutoScalingGroupLastActivitiesRequestParams struct { - // 伸缩组ID列表 + // 伸缩组ID列表。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` // 查询时排除取消类型活动。默认值为 false，表示不排除取消类型活动。 @@ -2425,7 +2468,7 @@ type DescribeAutoScalingGroupLastActivitiesRequestParams struct { type DescribeAutoScalingGroupLastActivitiesRequest struct { *tchttp.BaseRequest - // 伸缩组ID列表 + // 伸缩组ID列表。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` // 查询时排除取消类型活动。默认值为 false，表示不排除取消类型活动。 @@ -2483,13 +2526,14 @@ type DescribeAutoScalingGroupsRequestParams struct { AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。 + // 可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • auto-scaling-group-name - String - 是否必填：否 -（过滤条件）按照伸缩组名称过滤。
    • //
  • vague-auto-scaling-group-name - String - 是否必填：否 -（过滤条件）按照伸缩组名称模糊搜索。
    • - //
  • launch-configuration-id - String - 是否必填：否 -（过滤条件）按照启动配置ID过滤。
    • - //
  • tag-key - String - 是否必填：否 -（过滤条件）按照标签键进行过滤。
    • - //
  • tag-value - String - 是否必填：否 -（过滤条件）按照标签值进行过滤。
    • - //
  • tag:tag-key - String - 是否必填：否 -（过滤条件）按照标签键值对进行过滤。 tag-key使用具体的标签键进行替换。使用请参考示例2
    • + //
  • launch-configuration-id - String - 是否必填：否 -（过滤条件）按照启动配置ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。
    • + //
  • tag-key - String - 是否必填：否 -（过滤条件）按照标签键进行过滤。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagKey 获取标签键。
    • + //
  • tag-value - String - 是否必填：否 -（过滤条件）按照标签值进行过滤。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagValue 获取标签值。
    • + //
  • tag:tag-key - String - 是否必填：否 -（过滤条件）按照标签键值对进行过滤。 tag-key使用具体的标签键进行替换，请参考示例2。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagKey 获取标签键。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingGroupIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2507,13 +2551,14 @@ type DescribeAutoScalingGroupsRequest struct { AutoScalingGroupIds []*string `json:"AutoScalingGroupIds,omitnil,omitempty" name:"AutoScalingGroupIds"` // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。 + // 可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • auto-scaling-group-name - String - 是否必填：否 -（过滤条件）按照伸缩组名称过滤。
    • //
  • vague-auto-scaling-group-name - String - 是否必填：否 -（过滤条件）按照伸缩组名称模糊搜索。
    • - //
  • launch-configuration-id - String - 是否必填：否 -（过滤条件）按照启动配置ID过滤。
    • - //
  • tag-key - String - 是否必填：否 -（过滤条件）按照标签键进行过滤。
    • - //
  • tag-value - String - 是否必填：否 -（过滤条件）按照标签值进行过滤。
    • - //
  • tag:tag-key - String - 是否必填：否 -（过滤条件）按照标签键值对进行过滤。 tag-key使用具体的标签键进行替换。使用请参考示例2
    • + //
  • launch-configuration-id - String - 是否必填：否 -（过滤条件）按照启动配置ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。
    • + //
  • tag-key - String - 是否必填：否 -（过滤条件）按照标签键进行过滤。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagKey 获取标签键。
    • + //
  • tag-value - String - 是否必填：否 -（过滤条件）按照标签值进行过滤。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagValue 获取标签值。
    • + //
  • tag:tag-key - String - 是否必填：否 -（过滤条件）按照标签键值对进行过滤。 tag-key使用具体的标签键进行替换，请参考示例2。可通过调用接口 [GetTags](https://cloud.tencent.com/document/product/651/72275) ，取返回信息中的 TagKey 获取标签键。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingGroupIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2576,12 +2621,16 @@ func (r *DescribeAutoScalingGroupsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeAutoScalingInstancesRequestParams struct { - // 待查询云服务器（CVM）的实例ID。每次请求的上限为100。参数不支持同时指定InstanceIds和Filters。 + // 待查询云服务器（CVM）的实例ID列表，列表长度上限为100，不支持同时指定 InstanceIds 和 Filters。 + // 可以通过以下方式获取可用的实例ID： + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
    • + //
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。
    • InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 过滤条件。 - //
  • instance-id - String - 是否必填：否 -（过滤条件）按照实例ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • instance-id - String - 是否必填：否 -（过滤条件）按照实例ID过滤。可通过登录[控制台](https://console.cloud.tencent.com/cvm/index)或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • + //
  • private-ip-address - String - 是否必填：否 -（过滤条件）按照实例内网IP过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `PrivateIpAddresses`获取实例内网IP。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`InstanceIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2595,12 +2644,16 @@ type DescribeAutoScalingInstancesRequestParams struct { type DescribeAutoScalingInstancesRequest struct { *tchttp.BaseRequest - // 待查询云服务器（CVM）的实例ID。每次请求的上限为100。参数不支持同时指定InstanceIds和Filters。 + // 待查询云服务器（CVM）的实例ID列表，列表长度上限为100，不支持同时指定 InstanceIds 和 Filters。 + // 可以通过以下方式获取可用的实例ID： + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
    • + //
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。
    • InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 过滤条件。 - //
  • instance-id - String - 是否必填：否 -（过滤条件）按照实例ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • instance-id - String - 是否必填：否 -（过滤条件）按照实例ID过滤。可通过登录[控制台](https://console.cloud.tencent.com/cvm/index)或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `InstanceId` 获取实例ID。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • + //
  • private-ip-address - String - 是否必填：否 -（过滤条件）按照实例内网IP过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ，取返回信息中的 `PrivateIpAddresses`获取实例内网IP。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`InstanceIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2847,12 +2900,12 @@ func (r *DescribeLifecycleHooksResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeNotificationConfigurationsRequestParams struct { - // 按照一个或者多个通知ID查询。实例ID形如：asn-2sestqbr。每次请求的实例的上限为100。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 + // 按照一个或者多个通知ID查询，列表长度上限为100。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 获取通知ID。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 AutoScalingNotificationIds []*string `json:"AutoScalingNotificationIds,omitnil,omitempty" name:"AutoScalingNotificationIds"` // 过滤条件。 //
  • auto-scaling-notification-id - String - 是否必填：否 -（过滤条件）按照通知ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2866,12 +2919,12 @@ type DescribeNotificationConfigurationsRequestParams struct { type DescribeNotificationConfigurationsRequest struct { *tchttp.BaseRequest - // 按照一个或者多个通知ID查询。实例ID形如：asn-2sestqbr。每次请求的实例的上限为100。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 + // 按照一个或者多个通知ID查询，列表长度上限为100。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 获取通知ID。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 AutoScalingNotificationIds []*string `json:"AutoScalingNotificationIds,omitnil,omitempty" name:"AutoScalingNotificationIds"` // 过滤条件。 //
  • auto-scaling-notification-id - String - 是否必填：否 -（过滤条件）按照通知ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingNotificationIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -2938,7 +2991,7 @@ type DescribeRefreshActivitiesRequestParams struct { RefreshActivityIds []*string `json:"RefreshActivityIds,omitnil,omitempty" name:"RefreshActivityIds"` // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • refresh-activity-status-code - String - 是否必填：否 -（过滤条件）按照刷新活动状态过滤。（INIT：初始化中 | RUNNING：运行中 | SUCCESSFUL：活动成功 | FAILED_PAUSE：失败暂停 | AUTO_PAUSE：自动暂停 | MANUAL_PAUSE：手动暂停 | CANCELLED：活动取消 | FAILED：活动失败）
    • //
  • refresh-activity-type - String - 是否必填：否 -（过滤条件）按照刷新活动类型过滤。（NORMAL：正常刷新活动 | ROLLBACK：回滚刷新活动）
    • //
  • refresh-activity-id - String - 是否必填：否 -（过滤条件）按照刷新活动ID过滤。
    • @@ -2959,7 +3012,7 @@ type DescribeRefreshActivitiesRequest struct { RefreshActivityIds []*string `json:"RefreshActivityIds,omitnil,omitempty" name:"RefreshActivityIds"` // 过滤条件。 - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • refresh-activity-status-code - String - 是否必填：否 -（过滤条件）按照刷新活动状态过滤。（INIT：初始化中 | RUNNING：运行中 | SUCCESSFUL：活动成功 | FAILED_PAUSE：失败暂停 | AUTO_PAUSE：自动暂停 | MANUAL_PAUSE：手动暂停 | CANCELLED：活动取消 | FAILED：活动失败）
    • //
  • refresh-activity-type - String - 是否必填：否 -（过滤条件）按照刷新活动类型过滤。（NORMAL：正常刷新活动 | ROLLBACK：回滚刷新活动）
    • //
  • refresh-activity-id - String - 是否必填：否 -（过滤条件）按照刷新活动ID过滤。
    • @@ -3030,9 +3083,9 @@ type DescribeScalingPoliciesRequestParams struct { // 过滤条件。 //
  • auto-scaling-policy-id - String - 是否必填：否 -（过滤条件）按照告警策略ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • scaling-policy-name - String - 是否必填：否 -（过滤条件）按照告警策略名称过滤。
    • - //
  • scaling-policy-type - String - 是否必填：否 -（过滤条件）按照告警策略类型过滤，取值范围为SIMPLE，TARGET_TRACKING。
    • + //
  • scaling-policy-type - String - 是否必填：否 -（过滤条件）按照告警策略类型过滤，取值范围为SIMPLE，TARGET_TRACKING。两者分别表示简单策略和目标追踪策略。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingPolicyIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -3051,9 +3104,9 @@ type DescribeScalingPoliciesRequest struct { // 过滤条件。 //
  • auto-scaling-policy-id - String - 是否必填：否 -（过滤条件）按照告警策略ID过滤。
    • - //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。
    • + //
  • auto-scaling-group-id - String - 是否必填：否 -（过滤条件）按照伸缩组ID过滤。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • //
  • scaling-policy-name - String - 是否必填：否 -（过滤条件）按照告警策略名称过滤。
    • - //
  • scaling-policy-type - String - 是否必填：否 -（过滤条件）按照告警策略类型过滤，取值范围为SIMPLE，TARGET_TRACKING。
    • + //
  • scaling-policy-type - String - 是否必填：否 -（过滤条件）按照告警策略类型过滤，取值范围为SIMPLE，TARGET_TRACKING。两者分别表示简单策略和目标追踪策略。
    • // 每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`AutoScalingPolicyIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -3275,26 +3328,26 @@ func (r *DetachInstancesResponse) FromJsonString(s string) error { // Predefined struct for user type DetachLoadBalancersRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统负载均衡器ID列表，列表长度上限为20，LoadBalancerIds 和 ForwardLoadBalancerIdentifications 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，列表长度上限为20，LoadBalancerIds 和 ForwardLoadBalancerIdentifications 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器标识信息列表，列表长度上限为100，LoadBalancerIds 和 ForwardLoadBalancerIdentifications二者同时最多只能指定一个 + // 负载均衡器标识信息列表，列表长度上限为100，LoadBalancerIds 和 ForwardLoadBalancerIdentifications二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancerIdentifications []*ForwardLoadBalancerIdentification `json:"ForwardLoadBalancerIdentifications,omitnil,omitempty" name:"ForwardLoadBalancerIdentifications"` } type DetachLoadBalancersRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统负载均衡器ID列表，列表长度上限为20，LoadBalancerIds 和 ForwardLoadBalancerIdentifications 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，列表长度上限为20，LoadBalancerIds 和 ForwardLoadBalancerIdentifications 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器标识信息列表，列表长度上限为100，LoadBalancerIds 和 ForwardLoadBalancerIdentifications二者同时最多只能指定一个 + // 负载均衡器标识信息列表，列表长度上限为100，LoadBalancerIds 和 ForwardLoadBalancerIdentifications二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancerIdentifications []*ForwardLoadBalancerIdentification `json:"ForwardLoadBalancerIdentifications,omitnil,omitempty" name:"ForwardLoadBalancerIdentifications"` } @@ -3369,14 +3422,14 @@ type DetailedStatusMessage struct { // Predefined struct for user type DisableAutoScalingGroupRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } type DisableAutoScalingGroupRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } @@ -3423,14 +3476,14 @@ func (r *DisableAutoScalingGroupResponse) FromJsonString(s string) error { // Predefined struct for user type EnableAutoScalingGroupRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } type EnableAutoScalingGroupRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` } @@ -3565,7 +3618,7 @@ func (r *EnterStandbyResponse) FromJsonString(s string) error { // Predefined struct for user type ExecuteScalingPolicyRequestParams struct { - // 告警伸缩策略ID，不支持目标追踪策略。 + // 告警伸缩策略ID，不支持目标追踪策略。可通过 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) 接口返回的 `ScalingPolicyType ` 参数获取告警策略类型。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` // 是否检查伸缩组活动处于冷却时间内，默认值为false @@ -3578,7 +3631,7 @@ type ExecuteScalingPolicyRequestParams struct { type ExecuteScalingPolicyRequest struct { *tchttp.BaseRequest - // 告警伸缩策略ID，不支持目标追踪策略。 + // 告警伸缩策略ID，不支持目标追踪策略。可通过 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) 接口返回的 `ScalingPolicyType ` 参数获取告警策略类型。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` // 是否检查伸缩组活动处于冷却时间内，默认值为false @@ -3715,16 +3768,16 @@ type Filter struct { } type ForwardLoadBalancer struct { - // 负载均衡器ID + // 负载均衡器ID。作为入参时，该参数必填。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerId *string `json:"LoadBalancerId,omitnil,omitempty" name:"LoadBalancerId"` - // 应用型负载均衡监听器 ID + // 负载均衡监听器 ID。作为入参时，该参数必填。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ListenerId *string `json:"ListenerId,omitnil,omitempty" name:"ListenerId"` - // 目标规则属性列表 + // 目标规则属性列表。作为入参时，该参数必填。 TargetAttributes []*TargetAttribute `json:"TargetAttributes,omitnil,omitempty" name:"TargetAttributes"` - // 转发规则ID，注意：针对七层监听器此参数必填 + // 转发规则ID，注意：针对七层监听器此参数必填。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LocationId *string `json:"LocationId,omitnil,omitempty" name:"LocationId"` // 负载均衡实例所属地域，默认取AS服务所在地域。格式与公共参数Region相同，如："ap-guangzhou"。 @@ -3816,7 +3869,10 @@ type Instance struct { //
  • IN_TERMINATING_HOOK：缩容生命周期挂钩中
    • LifeCycleState *string `json:"LifeCycleState,omitnil,omitempty" name:"LifeCycleState"` - // 健康状态，取值包括HEALTHY和UNHEALTHY + // 健康状态，取值范围如下： + //
  • HEALTHY：实例处于健康状态
    • + //
  • UNHEALTHY：实例 ping 不可达
    • + //
  • CLB_UNHEALTHY：CLB 监听的实例端口不健康
    • HealthStatus *string `json:"HealthStatus,omitnil,omitempty" name:"HealthStatus"` // 是否加入缩容保护 @@ -3828,7 +3884,7 @@ type Instance struct { // 创建类型，取值包括AUTO_CREATION, MANUAL_ATTACHING。 CreationType *string `json:"CreationType,omitnil,omitempty" name:"CreationType"` - // 实例加入时间 + // 实例加入时间，按照ISO8601标准表示，并且使用UTC时间。 AddTime *string `json:"AddTime,omitnil,omitempty" name:"AddTime"` // 实例类型 @@ -3919,6 +3975,39 @@ type InternetAccessible struct { // 带宽包ID。可通过[DescribeBandwidthPackages](https://cloud.tencent.com/document/api/215/19209)接口返回值中的`BandwidthPackageId`获取。 // 注意：此字段可能返回 null，表示取不到有效值。 BandwidthPackageId *string `json:"BandwidthPackageId,omitnil,omitempty" name:"BandwidthPackageId"` + + // 线路类型。各种线路类型详情可参考：[EIP 的 IP 地址类型](https://cloud.tencent.com/document/product/1199/41646)。默认值：BGP。 + // + //
  • BGP：常规 BGP 线路
    • + // 已开通静态单线IP白名单的用户，可选值： + // + //
  • CMCC：中国移动
    • + //
  • CTCC：中国电信
    • + //
  • CUCC：中国联通
    • + // 注意：仅部分地域支持静态单线IP。 + InternetServiceProvider *string `json:"InternetServiceProvider,omitnil,omitempty" name:"InternetServiceProvider"` + + // 公网 IP 类型。 + // + //
  • WanIP：普通公网IP。
    • + //
  • HighQualityEIP：精品 IP。仅新加坡和中国香港支持精品IP。
    • + //
  • AntiDDoSEIP：高防 IP。仅部分地域支持高防IP，详情可见[弹性公网IP产品概述](https://cloud.tencent.com/document/product/1199/41646) 。
    • + // 如需为资源分配公网IPv4地址，请指定公网IPv4地址类型。 + // + // 精品IP 高防IP功能仅部分地区灰度开放，如需使用[请提交工单咨询](https://console.cloud.tencent.com/workorder/category) + IPv4AddressType *string `json:"IPv4AddressType,omitnil,omitempty" name:"IPv4AddressType"` + + // 高防包唯一ID，申请高防IP时，该字段必传。 + AntiDDoSPackageId *string `json:"AntiDDoSPackageId,omitnil,omitempty" name:"AntiDDoSPackageId"` + + // 实例销毁时是否一并销毁绑定的弹性IP。 + // + // 取值范围： + //
  • TRUE：表示保留EIP
    • + //
  • FALSE：表示不保留
    • + // 请注意，当IPv4AddressType字段指定EIP类型时，默认不保留EIP。WanIP不受此字段影响始终随实例销毁。 + // 变更配置此字段，已绑定伸缩组会立刻生效。 + IsKeepEIP *bool `json:"IsKeepEIP,omitnil,omitempty" name:"IsKeepEIP"` } type InvocationResult struct { @@ -3976,7 +4065,7 @@ type LaunchConfiguration struct { // 注意：此字段可能返回 null，表示取不到有效值。 UserData *string `json:"UserData,omitnil,omitempty" name:"UserData"` - // 启动配置创建时间。 + // 启动配置创建时间，为标准`UTC`时间。 CreatedTime *string `json:"CreatedTime,omitnil,omitempty" name:"CreatedTime"` // 实例的增强服务启用情况与其设置。 @@ -3988,7 +4077,11 @@ type LaunchConfiguration struct { // 启动配置当前状态。取值范围：
  • NORMAL：正常
  • IMAGE_ABNORMAL：启动配置镜像异常
  • CBS_SNAP_ABNORMAL：启动配置数据盘快照异常
  • SECURITY_GROUP_ABNORMAL：启动配置安全组异常
    • LaunchConfigurationStatus *string `json:"LaunchConfigurationStatus,omitnil,omitempty" name:"LaunchConfigurationStatus"` - // 实例计费类型，CVM默认值按照POSTPAID_BY_HOUR处理。
  • POSTPAID_BY_HOUR：按小时后付费
  • SPOTPAID：竞价付费
    • + // 实例计费类型，取值范围如下： + //
  • POSTPAID_BY_HOUR：按小时后付费
    • + //
  • SPOTPAID：竞价付费
    • + //
  • PREPAID：预付费，即包年包月
    • + //
  • CDCPAID：专用集群付费
    • InstanceChargeType *string `json:"InstanceChargeType,omitnil,omitempty" name:"InstanceChargeType"` // 实例的市场相关选项，如竞价实例相关参数，若指定实例的付费模式为竞价付费则该参数必传。 @@ -4001,16 +4094,16 @@ type LaunchConfiguration struct { // 实例标签列表。扩容出来的实例会自动带上标签，最多支持10个标签。 InstanceTags []*InstanceTag `json:"InstanceTags,omitnil,omitempty" name:"InstanceTags"` - // 标签列表。 + // 标签列表，该参数内的标签仅用于绑定启动配置，不会传递给基于该启动配置扩容的 CVM 实例。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` // 版本号。 VersionNumber *int64 `json:"VersionNumber,omitnil,omitempty" name:"VersionNumber"` - // 更新时间。 + // 更新时间，为标准`UTC`时间。 UpdatedTime *string `json:"UpdatedTime,omitnil,omitempty" name:"UpdatedTime"` - // CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 + // CAM角色名称。可通过[DescribeRoleList](https://cloud.tencent.com/document/product/598/36223)接口返回值中的roleName获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` // 上次操作时，InstanceTypesCheckPolicy 取值。 @@ -4146,7 +4239,7 @@ type LoginSettings struct { // 特殊符号的取值范围： [( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ] Password *string `json:"Password,omitnil,omitempty" name:"Password"` - // 密钥ID列表。关联密钥后，就可以通过对应的私钥来访问实例；KeyId可通过接口DescribeKeyPairs获取，密钥与密码不能同时指定，同时Windows操作系统不支持指定密钥。当前仅支持购买的时候指定一个密钥。 + // 密钥ID列表。关联密钥后，就可以通过对应的私钥来访问实例；KeyId可通过接口[DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699)获取，密钥与密码不能同时指定，同时Windows操作系统不支持指定密钥。当前仅支持购买的时候指定一个密钥。 KeyIds []*string `json:"KeyIds,omitnil,omitempty" name:"KeyIds"` // 保持镜像的原始设置。该参数与Password或KeyIds.N不能同时指定。只有使用自定义镜像、共享镜像或外部导入镜像创建实例时才能指定该参数为TRUE。取值范围： @@ -4193,31 +4286,35 @@ type MetricAlarm struct { // Predefined struct for user type ModifyAutoScalingGroupRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可以通过如下方式获取可用的伸缩组ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
    • + //
  • 通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 默认冷却时间，单位秒，默认值为300 + // 默认冷却时间，单位秒，取值范围 [0,3600]，默认值为300。 DefaultCooldown *uint64 `json:"DefaultCooldown,omitnil,omitempty" name:"DefaultCooldown"` - // 期望实例数，大小介于最小实例数和最大实例数之间 + // 期望实例数，取值范围 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 启动配置ID + // 启动配置ID。可以通过如下方式获取可用的启动配置ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 查询启动配置ID。
    • + //
  • 通过调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。
    • LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 项目ID + // 项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 ProjectId 字段来获取。默认值为 0，表示使用默认项目。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 子网ID列表 + // 子网ID列表。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询；也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ，从接口返回中的SubnetId字段获取。 SubnetIds []*string `json:"SubnetIds,omitnil,omitempty" name:"SubnetIds"` // 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。 @@ -4225,7 +4322,7 @@ type ModifyAutoScalingGroupRequestParams struct { //
  • NEWEST_INSTANCE，优先销毁伸缩组中最新的实例。
    • TerminationPolicies []*string `json:"TerminationPolicies,omitnil,omitempty" name:"TerminationPolicies"` - // VPC ID，基础网络则填空字符串。修改为具体VPC ID时，需指定相应的SubnetIds；修改为基础网络时，需指定相应的Zones。 + // 私有网络ID。修改私有网络时，需将 SubnetIds 参数同步修改为该私有网络的子网。有效的 VpcId 可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询；也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ，从接口返回中的 VpcId 字段获取。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 可用区列表 @@ -4248,7 +4345,7 @@ type ModifyAutoScalingGroupRequestParams struct { // 服务设置，包括云监控不健康替换等服务设置。 ServiceSettings *ServiceSettings `json:"ServiceSettings,omitnil,omitempty" name:"ServiceSettings"` - // 实例具有IPv6地址数量的配置，取值包括0、1。 + // 实例具有IPv6地址数量的配置，取值包括0、1。默认值为 0，表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络，需在子网中开启 IPv6 CIDR，其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 Ipv6AddressCount *int64 `json:"Ipv6AddressCount,omitnil,omitempty" name:"Ipv6AddressCount"` // 多可用区/子网策略，取值包括 PRIORITY 和 EQUALITY，默认为 PRIORITY。 @@ -4290,31 +4387,35 @@ type ModifyAutoScalingGroupRequestParams struct { type ModifyAutoScalingGroupRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可以通过如下方式获取可用的伸缩组ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 查询伸缩组ID。
    • + //
  • 通过调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。
    • AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` // 伸缩组名称，在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点，最大长度不能超55个字节。 AutoScalingGroupName *string `json:"AutoScalingGroupName,omitnil,omitempty" name:"AutoScalingGroupName"` - // 默认冷却时间，单位秒，默认值为300 + // 默认冷却时间，单位秒，取值范围 [0,3600]，默认值为300。 DefaultCooldown *uint64 `json:"DefaultCooldown,omitnil,omitempty" name:"DefaultCooldown"` - // 期望实例数，大小介于最小实例数和最大实例数之间 + // 期望实例数，取值范围 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 启动配置ID + // 启动配置ID。可以通过如下方式获取可用的启动配置ID: + //
  • 通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 查询启动配置ID。
    • + //
  • 通过调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。
    • LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]。需满足最大值大于等于期望值，期望值大于等于最小值。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 项目ID + // 项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 ProjectId 字段来获取。默认值为 0，表示使用默认项目。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 子网ID列表 + // 子网ID列表。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet)查询；也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ，从接口返回中的SubnetId字段获取。 SubnetIds []*string `json:"SubnetIds,omitnil,omitempty" name:"SubnetIds"` // 销毁策略，目前长度上限为1。取值包括 OLDEST_INSTANCE 和 NEWEST_INSTANCE。 @@ -4322,7 +4423,7 @@ type ModifyAutoScalingGroupRequest struct { //
  • NEWEST_INSTANCE，优先销毁伸缩组中最新的实例。
    • TerminationPolicies []*string `json:"TerminationPolicies,omitnil,omitempty" name:"TerminationPolicies"` - // VPC ID，基础网络则填空字符串。修改为具体VPC ID时，需指定相应的SubnetIds；修改为基础网络时，需指定相应的Zones。 + // 私有网络ID。修改私有网络时，需将 SubnetIds 参数同步修改为该私有网络的子网。有效的 VpcId 可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc)查询；也可以调用接口 [DescribeVpc](https://cloud.tencent.com/document/api/215/15778) ，从接口返回中的 VpcId 字段获取。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 可用区列表 @@ -4345,7 +4446,7 @@ type ModifyAutoScalingGroupRequest struct { // 服务设置，包括云监控不健康替换等服务设置。 ServiceSettings *ServiceSettings `json:"ServiceSettings,omitnil,omitempty" name:"ServiceSettings"` - // 实例具有IPv6地址数量的配置，取值包括0、1。 + // 实例具有IPv6地址数量的配置，取值包括0、1。默认值为 0，表示实例不分配 IPv6 地址。需使用支持 IPv6 的私有网络，需在子网中开启 IPv6 CIDR，其他使用限制可参考 [IPv6使用限制](https://cloud.tencent.com/document/product/1142/38369)。 Ipv6AddressCount *int64 `json:"Ipv6AddressCount,omitnil,omitempty" name:"Ipv6AddressCount"` // 多可用区/子网策略，取值包括 PRIORITY 和 EQUALITY，默认为 PRIORITY。 @@ -4449,32 +4550,32 @@ func (r *ModifyAutoScalingGroupResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyDesiredCapacityRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 期望实例数 + // 期望实例数，取值范围 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` } type ModifyDesiredCapacityRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 期望实例数 + // 期望实例数，取值范围 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 DesiredCapacity *uint64 `json:"DesiredCapacity,omitnil,omitempty" name:"DesiredCapacity"` - // 最小实例数，取值范围为0-2000。 + // 最小实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MinSize *uint64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // 最大实例数，取值范围为0-2000。 + // 最大实例数，取值范围为 [0,2000]，同时需满足 MaxSize >= DesiredCapacity >= MinSize 。 MaxSize *uint64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` } @@ -4524,14 +4625,14 @@ func (r *ModifyDesiredCapacityResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyLaunchConfigurationAttributesRequestParams struct { - // 启动配置ID + // 启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-8toqc6s3`。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` // 实例类型列表，不同实例机型指定了不同的资源规格，最多支持10种实例机型。 - // InstanceType 指定单一实例类型，通过设置 InstanceTypes可以指定多实例类型，并使原有的InstanceType失效。 + // InstanceType 指定单一实例类型，通过设置 InstanceTypes可以指定多实例类型，并使原有的InstanceType失效。具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格描述](https://cloud.tencent.com/document/product/213/11518)。 InstanceTypes []*string `json:"InstanceTypes,omitnil,omitempty" name:"InstanceTypes"` // 实例类型校验策略，在实际修改 InstanceTypes 时发挥作用，取值包括 ALL 和 ANY，默认取值为ANY。 @@ -4600,17 +4701,17 @@ type ModifyLaunchConfigurationAttributesRequestParams struct { // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。 EnhancedService *EnhancedService `json:"EnhancedService,omitnil,omitempty" name:"EnhancedService"` - // CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 + // CAM角色名称。可通过[DescribeRoleList](https://cloud.tencent.com/document/product/598/36223)接口返回值中的roleName获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。
    + // 高性能计算集群ID。可通过调用[DescribeHpcClusters](https://cloud.tencent.com/document/product/213/83220)接口获取该参数。 // 注意：此字段默认为空。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // IPv6公网带宽相关信息设置。若新建实例包含IPv6地址，该参数可为新建实例的IPv6地址分配公网带宽。关联启动配置的伸缩组Ipv6AddressCount参数为0时，该参数不会生效。 IPv6InternetAccessible *IPv6InternetAccessible `json:"IPv6InternetAccessible,omitnil,omitempty" name:"IPv6InternetAccessible"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。可通过调用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/product/213/17810)接口获取该参数。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 实例登录设置，包括密码、密钥或保持镜像的原始登录设置。
    请注意，指定新的登录设置会覆盖原有登录设置。例如，如果您之前使用密码登录，使用该参数将登录设置修改为密钥，则原有密码被清除。 @@ -4620,7 +4721,7 @@ type ModifyLaunchConfigurationAttributesRequestParams struct { // 该参数会覆盖原有的实例标签列表，如需新增标签，需将新标签和原有标签一并传入。 InstanceTags []*InstanceTag `json:"InstanceTags,omitnil,omitempty" name:"InstanceTags"` - // 镜像族名称。 + // 镜像族名称。可通过调用[DescribeImages](https://cloud.tencent.com/document/product/213/15715)接口获取该参数。 ImageFamily *string `json:"ImageFamily,omitnil,omitempty" name:"ImageFamily"` // 本地专用集群ID。 @@ -4633,14 +4734,14 @@ type ModifyLaunchConfigurationAttributesRequestParams struct { type ModifyLaunchConfigurationAttributesRequest struct { *tchttp.BaseRequest - // 启动配置ID + // 启动配置ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/config) 或调用接口 [DescribeLaunchConfigurations](https://cloud.tencent.com/document/api/377/20445) ，取返回信息中的 LaunchConfigurationId 获取启动配置ID。 LaunchConfigurationId *string `json:"LaunchConfigurationId,omitnil,omitempty" name:"LaunchConfigurationId"` // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-8toqc6s3`。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` // 实例类型列表，不同实例机型指定了不同的资源规格，最多支持10种实例机型。 - // InstanceType 指定单一实例类型，通过设置 InstanceTypes可以指定多实例类型，并使原有的InstanceType失效。 + // InstanceType 指定单一实例类型，通过设置 InstanceTypes可以指定多实例类型，并使原有的InstanceType失效。具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格描述](https://cloud.tencent.com/document/product/213/11518)。 InstanceTypes []*string `json:"InstanceTypes,omitnil,omitempty" name:"InstanceTypes"` // 实例类型校验策略，在实际修改 InstanceTypes 时发挥作用，取值包括 ALL 和 ANY，默认取值为ANY。 @@ -4709,17 +4810,17 @@ type ModifyLaunchConfigurationAttributesRequest struct { // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。 EnhancedService *EnhancedService `json:"EnhancedService,omitnil,omitempty" name:"EnhancedService"` - // CAM角色名称。可通过DescribeRoleList接口返回值中的roleName获取。 + // CAM角色名称。可通过[DescribeRoleList](https://cloud.tencent.com/document/product/598/36223)接口返回值中的roleName获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。
    + // 高性能计算集群ID。可通过调用[DescribeHpcClusters](https://cloud.tencent.com/document/product/213/83220)接口获取该参数。 // 注意：此字段默认为空。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // IPv6公网带宽相关信息设置。若新建实例包含IPv6地址，该参数可为新建实例的IPv6地址分配公网带宽。关联启动配置的伸缩组Ipv6AddressCount参数为0时，该参数不会生效。 IPv6InternetAccessible *IPv6InternetAccessible `json:"IPv6InternetAccessible,omitnil,omitempty" name:"IPv6InternetAccessible"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。可通过调用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/product/213/17810)接口获取该参数。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 实例登录设置，包括密码、密钥或保持镜像的原始登录设置。
    请注意，指定新的登录设置会覆盖原有登录设置。例如，如果您之前使用密码登录，使用该参数将登录设置修改为密钥，则原有密码被清除。 @@ -4729,7 +4830,7 @@ type ModifyLaunchConfigurationAttributesRequest struct { // 该参数会覆盖原有的实例标签列表，如需新增标签，需将新标签和原有标签一并传入。 InstanceTags []*InstanceTag `json:"InstanceTags,omitnil,omitempty" name:"InstanceTags"` - // 镜像族名称。 + // 镜像族名称。可通过调用[DescribeImages](https://cloud.tencent.com/document/product/213/15715)接口获取该参数。 ImageFamily *string `json:"ImageFamily,omitnil,omitempty" name:"ImageFamily"` // 本地专用集群ID。 @@ -4925,20 +5026,20 @@ func (r *ModifyLifecycleHookResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyLoadBalancerTargetAttributesRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 需修改目标规则属性的应用型负载均衡器列表，列表长度上限为100 + // 需修改目标规则属性的负载均衡器列表，列表长度上限为100。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` } type ModifyLoadBalancerTargetAttributesRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 需修改目标规则属性的应用型负载均衡器列表，列表长度上限为100 + // 需修改目标规则属性的负载均衡器列表，列表长度上限为100。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` } @@ -4989,13 +5090,13 @@ func (r *ModifyLoadBalancerTargetAttributesResponse) FromJsonString(s string) er // Predefined struct for user type ModifyLoadBalancersRequestParams struct { - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` // 负载均衡器校验策略，取值包括 ALL 和 DIFF，默认取值为 ALL。 @@ -5007,13 +5108,13 @@ type ModifyLoadBalancersRequestParams struct { type ModifyLoadBalancersRequest struct { *tchttp.BaseRequest - // 伸缩组ID + // 伸缩组ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeAutoScalingGroups](https://cloud.tencent.com/document/api/377/20438) ，取返回信息中的 AutoScalingGroupId 获取伸缩组ID。 AutoScalingGroupId *string `json:"AutoScalingGroupId,omitnil,omitempty" name:"AutoScalingGroupId"` - // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 传统负载均衡器ID列表，目前长度上限为20，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 LoadBalancerIds []*string `json:"LoadBalancerIds,omitnil,omitempty" name:"LoadBalancerIds"` - // 应用型负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个 + // 负载均衡器列表，目前长度上限为100，LoadBalancerIds 和 ForwardLoadBalancers 二者同时最多只能指定一个。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 ForwardLoadBalancers []*ForwardLoadBalancer `json:"ForwardLoadBalancers,omitnil,omitempty" name:"ForwardLoadBalancers"` // 负载均衡器校验策略，取值包括 ALL 和 DIFF，默认取值为 ALL。 @@ -5071,7 +5172,7 @@ func (r *ModifyLoadBalancersResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyNotificationConfigurationRequestParams struct { - // 待修改的通知ID。 + // 待修改的通知ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeNotificationConfigurations](https://cloud.tencent.com/document/api/377/33183) ，取返回信息中的 AutoScalingNotificationId 获取通知ID。 AutoScalingNotificationId *string `json:"AutoScalingNotificationId,omitnil,omitempty" name:"AutoScalingNotificationId"` // 通知类型，即为需要订阅的通知类型集合，取值范围如下： @@ -5083,20 +5184,20 @@ type ModifyNotificationConfigurationRequestParams struct { //
  • REPLACE_UNHEALTHY_INSTANCE_FAILED：替换不健康子机失败
    • NotificationTypes []*string `json:"NotificationTypes,omitnil,omitempty" name:"NotificationTypes"` - // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。 + // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。该参数仅在 `TargetType ` 为 `USER_GROUP ` 时生效。 NotificationUserGroupIds []*string `json:"NotificationUserGroupIds,omitnil,omitempty" name:"NotificationUserGroupIds"` - // CMQ 队列或 TDMQ CMQ 队列名。 + // TDMQ CMQ 队列名。[原CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。该参数仅在 `TargetType ` 为 `TDMQ_CMQ_QUEUE ` 时生效。 QueueName *string `json:"QueueName,omitnil,omitempty" name:"QueueName"` - // CMQ 主题或 TDMQ CMQ 主题名。 + // TDMQ CMQ 主题名。[原CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。该参数仅在 `TargetType ` 为 `TDMQ_CMQ_TOPIC ` 时生效。 TopicName *string `json:"TopicName,omitnil,omitempty" name:"TopicName"` } type ModifyNotificationConfigurationRequest struct { *tchttp.BaseRequest - // 待修改的通知ID。 + // 待修改的通知ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeNotificationConfigurations](https://cloud.tencent.com/document/api/377/33183) ，取返回信息中的 AutoScalingNotificationId 获取通知ID。 AutoScalingNotificationId *string `json:"AutoScalingNotificationId,omitnil,omitempty" name:"AutoScalingNotificationId"` // 通知类型，即为需要订阅的通知类型集合，取值范围如下： @@ -5108,13 +5209,13 @@ type ModifyNotificationConfigurationRequest struct { //
  • REPLACE_UNHEALTHY_INSTANCE_FAILED：替换不健康子机失败
    • NotificationTypes []*string `json:"NotificationTypes,omitnil,omitempty" name:"NotificationTypes"` - // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。 + // 通知组ID，即为用户组ID集合，用户组ID可以通过[ListGroups](https://cloud.tencent.com/document/product/598/34589)查询。该参数仅在 `TargetType ` 为 `USER_GROUP ` 时生效。 NotificationUserGroupIds []*string `json:"NotificationUserGroupIds,omitnil,omitempty" name:"NotificationUserGroupIds"` - // CMQ 队列或 TDMQ CMQ 队列名。 + // TDMQ CMQ 队列名。[原CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。该参数仅在 `TargetType ` 为 `TDMQ_CMQ_QUEUE ` 时生效。 QueueName *string `json:"QueueName,omitnil,omitempty" name:"QueueName"` - // CMQ 主题或 TDMQ CMQ 主题名。 + // TDMQ CMQ 主题名。[原CMQ已下线](https://cloud.tencent.com/document/product/1496/83970)，目前仅推荐使用 TDMQ CMQ。该参数仅在 `TargetType ` 为 `TDMQ_CMQ_TOPIC ` 时生效。 TopicName *string `json:"TopicName,omitnil,omitempty" name:"TopicName"` } @@ -5165,10 +5266,10 @@ func (r *ModifyNotificationConfigurationResponse) FromJsonString(s string) error // Predefined struct for user type ModifyScalingPolicyRequestParams struct { - // 告警策略ID。 + // 告警策略ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) ，取返回信息中的 AutoScalingPolicyId 获取告警策略ID。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` - // 告警策略名称。 + // 告警策略名称，在您账号中必须唯一。名称长度不能超过60，名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点。 ScalingPolicyName *string `json:"ScalingPolicyName,omitnil,omitempty" name:"ScalingPolicyName"` // 告警触发后，期望实例数修改方式，仅适用于简单策略。取值范围：
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
  • EXACT_CAPACITY：调整至指定期望实例数
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • @@ -5203,10 +5304,10 @@ type ModifyScalingPolicyRequestParams struct { type ModifyScalingPolicyRequest struct { *tchttp.BaseRequest - // 告警策略ID。 + // 告警策略ID。可通过登录 [控制台](https://console.cloud.tencent.com/autoscaling/group) 或调用接口 [DescribeScalingPolicies](https://cloud.tencent.com/document/api/377/33178) ，取返回信息中的 AutoScalingPolicyId 获取告警策略ID。 AutoScalingPolicyId *string `json:"AutoScalingPolicyId,omitnil,omitempty" name:"AutoScalingPolicyId"` - // 告警策略名称。 + // 告警策略名称，在您账号中必须唯一。名称长度不能超过60，名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点。 ScalingPolicyName *string `json:"ScalingPolicyName,omitnil,omitempty" name:"ScalingPolicyName"` // 告警触发后，期望实例数修改方式，仅适用于简单策略。取值范围：
  • CHANGE_IN_CAPACITY：增加或减少若干期望实例数
  • EXACT_CAPACITY：调整至指定期望实例数
  • PERCENT_CHANGE_IN_CAPACITY：按百分比调整期望实例数
    • @@ -5394,8 +5495,8 @@ func (r *ModifyScheduledActionResponse) FromJsonString(s string) error { type NotificationTarget struct { // 目标类型，取值范围包括`CMQ_QUEUE`、`CMQ_TOPIC`、`TDMQ_CMQ_QUEUE`、`TDMQ_CMQ_TOPIC`。 - //
  • CMQ_QUEUE，指腾讯云消息队列-队列模型。
    • - //
  • CMQ_TOPIC，指腾讯云消息队列-主题模型。
    • + //
  • CMQ_QUEUE，指腾讯云消息队列-队列模型，对应产品已下线，[建议切换](https://cloud.tencent.com/document/product/1496/83970) TDMQ_CMQ_QUEUE 使用。
    • + //
  • CMQ_TOPIC，指腾讯云消息队列-主题模型，对应产品已下线，[建议切换](https://cloud.tencent.com/document/product/1496/83970) TDMQ_CMQ_TOPIC 使用。
    • //
  • TDMQ_CMQ_QUEUE，指腾讯云 TDMQ 消息队列-队列模型。
    • //
  • TDMQ_CMQ_TOPIC，指腾讯云 TDMQ 消息队列-主题模型。
    • TargetType *string `json:"TargetType,omitnil,omitempty" name:"TargetType"` @@ -5420,7 +5521,9 @@ type RefreshActivity struct { // 刷新批次信息列表。 RefreshBatchSet []*RefreshBatch `json:"RefreshBatchSet,omitnil,omitempty" name:"RefreshBatchSet"` - // 刷新模式。 + // 刷新模式。取值范围如下： + //
  • ROLLING_UPDATE_RESET：重装系统进行滚动更新
    • + //
  • ROLLING_UPDATE_REPLACE：新建实例替换进行滚动更新，该模式暂不支持回滚接口
    • RefreshMode *string `json:"RefreshMode,omitnil,omitempty" name:"RefreshMode"` // 实例更新设置参数。 @@ -5445,15 +5548,15 @@ type RefreshActivity struct { // 当前刷新批次序号。例如，2 表示当前活动正在刷新第二批次的实例。 CurrentRefreshBatchNum *uint64 `json:"CurrentRefreshBatchNum,omitnil,omitempty" name:"CurrentRefreshBatchNum"` - // 刷新活动开始时间。 + // 刷新活动开始时间，为标准 `UTC` 时间，格式形如 `YYYY-MM-DDTHH:mm:ssZ`。 // 注意：此字段可能返回 null，表示取不到有效值。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 刷新活动结束时间。 + // 刷新活动结束时间，为标准 `UTC` 时间，格式形如 `YYYY-MM-DDTHH:mm:ssZ`。 // 注意：此字段可能返回 null，表示取不到有效值。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 刷新活动创建时间。 + // 刷新活动创建时间，为标准 `UTC` 时间，格式形如 `YYYY-MM-DDTHH:mm:ssZ`。 CreatedTime *string `json:"CreatedTime,omitnil,omitempty" name:"CreatedTime"` } @@ -5497,6 +5600,9 @@ type RefreshSettings struct { // 实例后端服务健康状态检查，默认为 FALSE。仅针对绑定应用型负载均衡器的伸缩组生效，开启该检查后，如刷新后实例未通过检查，负载均衡器端口权重始终为 0，且标记为刷新失败。取值范围如下：
  • TRUE：开启检查
  • FALSE：不开启检查
    • CheckInstanceTargetHealth *bool `json:"CheckInstanceTargetHealth,omitnil,omitempty" name:"CheckInstanceTargetHealth"` + + // 实例后端服务健康状态检查的超时时间，单位为秒，取值范围[60,7200]，默认时间1800秒。仅在CheckInstanceTargetHealth参数开启后生效，若实例健康检查超时，则标记为刷新失败。 + CheckInstanceTargetHealthTimeout *uint64 `json:"CheckInstanceTargetHealthTimeout,omitnil,omitempty" name:"CheckInstanceTargetHealthTimeout"` } type RelatedInstance struct { @@ -5933,7 +6039,7 @@ type ScalingPolicy struct { // 告警触发后，期望实例数的调整值，仅适用于简单策略。 AdjustmentValue *int64 `json:"AdjustmentValue,omitnil,omitempty" name:"AdjustmentValue"` - // 冷却时间，仅适用于简单策略。 + // 冷却时间，单位为秒，仅适用于简单策略。取值范围 [0,3600]，默认冷却时间300秒。 Cooldown *uint64 `json:"Cooldown,omitnil,omitempty" name:"Cooldown"` // 简单告警触发策略告警监控指标，仅适用于简单策略。 @@ -6217,7 +6323,7 @@ type StartInstanceRefreshRequestParams struct { // 刷新设置。 RefreshSettings *RefreshSettings `json:"RefreshSettings,omitnil,omitempty" name:"RefreshSettings"` - // 刷新模式。取值范围： + // 刷新模式。默认值为 ROLLING_UPDATE_RESET，取值范围： //
  • ROLLING_UPDATE_RESET：重装系统进行滚动更新
    • //
  • ROLLING_UPDATE_REPLACE：新建实例替换进行滚动更新，该模式暂不支持回滚接口
    • RefreshMode *string `json:"RefreshMode,omitnil,omitempty" name:"RefreshMode"` @@ -6232,7 +6338,7 @@ type StartInstanceRefreshRequest struct { // 刷新设置。 RefreshSettings *RefreshSettings `json:"RefreshSettings,omitnil,omitempty" name:"RefreshSettings"` - // 刷新模式。取值范围： + // 刷新模式。默认值为 ROLLING_UPDATE_RESET，取值范围： //
  • ROLLING_UPDATE_RESET：重装系统进行滚动更新
    • //
  • ROLLING_UPDATE_REPLACE：新建实例替换进行滚动更新，该模式暂不支持回滚接口
    • RefreshMode *string `json:"RefreshMode,omitnil,omitempty" name:"RefreshMode"` @@ -6441,6 +6547,9 @@ type SystemDisk struct { //
  • CLOUD_BASIC：普通云硬盘
    • //
  • CLOUD_PREMIUM：高性能云硬盘
    • //
  • CLOUD_SSD：SSD云硬盘
    • + //
  • CLOUD_BSSD：通用型SSD云硬盘
    • + //
  • CLOUD_HSSD：增强型SSD云硬盘
    • + //
  • CLOUD_TSSD：极速型SSD云硬盘
    • //
  • 默认取值：CLOUD_PREMIUM。
    • DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` @@ -6455,15 +6564,15 @@ type Tag struct { // 标签值 Value *string `json:"Value,omitnil,omitempty" name:"Value"` - // 标签绑定的资源类型，当前支持类型："auto-scaling-group", "launch-configuration" + // 标签绑定的资源类型，当前支持类型："auto-scaling-group", "launch-configuration"。分别表示：伸缩组资源，启动配置资源。 ResourceType *string `json:"ResourceType,omitnil,omitempty" name:"ResourceType"` } type TargetAttribute struct { - // 端口 + // 端口。取值范围为 [1,65535]。作为入参时，该参数必填。 Port *uint64 `json:"Port,omitnil,omitempty" name:"Port"` - // 权重 + // 权重。取值范围为 [0,100]。作为入参时，该参数必填。 Weight *uint64 `json:"Weight,omitnil,omitempty" name:"Weight"` } diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/http/request.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/http/request.go index 50786de631..09848538b8 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/http/request.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/http/request.go @@ -265,7 +265,7 @@ func CompleteCommonParams(request Request, region string, requestClient string) params["Action"] = request.GetAction() params["Timestamp"] = strconv.FormatInt(time.Now().Unix(), 10) params["Nonce"] = strconv.Itoa(rand.Int()) - params["RequestClient"] = "SDK_GO_1.0.1196" + params["RequestClient"] = "SDK_GO_1.0.1211" if requestClient != "" { params["RequestClient"] += ": " + requestClient } diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/client.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/client.go index 1e750ef206..8cb94ceec5 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/client.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/client.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -1178,6 +1178,8 @@ func NewCreateLaunchTemplateVersionResponse() (response *CreateLaunchTemplateVer // CreateLaunchTemplateVersion // 本接口（CreateLaunchTemplateVersion）根据指定的实例模板ID以及对应的模板版本号创建新的实例启动模板，若未指定模板版本号则使用默认版本号。每个实例启动模板最多创建30个版本。 // +// * 新实例模板中未显式指定的参数值，使用指定版本号对应参数值覆盖。 +// // 可能返回的错误码: // AUTHFAILURE_CAMROLENAMEAUTHENTICATEFAILED = "AuthFailure.CamRoleNameAuthenticateFailed" // FAILEDOPERATION_DISASTERRECOVERGROUPNOTFOUND = "FailedOperation.DisasterRecoverGroupNotFound" @@ -1262,6 +1264,8 @@ func (c *Client) CreateLaunchTemplateVersion(request *CreateLaunchTemplateVersio // CreateLaunchTemplateVersion // 本接口（CreateLaunchTemplateVersion）根据指定的实例模板ID以及对应的模板版本号创建新的实例启动模板，若未指定模板版本号则使用默认版本号。每个实例启动模板最多创建30个版本。 // +// * 新实例模板中未显式指定的参数值，使用指定版本号对应参数值覆盖。 +// // 可能返回的错误码: // AUTHFAILURE_CAMROLENAMEAUTHENTICATEFAILED = "AuthFailure.CamRoleNameAuthenticateFailed" // FAILEDOPERATION_DISASTERRECOVERGROUPNOTFOUND = "FailedOperation.DisasterRecoverGroupNotFound" @@ -8781,12 +8785,15 @@ func NewRunInstancesResponse() (response *RunInstancesResponse) { // INVALIDPARAMETERVALUE_DEDICATEDCLUSTERNOTSUPPORTEDCHARGETYPE = "InvalidParameterValue.DedicatedClusterNotSupportedChargeType" // INVALIDPARAMETERVALUE_DUPLICATE = "InvalidParameterValue.Duplicate" // INVALIDPARAMETERVALUE_DUPLICATETAGS = "InvalidParameterValue.DuplicateTags" +// INVALIDPARAMETERVALUE_ELASTICNETWORKNOTEXIST = "InvalidParameterValue.ElasticNetworkNotExist" +// INVALIDPARAMETERVALUE_ELASTICNETWORKVPCSUBNETMISMATCH = "InvalidParameterValue.ElasticNetworkVpcSubnetMismatch" // INVALIDPARAMETERVALUE_EXTERNALIPQUOTALIMITED = "InvalidParameterValue.ExternalIpQuotaLimited" // INVALIDPARAMETERVALUE_HPCCLUSTERIDZONEIDNOTMATCH = "InvalidParameterValue.HpcClusterIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_IPADDRESSMALFORMED = "InvalidParameterValue.IPAddressMalformed" // INVALIDPARAMETERVALUE_ILLEGALHOSTNAME = "InvalidParameterValue.IllegalHostName" // INVALIDPARAMETERVALUE_INCORRECTFORMAT = "InvalidParameterValue.IncorrectFormat" // INVALIDPARAMETERVALUE_INSTANCETYPENOTFOUND = "InvalidParameterValue.InstanceTypeNotFound" +// INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTELASTICNETWORKS = "InvalidParameterValue.InstanceTypeNotSupportElasticNetworks" // INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTHPCCLUSTER = "InvalidParameterValue.InstanceTypeNotSupportHpcCluster" // INVALIDPARAMETERVALUE_INSTANCETYPEREQUIREDHPCCLUSTER = "InvalidParameterValue.InstanceTypeRequiredHpcCluster" // INVALIDPARAMETERVALUE_INSUFFICIENTOFFERING = "InvalidParameterValue.InsufficientOffering" @@ -8798,9 +8805,11 @@ func NewRunInstancesResponse() (response *RunInstancesResponse) { // INVALIDPARAMETERVALUE_INVALIDIMAGEOSNAME = "InvalidParameterValue.InvalidImageOsName" // INVALIDPARAMETERVALUE_INVALIDIMAGESTATE = "InvalidParameterValue.InvalidImageState" // INVALIDPARAMETERVALUE_INVALIDIPFORMAT = "InvalidParameterValue.InvalidIpFormat" +// INVALIDPARAMETERVALUE_INVALIDNETWORKINTERFACEID = "InvalidParameterValue.InvalidNetworkInterfaceId" // INVALIDPARAMETERVALUE_INVALIDPASSWORD = "InvalidParameterValue.InvalidPassword" // INVALIDPARAMETERVALUE_INVALIDTIMEFORMAT = "InvalidParameterValue.InvalidTimeFormat" // INVALIDPARAMETERVALUE_INVALIDUSERDATAFORMAT = "InvalidParameterValue.InvalidUserDataFormat" +// INVALIDPARAMETERVALUE_INVALIDVPCIDSUBNETIDNOTFOUND = "InvalidParameterValue.InvalidVpcIdSubnetIdNotFound" // INVALIDPARAMETERVALUE_ISPNOTSUPPORTFOREDGEZONE = "InvalidParameterValue.IspNotSupportForEdgeZone" // INVALIDPARAMETERVALUE_ISPVALUEREPEATED = "InvalidParameterValue.IspValueRepeated" // INVALIDPARAMETERVALUE_KEYPAIRNOTFOUND = "InvalidParameterValue.KeyPairNotFound" @@ -8810,10 +8819,12 @@ func NewRunInstancesResponse() (response *RunInstancesResponse) { // INVALIDPARAMETERVALUE_LAUNCHTEMPLATEVERSION = "InvalidParameterValue.LaunchTemplateVersion" // INVALIDPARAMETERVALUE_LIMITEXCEEDED = "InvalidParameterValue.LimitExceeded" // INVALIDPARAMETERVALUE_MUSTDHCPENABLEDVPC = "InvalidParameterValue.MustDhcpEnabledVpc" +// INVALIDPARAMETERVALUE_MUSTENABLEDISRDMA = "InvalidParameterValue.MustEnabledIsRdma" // INVALIDPARAMETERVALUE_NOTCDCSUBNET = "InvalidParameterValue.NotCdcSubnet" // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SNAPSHOTIDMALFORMED = "InvalidParameterValue.SnapshotIdMalformed" // INVALIDPARAMETERVALUE_SUBNETIDMALFORMED = "InvalidParameterValue.SubnetIdMalformed" +// INVALIDPARAMETERVALUE_SUBNETIDZONEIDNOTMATCH = "InvalidParameterValue.SubnetIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_SUBNETNOTEXIST = "InvalidParameterValue.SubnetNotExist" // INVALIDPARAMETERVALUE_TAGKEYNOTFOUND = "InvalidParameterValue.TagKeyNotFound" // INVALIDPARAMETERVALUE_TAGQUOTALIMITEXCEEDED = "InvalidParameterValue.TagQuotaLimitExceeded" @@ -8821,6 +8832,7 @@ func NewRunInstancesResponse() (response *RunInstancesResponse) { // INVALIDPARAMETERVALUE_TOOLARGE = "InvalidParameterValue.TooLarge" // INVALIDPARAMETERVALUE_VPCIDMALFORMED = "InvalidParameterValue.VpcIdMalformed" // INVALIDPARAMETERVALUE_VPCIDNOTEXIST = "InvalidParameterValue.VpcIdNotExist" +// INVALIDPARAMETERVALUE_VPCIDSUBNETIDNOTMATCH = "InvalidParameterValue.VpcIdSubnetIdNotMatch" // INVALIDPARAMETERVALUE_VPCIDZONEIDNOTMATCH = "InvalidParameterValue.VpcIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_VPCNOTSUPPORTIPV6ADDRESS = "InvalidParameterValue.VpcNotSupportIpv6Address" // INVALIDPARAMETERVALUE_ZONENOTSUPPORTED = "InvalidParameterValue.ZoneNotSupported" @@ -8866,6 +8878,7 @@ func NewRunInstancesResponse() (response *RunInstancesResponse) { // UNSUPPORTEDOPERATION_BANDWIDTHPACKAGEIDNOTSUPPORTED = "UnsupportedOperation.BandwidthPackageIdNotSupported" // UNSUPPORTEDOPERATION_HIBERNATIONOSVERSION = "UnsupportedOperation.HibernationOsVersion" // UNSUPPORTEDOPERATION_INSTANCESTATEISOLATING = "UnsupportedOperation.InstanceStateIsolating" +// UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTCONFIDENTIALITY = "UnsupportedOperation.InstanceTypeNotSupportConfidentiality" // UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTGRIDLICENCE = "UnsupportedOperation.InstanceTypeNotSupportGridLicence" // UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTJUMBOFRAME = "UnsupportedOperation.InstanceTypeNotSupportJumboFrame" // UNSUPPORTEDOPERATION_INSTANCESENABLEJUMBOWITHOUTREBOOT = "UnsupportedOperation.InstancesEnableJumboWithoutReboot" @@ -8953,12 +8966,15 @@ func (c *Client) RunInstances(request *RunInstancesRequest) (response *RunInstan // INVALIDPARAMETERVALUE_DEDICATEDCLUSTERNOTSUPPORTEDCHARGETYPE = "InvalidParameterValue.DedicatedClusterNotSupportedChargeType" // INVALIDPARAMETERVALUE_DUPLICATE = "InvalidParameterValue.Duplicate" // INVALIDPARAMETERVALUE_DUPLICATETAGS = "InvalidParameterValue.DuplicateTags" +// INVALIDPARAMETERVALUE_ELASTICNETWORKNOTEXIST = "InvalidParameterValue.ElasticNetworkNotExist" +// INVALIDPARAMETERVALUE_ELASTICNETWORKVPCSUBNETMISMATCH = "InvalidParameterValue.ElasticNetworkVpcSubnetMismatch" // INVALIDPARAMETERVALUE_EXTERNALIPQUOTALIMITED = "InvalidParameterValue.ExternalIpQuotaLimited" // INVALIDPARAMETERVALUE_HPCCLUSTERIDZONEIDNOTMATCH = "InvalidParameterValue.HpcClusterIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_IPADDRESSMALFORMED = "InvalidParameterValue.IPAddressMalformed" // INVALIDPARAMETERVALUE_ILLEGALHOSTNAME = "InvalidParameterValue.IllegalHostName" // INVALIDPARAMETERVALUE_INCORRECTFORMAT = "InvalidParameterValue.IncorrectFormat" // INVALIDPARAMETERVALUE_INSTANCETYPENOTFOUND = "InvalidParameterValue.InstanceTypeNotFound" +// INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTELASTICNETWORKS = "InvalidParameterValue.InstanceTypeNotSupportElasticNetworks" // INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTHPCCLUSTER = "InvalidParameterValue.InstanceTypeNotSupportHpcCluster" // INVALIDPARAMETERVALUE_INSTANCETYPEREQUIREDHPCCLUSTER = "InvalidParameterValue.InstanceTypeRequiredHpcCluster" // INVALIDPARAMETERVALUE_INSUFFICIENTOFFERING = "InvalidParameterValue.InsufficientOffering" @@ -8970,9 +8986,11 @@ func (c *Client) RunInstances(request *RunInstancesRequest) (response *RunInstan // INVALIDPARAMETERVALUE_INVALIDIMAGEOSNAME = "InvalidParameterValue.InvalidImageOsName" // INVALIDPARAMETERVALUE_INVALIDIMAGESTATE = "InvalidParameterValue.InvalidImageState" // INVALIDPARAMETERVALUE_INVALIDIPFORMAT = "InvalidParameterValue.InvalidIpFormat" +// INVALIDPARAMETERVALUE_INVALIDNETWORKINTERFACEID = "InvalidParameterValue.InvalidNetworkInterfaceId" // INVALIDPARAMETERVALUE_INVALIDPASSWORD = "InvalidParameterValue.InvalidPassword" // INVALIDPARAMETERVALUE_INVALIDTIMEFORMAT = "InvalidParameterValue.InvalidTimeFormat" // INVALIDPARAMETERVALUE_INVALIDUSERDATAFORMAT = "InvalidParameterValue.InvalidUserDataFormat" +// INVALIDPARAMETERVALUE_INVALIDVPCIDSUBNETIDNOTFOUND = "InvalidParameterValue.InvalidVpcIdSubnetIdNotFound" // INVALIDPARAMETERVALUE_ISPNOTSUPPORTFOREDGEZONE = "InvalidParameterValue.IspNotSupportForEdgeZone" // INVALIDPARAMETERVALUE_ISPVALUEREPEATED = "InvalidParameterValue.IspValueRepeated" // INVALIDPARAMETERVALUE_KEYPAIRNOTFOUND = "InvalidParameterValue.KeyPairNotFound" @@ -8982,10 +9000,12 @@ func (c *Client) RunInstances(request *RunInstancesRequest) (response *RunInstan // INVALIDPARAMETERVALUE_LAUNCHTEMPLATEVERSION = "InvalidParameterValue.LaunchTemplateVersion" // INVALIDPARAMETERVALUE_LIMITEXCEEDED = "InvalidParameterValue.LimitExceeded" // INVALIDPARAMETERVALUE_MUSTDHCPENABLEDVPC = "InvalidParameterValue.MustDhcpEnabledVpc" +// INVALIDPARAMETERVALUE_MUSTENABLEDISRDMA = "InvalidParameterValue.MustEnabledIsRdma" // INVALIDPARAMETERVALUE_NOTCDCSUBNET = "InvalidParameterValue.NotCdcSubnet" // INVALIDPARAMETERVALUE_RANGE = "InvalidParameterValue.Range" // INVALIDPARAMETERVALUE_SNAPSHOTIDMALFORMED = "InvalidParameterValue.SnapshotIdMalformed" // INVALIDPARAMETERVALUE_SUBNETIDMALFORMED = "InvalidParameterValue.SubnetIdMalformed" +// INVALIDPARAMETERVALUE_SUBNETIDZONEIDNOTMATCH = "InvalidParameterValue.SubnetIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_SUBNETNOTEXIST = "InvalidParameterValue.SubnetNotExist" // INVALIDPARAMETERVALUE_TAGKEYNOTFOUND = "InvalidParameterValue.TagKeyNotFound" // INVALIDPARAMETERVALUE_TAGQUOTALIMITEXCEEDED = "InvalidParameterValue.TagQuotaLimitExceeded" @@ -8993,6 +9013,7 @@ func (c *Client) RunInstances(request *RunInstancesRequest) (response *RunInstan // INVALIDPARAMETERVALUE_TOOLARGE = "InvalidParameterValue.TooLarge" // INVALIDPARAMETERVALUE_VPCIDMALFORMED = "InvalidParameterValue.VpcIdMalformed" // INVALIDPARAMETERVALUE_VPCIDNOTEXIST = "InvalidParameterValue.VpcIdNotExist" +// INVALIDPARAMETERVALUE_VPCIDSUBNETIDNOTMATCH = "InvalidParameterValue.VpcIdSubnetIdNotMatch" // INVALIDPARAMETERVALUE_VPCIDZONEIDNOTMATCH = "InvalidParameterValue.VpcIdZoneIdNotMatch" // INVALIDPARAMETERVALUE_VPCNOTSUPPORTIPV6ADDRESS = "InvalidParameterValue.VpcNotSupportIpv6Address" // INVALIDPARAMETERVALUE_ZONENOTSUPPORTED = "InvalidParameterValue.ZoneNotSupported" @@ -9038,6 +9059,7 @@ func (c *Client) RunInstances(request *RunInstancesRequest) (response *RunInstan // UNSUPPORTEDOPERATION_BANDWIDTHPACKAGEIDNOTSUPPORTED = "UnsupportedOperation.BandwidthPackageIdNotSupported" // UNSUPPORTEDOPERATION_HIBERNATIONOSVERSION = "UnsupportedOperation.HibernationOsVersion" // UNSUPPORTEDOPERATION_INSTANCESTATEISOLATING = "UnsupportedOperation.InstanceStateIsolating" +// UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTCONFIDENTIALITY = "UnsupportedOperation.InstanceTypeNotSupportConfidentiality" // UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTGRIDLICENCE = "UnsupportedOperation.InstanceTypeNotSupportGridLicence" // UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTJUMBOFRAME = "UnsupportedOperation.InstanceTypeNotSupportJumboFrame" // UNSUPPORTEDOPERATION_INSTANCESENABLEJUMBOWITHOUTREBOOT = "UnsupportedOperation.InstancesEnableJumboWithoutReboot" diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/errors.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/errors.go index b341628e51..36e369214f 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/errors.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/errors.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -395,6 +395,12 @@ const ( // 重复标签。 INVALIDPARAMETERVALUE_DUPLICATETAGS = "InvalidParameterValue.DuplicateTags" + // 弹性网卡数据不存在 + INVALIDPARAMETERVALUE_ELASTICNETWORKNOTEXIST = "InvalidParameterValue.ElasticNetworkNotExist" + + // 弹性网卡数据vpc子网不匹配,必须为同vpc不同子网 + INVALIDPARAMETERVALUE_ELASTICNETWORKVPCSUBNETMISMATCH = "InvalidParameterValue.ElasticNetworkVpcSubnetMismatch" + // 实例的申请的外网IP个数超过了这种规格实例的外网ip配额。 INVALIDPARAMETERVALUE_EXTERNALIPQUOTALIMITED = "InvalidParameterValue.ExternalIpQuotaLimited" @@ -428,6 +434,9 @@ const ( // 指定机型不存在 INVALIDPARAMETERVALUE_INSTANCETYPENOTFOUND = "InvalidParameterValue.InstanceTypeNotFound" + // 实例类型不支持弹性网卡数据 + INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTELASTICNETWORKS = "InvalidParameterValue.InstanceTypeNotSupportElasticNetworks" + // 实例类型不可加入高性能计算集群。 INVALIDPARAMETERVALUE_INSTANCETYPENOTSUPPORTHPCCLUSTER = "InvalidParameterValue.InstanceTypeNotSupportHpcCluster" @@ -500,6 +509,9 @@ const ( // 许可证类型不可用。 INVALIDPARAMETERVALUE_INVALIDLICENSETYPE = "InvalidParameterValue.InvalidLicenseType" + // 指定的弹性网卡id非vrdma网卡 + INVALIDPARAMETERVALUE_INVALIDNETWORKINTERFACEID = "InvalidParameterValue.InvalidNetworkInterfaceId" + // 参数值错误。 INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUELIMIT = "InvalidParameterValue.InvalidParameterValueLimit" @@ -518,6 +530,9 @@ const ( // 无效的模糊查询字符串。 INVALIDPARAMETERVALUE_INVALIDVAGUENAME = "InvalidParameterValue.InvalidVagueName" + // 这个特别的VpcId or SubnetId在弹性网库数据结构未发现 + INVALIDPARAMETERVALUE_INVALIDVPCIDSUBNETIDNOTFOUND = "InvalidParameterValue.InvalidVpcIdSubnetIdNotFound" + // 边缘可用区不支持这个运营商。 INVALIDPARAMETERVALUE_ISPNOTSUPPORTFOREDGEZONE = "InvalidParameterValue.IspNotSupportForEdgeZone" @@ -560,6 +575,9 @@ const ( // 参数值必须为开启DHCP的VPC INVALIDPARAMETERVALUE_MUSTDHCPENABLEDVPC = "InvalidParameterValue.MustDhcpEnabledVpc" + // 参数值必须为开启弹性rdma接口 + INVALIDPARAMETERVALUE_MUSTENABLEDISRDMA = "InvalidParameterValue.MustEnabledIsRdma" + // 子网不属于该cdc集群。 INVALIDPARAMETERVALUE_NOTCDCSUBNET = "InvalidParameterValue.NotCdcSubnet" @@ -590,6 +608,9 @@ const ( // 子网ID不合要求，请提供规范的子网ID，类似subnet-xxxxxxxx，字母x代表小写字符或者数字 INVALIDPARAMETERVALUE_SUBNETIDMALFORMED = "InvalidParameterValue.SubnetIdMalformed" + // 子网ID所在可用区与实例所在区不匹配。 + INVALIDPARAMETERVALUE_SUBNETIDZONEIDNOTMATCH = "InvalidParameterValue.SubnetIdZoneIdNotMatch" + // 创建失败，您指定的子网不存在，请您重新指定 INVALIDPARAMETERVALUE_SUBNETNOTEXIST = "InvalidParameterValue.SubnetNotExist" @@ -617,6 +638,9 @@ const ( // 指定的VpcId不存在。 INVALIDPARAMETERVALUE_VPCIDNOTEXIST = "InvalidParameterValue.VpcIdNotExist" + // 指定的VpcId和SubnetId不匹配。 + INVALIDPARAMETERVALUE_VPCIDSUBNETIDNOTMATCH = "InvalidParameterValue.VpcIdSubnetIdNotMatch" + // VPC网络与实例不在同一可用区 INVALIDPARAMETERVALUE_VPCIDZONEIDNOTMATCH = "InvalidParameterValue.VpcIdZoneIdNotMatch" @@ -995,6 +1019,9 @@ const ( // 请求不支持正在销毁的实例 UNSUPPORTEDOPERATION_INSTANCESTATETERMINATING = "UnsupportedOperation.InstanceStateTerminating" + // 实例类型不支持设置`Confidentiality` 状态 + UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTCONFIDENTIALITY = "UnsupportedOperation.InstanceTypeNotSupportConfidentiality" + // 实例类型不支持设置`GridDriverService` 状态 UNSUPPORTEDOPERATION_INSTANCETYPENOTSUPPORTGRIDLICENCE = "UnsupportedOperation.InstanceTypeNotSupportGridLicence" diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/models.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/models.go index 3373f7d4b4..132db3b252 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/models.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312/models.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -1075,7 +1075,7 @@ func (r *CreateImageResponse) FromJsonString(s string) error { // Predefined struct for user type CreateKeyPairRequestParams struct { - // 密钥对名称，可由数字，字母和下划线组成，长度不超过25个字符。 + // 密钥对名称，可由数字、字母和下划线组成，长度不超过25个字符。密钥对名称不能和已经存在的密钥对名称重复。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` // 密钥对创建后所属的项目ID，ProjectId为0表示默认项目。 @@ -1091,7 +1091,7 @@ type CreateKeyPairRequestParams struct { type CreateKeyPairRequest struct { *tchttp.BaseRequest - // 密钥对名称，可由数字，字母和下划线组成，长度不超过25个字符。 + // 密钥对名称，可由数字、字母和下划线组成，长度不超过25个字符。密钥对名称不能和已经存在的密钥对名称重复。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` // 密钥对创建后所属的项目ID，ProjectId为0表示默认项目。 @@ -1161,7 +1161,7 @@ type CreateLaunchTemplateRequestParams struct { // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-xxx`。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，传入InstanceType获取当前机型支持的镜像列表，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` - // 实例启动模板版本描述。长度为2~256个英文或中文字符。 + // 实例启动模板版本描述。长度为2~256个英文或中文字符，默认为空字符。 LaunchTemplateVersionDescription *string `json:"LaunchTemplateVersionDescription,omitnil,omitempty" name:"LaunchTemplateVersionDescription"` // 实例机型。不同实例机型指定了不同的资源规格。 @@ -1171,7 +1171,7 @@ type CreateLaunchTemplateRequestParams struct { // 实例系统盘配置信息。若不指定该参数，则按照系统默认值进行分配。 SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` - // 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘。支持购买的时候指定21块数据盘，其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘，最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 + // 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘。支持购买的时候指定21块数据盘，其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘，最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘，详情请参考[ 云硬盘使用限制](https://cloud.tencent.com/document/product/362/5145)。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` // 私有网络相关信息配置。通过该参数可以指定私有网络的ID，子网ID等信息。若不指定该参数，则默认使用基础网络。若在此参数中指定了私有网络IP，即表示每个实例的主网卡IP；同时，InstanceCount参数必须与私有网络IP的个数一致且不能大于20。 @@ -1180,7 +1180,7 @@ type CreateLaunchTemplateRequestParams struct { // 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 InternetAccessible *InternetAccessible `json:"InternetAccessible,omitnil,omitempty" name:"InternetAccessible"` - // 购买实例数量。包年包月实例取值范围：[1，300]，按量计费实例取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 + // 购买实例数量。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 InstanceCount *int64 `json:"InstanceCount,omitnil,omitempty" name:"InstanceCount"` // 实例显示名称。
  • 不指定实例显示名称则默认显示‘未命名’。
  • 购买多台实例，如果指定模式串`{R:x}`，表示生成数字`[x, x+n-1]`，其中`n`表示购买实例的数量，例如`server_{R:3}`，购买1台时，实例显示名称为`server_3`；购买2台时，实例显示名称分别为`server_3`，`server_4`。支持指定多个模式串`{R:x}`。
  • 购买多台实例，如果不指定模式串，则在实例显示名称添加后缀`1、2...n`，其中`n`表示购买实例的数量，例如`server_`，购买2台时，实例显示名称分别为`server_1`，`server_2`。
  • 最多支持128个字符（包含模式串）。
    • @@ -1189,7 +1189,7 @@ type CreateLaunchTemplateRequestParams struct { // 实例登录设置。通过该参数可以设置实例的登录方式为密钥或保持镜像的原始登录设置。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的sgId字段来获取。若不指定该参数，则绑定默认安全组。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认公共镜像开启云监控、云安全服务；自定义镜像与镜像市场镜像默认不开启云监控，云安全服务，而使用镜像里保留的服务。 @@ -1204,7 +1204,7 @@ type CreateLaunchTemplateRequestParams struct { // 定时任务。通过该参数可以为实例指定定时任务，目前仅支持定时销毁。 ActionTimer *ActionTimer `json:"ActionTimer,omitnil,omitempty" name:"ActionTimer"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。该参数可以通过调用 [ DescribeDisasterRecoverGroups ](https://cloud.tencent.com/document/api/213/17810) 的返回值中的 `DisasterRecoverGroupId` 字段来获取。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云服务器实例。 @@ -1223,10 +1223,10 @@ type CreateLaunchTemplateRequestParams struct { // false（默认）：发送正常请求，通过检查后直接创建实例。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)接口返回值中的`RoleName `获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 + // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。该参数可以通过调用 [DescribeHpcClusters](https://cloud.tencent.com/document/api/213/83220) 的返回值中的 `HpcClusterId` 字段来获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // 实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID：预付费，即包年包月
  • POSTPAID_BY_HOUR：按小时后付费
  • CDHPAID：独享子机（基于专用宿主机创建，宿主机部分的资源不收费）
  • SPOTPAID：竞价付费
    • 默认值：POSTPAID_BY_HOUR。 @@ -1240,6 +1240,17 @@ type CreateLaunchTemplateRequestParams struct { // 标签描述列表。通过指定该参数可以绑定标签到实例启动模板。 LaunchTemplateTagSpecification []*TagSpecification `json:"LaunchTemplateTagSpecification,omitnil,omitempty" name:"LaunchTemplateTagSpecification"` + + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + + // 只允许传递 Update 和 Replace 参数，在模板使用自定义 Metadata 且在 RunInstances 也传递 Metadata 时生效。默认采用 Replace。 + // + // - Update：设模板 t含本参数值为Update、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k1:v1, k2:v3] + // - Replace：模板 t含本参数值为Replace、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k2:v3] + // **注：内测中**。 + TemplateDataModifyAction *string `json:"TemplateDataModifyAction,omitnil,omitempty" name:"TemplateDataModifyAction"` } type CreateLaunchTemplateRequest struct { @@ -1254,7 +1265,7 @@ type CreateLaunchTemplateRequest struct { // 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID，格式形如`img-xxx`。镜像类型分为四种：
  • 公共镜像
  • 自定义镜像
  • 共享镜像
  • 服务市场镜像

    • 可通过以下方式获取可用的镜像ID：
  • `公共镜像`、`自定义镜像`、`共享镜像`的镜像ID可通过登录[控制台](https://console.cloud.tencent.com/cvm/image?rid=1&imageType=PUBLIC_IMAGE)查询；`服务镜像市场`的镜像ID可通过[云市场](https://market.cloud.tencent.com/list)查询。
  • 通过调用接口 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) ，传入InstanceType获取当前机型支持的镜像列表，取返回信息中的`ImageId`字段。
    • ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` - // 实例启动模板版本描述。长度为2~256个英文或中文字符。 + // 实例启动模板版本描述。长度为2~256个英文或中文字符，默认为空字符。 LaunchTemplateVersionDescription *string `json:"LaunchTemplateVersionDescription,omitnil,omitempty" name:"LaunchTemplateVersionDescription"` // 实例机型。不同实例机型指定了不同的资源规格。 @@ -1264,7 +1275,7 @@ type CreateLaunchTemplateRequest struct { // 实例系统盘配置信息。若不指定该参数，则按照系统默认值进行分配。 SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` - // 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘。支持购买的时候指定21块数据盘，其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘，最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 + // 实例数据盘配置信息。若不指定该参数，则默认不购买数据盘。支持购买的时候指定21块数据盘，其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘，最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘，详情请参考[ 云硬盘使用限制](https://cloud.tencent.com/document/product/362/5145)。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` // 私有网络相关信息配置。通过该参数可以指定私有网络的ID，子网ID等信息。若不指定该参数，则默认使用基础网络。若在此参数中指定了私有网络IP，即表示每个实例的主网卡IP；同时，InstanceCount参数必须与私有网络IP的个数一致且不能大于20。 @@ -1273,7 +1284,7 @@ type CreateLaunchTemplateRequest struct { // 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 InternetAccessible *InternetAccessible `json:"InternetAccessible,omitnil,omitempty" name:"InternetAccessible"` - // 购买实例数量。包年包月实例取值范围：[1，300]，按量计费实例取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 + // 购买实例数量。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 InstanceCount *int64 `json:"InstanceCount,omitnil,omitempty" name:"InstanceCount"` // 实例显示名称。
  • 不指定实例显示名称则默认显示‘未命名’。
  • 购买多台实例，如果指定模式串`{R:x}`，表示生成数字`[x, x+n-1]`，其中`n`表示购买实例的数量，例如`server_{R:3}`，购买1台时，实例显示名称为`server_3`；购买2台时，实例显示名称分别为`server_3`，`server_4`。支持指定多个模式串`{R:x}`。
  • 购买多台实例，如果不指定模式串，则在实例显示名称添加后缀`1、2...n`，其中`n`表示购买实例的数量，例如`server_`，购买2台时，实例显示名称分别为`server_1`，`server_2`。
  • 最多支持128个字符（包含模式串）。
    • @@ -1282,7 +1293,7 @@ type CreateLaunchTemplateRequest struct { // 实例登录设置。通过该参数可以设置实例的登录方式为密钥或保持镜像的原始登录设置。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的sgId字段来获取。若不指定该参数，则绑定默认安全组。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认公共镜像开启云监控、云安全服务；自定义镜像与镜像市场镜像默认不开启云监控，云安全服务，而使用镜像里保留的服务。 @@ -1297,7 +1308,7 @@ type CreateLaunchTemplateRequest struct { // 定时任务。通过该参数可以为实例指定定时任务，目前仅支持定时销毁。 ActionTimer *ActionTimer `json:"ActionTimer,omitnil,omitempty" name:"ActionTimer"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。该参数可以通过调用 [ DescribeDisasterRecoverGroups ](https://cloud.tencent.com/document/api/213/17810) 的返回值中的 `DisasterRecoverGroupId` 字段来获取。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云服务器实例。 @@ -1316,10 +1327,10 @@ type CreateLaunchTemplateRequest struct { // false（默认）：发送正常请求，通过检查后直接创建实例。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)接口返回值中的`RoleName `获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 + // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。该参数可以通过调用 [DescribeHpcClusters](https://cloud.tencent.com/document/api/213/83220) 的返回值中的 `HpcClusterId` 字段来获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // 实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID：预付费，即包年包月
  • POSTPAID_BY_HOUR：按小时后付费
  • CDHPAID：独享子机（基于专用宿主机创建，宿主机部分的资源不收费）
  • SPOTPAID：竞价付费
    • 默认值：POSTPAID_BY_HOUR。 @@ -1333,6 +1344,17 @@ type CreateLaunchTemplateRequest struct { // 标签描述列表。通过指定该参数可以绑定标签到实例启动模板。 LaunchTemplateTagSpecification []*TagSpecification `json:"LaunchTemplateTagSpecification,omitnil,omitempty" name:"LaunchTemplateTagSpecification"` + + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + + // 只允许传递 Update 和 Replace 参数，在模板使用自定义 Metadata 且在 RunInstances 也传递 Metadata 时生效。默认采用 Replace。 + // + // - Update：设模板 t含本参数值为Update、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k1:v1, k2:v3] + // - Replace：模板 t含本参数值为Replace、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k2:v3] + // **注：内测中**。 + TemplateDataModifyAction *string `json:"TemplateDataModifyAction,omitnil,omitempty" name:"TemplateDataModifyAction"` } func (r *CreateLaunchTemplateRequest) ToJsonString() string { @@ -1375,6 +1397,8 @@ func (r *CreateLaunchTemplateRequest) FromJsonString(s string) error { delete(f, "InstanceChargePrepaid") delete(f, "DisableApiTermination") delete(f, "LaunchTemplateTagSpecification") + delete(f, "Metadata") + delete(f, "TemplateDataModifyAction") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateLaunchTemplateRequest has unknown keys!", "") } @@ -1411,13 +1435,13 @@ type CreateLaunchTemplateVersionRequestParams struct { // 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目，所属宿主机（在专用宿主机上创建子机时指定）等属性。 Placement *Placement `json:"Placement,omitnil,omitempty" name:"Placement"` - // 启动模板ID，新版本将基于该实例启动模板ID创建。 + // 启动模板ID，新版本将基于该实例启动模板ID创建。可通过 [DescribeLaunchTemplates](https://cloud.tencent.com/document/api/213/66322) 接口返回值中的`LaunchTemplateId`获取。 LaunchTemplateId *string `json:"LaunchTemplateId,omitnil,omitempty" name:"LaunchTemplateId"` - // 若给定，新实例启动模板将基于给定的版本号创建。若未指定则使用默认版本。 + // 若给定，新实例启动模板将基于给定的版本号创建。若未指定则使用默认版本,可以通过 [DescribeLaunchTemplateVersions](https://cloud.tencent.com/document/api/213/66323)查询默认版本。 LaunchTemplateVersion *int64 `json:"LaunchTemplateVersion,omitnil,omitempty" name:"LaunchTemplateVersion"` - // 实例启动模板版本描述。长度为2~256个英文或中文字符。 + // 实例启动模板版本描述。长度为2~256个英文或中文字符，不指定该参数时默认为空字符。 LaunchTemplateVersionDescription *string `json:"LaunchTemplateVersionDescription,omitnil,omitempty" name:"LaunchTemplateVersionDescription"` // 实例机型。不同实例机型指定了不同的资源规格。 @@ -1439,7 +1463,7 @@ type CreateLaunchTemplateVersionRequestParams struct { // 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 InternetAccessible *InternetAccessible `json:"InternetAccessible,omitnil,omitempty" name:"InternetAccessible"` - // 购买实例数量。包年包月实例取值范围：[1，300]，按量计费实例取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 + // 购买实例数量。具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 InstanceCount *int64 `json:"InstanceCount,omitnil,omitempty" name:"InstanceCount"` // 实例显示名称。
  • 不指定实例显示名称则默认显示‘未命名’。
  • 购买多台实例，如果指定模式串`{R:x}`，表示生成数字`[x, x+n-1]`，其中`n`表示购买实例的数量，例如`server_{R:3}`，购买1台时，实例显示名称为`server_3`；购买2台时，实例显示名称分别为`server_3`，`server_4`。支持指定多个模式串`{R:x}`。
  • 购买多台实例，如果不指定模式串，则在实例显示名称添加后缀`1、2...n`，其中`n`表示购买实例的数量，例如`server_`，购买2台时，实例显示名称分别为`server_1`，`server_2`。
  • 最多支持128个字符（包含模式串）。
    • @@ -1463,7 +1487,7 @@ type CreateLaunchTemplateVersionRequestParams struct { // 定时任务。通过该参数可以为实例指定定时任务，目前仅支持定时销毁。 ActionTimer *ActionTimer `json:"ActionTimer,omitnil,omitempty" name:"ActionTimer"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。可使用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/api/213/17810)接口获取。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云服务器实例。 @@ -1482,10 +1506,10 @@ type CreateLaunchTemplateVersionRequestParams struct { // false（默认）：发送正常请求，通过检查后直接创建实例。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 + // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。该参数可以通过调用 [DescribeHpcClusters](https://cloud.tencent.com/document/api/213/83220) 的返回值中的 `HpcClusterId` 字段来获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // 实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID：预付费，即包年包月
  • POSTPAID_BY_HOUR：按小时后付费
  • CDHPAID：独享子机（基于专用宿主机创建，宿主机部分的资源不收费）
  • SPOTPAID：竞价付费
    • 默认值：POSTPAID_BY_HOUR。 @@ -1496,6 +1520,17 @@ type CreateLaunchTemplateVersionRequestParams struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • TRUE：表示开启实例保护，不允许通过api接口删除实例

  • FALSE：表示关闭实例保护，允许通过api接口删除实例


    • 默认取值：FALSE。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` + + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + + // 只允许传递 Update 和 Replace 参数，在模板使用自定义 Metadata 且在 RunInstances 也传递 Metadata 时生效。默认采用 Replace。 + // + // - Update：设模板 t含本参数值为Update、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k1:v1, k2:v3] + // - Replace：模板 t含本参数值为Replace、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k2:v3] + // **注：内测中**。 + TemplateDataModifyAction *string `json:"TemplateDataModifyAction,omitnil,omitempty" name:"TemplateDataModifyAction"` } type CreateLaunchTemplateVersionRequest struct { @@ -1504,13 +1539,13 @@ type CreateLaunchTemplateVersionRequest struct { // 实例所在的位置。通过该参数可以指定实例所属可用区，所属项目，所属宿主机（在专用宿主机上创建子机时指定）等属性。 Placement *Placement `json:"Placement,omitnil,omitempty" name:"Placement"` - // 启动模板ID，新版本将基于该实例启动模板ID创建。 + // 启动模板ID，新版本将基于该实例启动模板ID创建。可通过 [DescribeLaunchTemplates](https://cloud.tencent.com/document/api/213/66322) 接口返回值中的`LaunchTemplateId`获取。 LaunchTemplateId *string `json:"LaunchTemplateId,omitnil,omitempty" name:"LaunchTemplateId"` - // 若给定，新实例启动模板将基于给定的版本号创建。若未指定则使用默认版本。 + // 若给定，新实例启动模板将基于给定的版本号创建。若未指定则使用默认版本,可以通过 [DescribeLaunchTemplateVersions](https://cloud.tencent.com/document/api/213/66323)查询默认版本。 LaunchTemplateVersion *int64 `json:"LaunchTemplateVersion,omitnil,omitempty" name:"LaunchTemplateVersion"` - // 实例启动模板版本描述。长度为2~256个英文或中文字符。 + // 实例启动模板版本描述。长度为2~256个英文或中文字符，不指定该参数时默认为空字符。 LaunchTemplateVersionDescription *string `json:"LaunchTemplateVersionDescription,omitnil,omitempty" name:"LaunchTemplateVersionDescription"` // 实例机型。不同实例机型指定了不同的资源规格。 @@ -1532,7 +1567,7 @@ type CreateLaunchTemplateVersionRequest struct { // 公网带宽相关信息设置。若不指定该参数，则默认公网带宽为0Mbps。 InternetAccessible *InternetAccessible `json:"InternetAccessible,omitnil,omitempty" name:"InternetAccessible"` - // 购买实例数量。包年包月实例取值范围：[1，300]，按量计费实例取值范围：[1，100]。默认取值：1。指定购买实例的数量不能超过用户所能购买的剩余配额数量，具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 + // 购买实例数量。具体配额相关限制详见[CVM实例购买限制](https://cloud.tencent.com/document/product/213/2664)。 InstanceCount *int64 `json:"InstanceCount,omitnil,omitempty" name:"InstanceCount"` // 实例显示名称。
  • 不指定实例显示名称则默认显示‘未命名’。
  • 购买多台实例，如果指定模式串`{R:x}`，表示生成数字`[x, x+n-1]`，其中`n`表示购买实例的数量，例如`server_{R:3}`，购买1台时，实例显示名称为`server_3`；购买2台时，实例显示名称分别为`server_3`，`server_4`。支持指定多个模式串`{R:x}`。
  • 购买多台实例，如果不指定模式串，则在实例显示名称添加后缀`1、2...n`，其中`n`表示购买实例的数量，例如`server_`，购买2台时，实例显示名称分别为`server_1`，`server_2`。
  • 最多支持128个字符（包含模式串）。
    • @@ -1556,7 +1591,7 @@ type CreateLaunchTemplateVersionRequest struct { // 定时任务。通过该参数可以为实例指定定时任务，目前仅支持定时销毁。 ActionTimer *ActionTimer `json:"ActionTimer,omitnil,omitempty" name:"ActionTimer"` - // 置放群组id，仅支持指定一个。 + // 置放群组id，仅支持指定一个。可使用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/api/213/17810)接口获取。 DisasterRecoverGroupIds []*string `json:"DisasterRecoverGroupIds,omitnil,omitempty" name:"DisasterRecoverGroupIds"` // 标签描述列表。通过指定该参数可以同时绑定标签到相应的资源实例，当前仅支持绑定标签到云服务器实例。 @@ -1575,10 +1610,10 @@ type CreateLaunchTemplateVersionRequest struct { // false（默认）：发送正常请求，通过检查后直接创建实例。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` - // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 + // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。该参数可以通过调用 [DescribeHpcClusters](https://cloud.tencent.com/document/api/213/83220) 的返回值中的 `HpcClusterId` 字段来获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` // 实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID：预付费，即包年包月
  • POSTPAID_BY_HOUR：按小时后付费
  • CDHPAID：独享子机（基于专用宿主机创建，宿主机部分的资源不收费）
  • SPOTPAID：竞价付费
    • 默认值：POSTPAID_BY_HOUR。 @@ -1589,6 +1624,17 @@ type CreateLaunchTemplateVersionRequest struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • TRUE：表示开启实例保护，不允许通过api接口删除实例

  • FALSE：表示关闭实例保护，允许通过api接口删除实例


    • 默认取值：FALSE。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` + + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + + // 只允许传递 Update 和 Replace 参数，在模板使用自定义 Metadata 且在 RunInstances 也传递 Metadata 时生效。默认采用 Replace。 + // + // - Update：设模板 t含本参数值为Update、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k1:v1, k2:v3] + // - Replace：模板 t含本参数值为Replace、 metadata=[k1:v1, k2:v2] ，则RunInstances（给metadata=[k2:v3]）+ t 创建的 cvm 使用metadata=[k2:v3] + // **注：内测中**。 + TemplateDataModifyAction *string `json:"TemplateDataModifyAction,omitnil,omitempty" name:"TemplateDataModifyAction"` } func (r *CreateLaunchTemplateVersionRequest) ToJsonString() string { @@ -1631,6 +1677,8 @@ func (r *CreateLaunchTemplateVersionRequest) FromJsonString(s string) error { delete(f, "InstanceChargeType") delete(f, "InstanceChargePrepaid") delete(f, "DisableApiTermination") + delete(f, "Metadata") + delete(f, "TemplateDataModifyAction") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateLaunchTemplateVersionRequest has unknown keys!", "") } @@ -1666,7 +1714,7 @@ type DataDisk struct { // 数据盘大小，单位：GiB。最小调整步长为10GiB，不同数据盘类型取值范围不同，具体限制详见：[存储概述](https://cloud.tencent.com/document/product/213/4952)。默认值为0，表示不购买数据盘。更多限制详见产品文档。 DiskSize *int64 `json:"DiskSize,omitnil,omitempty" name:"DiskSize"` - // 数据盘类型。数据盘类型限制详见[存储概述](https://cloud.tencent.com/document/product/213/4952)。取值范围：
  • LOCAL_BASIC：本地硬盘
  • LOCAL_SSD：本地SSD硬盘
  • LOCAL_NVME：本地NVME硬盘，与InstanceType强相关，不支持指定
  • LOCAL_PRO：本地HDD硬盘，与InstanceType强相关，不支持指定
  • CLOUD_BASIC：普通云硬盘
  • CLOUD_PREMIUM：高性能云硬盘
  • CLOUD_SSD：SSD云硬盘
  • CLOUD_HSSD：增强型SSD云硬盘
  • CLOUD_TSSD：极速型SSD云硬盘
  • CLOUD_BSSD：通用型SSD云硬盘

    默认取值：LOCAL_BASIC。

    该参数对`ResizeInstanceDisk`接口无效。
    • + // 数据盘类型。数据盘类型限制详见[存储概述](https://cloud.tencent.com/document/product/213/4952)。取值范围：
  • LOCAL_BASIC：本地硬盘
  • LOCAL_SSD：本地SSD硬盘
  • LOCAL_NVME：本地NVME硬盘，与InstanceType强相关，不支持指定
  • LOCAL_PRO：本地HDD硬盘，与InstanceType强相关，不支持指定
  • CLOUD_BASIC：普通云硬盘
  • CLOUD_PREMIUM：高性能云硬盘
  • CLOUD_SSD：SSD云硬盘
  • CLOUD_HSSD：增强型SSD云硬盘
  • CLOUD_TSSD：极速型SSD云硬盘
  • CLOUD_BSSD：通用型SSD云硬盘

    • 默认取值：LOCAL_BASIC

    该参数对`ResizeInstanceDisk`接口无效。 DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` // 数据盘ID。 @@ -1685,17 +1733,19 @@ type DataDisk struct { // 自定义CMK对应的ID，取值为UUID或者类似kms-abcd1234。用于加密云盘。 // // 该参数目前仅用于 `RunInstances` 接口。 + // 注意：此字段可能返回 null，表示取不到有效值。 KmsKeyId *string `json:"KmsKeyId,omitnil,omitempty" name:"KmsKeyId"` // 云硬盘性能，单位：MiB/s。使用此参数可给云硬盘购买额外的性能。 // 当前仅支持极速型云盘（CLOUD_TSSD）和增强型SSD云硬盘（CLOUD_HSSD） + // 注意：此字段可能返回 null，表示取不到有效值。 ThroughputPerformance *int64 `json:"ThroughputPerformance,omitnil,omitempty" name:"ThroughputPerformance"` // 所属的独享集群ID。 + // 注意：此字段可能返回 null，表示取不到有效值。 CdcId *string `json:"CdcId,omitnil,omitempty" name:"CdcId"` // 突发性能 - // // 注：内测中。 BurstPerformance *bool `json:"BurstPerformance,omitnil,omitempty" name:"BurstPerformance"` @@ -2607,25 +2657,25 @@ func (r *DescribeHostsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeHpcClustersRequestParams struct { - // 高性能计算集群ID数组。 + // 一个或多个待操作的高性能计算集群ID。集群ID信息可通过 [查询高性能集群信息](https://cloud.tencent.com/document/api/213/83220) 接口获取。每次请求高性能计算集群信息的批量上限为100，默认配合Limit传参数，不能超过Limit值，Limit默认20。 HpcClusterIds []*string `json:"HpcClusterIds,omitnil,omitempty" name:"HpcClusterIds"` - // 高性能计算集群名称。 + // 高性能计算集群名称，长度限制[1-60]。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` - // 可用区。 + // 可用区信息。可用区信息可通过 [查询可用区信息](https://cloud.tencent.com/document/api/213/15707) 接口获取。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 偏移量, 默认值0。 Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 本次请求量, 默认值20。 + // 本次请求量, 默认值20，范围限制为[1-100]。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 高性能计算集群类型。 + // 高性能计算集群类型，当前有三个取值：分别是CDC/CHC/STANDARD，其中STANDARD是默认的标准模式。 HpcClusterType *string `json:"HpcClusterType,omitnil,omitempty" name:"HpcClusterType"` - // 高性能计算集群对应的业务场景标识，当前只支持CDC。 + // 高性能计算集群对应的业务场景标识，当前只支持CDC场景类型。 HpcClusterBusinessId *string `json:"HpcClusterBusinessId,omitnil,omitempty" name:"HpcClusterBusinessId"` // 高性能计算集群实例类型 @@ -2638,25 +2688,25 @@ type DescribeHpcClustersRequestParams struct { type DescribeHpcClustersRequest struct { *tchttp.BaseRequest - // 高性能计算集群ID数组。 + // 一个或多个待操作的高性能计算集群ID。集群ID信息可通过 [查询高性能集群信息](https://cloud.tencent.com/document/api/213/83220) 接口获取。每次请求高性能计算集群信息的批量上限为100，默认配合Limit传参数，不能超过Limit值，Limit默认20。 HpcClusterIds []*string `json:"HpcClusterIds,omitnil,omitempty" name:"HpcClusterIds"` - // 高性能计算集群名称。 + // 高性能计算集群名称，长度限制[1-60]。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` - // 可用区。 + // 可用区信息。可用区信息可通过 [查询可用区信息](https://cloud.tencent.com/document/api/213/15707) 接口获取。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 偏移量, 默认值0。 Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 本次请求量, 默认值20。 + // 本次请求量, 默认值20，范围限制为[1-100]。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 高性能计算集群类型。 + // 高性能计算集群类型，当前有三个取值：分别是CDC/CHC/STANDARD，其中STANDARD是默认的标准模式。 HpcClusterType *string `json:"HpcClusterType,omitnil,omitempty" name:"HpcClusterType"` - // 高性能计算集群对应的业务场景标识，当前只支持CDC。 + // 高性能计算集群对应的业务场景标识，当前只支持CDC场景类型。 HpcClusterBusinessId *string `json:"HpcClusterBusinessId,omitnil,omitempty" name:"HpcClusterBusinessId"` // 高性能计算集群实例类型 @@ -2835,14 +2885,14 @@ func (r *DescribeImageQuotaResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeImageSharePermissionRequestParams struct { - // 需要共享的镜像Id + // 需要共享的镜像 ID，可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回的`ImageId`获取。 ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` } type DescribeImageSharePermissionRequest struct { *tchttp.BaseRequest - // 需要共享的镜像Id + // 需要共享的镜像 ID，可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回的`ImageId`获取。 ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` } @@ -2900,17 +2950,17 @@ type DescribeImagesRequestParams struct { //
  • image-id
    • //

    按照【镜像ID】进行过滤。

    类型：String

    必选：否

    //
  • image-type
    • - //

    按照【镜像类型】进行过滤。

    类型：String

    必选：否

    可选项：

    PRIVATE_IMAGE: 私有镜像 (本账户创建的镜像)

    PUBLIC_IMAGE: 公共镜像 (腾讯云官方镜像)

    SHARED_IMAGE: 共享镜像(其他账户共享给本账户的镜像)

    + //

    按照【镜像类型】进行过滤。

    类型：String

    必选：否

    可选项：

    PRIVATE_IMAGE: 自定义镜像 (本账户创建的镜像)

    PUBLIC_IMAGE: 公共镜像 (腾讯云官方镜像)

    SHARED_IMAGE: 共享镜像(其他账户共享给本账户的镜像)

    //
  • image-name
    • - //

    按照【镜像名称】进行过滤。

    类型：String

    必选：否

    + //

    按照【镜像名称】进行过滤。支持模糊查询。

    类型：String

    必选：否

    //
  • platform
    • - //

    按照【镜像平台】进行过滤，如CentOS。

    类型：String

    必选：否

    + //

    按照【镜像平台】进行过滤，如 CentOS，支持模糊匹配。可通过 DescribeImages 接口返回的 Platform 获取。

    类型：String

    必选：否

    //
  • tag-key
    • - //

    按照【标签键】进行过滤。

    类型：String

    必选：否

    + //

    按照【标签键】进行过滤。可通过 GetTags 接口返回的 TagKey 获取。

    类型：String

    必选：否

    //
  • tag-value
    • - //

    按照【标签值】进行过滤。

    类型：String

    必选：否

    + //

    按照【标签值】进行过滤。可通过 GetTags 接口返回的 TagValue 获取。

    类型：String

    必选：否

    //
  • tag:tag-key
    • - //

    按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。

    类型：String

    必选：否

    + //

    按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。可通过 GetTags 接口返回的 TagKey 和 TagValue 获取。

    类型：String

    必选：否

    Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` // 偏移量，默认为0。关于Offset详见[API简介](/document/api/213/568#.E8.BE.93.E5.85.A5.E5.8F.82.E6.95.B0.E4.B8.8E.E8.BF.94.E5.9B.9E.E5.8F.82.E6.95.B0.E9.87.8A.E4.B9.89)。 @@ -2919,7 +2969,7 @@ type DescribeImagesRequestParams struct { // 数量限制，默认为20，最大值为100。关于Limit详见[API简介](/document/api/213/568#.E8.BE.93.E5.85.A5.E5.8F.82.E6.95.B0.E4.B8.8E.E8.BF.94.E5.9B.9E.E5.8F.82.E6.95.B0.E9.87.8A.E4.B9.89)。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 实例类型，如 `S1.SMALL1` + // 实例类型，如 `S1.SMALL1`。可通过 [DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/product/213/15749) 接口返回的 `InstanceType` 获取。 InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` } @@ -2934,17 +2984,17 @@ type DescribeImagesRequest struct { //
  • image-id
    • //

    按照【镜像ID】进行过滤。

    类型：String

    必选：否

    //
  • image-type
    • - //

    按照【镜像类型】进行过滤。

    类型：String

    必选：否

    可选项：

    PRIVATE_IMAGE: 私有镜像 (本账户创建的镜像)

    PUBLIC_IMAGE: 公共镜像 (腾讯云官方镜像)

    SHARED_IMAGE: 共享镜像(其他账户共享给本账户的镜像)

    + //

    按照【镜像类型】进行过滤。

    类型：String

    必选：否

    可选项：

    PRIVATE_IMAGE: 自定义镜像 (本账户创建的镜像)

    PUBLIC_IMAGE: 公共镜像 (腾讯云官方镜像)

    SHARED_IMAGE: 共享镜像(其他账户共享给本账户的镜像)

    //
  • image-name
    • - //

    按照【镜像名称】进行过滤。

    类型：String

    必选：否

    + //

    按照【镜像名称】进行过滤。支持模糊查询。

    类型：String

    必选：否

    //
  • platform
    • - //

    按照【镜像平台】进行过滤，如CentOS。

    类型：String

    必选：否

    + //

    按照【镜像平台】进行过滤，如 CentOS，支持模糊匹配。可通过 DescribeImages 接口返回的 Platform 获取。

    类型：String

    必选：否

    //
  • tag-key
    • - //

    按照【标签键】进行过滤。

    类型：String

    必选：否

    + //

    按照【标签键】进行过滤。可通过 GetTags 接口返回的 TagKey 获取。

    类型：String

    必选：否

    //
  • tag-value
    • - //

    按照【标签值】进行过滤。

    类型：String

    必选：否

    + //

    按照【标签值】进行过滤。可通过 GetTags 接口返回的 TagValue 获取。

    类型：String

    必选：否

    //
  • tag:tag-key
    • - //

    按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。

    类型：String

    必选：否

    + //

    按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。可通过 GetTags 接口返回的 TagKey 和 TagValue 获取。

    类型：String

    必选：否

    Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` // 偏移量，默认为0。关于Offset详见[API简介](/document/api/213/568#.E8.BE.93.E5.85.A5.E5.8F.82.E6.95.B0.E4.B8.8E.E8.BF.94.E5.9B.9E.E5.8F.82.E6.95.B0.E9.87.8A.E4.B9.89)。 @@ -2953,7 +3003,7 @@ type DescribeImagesRequest struct { // 数量限制，默认为20，最大值为100。关于Limit详见[API简介](/document/api/213/568#.E8.BE.93.E5.85.A5.E5.8F.82.E6.95.B0.E4.B8.8E.E8.BF.94.E5.9B.9E.E5.8F.82.E6.95.B0.E9.87.8A.E4.B9.89)。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 实例类型，如 `S1.SMALL1` + // 实例类型，如 `S1.SMALL1`。可通过 [DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/product/213/15749) 接口返回的 `InstanceType` 获取。 InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` } @@ -3602,9 +3652,9 @@ type DescribeInstancesRequestParams struct { // 按照一个或者多个实例ID查询。实例ID例如：`ins-xxxxxxxx`。（此参数的具体格式可参考API[简介](https://cloud.tencent.com/document/api/213/15688)的`ids.N`一节）。每次请求的实例的上限为100。参数不支持同时指定`InstanceIds`和`Filters`。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - //
  • zone

    • 按照【可用区】进行过滤。可用区例如：ap-guangzhou-1。

    类型：String

    必选：否

    可选项：可用区列表

  • project-id

    • 按照【项目ID】进行过滤，可通过调用[DescribeProjects](https://cloud.tencent.com/document/api/651/78725)查询已创建的项目列表或登录[控制台](https://console.cloud.tencent.com/cvm/index)进行查看；也可以调用[AddProject](https://cloud.tencent.com/document/api/651/81952)创建新的项目。项目ID例如：1002189。

    类型：Integer

    必选：否

  • host-id

    • 按照【[CDH](https://cloud.tencent.com/document/product/416) ID】进行过滤。[CDH](https://cloud.tencent.com/document/product/416) ID例如：host-xxxxxxxx。

    类型：String

    必选：否

  • dedicated-cluster-id

    • 按照【[CDC](https://cloud.tencent.com/document/product/1346) ID】进行过滤。[CDC](https://cloud.tencent.com/document/product/1346) ID例如：cluster-xxxxxxx。

    类型：String

    必选：否

  • vpc-id

    • 按照【VPC ID】进行过滤。VPC ID例如：vpc-xxxxxxxx。

    类型：String

    必选：否

  • subnet-id

    • 按照【子网ID】进行过滤。子网ID例如：subnet-xxxxxxxx。

    类型：String

    必选：否

  • instance-id

    • 按照【实例ID】进行过滤。实例ID例如：ins-xxxxxxxx。

    类型：String

    必选：否

  • uuid

    • 按照【实例UUID】进行过滤。实例UUID例如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

    类型：String

    必选：否

  • security-group-id

    • 按照【安全组ID】进行过滤。安全组ID例如: sg-8jlk3f3r。

    类型：String

    必选：否

  • instance-name

    • 按照【实例名称】进行过滤。

    类型：String

    必选：否

  • instance-charge-type

    • 按照【实例计费模式】进行过滤。(PREPAID：表示预付费，即包年包月 | POSTPAID_BY_HOUR：表示后付费，即按量计费 | CDHPAID：表示[CDH](https://cloud.tencent.com/document/product/416)付费，即只对[CDH](https://cloud.tencent.com/document/product/416)计费，不对[CDH](https://cloud.tencent.com/document/product/416)上的实例计费。)

    类型：String

    必选：否

  • instance-state

    • 按照【实例状态】进行过滤。状态类型详见[实例状态表](https://cloud.tencent.com/document/api/213/15753#InstanceStatus)

    类型：String

    必选：否

  • private-ip-address

    • 按照【实例主网卡的内网IP】进行过滤。

    类型：String

    必选：否

  • public-ip-address

    • 按照【实例主网卡的公网IP】进行过滤，包含实例创建时自动分配的IP和实例创建后手动绑定的弹性IP。

    类型：String

    必选：否

  • ipv6-address

    • 按照【实例的IPv6地址】进行过滤。

    类型：String

    必选：否

  • tag-key

    • 按照【标签键】进行过滤。

    类型：String

    必选：否

  • tag-value

    • 按照【标签值】进行过滤。

    类型：String

    必选：否

  • tag:tag-key

    • 按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。使用请参考示例2。

    类型：String

    必选：否

  • creation-start-time

    • 按照【实例创建起始时间】进行过滤。例如：2023-06-01 00:00:00。 + //

  • zone

    • 按照【可用区】进行过滤。可用区例如：ap-guangzhou-1。

    类型：String

    必选：否

    可选项：可用区列表

  • project-id

    • 按照【项目ID】进行过滤，可通过调用[DescribeProjects](https://cloud.tencent.com/document/api/651/78725)查询已创建的项目列表或登录[控制台](https://console.cloud.tencent.com/cvm/index)进行查看；也可以调用[AddProject](https://cloud.tencent.com/document/api/651/81952)创建新的项目。项目ID例如：1002189。

    类型：Integer

    必选：否

  • host-id

    • 按照【[CDH](https://cloud.tencent.com/document/product/416) ID】进行过滤。[CDH](https://cloud.tencent.com/document/product/416) ID例如：host-xxxxxxxx。

    类型：String

    必选：否

  • dedicated-cluster-id

    • 按照【[CDC](https://cloud.tencent.com/document/product/1346) ID】进行过滤。[CDC](https://cloud.tencent.com/document/product/1346) ID例如：cluster-xxxxxxx。

    类型：String

    必选：否

  • vpc-id

    • 按照【VPC ID】进行过滤。VPC ID例如：vpc-xxxxxxxx。

    类型：String

    必选：否

  • subnet-id

    • 按照【子网ID】进行过滤。子网ID例如：subnet-xxxxxxxx。

    类型：String

    必选：否

  • instance-id

    • 按照【实例ID】进行过滤。实例ID例如：ins-xxxxxxxx。

    类型：String

    必选：否

  • uuid

    • 按照【实例UUID】进行过滤。实例UUID例如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

    类型：String

    必选：否

  • security-group-id

    • 按照【安全组ID】进行过滤。安全组ID例如: sg-8jlk3f3r。

    类型：String

    必选：否

  • instance-name

    • 按照【实例名称】进行过滤。

    类型：String

    必选：否

  • instance-charge-type

    • 按照【实例计费模式】进行过滤。(PREPAID：表示预付费，即包年包月 | POSTPAID_BY_HOUR：表示后付费，即按量计费 | CDHPAID：表示[CDH](https://cloud.tencent.com/document/product/416)付费，即只对[CDH](https://cloud.tencent.com/document/product/416)计费，不对[CDH](https://cloud.tencent.com/document/product/416)上的实例计费。)

    类型：String

    必选：否

  • instance-state

    • 按照【实例状态】进行过滤。状态类型详见[实例状态表](https://cloud.tencent.com/document/api/213/15753#InstanceStatus)

    类型：String

    必选：否

  • private-ip-address

    • 按照【实例主网卡的内网IP】进行过滤。

    类型：String

    必选：否

  • public-ip-address

    • 按照【实例主网卡的公网IP】进行过滤，包含实例创建时自动分配的IP和实例创建后手动绑定的弹性IP。

    类型：String

    必选：否

  • ipv6-address

    • 按照【实例的IPv6地址】进行过滤。

    类型：String

    必选：否

  • tag-key

    • 按照【标签键】进行过滤。

    类型：String

    必选：否

  • tag-value

    • 按照【标签值】进行过滤。

    类型：String

    必选：否

  • tag:tag-key

    • 按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。使用请参考示例2。

    类型：String

    必选：否

  • creation-start-time

    • 按照【创建实例请求的起始时间】进行过滤。例如：2023-06-01 00:00:00。 //

    类型：String

    必选：否

    - //
  • creation-end-time

    • 按照【实例创建截止时间】进行过滤。例如：2023-06-01 00:00:00。 + //

  • creation-end-time

    • 按照【创建实例请求的截止时间】进行过滤。例如：2023-06-01 00:00:00。 //

    类型：String

    必选：否

    每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`InstanceIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -3621,9 +3671,9 @@ type DescribeInstancesRequest struct { // 按照一个或者多个实例ID查询。实例ID例如：`ins-xxxxxxxx`。（此参数的具体格式可参考API[简介](https://cloud.tencent.com/document/api/213/15688)的`ids.N`一节）。每次请求的实例的上限为100。参数不支持同时指定`InstanceIds`和`Filters`。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - //
  • zone

    • 按照【可用区】进行过滤。可用区例如：ap-guangzhou-1。

    类型：String

    必选：否

    可选项：可用区列表

  • project-id

    • 按照【项目ID】进行过滤，可通过调用[DescribeProjects](https://cloud.tencent.com/document/api/651/78725)查询已创建的项目列表或登录[控制台](https://console.cloud.tencent.com/cvm/index)进行查看；也可以调用[AddProject](https://cloud.tencent.com/document/api/651/81952)创建新的项目。项目ID例如：1002189。

    类型：Integer

    必选：否

  • host-id

    • 按照【[CDH](https://cloud.tencent.com/document/product/416) ID】进行过滤。[CDH](https://cloud.tencent.com/document/product/416) ID例如：host-xxxxxxxx。

    类型：String

    必选：否

  • dedicated-cluster-id

    • 按照【[CDC](https://cloud.tencent.com/document/product/1346) ID】进行过滤。[CDC](https://cloud.tencent.com/document/product/1346) ID例如：cluster-xxxxxxx。

    类型：String

    必选：否

  • vpc-id

    • 按照【VPC ID】进行过滤。VPC ID例如：vpc-xxxxxxxx。

    类型：String

    必选：否

  • subnet-id

    • 按照【子网ID】进行过滤。子网ID例如：subnet-xxxxxxxx。

    类型：String

    必选：否

  • instance-id

    • 按照【实例ID】进行过滤。实例ID例如：ins-xxxxxxxx。

    类型：String

    必选：否

  • uuid

    • 按照【实例UUID】进行过滤。实例UUID例如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

    类型：String

    必选：否

  • security-group-id

    • 按照【安全组ID】进行过滤。安全组ID例如: sg-8jlk3f3r。

    类型：String

    必选：否

  • instance-name

    • 按照【实例名称】进行过滤。

    类型：String

    必选：否

  • instance-charge-type

    • 按照【实例计费模式】进行过滤。(PREPAID：表示预付费，即包年包月 | POSTPAID_BY_HOUR：表示后付费，即按量计费 | CDHPAID：表示[CDH](https://cloud.tencent.com/document/product/416)付费，即只对[CDH](https://cloud.tencent.com/document/product/416)计费，不对[CDH](https://cloud.tencent.com/document/product/416)上的实例计费。)

    类型：String

    必选：否

  • instance-state

    • 按照【实例状态】进行过滤。状态类型详见[实例状态表](https://cloud.tencent.com/document/api/213/15753#InstanceStatus)

    类型：String

    必选：否

  • private-ip-address

    • 按照【实例主网卡的内网IP】进行过滤。

    类型：String

    必选：否

  • public-ip-address

    • 按照【实例主网卡的公网IP】进行过滤，包含实例创建时自动分配的IP和实例创建后手动绑定的弹性IP。

    类型：String

    必选：否

  • ipv6-address

    • 按照【实例的IPv6地址】进行过滤。

    类型：String

    必选：否

  • tag-key

    • 按照【标签键】进行过滤。

    类型：String

    必选：否

  • tag-value

    • 按照【标签值】进行过滤。

    类型：String

    必选：否

  • tag:tag-key

    • 按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。使用请参考示例2。

    类型：String

    必选：否

  • creation-start-time

    • 按照【实例创建起始时间】进行过滤。例如：2023-06-01 00:00:00。 + //

  • zone

    • 按照【可用区】进行过滤。可用区例如：ap-guangzhou-1。

    类型：String

    必选：否

    可选项：可用区列表

  • project-id

    • 按照【项目ID】进行过滤，可通过调用[DescribeProjects](https://cloud.tencent.com/document/api/651/78725)查询已创建的项目列表或登录[控制台](https://console.cloud.tencent.com/cvm/index)进行查看；也可以调用[AddProject](https://cloud.tencent.com/document/api/651/81952)创建新的项目。项目ID例如：1002189。

    类型：Integer

    必选：否

  • host-id

    • 按照【[CDH](https://cloud.tencent.com/document/product/416) ID】进行过滤。[CDH](https://cloud.tencent.com/document/product/416) ID例如：host-xxxxxxxx。

    类型：String

    必选：否

  • dedicated-cluster-id

    • 按照【[CDC](https://cloud.tencent.com/document/product/1346) ID】进行过滤。[CDC](https://cloud.tencent.com/document/product/1346) ID例如：cluster-xxxxxxx。

    类型：String

    必选：否

  • vpc-id

    • 按照【VPC ID】进行过滤。VPC ID例如：vpc-xxxxxxxx。

    类型：String

    必选：否

  • subnet-id

    • 按照【子网ID】进行过滤。子网ID例如：subnet-xxxxxxxx。

    类型：String

    必选：否

  • instance-id

    • 按照【实例ID】进行过滤。实例ID例如：ins-xxxxxxxx。

    类型：String

    必选：否

  • uuid

    • 按照【实例UUID】进行过滤。实例UUID例如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

    类型：String

    必选：否

  • security-group-id

    • 按照【安全组ID】进行过滤。安全组ID例如: sg-8jlk3f3r。

    类型：String

    必选：否

  • instance-name

    • 按照【实例名称】进行过滤。

    类型：String

    必选：否

  • instance-charge-type

    • 按照【实例计费模式】进行过滤。(PREPAID：表示预付费，即包年包月 | POSTPAID_BY_HOUR：表示后付费，即按量计费 | CDHPAID：表示[CDH](https://cloud.tencent.com/document/product/416)付费，即只对[CDH](https://cloud.tencent.com/document/product/416)计费，不对[CDH](https://cloud.tencent.com/document/product/416)上的实例计费。)

    类型：String

    必选：否

  • instance-state

    • 按照【实例状态】进行过滤。状态类型详见[实例状态表](https://cloud.tencent.com/document/api/213/15753#InstanceStatus)

    类型：String

    必选：否

  • private-ip-address

    • 按照【实例主网卡的内网IP】进行过滤。

    类型：String

    必选：否

  • public-ip-address

    • 按照【实例主网卡的公网IP】进行过滤，包含实例创建时自动分配的IP和实例创建后手动绑定的弹性IP。

    类型：String

    必选：否

  • ipv6-address

    • 按照【实例的IPv6地址】进行过滤。

    类型：String

    必选：否

  • tag-key

    • 按照【标签键】进行过滤。

    类型：String

    必选：否

  • tag-value

    • 按照【标签值】进行过滤。

    类型：String

    必选：否

  • tag:tag-key

    • 按照【标签键值对】进行过滤。tag-key使用具体的标签键进行替换。使用请参考示例2。

    类型：String

    必选：否

  • creation-start-time

    • 按照【创建实例请求的起始时间】进行过滤。例如：2023-06-01 00:00:00。 //

    类型：String

    必选：否

    - //
  • creation-end-time

    • 按照【实例创建截止时间】进行过滤。例如：2023-06-01 00:00:00。 + //

  • creation-end-time

    • 按照【创建实例请求的截止时间】进行过滤。例如：2023-06-01 00:00:00。 //

    类型：String

    必选：否

    每次请求的`Filters`的上限为10，`Filter.Values`的上限为5。参数不支持同时指定`InstanceIds`和`Filters`。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` @@ -4377,10 +4427,10 @@ func (r *DescribeReservedInstancesOfferingsResponse) FromJsonString(s string) er // Predefined struct for user type DescribeTaskInfoRequestParams struct { - // 返回数量，默认为20，最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 + // 返回数量，最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 偏移量，默认为0。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 + // 偏移量。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` // 按照指定的产品类型查询，支持取值： @@ -4423,16 +4473,16 @@ type DescribeTaskInfoRequestParams struct { // 按照一个或者多个任务ID查询。任务ID形如：`rep-xxxxxxxx`。 TaskIds []*string `json:"TaskIds,omitnil,omitempty" name:"TaskIds"` - // 按照一个或者多个实例ID查询。实例ID形如：`ins-xxxxxxxx`。 + // 按照一个或者多个实例ID查询。实例ID形如：`ins-xxxxxxxx`，可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 按照一个或者多个实例名称查询。 Aliases []*string `json:"Aliases,omitnil,omitempty" name:"Aliases"` - // 时间查询区间的起始位置，会根据任务创建时间`CreateTime`进行过滤。未传入时默认为当天`00:00:00`。 + // 时间查询区间的起始位置，会根据任务创建时间`CreateTime`进行过滤，格式为`YYYY-MM-DD hh:mm:ss`。未传入时默认为当天`00:00:00`。 StartDate *string `json:"StartDate,omitnil,omitempty" name:"StartDate"` - // 时间查询区间的终止位置，会根据任务创建时间`CreateTime`进行过滤。未传入时默认为当前时刻。 + // 时间查询区间的终止位置，会根据任务创建时间`CreateTime`进行过滤，格式为`YYYY-MM-DD hh:mm:ss`。未传入时默认为当前时刻。 EndDate *string `json:"EndDate,omitnil,omitempty" name:"EndDate"` // 指定返回维修任务列表的排序字段，目前支持： @@ -4456,10 +4506,10 @@ type DescribeTaskInfoRequestParams struct { type DescribeTaskInfoRequest struct { *tchttp.BaseRequest - // 返回数量，默认为20，最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 + // 返回数量，最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 偏移量，默认为0。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 + // 偏移量。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` // 按照指定的产品类型查询，支持取值： @@ -4502,16 +4552,16 @@ type DescribeTaskInfoRequest struct { // 按照一个或者多个任务ID查询。任务ID形如：`rep-xxxxxxxx`。 TaskIds []*string `json:"TaskIds,omitnil,omitempty" name:"TaskIds"` - // 按照一个或者多个实例ID查询。实例ID形如：`ins-xxxxxxxx`。 + // 按照一个或者多个实例ID查询。实例ID形如：`ins-xxxxxxxx`，可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 按照一个或者多个实例名称查询。 Aliases []*string `json:"Aliases,omitnil,omitempty" name:"Aliases"` - // 时间查询区间的起始位置，会根据任务创建时间`CreateTime`进行过滤。未传入时默认为当天`00:00:00`。 + // 时间查询区间的起始位置，会根据任务创建时间`CreateTime`进行过滤，格式为`YYYY-MM-DD hh:mm:ss`。未传入时默认为当天`00:00:00`。 StartDate *string `json:"StartDate,omitnil,omitempty" name:"StartDate"` - // 时间查询区间的终止位置，会根据任务创建时间`CreateTime`进行过滤。未传入时默认为当前时刻。 + // 时间查询区间的终止位置，会根据任务创建时间`CreateTime`进行过滤，格式为`YYYY-MM-DD hh:mm:ss`。未传入时默认为当前时刻。 EndDate *string `json:"EndDate,omitnil,omitempty" name:"EndDate"` // 指定返回维修任务列表的排序字段，目前支持： @@ -5362,8 +5412,7 @@ type Image struct { // CREATING-创建中 // NORMAL-正常 // CREATEFAILED-创建失败 - // USING-使用中 - // SYNCING-同步中 + // SYNCING-复制中 // IMPORTING-导入中 // IMPORTFAILED-导入失败 ImageState *string `json:"ImageState,omitnil,omitempty" name:"ImageState"` @@ -5431,40 +5480,50 @@ type ImportImageDataDisk struct { // Predefined struct for user type ImportImageRequestParams struct { - // 导入镜像的操作系统架构，`x86_64` 或 `i386` + // 导入镜像的操作系统架构。 + // 取值范围包括：`x86_64` 、`i386`、`arm_64` Architecture *string `json:"Architecture,omitnil,omitempty" name:"Architecture"` - // 导入镜像的操作系统类型，通过`DescribeImportImageOs`获取 + // 导入镜像的操作系统类型 。 + // 可通过 [DescribeImportImageOs](https://cloud.tencent.com/document/api/213/15718) 接口返回值中的`ImportImageOsListSupported`获取。 OsType *string `json:"OsType,omitnil,omitempty" name:"OsType"` - // 导入镜像的操作系统版本，通过`DescribeImportImageOs`获取 + // 导入镜像的操作系统版本。 + // 可通过 [DescribeImportImageOs](https://cloud.tencent.com/document/api/213/15718) 接口返回值中的`ImportImageOsVersionSet`获取。 OsVersion *string `json:"OsVersion,omitnil,omitempty" name:"OsVersion"` // 导入镜像存放的cos地址 ImageUrl *string `json:"ImageUrl,omitnil,omitempty" name:"ImageUrl"` - // 镜像名称 + // 镜像名称。 + // 最多支持 60 个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` - // 镜像描述 + // 镜像描述。 + // 最多支持 256 个字符。 ImageDescription *string `json:"ImageDescription,omitnil,omitempty" name:"ImageDescription"` - // 只检查参数，不执行任务 + // 只检查参数，不执行任务。 + // 默认值：false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 是否强制导入，参考[强制导入镜像](https://cloud.tencent.com/document/product/213/12849) + // 默认值：false Force *bool `json:"Force,omitnil,omitempty" name:"Force"` // 标签描述列表。通过指定该参数可以同时绑定标签到自定义镜像。 TagSpecification []*TagSpecification `json:"TagSpecification,omitnil,omitempty" name:"TagSpecification"` // 导入镜像后，激活操作系统采用的许可证类型。 - // 可选项： + // 默认值：TencentCloud + // 取值范围： // TencentCloud: 腾讯云官方许可 // BYOL: 自带许可（Bring Your Own License） LicenseType *string `json:"LicenseType,omitnil,omitempty" name:"LicenseType"` - // 启动模式 + // 启动模式。 + // 取值范围：`Legacy BIOS`、`UEFI` + // 默认值：Legacy BIOS BootMode *string `json:"BootMode,omitnil,omitempty" name:"BootMode"` // 镜像族 @@ -5477,40 +5536,50 @@ type ImportImageRequestParams struct { type ImportImageRequest struct { *tchttp.BaseRequest - // 导入镜像的操作系统架构，`x86_64` 或 `i386` + // 导入镜像的操作系统架构。 + // 取值范围包括：`x86_64` 、`i386`、`arm_64` Architecture *string `json:"Architecture,omitnil,omitempty" name:"Architecture"` - // 导入镜像的操作系统类型，通过`DescribeImportImageOs`获取 + // 导入镜像的操作系统类型 。 + // 可通过 [DescribeImportImageOs](https://cloud.tencent.com/document/api/213/15718) 接口返回值中的`ImportImageOsListSupported`获取。 OsType *string `json:"OsType,omitnil,omitempty" name:"OsType"` - // 导入镜像的操作系统版本，通过`DescribeImportImageOs`获取 + // 导入镜像的操作系统版本。 + // 可通过 [DescribeImportImageOs](https://cloud.tencent.com/document/api/213/15718) 接口返回值中的`ImportImageOsVersionSet`获取。 OsVersion *string `json:"OsVersion,omitnil,omitempty" name:"OsVersion"` // 导入镜像存放的cos地址 ImageUrl *string `json:"ImageUrl,omitnil,omitempty" name:"ImageUrl"` - // 镜像名称 + // 镜像名称。 + // 最多支持 60 个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` - // 镜像描述 + // 镜像描述。 + // 最多支持 256 个字符。 ImageDescription *string `json:"ImageDescription,omitnil,omitempty" name:"ImageDescription"` - // 只检查参数，不执行任务 + // 只检查参数，不执行任务。 + // 默认值：false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 是否强制导入，参考[强制导入镜像](https://cloud.tencent.com/document/product/213/12849) + // 默认值：false Force *bool `json:"Force,omitnil,omitempty" name:"Force"` // 标签描述列表。通过指定该参数可以同时绑定标签到自定义镜像。 TagSpecification []*TagSpecification `json:"TagSpecification,omitnil,omitempty" name:"TagSpecification"` // 导入镜像后，激活操作系统采用的许可证类型。 - // 可选项： + // 默认值：TencentCloud + // 取值范围： // TencentCloud: 腾讯云官方许可 // BYOL: 自带许可（Bring Your Own License） LicenseType *string `json:"LicenseType,omitnil,omitempty" name:"LicenseType"` - // 启动模式 + // 启动模式。 + // 取值范围：`Legacy BIOS`、`UEFI` + // 默认值：Legacy BIOS BootMode *string `json:"BootMode,omitnil,omitempty" name:"BootMode"` // 镜像族 @@ -6046,6 +6115,9 @@ type InquiryPriceResetInstanceRequestParams struct { // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 EnhancedService *EnhancedService `json:"EnhancedService,omitnil,omitempty" name:"EnhancedService"` + + // 提供给实例使用的用户数据，需要以 base64 方式编码，支持的最大数据大小为 16KB。关于获取此参数的详细介绍，请参阅[Windows](https://cloud.tencent.com/document/product/213/17526)和[Linux](https://cloud.tencent.com/document/product/213/17525)启动时运行命令。 + UserData *string `json:"UserData,omitnil,omitempty" name:"UserData"` } type InquiryPriceResetInstanceRequest struct { @@ -6065,6 +6137,9 @@ type InquiryPriceResetInstanceRequest struct { // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 EnhancedService *EnhancedService `json:"EnhancedService,omitnil,omitempty" name:"EnhancedService"` + + // 提供给实例使用的用户数据，需要以 base64 方式编码，支持的最大数据大小为 16KB。关于获取此参数的详细介绍，请参阅[Windows](https://cloud.tencent.com/document/product/213/17526)和[Linux](https://cloud.tencent.com/document/product/213/17525)启动时运行命令。 + UserData *string `json:"UserData,omitnil,omitempty" name:"UserData"` } func (r *InquiryPriceResetInstanceRequest) ToJsonString() string { @@ -6084,6 +6159,7 @@ func (r *InquiryPriceResetInstanceRequest) FromJsonString(s string) error { delete(f, "SystemDisk") delete(f, "LoginSettings") delete(f, "EnhancedService") + delete(f, "UserData") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "InquiryPriceResetInstanceRequest has unknown keys!", "") } @@ -6387,7 +6463,7 @@ type InquiryPriceRunInstancesRequestParams struct { // 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的`SecurityGroupId`字段来获取。若不指定该参数，则默认不绑定安全组。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 @@ -6405,6 +6481,11 @@ type InquiryPriceRunInstancesRequestParams struct { // 实例的市场相关选项，如竞价实例相关参数 InstanceMarketOptions *InstanceMarketOptionsRequest `json:"InstanceMarketOptions,omitnil,omitempty" name:"InstanceMarketOptions"` + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + // 高性能计算集群ID。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` @@ -6457,7 +6538,7 @@ type InquiryPriceRunInstancesRequest struct { // 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的`SecurityGroupId`字段来获取。若不指定该参数，则默认不绑定安全组。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 @@ -6475,6 +6556,11 @@ type InquiryPriceRunInstancesRequest struct { // 实例的市场相关选项，如竞价实例相关参数 InstanceMarketOptions *InstanceMarketOptionsRequest `json:"InstanceMarketOptions,omitnil,omitempty" name:"InstanceMarketOptions"` + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + // 高性能计算集群ID。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` @@ -6515,6 +6601,7 @@ func (r *InquiryPriceRunInstancesRequest) FromJsonString(s string) error { delete(f, "HostName") delete(f, "TagSpecification") delete(f, "InstanceMarketOptions") + delete(f, "Metadata") delete(f, "HpcClusterId") delete(f, "CpuTopology") delete(f, "LaunchTemplate") @@ -6619,7 +6706,7 @@ type Instance struct { // 实例的CPU核数，单位：核。 CPU *int64 `json:"CPU,omitnil,omitempty" name:"CPU"` - // 实例内存容量，单位：`GB`。 + // 实例内存容量，单位：`GiB`。 Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` // 实例业务状态。取值范围：
  • NORMAL：表示正常状态的实例
  • EXPIRED：表示过期的实例
  • PROTECTIVELY_ISOLATED：表示被安全隔离的实例。
    • @@ -6739,6 +6826,9 @@ type Instance struct { // 实例的最新操作错误信息。 // 注意：此字段可能返回 null，表示取不到有效值。 LatestOperationErrorMsg *string `json:"LatestOperationErrorMsg,omitnil,omitempty" name:"LatestOperationErrorMsg"` + + // 实例绑定的公网IPv6地址。 + PublicIPv6Addresses []*string `json:"PublicIPv6Addresses,omitnil,omitempty" name:"PublicIPv6Addresses"` } type InstanceAttribute struct { @@ -6913,6 +7003,47 @@ type InternetAccessible struct { // 带宽包ID。可通过[ DescribeBandwidthPackages ](https://cloud.tencent.com/document/api/215/19209)接口返回值中的`BandwidthPackageId`获取。该参数仅在RunInstances接口中作为入参使用。 BandwidthPackageId *string `json:"BandwidthPackageId,omitnil,omitempty" name:"BandwidthPackageId"` + + // 线路类型。各种线路类型详情可参考：[EIP 的 IP 地址类型](https://cloud.tencent.com/document/product/1199/41646)。默认值：BGP。 + // + // - BGP：常规 BGP 线路 + // + // 已开通静态单线IP白名单的用户，可选值： + // + // - CMCC：中国移动 + // - CTCC：中国电信 + // - CUCC：中国联通 + // + // 注意：仅部分地域支持静态单线IP。 + // 示例值：BGP + InternetServiceProvider *string `json:"InternetServiceProvider,omitnil,omitempty" name:"InternetServiceProvider"` + + // 公网 IP 类型。 + // + // - WanIP：普通公网IP。 + // - HighQualityEIP：精品 IP。仅新加坡和中国香港支持精品IP。 + // - AntiDDoSEIP：高防 IP。仅部分地域支持高防IP，详情可见[弹性公网IP产品概述](https://cloud.tencent.com/document/product/1199/41646)。 + // + // 如需为资源分配公网IPv4地址，请指定公网IPv4地址类型。 + // + // 示例值：WanIP + // + // 此功能仅部分地区灰度开放，如需使用[请提交工单咨询](https://console.cloud.tencent.com/workorder/category) + IPv4AddressType *string `json:"IPv4AddressType,omitnil,omitempty" name:"IPv4AddressType"` + + // 弹性公网 IPv6 类型。 + // - EIPv6：弹性公网 IPv6。 + // - HighQualityEIPv6：精品 IPv6。仅中国香港支持精品IPv6。 + // + // 如需为资源分配IPv6地址，请指定弹性公网IPv6类型。 + // 示例值：EIPv6 + // + // 此功能仅部分地区灰度开放，如需使用[请提交工单咨询](https://console.cloud.tencent.com/workorder/category) + IPv6AddressType *string `json:"IPv6AddressType,omitnil,omitempty" name:"IPv6AddressType"` + + // 高防包唯一ID，申请高防IP时，该字段必传。 + // 示例值：bgp-12345678 + AntiDDoSPackageId *string `json:"AntiDDoSPackageId,omitnil,omitempty" name:"AntiDDoSPackageId"` } type InternetBandwidthConfig struct { @@ -7197,6 +7328,19 @@ type LoginSettings struct { KeepImageLogin *string `json:"KeepImageLogin,omitnil,omitempty" name:"KeepImageLogin"` } +type Metadata struct { + // 自定义metadata键值对列表。 + Items []*MetadataItem `json:"Items,omitnil,omitempty" name:"Items"` +} + +type MetadataItem struct { + // 自定义metadata键，需符合正则 ^[a-zA-Z0-9_-]+$，长度 ≤128 字节（大小写敏感）； + Key *string `json:"Key,omitnil,omitempty" name:"Key"` + + // 自定义metadata值，支持任意数据（含二进制），大小 ≤256 KB（大小写敏感）； + Value *string `json:"Value,omitnil,omitempty" name:"Value"` +} + // Predefined struct for user type ModifyChcAttributeRequestParams struct { // CHC物理服务器ID。 @@ -7355,10 +7499,10 @@ type ModifyHostsAttributeRequestParams struct { // CDH实例显示名称。可任意命名，但不得超过60个字符。 HostName *string `json:"HostName,omitnil,omitempty" name:"HostName"` - // 自动续费标识。取值范围：
  • NOTIFY_AND_AUTO_RENEW：通知过期且自动续费
  • NOTIFY_AND_MANUAL_RENEW：通知过期不自动续费
  • DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知过期不自动续费

    若该参数指定为NOTIFY_AND_AUTO_RENEW，在账户余额充足的情况下，实例到期后将按月自动续费。 + // 自动续费标识。取值范围：
  • NOTIFY_AND_AUTO_RENEW：通知过期且自动续费
  • NOTIFY_AND_MANUAL_RENEW：通知过期不自动续费
  • DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知过期不自动续费

    • 若该参数指定为NOTIFY_AND_AUTO_RENEW，在账户余额充足的情况下，实例到期后将按月自动续费。 RenewFlag *string `json:"RenewFlag,omitnil,omitempty" name:"RenewFlag"` - // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/doc/api/403/4398)接口创建。可通过[`DescribeProject`](https://cloud.tencent.com/document/product/378/4400) API返回值中的`projectId`获取。后续使用[DescribeHosts](https://cloud.tencent.com/document/api/213/16474)接口查询实例时，项目ID可用于过滤结果。 + // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[DescribeProject](https://cloud.tencent.com/document/product/378/4400) API返回值中的`projectId`获取。后续使用[DescribeHosts](https://cloud.tencent.com/document/api/213/16474)接口查询实例时，项目ID可用于过滤结果。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } @@ -7371,10 +7515,10 @@ type ModifyHostsAttributeRequest struct { // CDH实例显示名称。可任意命名，但不得超过60个字符。 HostName *string `json:"HostName,omitnil,omitempty" name:"HostName"` - // 自动续费标识。取值范围：
  • NOTIFY_AND_AUTO_RENEW：通知过期且自动续费
  • NOTIFY_AND_MANUAL_RENEW：通知过期不自动续费
  • DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知过期不自动续费

    若该参数指定为NOTIFY_AND_AUTO_RENEW，在账户余额充足的情况下，实例到期后将按月自动续费。 + // 自动续费标识。取值范围：
  • NOTIFY_AND_AUTO_RENEW：通知过期且自动续费
  • NOTIFY_AND_MANUAL_RENEW：通知过期不自动续费
  • DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知过期不自动续费

    • 若该参数指定为NOTIFY_AND_AUTO_RENEW，在账户余额充足的情况下，实例到期后将按月自动续费。 RenewFlag *string `json:"RenewFlag,omitnil,omitempty" name:"RenewFlag"` - // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/doc/api/403/4398)接口创建。可通过[`DescribeProject`](https://cloud.tencent.com/document/product/378/4400) API返回值中的`projectId`获取。后续使用[DescribeHosts](https://cloud.tencent.com/document/api/213/16474)接口查询实例时，项目ID可用于过滤结果。 + // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[DescribeProject](https://cloud.tencent.com/document/product/378/4400) API返回值中的`projectId`获取。后续使用[DescribeHosts](https://cloud.tencent.com/document/api/213/16474)接口查询实例时，项目ID可用于过滤结果。 ProjectId *uint64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } @@ -7424,26 +7568,26 @@ func (r *ModifyHostsAttributeResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyHpcClusterAttributeRequestParams struct { - // 高性能计算集群ID。 + // 高性能计算集群ID。集群ID可通过 [查询高性能集群信息](https://cloud.tencent.com/document/api/213/83220) 接口获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` - // 高性能计算集群新名称。 + // 高性能计算集群新名称，长度限制[1-60]。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` - // 高性能计算集群新备注。 + // 高性能计算集群新备注，长度[1-256]。 Remark *string `json:"Remark,omitnil,omitempty" name:"Remark"` } type ModifyHpcClusterAttributeRequest struct { *tchttp.BaseRequest - // 高性能计算集群ID。 + // 高性能计算集群ID。集群ID可通过 [查询高性能集群信息](https://cloud.tencent.com/document/api/213/83220) 接口获取。 HpcClusterId *string `json:"HpcClusterId,omitnil,omitempty" name:"HpcClusterId"` - // 高性能计算集群新名称。 + // 高性能计算集群新名称，长度限制[1-60]。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` - // 高性能计算集群新备注。 + // 高性能计算集群新备注，长度[1-256]。 Remark *string `json:"Remark,omitnil,omitempty" name:"Remark"` } @@ -7731,7 +7875,7 @@ type ModifyInstancesAttributeRequestParams struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • true：表示开启实例保护，不允许通过api接口删除实例
  • false：表示关闭实例保护，允许通过api接口删除实例
    • 默认取值：false。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` - // 角色类别，与CamRoleName搭配使用，该值可从CAM DescribeRoleList, GetRole接口返回RoleType字段获取，当前只接受user、system和service_linked三种类别。 + // 角色类别，与CamRoleName搭配使用，该值可从CAM [ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)或[ GetRole ](https://cloud.tencent.com/document/product/598/36221)接口返回RoleType字段获取，当前只接受user、system和service_linked三种类别。 // 举例：一般CamRoleName中包含“LinkedRoleIn”（如TKE_QCSLinkedRoleInPrometheusService）时，DescribeRoleList和GetRole返回的RoleType为service_linked，则本参数也需要传递service_linked。 // 该参数默认值为user，若CameRoleName为非service_linked类型，本参数可不传递。 CamRoleType *string `json:"CamRoleType,omitnil,omitempty" name:"CamRoleType"` @@ -7767,7 +7911,7 @@ type ModifyInstancesAttributeRequest struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • true：表示开启实例保护，不允许通过api接口删除实例
  • false：表示关闭实例保护，允许通过api接口删除实例
    • 默认取值：false。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` - // 角色类别，与CamRoleName搭配使用，该值可从CAM DescribeRoleList, GetRole接口返回RoleType字段获取，当前只接受user、system和service_linked三种类别。 + // 角色类别，与CamRoleName搭配使用，该值可从CAM [ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)或[ GetRole ](https://cloud.tencent.com/document/product/598/36221)接口返回RoleType字段获取，当前只接受user、system和service_linked三种类别。 // 举例：一般CamRoleName中包含“LinkedRoleIn”（如TKE_QCSLinkedRoleInPrometheusService）时，DescribeRoleList和GetRole返回的RoleType为service_linked，则本参数也需要传递service_linked。 // 该参数默认值为user，若CameRoleName为非service_linked类型，本参数可不传递。 CamRoleType *string `json:"CamRoleType,omitnil,omitempty" name:"CamRoleType"` @@ -7905,7 +8049,7 @@ func (r *ModifyInstancesChargeTypeResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyInstancesDisasterRecoverGroupRequestParams struct { - // 一个或多个待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为1 + // 一个或多个待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 分散置放群组ID，可使用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/api/213/17810)接口获取 @@ -7918,7 +8062,7 @@ type ModifyInstancesDisasterRecoverGroupRequestParams struct { type ModifyInstancesDisasterRecoverGroupRequest struct { *tchttp.BaseRequest - // 一个或多个待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为1 + // 一个或多个待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 分散置放群组ID，可使用[DescribeDisasterRecoverGroups](https://cloud.tencent.com/document/api/213/17810)接口获取 @@ -8330,10 +8474,10 @@ type Placement struct { // 实例所属的可用区名称。该参数可以通过调用 [DescribeZones](https://cloud.tencent.com/document/product/213/15707) 的返回值中的Zone字段来获取。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` - // 实例所属项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。不填为默认项目。 + // 实例所属项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 `ProjectId` 字段来获取。默认取值0，表示默认项目。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 实例所属的专用宿主机ID列表，仅用于入参。如果您有购买专用宿主机并且指定了该参数，则您购买的实例就会随机的部署在这些专用宿主机上。 + // 实例所属的专用宿主机ID列表，仅用于入参。如果您有购买专用宿主机并且指定了该参数，则您购买的实例就会随机的部署在这些专用宿主机上。该参数可以通过调用 [DescribeHosts](https://cloud.tencent.com/document/api/213/16474) 的返回值中的 `HostId` 字段来获取。 HostIds []*string `json:"HostIds,omitnil,omitempty" name:"HostIds"` // 实例所属的专用宿主机ID，仅用于出参。 @@ -8545,6 +8689,8 @@ type RebootInstancesRequestParams struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 本参数已弃用，推荐使用StopType，不可以与参数StopType同时使用。表示是否在正常重启失败后选择强制重启实例。取值范围：
  • true：表示在正常重启失败后进行强制重启
  • false：表示在正常重启失败后不进行强制重启

    • 默认取值：false。 + // + // Deprecated: ForceReboot is deprecated. ForceReboot *bool `json:"ForceReboot,omitnil,omitempty" name:"ForceReboot"` // 关机类型。取值范围：
  • SOFT：表示软关机
  • HARD：表示硬关机
  • SOFT_FIRST：表示优先软关机，失败再执行硬关机

    • 默认取值：SOFT。 @@ -8866,10 +9012,10 @@ type RepairTaskControlRequestParams struct { // - `CPM2.0`：裸金属云服务器 Product *string `json:"Product,omitnil,omitempty" name:"Product"` - // 指定待操作的实例ID列表，仅允许对列表中的实例ID相关的维修任务发起授权。 + // 指定待操作的实例ID列表，仅允许对列表中的实例ID相关的维修任务发起授权，可通过 [DescribeTaskInfo](https://cloud.tencent.com/document/api/213/87933) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 维修任务ID。 + // 指定待操作的维修任务ID，可通过 [DescribeTaskInfo](https://cloud.tencent.com/document/api/213/87933) 接口返回值中的`TaskId`获取。 TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"` // 操作类型，当前只支持传入`AuthorizeRepair`。 @@ -8878,7 +9024,12 @@ type RepairTaskControlRequestParams struct { // 预约授权时间，形如`2023-01-01 12:00:00`。预约时间需晚于当前时间至少5分钟，且在48小时之内。 OrderAuthTime *string `json:"OrderAuthTime,omitnil,omitempty" name:"OrderAuthTime"` - // 附加的授权处理策略。 + // 附加的授权处理策略，不传或为空时，按默认授权方式进行处理。对于支持弃盘迁移授权的维修任务，当且仅当传入`LossyLocal`时，代表本次授权可允许发起弃盘迁移。 + // + // 注意： + // 1. 指定`TaskSubMethod`为`LossyLocal`调用接口发起**弃盘迁移授权**时，本地盘实例的**所有本地盘数据都会清空**，相当于**重新部署本地盘实例**。 + // 2. 对于非本地盘实例，或不支持弃盘迁移选项的任务，指定`TaskSubMethod`为`LossyLocal`时接口不会报错，不过后端会自动忽略该参数。 + // 3. 特别的：如果本地盘实例系统盘是CBS云盘，并且`/etc/fstab`里之前配置了本地盘的自动挂载项，建议可根据业务侧的实际需求，评估是否在对应挂载项追加上`nofail`参数（代表对应挂载点挂载失败不阻塞开机流程）或注释对应的挂载路径。否则授权弃盘迁移后，对应本地盘数据已清空，自动挂载失败会导致实例开机流程失败进入救援模式。具体可参考 [Linux 实例：/etc/fstab 配置错误导致无法登录](https://cloud.tencent.com/document/product/213/72039)。 TaskSubMethod *string `json:"TaskSubMethod,omitnil,omitempty" name:"TaskSubMethod"` } @@ -8892,10 +9043,10 @@ type RepairTaskControlRequest struct { // - `CPM2.0`：裸金属云服务器 Product *string `json:"Product,omitnil,omitempty" name:"Product"` - // 指定待操作的实例ID列表，仅允许对列表中的实例ID相关的维修任务发起授权。 + // 指定待操作的实例ID列表，仅允许对列表中的实例ID相关的维修任务发起授权，可通过 [DescribeTaskInfo](https://cloud.tencent.com/document/api/213/87933) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 维修任务ID。 + // 指定待操作的维修任务ID，可通过 [DescribeTaskInfo](https://cloud.tencent.com/document/api/213/87933) 接口返回值中的`TaskId`获取。 TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"` // 操作类型，当前只支持传入`AuthorizeRepair`。 @@ -8904,7 +9055,12 @@ type RepairTaskControlRequest struct { // 预约授权时间，形如`2023-01-01 12:00:00`。预约时间需晚于当前时间至少5分钟，且在48小时之内。 OrderAuthTime *string `json:"OrderAuthTime,omitnil,omitempty" name:"OrderAuthTime"` - // 附加的授权处理策略。 + // 附加的授权处理策略，不传或为空时，按默认授权方式进行处理。对于支持弃盘迁移授权的维修任务，当且仅当传入`LossyLocal`时，代表本次授权可允许发起弃盘迁移。 + // + // 注意： + // 1. 指定`TaskSubMethod`为`LossyLocal`调用接口发起**弃盘迁移授权**时，本地盘实例的**所有本地盘数据都会清空**，相当于**重新部署本地盘实例**。 + // 2. 对于非本地盘实例，或不支持弃盘迁移选项的任务，指定`TaskSubMethod`为`LossyLocal`时接口不会报错，不过后端会自动忽略该参数。 + // 3. 特别的：如果本地盘实例系统盘是CBS云盘，并且`/etc/fstab`里之前配置了本地盘的自动挂载项，建议可根据业务侧的实际需求，评估是否在对应挂载项追加上`nofail`参数（代表对应挂载点挂载失败不阻塞开机流程）或注释对应的挂载路径。否则授权弃盘迁移后，对应本地盘数据已清空，自动挂载失败会导致实例开机流程失败进入救援模式。具体可参考 [Linux 实例：/etc/fstab 配置错误导致无法登录](https://cloud.tencent.com/document/product/213/72039)。 TaskSubMethod *string `json:"TaskSubMethod,omitnil,omitempty" name:"TaskSubMethod"` } @@ -9075,7 +9231,16 @@ type RepairTaskInfo struct { // 注意：此字段可能返回 null，表示取不到有效值。 TaskSubType *string `json:"TaskSubType,omitnil,omitempty" name:"TaskSubType"` - // 任务授权类型 + // 任务授权类型，当前`AuthType`和维修任务提供的授权选项的对应关系如下： + // + // - `"1"`：仅提供【在线迁移授权】 + // - `"2"`：仅提供【停机授权】 + // - `"3"`：仅提供【在线换盘授权】 + // - `"4"`：提供【停机换盘授权】（默认）、【弃盘迁移授权】（可选） + // - `"5"`：提供【停机授权】（默认）、【弃盘迁移授权】（可选） + // - `"6"`：仅提供【在线维护授权】 + // - `"7"`：提供【在线维护授权】（默认）、【停机授权】（可选） + // - `"8"`：仅提供【弃盘迁移授权】 AuthType *uint64 `json:"AuthType,omitnil,omitempty" name:"AuthType"` // 授权渠道，支持取值： @@ -9693,7 +9858,7 @@ type RunInstancesRequestParams struct { // 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 sgId 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认公共镜像开启云监控、云安全服务；自定义镜像与镜像市场镜像默认不开启云监控，云安全服务，而使用镜像里保留的服务。 @@ -9720,6 +9885,10 @@ type RunInstancesRequestParams struct { // 提供给实例使用的用户数据，需要以 base64 方式编码，支持的最大数据大小为 16KB。关于获取此参数的详细介绍，请参阅[Windows](https://cloud.tencent.com/document/product/213/17526)和[Linux](https://cloud.tencent.com/document/product/213/17525)启动时运行命令。 UserData *string `json:"UserData,omitnil,omitempty" name:"UserData"` + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + // 是否只预检此次请求。 // true：发送检查请求，不会创建实例。检查项包括是否填写了必需参数，请求格式，业务限制和云服务器库存。 // 如果检查不通过，则返回对应错误码； @@ -9730,7 +9899,7 @@ type RunInstancesRequestParams struct { // 描述了实例CPU拓扑结构的相关信息。若不指定该参数，则按系统资源情况决定。 CpuTopology *CpuTopology `json:"CpuTopology,omitnil,omitempty" name:"CpuTopology"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)接口返回值中的`RoleName `获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 @@ -9747,6 +9916,9 @@ type RunInstancesRequestParams struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • true：表示开启实例保护，不允许通过api接口删除实例

  • false：表示关闭实例保护，允许通过api接口删除实例


    • 默认取值：false。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` + + // 实例是否开启巨型帧，取值范围：
  • true：表示实例开启巨型帧，只有支持巨型帧的机型可设置为true。
  • false：表示实例关闭巨型帧，只有支持巨型帧的机型可设置为false。
    支持巨型帧的实例规格： [实例规格](https://cloud.tencent.com/document/product/213/11518) + EnableJumboFrame *bool `json:"EnableJumboFrame,omitnil,omitempty" name:"EnableJumboFrame"` } type RunInstancesRequest struct { @@ -9791,7 +9963,7 @@ type RunInstancesRequest struct { // 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 sgId 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 + // 实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的 `SecurityGroupId` 字段来获取。若不指定该参数，则绑定指定项目下的默认安全组，如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认公共镜像开启云监控、云安全服务；自定义镜像与镜像市场镜像默认不开启云监控，云安全服务，而使用镜像里保留的服务。 @@ -9818,6 +9990,10 @@ type RunInstancesRequest struct { // 提供给实例使用的用户数据，需要以 base64 方式编码，支持的最大数据大小为 16KB。关于获取此参数的详细介绍，请参阅[Windows](https://cloud.tencent.com/document/product/213/17526)和[Linux](https://cloud.tencent.com/document/product/213/17525)启动时运行命令。 UserData *string `json:"UserData,omitnil,omitempty" name:"UserData"` + // 自定义metadata，支持创建 CVM 时添加自定义元数据键值对。 + // **注：内测中**。 + Metadata *Metadata `json:"Metadata,omitnil,omitempty" name:"Metadata"` + // 是否只预检此次请求。 // true：发送检查请求，不会创建实例。检查项包括是否填写了必需参数，请求格式，业务限制和云服务器库存。 // 如果检查不通过，则返回对应错误码； @@ -9828,7 +10004,7 @@ type RunInstancesRequest struct { // 描述了实例CPU拓扑结构的相关信息。若不指定该参数，则按系统资源情况决定。 CpuTopology *CpuTopology `json:"CpuTopology,omitnil,omitempty" name:"CpuTopology"` - // CAM角色名称。可通过[`DescribeRoleList`](https://cloud.tencent.com/document/product/598/13887)接口返回值中的`roleName`获取。 + // CAM角色名称。可通过[ DescribeRoleList ](https://cloud.tencent.com/document/product/598/36223)接口返回值中的`RoleName `获取。 CamRoleName *string `json:"CamRoleName,omitnil,omitempty" name:"CamRoleName"` // 高性能计算集群ID。若创建的实例为高性能计算实例，需指定实例放置的集群，否则不可指定。 @@ -9845,6 +10021,9 @@ type RunInstancesRequest struct { // 实例销毁保护标志，表示是否允许通过api接口删除实例。取值范围：
  • true：表示开启实例保护，不允许通过api接口删除实例

  • false：表示关闭实例保护，允许通过api接口删除实例


    • 默认取值：false。 DisableApiTermination *bool `json:"DisableApiTermination,omitnil,omitempty" name:"DisableApiTermination"` + + // 实例是否开启巨型帧，取值范围：
  • true：表示实例开启巨型帧，只有支持巨型帧的机型可设置为true。
  • false：表示实例关闭巨型帧，只有支持巨型帧的机型可设置为false。
    支持巨型帧的实例规格： [实例规格](https://cloud.tencent.com/document/product/213/11518) + EnableJumboFrame *bool `json:"EnableJumboFrame,omitnil,omitempty" name:"EnableJumboFrame"` } func (r *RunInstancesRequest) ToJsonString() string { @@ -9880,6 +10059,7 @@ func (r *RunInstancesRequest) FromJsonString(s string) error { delete(f, "TagSpecification") delete(f, "InstanceMarketOptions") delete(f, "UserData") + delete(f, "Metadata") delete(f, "DryRun") delete(f, "CpuTopology") delete(f, "CamRoleName") @@ -9888,6 +10068,7 @@ func (r *RunInstancesRequest) FromJsonString(s string) error { delete(f, "DedicatedClusterId") delete(f, "ChcIds") delete(f, "DisableApiTermination") + delete(f, "EnableJumboFrame") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "RunInstancesRequest has unknown keys!", "") } @@ -9930,7 +10111,8 @@ type RunSecurityServiceEnabled struct { } type SharePermission struct { - // 镜像分享时间 + // 镜像分享时间。 + // 按照 ISO8601 标准表示，并且使用 UTC 时间，格式为：YYYY-MM-DDThh:mm:ssZ。 CreatedTime *string `json:"CreatedTime,omitnil,omitempty" name:"CreatedTime"` // 镜像分享的账户ID @@ -10032,6 +10214,8 @@ type StopInstancesRequestParams struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 本参数已弃用，推荐使用StopType，不可以与参数StopType同时使用。表示是否在正常关闭失败后选择强制关闭实例。取值范围：
  • true：表示在正常关闭失败后进行强制关闭
  • false：表示在正常关闭失败后不进行强制关闭

    • 默认取值：false。 + // + // Deprecated: ForceStop is deprecated. ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` // 实例的关闭模式。取值范围：
  • SOFT_FIRST：表示在正常关闭失败后进行强制关闭
  • HARD：直接强制关闭
  • SOFT：仅软关机
    • 默认取值：SOFT。 @@ -10260,6 +10444,7 @@ type SystemDisk struct { DiskSize *int64 `json:"DiskSize,omitnil,omitempty" name:"DiskSize"` // 所属的独享集群ID。 + // 注意：此字段可能返回 null，表示取不到有效值。 CdcId *string `json:"CdcId,omitnil,omitempty" name:"CdcId"` // 磁盘名称，长度不超过128 个字符。 @@ -10275,7 +10460,7 @@ type Tag struct { } type TagSpecification struct { - // 标签绑定的资源类型，云服务器为“instance”，专用宿主机为“host”，镜像为“image”，密钥为“keypair” + // 标签绑定的资源类型，云服务器为“instance”，专用宿主机为“host”，镜像为“image”，密钥为“keypair”，置放群组为“ps”，高性能计算集群为“hpc”。 ResourceType *string `json:"ResourceType,omitnil,omitempty" name:"ResourceType"` // 标签对列表 @@ -10295,6 +10480,12 @@ type TerminateInstancesRequestParams struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` + // 释放弹性IP。EIP2.0下，仅提供主网卡下首个EIP，EIP类型限定在HighQualityEIP、AntiDDoSEIP、EIPv6、HighQualityEIPv6这几种类型。默认行为不释放。 + // + // 示例值：true + // 默认值：false + ReleaseAddress *bool `json:"ReleaseAddress,omitnil,omitempty" name:"ReleaseAddress"` + // 释放实例挂载的包年包月数据盘。true表示销毁实例同时释放包年包月数据盘，false表示只销毁实例。 // 默认值：false ReleasePrepaidDataDisks *bool `json:"ReleasePrepaidDataDisks,omitnil,omitempty" name:"ReleasePrepaidDataDisks"` @@ -10306,6 +10497,12 @@ type TerminateInstancesRequest struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` + // 释放弹性IP。EIP2.0下，仅提供主网卡下首个EIP，EIP类型限定在HighQualityEIP、AntiDDoSEIP、EIPv6、HighQualityEIPv6这几种类型。默认行为不释放。 + // + // 示例值：true + // 默认值：false + ReleaseAddress *bool `json:"ReleaseAddress,omitnil,omitempty" name:"ReleaseAddress"` + // 释放实例挂载的包年包月数据盘。true表示销毁实例同时释放包年包月数据盘，false表示只销毁实例。 // 默认值：false ReleasePrepaidDataDisks *bool `json:"ReleasePrepaidDataDisks,omitnil,omitempty" name:"ReleasePrepaidDataDisks"` @@ -10324,6 +10521,7 @@ func (r *TerminateInstancesRequest) FromJsonString(s string) error { return err } delete(f, "InstanceIds") + delete(f, "ReleaseAddress") delete(f, "ReleasePrepaidDataDisks") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "TerminateInstancesRequest has unknown keys!", "") @@ -10354,7 +10552,7 @@ func (r *TerminateInstancesResponse) FromJsonString(s string) error { } type VirtualPrivateCloud struct { - // 私有网络ID，形如`vpc-xxx`。有效的VpcId可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc?rid=1)查询；也可以调用接口 [DescribeVpcEx](/document/api/215/1372) ，从接口返回中的`unVpcId`字段获取。若在创建子机时VpcId与SubnetId同时传入`DEFAULT`，则强制使用默认vpc网络。 + // 私有网络ID，形如`vpc-xxx`。有效的VpcId可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc?rid=1)查询；也可以调用接口 [DescribeVpcs](https://cloud.tencent.com/document/product/215/15778) ，从接口返回中的`VpcId `字段获取。若在创建子机时VpcId与SubnetId同时传入`DEFAULT`，则强制使用默认vpc网络。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 私有网络子网ID，形如`subnet-xxx`。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet?rid=1)查询；也可以调用接口 [DescribeSubnets](https://cloud.tencent.com/document/product/215/15784) ，从接口返回中的`SubnetId `字段获取。若在创建子机时SubnetId与VpcId同时传入`DEFAULT`，则强制使用默认vpc网络。 diff --git a/vendor/modules.txt b/vendor/modules.txt index d7a7675534..86f5dc6141 100644 --- a/vendor/modules.txt +++ b/vendor/modules.txt @@ -1110,7 +1110,7 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/apigateway/v20180808 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/apm v1.0.825 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/apm/v20210622 -# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1164 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as v1.0.1211 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/as/v20180419 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/bi v1.0.824 @@ -1167,7 +1167,7 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cloudaudit/v20190319 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cls v1.0.1148 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cls/v20201016 -# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1196 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common v1.0.1211 ## explicit; go 1.11 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors @@ -1181,7 +1181,7 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/controlcenter/v20230110 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/csip v1.0.860 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/csip/v20221121 -# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1206 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cwp v1.0.762 diff --git a/website/docs/r/as_scaling_config.html.markdown b/website/docs/r/as_scaling_config.html.markdown index a0d22333a4..a5b1fab834 100644 --- a/website/docs/r/as_scaling_config.html.markdown +++ b/website/docs/r/as_scaling_config.html.markdown @@ -61,7 +61,7 @@ resource "tencentcloud_as_scaling_config" "example" { } ``` -### charge type +### Using SPOTPAID charge type ```hcl data "tencentcloud_images" "example" { @@ -187,12 +187,65 @@ resource "tencentcloud_as_scaling_config" "example" { } ``` +### Create configuration with AntiDDos Eip + +```hcl +data "tencentcloud_images" "example" { + image_type = ["PUBLIC_IMAGE"] + os_name = "TencentOS Server 4 for x86_64" +} + +resource "tencentcloud_as_scaling_config" "example" { + configuration_name = "tf-example" + image_id = data.tencentcloud_images.example.images.0.image_id + instance_types = ["SA5.MEDIUM4"] + project_id = 0 + system_disk_type = "CLOUD_PREMIUM" + system_disk_size = "50" + + data_disk { + disk_type = "CLOUD_PREMIUM" + disk_size = 50 + } + + + internet_charge_type = "BANDWIDTH_PACKAGE" + internet_max_bandwidth_out = 10 + public_ip_assigned = true + bandwidth_package_id = "bwp-4ocyia9s" + ipv4_address_type = "AntiDDoSEIP" + anti_ddos_package_id = "bgp-xxxxxxx" + is_keep_eip = true + password = "Test@123#" + enhanced_security_service = false + enhanced_monitor_service = false + enhanced_automation_tools_service = false + user_data = "dGVzdA==" + + host_name_settings { + host_name = "host-name" + host_name_style = "UNIQUE" + } + + instance_tags = { + tag = "example" + } + + tags = { + "createdBy" = "Terraform" + "owner" = "tf" + } +} +``` + ## Argument Reference The following arguments are supported: * `configuration_name` - (Required, String) Name of a launch configuration. * `instance_types` - (Required, List: [`String`]) Specified types of CVM instances. +* `anti_ddos_package_id` - (Optional, String) Anti-DDoS service package ID. This is required when you want to request an AntiDDoS IP. +* `bandwidth_package_id` - (Optional, String) Bandwidth package ID. * `cam_role_name` - (Optional, String) CAM role name authorized to access. * `data_disk` - (Optional, List) Configurations of data disk. * `dedicated_cluster_id` - (Optional, String) Dedicated Cluster ID. @@ -211,6 +264,8 @@ The following arguments are supported: * `instance_tags` - (Optional, Map) A list of tags used to associate different resources. * `internet_charge_type` - (Optional, String) Charge types for network traffic. Valid values: `BANDWIDTH_PREPAID`, `TRAFFIC_POSTPAID_BY_HOUR` and `BANDWIDTH_PACKAGE`. * `internet_max_bandwidth_out` - (Optional, Int) Max bandwidth of Internet access in Mbps. Default is `0`. +* `ipv4_address_type` - (Optional, String) AddressType. Default value: WanIP. For beta users of dedicated IP. the value can be: HighQualityEIP: Dedicated IP. Note that dedicated IPs are only available in partial regions. For beta users of Anti-DDoS IP, the value can be: AntiDDoSEIP: Anti-DDoS EIP. Note that Anti-DDoS IPs are only available in partial regions. +* `is_keep_eip` - (Optional, Bool) Whether to delete the bound EIP when the instance is destroyed. Range of values: True: retain the EIP; False: not retain the EIP. Note that when the IPv4AddressType field specifies the EIP type, the default behavior is not to retain the EIP. WanIP is unaffected by this field and will always be deleted with the instance. Changing this field configuration will take effect immediately for resources already bound to a scaling group. * `keep_image_login` - (Optional, Bool) Specify whether to keep original settings of a CVM image. And it can't be used with password or key_ids together. * `key_ids` - (Optional, List: [`String`]) ID list of keys. * `password` - (Optional, String) Password to access. diff --git a/website/docs/r/instance.html.markdown b/website/docs/r/instance.html.markdown index f5315856ae..f1e2fe04d5 100644 --- a/website/docs/r/instance.html.markdown +++ b/website/docs/r/instance.html.markdown @@ -19,6 +19,8 @@ Provides a CVM instance resource. ~> **NOTE:** When creating a CVM instance using a `launch_template_id`, if you set other parameter values ​​at the same time, the template definition values ​​will be overwritten. +~> **NOTE:** It is recommended to use resource `tencentcloud_eip` to create a AntiDDos Eip, and then call resource `tencentcloud_eip_association` to bind it to resource `tencentcloud_instance`. + ## Example Usage ### Create a general POSTPAID_BY_HOUR CVM instance @@ -254,11 +256,43 @@ resource "tencentcloud_instance" "example" { } ``` +### Create CVM instance with AntiDDos Eip + +```hcl +resource "tencentcloud_instance" "example" { + instance_name = "tf-example" + availability_zone = "ap-guangzhou-6" + image_id = "img-eb30mz89" + instance_type = "S5.MEDIUM4" + system_disk_type = "CLOUD_HSSD" + system_disk_size = 50 + hostname = "user" + project_id = 0 + vpc_id = "vpc-i5yyodl9" + subnet_id = "subnet-hhi88a58" + internet_charge_type = "BANDWIDTH_PACKAGE" + bandwidth_package_id = "bwp-4ocyia9s" + ipv4_address_type = "AntiDDoSEIP" + anti_ddos_package_id = "bgp-xxxxxxx" + + data_disks { + data_disk_type = "CLOUD_HSSD" + data_disk_size = 100 + encrypt = false + } + + tags = { + tagKey = "tagValue" + } +} +``` + ## Argument Reference The following arguments are supported: * `allocate_public_ip` - (Optional, Bool, ForceNew) Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false. +* `anti_ddos_package_id` - (Optional, String, ForceNew) Anti-DDoS service package ID. This is required when you want to request an AntiDDoS IP. * `availability_zone` - (Optional, String, ForceNew) The available zone for the CVM instance. * `bandwidth_package_id` - (Optional, String) bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id. * `cam_role_name` - (Optional, String) CAM role name authorized to access. @@ -282,6 +316,7 @@ The following arguments are supported: * `instance_type` - (Optional, String) The type of the instance. * `internet_charge_type` - (Optional, String) Internet charge type of the instance, Valid values are `BANDWIDTH_PREPAID`, `TRAFFIC_POSTPAID_BY_HOUR`, `BANDWIDTH_POSTPAID_BY_HOUR` and `BANDWIDTH_PACKAGE`. If not set, internet charge type are consistent with the cvm charge type by default. This value takes NO Effect when changing and does not need to be set when `allocate_public_ip` is false. * `internet_max_bandwidth_out` - (Optional, Int) Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when `allocate_public_ip` is false. +* `ipv4_address_type` - (Optional, String, ForceNew) AddressType. Default value: WanIP. For beta users of dedicated IP. the value can be: HighQualityEIP: Dedicated IP. Note that dedicated IPs are only available in partial regions. For beta users of Anti-DDoS IP, the value can be: AntiDDoSEIP: Anti-DDoS EIP. Note that Anti-DDoS IPs are only available in partial regions. * `keep_image_login` - (Optional, Bool) Whether to keep image login or not, default is `false`. When the image type is private or shared or imported, this parameter can be set `true`. Modifications may lead to the reinstallation of the instance's operating system.. * `key_ids` - (Optional, Set: [`String`]) The key pair to use for the instance, it looks like `skey-16jig7tx`. Modifications may lead to the reinstallation of the instance's operating system. * `key_name` - (Optional, String, **Deprecated**) Please use `key_ids` instead. The key pair to use for the instance, it looks like `skey-16jig7tx`. Modifications may lead to the reinstallation of the instance's operating system.