diff --git a/go.mod b/go.mod index 4eddfc13d4..cf9ebe4ca1 100644 --- a/go.mod +++ b/go.mod @@ -47,7 +47,7 @@ require ( 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.1154 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1128 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cwp v1.0.762 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cynosdb v1.0.1111 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/dayu v1.0.335 @@ -107,7 +107,7 @@ require ( require ( github.com/hashicorp/go-uuid v1.0.3 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.970 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdwdoris v1.0.993 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdwpg v1.0.1126 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/controlcenter v1.0.993 diff --git a/go.sum b/go.sum index 15ef9cbec0..6f567e3721 100644 --- a/go.sum +++ b/go.sum @@ -845,6 +845,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944 h1:+PGoNHl github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944/go.mod h1:+VHcZ4Cnzpt6vtCvNROz8xWfNWUkoAZ9UPSonbA3NWM= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.970 h1:0A6PwOaUeLtm4U5TR1uD91ETBgDcnfqFnsG9mwCNvlY= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.970/go.mod h1:H4k8QCKds731GA9pmSOfHJ99ZOZhy+gKvX1/N2DOsQQ= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149 h1:lW1auC8TdFa4NkE6ORzslUrP3lcGigdd0X8/4T+pY40= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149/go.mod h1:LDcZtoh9sKi/2/Tze53H64C4G3CzzHN22AWsflf3Cn4= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdn v1.0.1010 h1:sO0vW6E09xFQ5+I8mfvAyIlRZvWBWPf6ilZU5LI4lmE= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdn v1.0.1010/go.mod h1:/UDEkf2UhUud19VVMGMTpyiI7HoE3U/c23uoAqDgIWA= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdwch v1.0.843 h1:3Xr3UPscUfi5jAzCtwQjDfDf4TPsbUxsCrDdHo6xIRI= @@ -969,6 +971,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/csip v1.0.860 h1:F3esKB github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/csip v1.0.860/go.mod h1:NZo1WplQcC314kMlCRUoy8NQju2BnolIJj7NAWgsuhY= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1128 h1:qoSzTKnmGdXlfphMoEwqgaGjs5gwOy/PqzMu7dlLHNM= 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/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/provider.go b/tencentcloud/provider.go index e13c1928f5..cce4b0c8e5 100644 --- a/tencentcloud/provider.go +++ b/tencentcloud/provider.go @@ -2323,6 +2323,7 @@ func Provider() *schema.Provider { "tencentcloud_kubernetes_native_node_pool": tke.ResourceTencentCloudKubernetesNativeNodePool(), "tencentcloud_cdc_site": cdc.ResourceTencentCloudCdcSite(), "tencentcloud_cdc_dedicated_cluster": cdc.ResourceTencentCloudCdcDedicatedCluster(), + "tencentcloud_cdc_dedicated_cluster_image_cache": cdc.ResourceTencentCloudDedicatedClusterImageCache(), "tencentcloud_cdwdoris_instance": cdwdoris.ResourceTencentCloudCdwdorisInstance(), "tencentcloud_cdwdoris_workload_group": cdwdoris.ResourceTencentCloudCdwdorisWorkloadGroup(), //"tencentcloud_cdwdoris_user": cdwdoris.ResourceTencentCloudCdwdorisUser(), diff --git a/tencentcloud/provider.md b/tencentcloud/provider.md index 92e7fc4a8f..df55dc54eb 100644 --- a/tencentcloud/provider.md +++ b/tencentcloud/provider.md @@ -2289,6 +2289,7 @@ tencentcloud_cdc_dedicated_clusters Resource tencentcloud_cdc_site tencentcloud_cdc_dedicated_cluster +tencentcloud_cdc_dedicated_cluster_image_cache CdwDoris Data Source diff --git a/tencentcloud/services/cdc/extension_cdc.go b/tencentcloud/services/cdc/extension_cdc.go new file mode 100644 index 0000000000..66ef2b6d68 --- /dev/null +++ b/tencentcloud/services/cdc/extension_cdc.go @@ -0,0 +1,8 @@ +package cdc + +const ( + CDC_CACHE_STATUS_CACHED = "CACHED" + CDC_CACHE_STATUS_CACHE_FAILED = "CACHE_FAILED" + CDC_CACHE_STATUS_CACHED_ALL = "CACHED_ALL" + CDC_CACHE_STATUS_NO_CACHE = "NO_CACHE" +) diff --git a/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.go b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.go new file mode 100644 index 0000000000..edd4c69595 --- /dev/null +++ b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.go @@ -0,0 +1,176 @@ +package cdc + +import ( + "context" + "fmt" + "log" + "strings" + "time" + + "github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource" + "github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema" + cdc "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214" + sdkErrors "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors" + cvm "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312" + tccommon "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/common" + "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/internal/helper" +) + +func ResourceTencentCloudDedicatedClusterImageCache() *schema.Resource { + return &schema.Resource{ + Create: ResourceTencentCloudCdcDedicatedClusterImageCacheCreate, + Read: ResourceTencentCloudCdcDedicatedClusterImageCacheRead, + Delete: ResourceTencentCloudCdcDedicatedClusterImageCacheDelete, + Importer: &schema.ResourceImporter{ + State: schema.ImportStatePassthrough, + }, + Schema: map[string]*schema.Schema{ + "dedicated_cluster_id": { + Required: true, + ForceNew: true, + Type: schema.TypeString, + Description: "Cluster ID.", + }, + "image_id": { + Required: true, + ForceNew: true, + Type: schema.TypeString, + Description: "Image ID.", + }, + }, + } +} + +func ResourceTencentCloudCdcDedicatedClusterImageCacheCreate(d *schema.ResourceData, meta interface{}) error { + defer tccommon.LogElapsed("resource.tencentcloud_cdc_dedicated_cluster_image_cache.create")() + + var ( + logId = tccommon.GetLogId(tccommon.ContextNil) + request = cdc.NewCreateDedicatedClusterImageCacheRequest() + dedicatedClusterId string + image string + ) + + if v, ok := d.GetOk("dedicated_cluster_id"); ok { + dedicatedClusterId = v.(string) + request.DedicatedClusterId = helper.String(dedicatedClusterId) + } + + if v, ok := d.GetOk("image_id"); ok { + image = v.(string) + request.ImageId = helper.String(image) + } + + err := resource.Retry(tccommon.WriteRetryTimeout, func() *resource.RetryError { + result, e := meta.(tccommon.ProviderMeta).GetAPIV3Conn().UseCdcClient().CreateDedicatedClusterImageCache(request) + if e != nil { + return tccommon.RetryError(e) + } else { + log.Printf("[DEBUG]%s api[%s] success, request body [%s], response body [%s]\n", logId, request.GetAction(), request.ToJsonString(), result.ToJsonString()) + } + + return nil + }) + + if err != nil { + log.Printf("[CRITAL]%s create cdc dedicatedClusterImageCache failed, reason:%+v", logId, err) + return err + } + + d.SetId(strings.Join([]string{dedicatedClusterId, image}, tccommon.FILED_SP)) + + service := CdcService{client: meta.(tccommon.ProviderMeta).GetAPIV3Conn()} + conf := tccommon.BuildStateChangeConf([]string{}, []string{CDC_CACHE_STATUS_CACHED, CDC_CACHE_STATUS_CACHE_FAILED}, 20*tccommon.ReadRetryTimeout, time.Second, service.DedicatedClusterImageCacheStateRefreshFunc(dedicatedClusterId, image, CDC_CACHE_STATUS_CACHED_ALL, []string{})) + if object, e := conf.WaitForState(); e != nil { + return e + } else { + imageCacheState := object.(*cvm.Image) + if imageCacheState.CdcCacheStatus != nil && *imageCacheState.CdcCacheStatus == CDC_CACHE_STATUS_CACHE_FAILED { + return fmt.Errorf("cache failed") + } + } + + return ResourceTencentCloudCdcDedicatedClusterImageCacheRead(d, meta) +} + +func ResourceTencentCloudCdcDedicatedClusterImageCacheRead(d *schema.ResourceData, meta interface{}) error { + defer tccommon.LogElapsed("resource.tencentcloud_cdc_dedicated_cluster_image_cache.read")() + + var ( + logId = tccommon.GetLogId(tccommon.ContextNil) + ctx = context.WithValue(context.TODO(), tccommon.LogIdKey, logId) + service = CdcService{client: meta.(tccommon.ProviderMeta).GetAPIV3Conn()} + ) + + idSplit := strings.Split(d.Id(), tccommon.FILED_SP) + if len(idSplit) != 2 { + return fmt.Errorf("id is broken,%s", d.Id()) + } + images, err := service.DescribeImages(ctx, idSplit[0], idSplit[1], CDC_CACHE_STATUS_CACHED_ALL) + if err != nil { + return err + } + + if len(images) == 0 { + d.SetId("") + log.Printf("[WARN]%s resource `CdcDedicatedClusterImageCache` [%s] not found, please check if it has been deleted.\n", logId, d.Id()) + return nil + } + + if images[0].CdcCacheStatus != nil && *images[0].CdcCacheStatus == CDC_CACHE_STATUS_CACHED { + _ = d.Set("dedicated_cluster_id", idSplit[0]) + _ = d.Set("image_id", idSplit[1]) + } else { + d.SetId("") + log.Printf("[WARN]%s resource `CdcDedicatedClusterImageCache` [%s] not found, please check if it has been deleted.\n", logId, d.Id()) + return nil + } + + return nil +} + +func ResourceTencentCloudCdcDedicatedClusterImageCacheDelete(d *schema.ResourceData, meta interface{}) error { + defer tccommon.LogElapsed("resource.tencentcloud_cdc_dedicated_cluster_image_cache.delete")() + + var ( + logId = tccommon.GetLogId(tccommon.ContextNil) + request = cdc.NewDeleteDedicatedClusterImageCacheRequest() + ) + + idSplit := strings.Split(d.Id(), tccommon.FILED_SP) + if len(idSplit) != 2 { + return fmt.Errorf("id is broken,%s", d.Id()) + } + + request.DedicatedClusterId = helper.String(idSplit[0]) + request.ImageId = helper.String(idSplit[1]) + + err := resource.Retry(tccommon.WriteRetryTimeout, func() *resource.RetryError { + result, e := meta.(tccommon.ProviderMeta).GetAPIV3Conn().UseCdcClient().DeleteDedicatedClusterImageCache(request) + if e != nil { + if sdkerr, ok := e.(*sdkErrors.TencentCloudSDKError); ok { + if sdkerr.Code == "InvalidParameter.ImageNotCacheInCdc" { + return nil + } + } + return tccommon.RetryError(e) + } else { + log.Printf("[DEBUG]%s api[%s] success, request body [%s], response body [%s]\n", logId, request.GetAction(), request.ToJsonString(), result.ToJsonString()) + } + + return nil + }) + + if err != nil { + log.Printf("[CRITAL]%s delete cdc dedicatedClusterImageCache failed, reason:%+v", logId, err) + return err + } + + service := CdcService{client: meta.(tccommon.ProviderMeta).GetAPIV3Conn()} + conf := tccommon.BuildStateChangeConf([]string{}, []string{CDC_CACHE_STATUS_NO_CACHE}, 20*tccommon.ReadRetryTimeout, time.Second, service.DedicatedClusterImageCacheStateRefreshFunc(idSplit[0], idSplit[1], CDC_CACHE_STATUS_NO_CACHE, []string{})) + if _, e := conf.WaitForState(); e != nil { + return e + } + + return nil +} diff --git a/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.md b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.md new file mode 100644 index 0000000000..0cf0d7cea4 --- /dev/null +++ b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache.md @@ -0,0 +1,18 @@ +Provides a resource to create a CDC dedicated cluster image cache + +Example Usage + +```hcl +resource "tencentcloud_cdc_dedicated_cluster_image_cache" "cdc_dedicated_cluster_image_cache" { + dedicated_cluster_id = "cluster-262n63e8" + image_id = "img-eb30mz89" +} +``` + +Import + +CDC dedicated cluster image cache can be imported using the id, e.g. + +``` +terraform import tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache ${dedicated_cluster_id}#${image_id} +``` \ No newline at end of file diff --git a/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache_test.go b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache_test.go new file mode 100644 index 0000000000..e4c09bf4c5 --- /dev/null +++ b/tencentcloud/services/cdc/resource_tc_cdc_dedicated_cluster_image_cache_test.go @@ -0,0 +1,40 @@ +package cdc_test + +import ( + "testing" + + "github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource" + tcacctest "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/acctest" +) + +func TestAccTencentCloudCdcDedicatedClusterImageCacheResource_basic(t *testing.T) { + t.Parallel() + resource.Test(t, resource.TestCase{ + PreCheck: func() { + tcacctest.AccPreCheck(t) + }, + Providers: tcacctest.AccProviders, + Steps: []resource.TestStep{ + { + Config: testAccCdcDedicatedClusterImageCache, + Check: resource.ComposeTestCheckFunc( + resource.TestCheckResourceAttrSet("tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache", "id"), + resource.TestCheckResourceAttr("tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache", "dedicated_cluster_id", "cluster-262n63e8"), + resource.TestCheckResourceAttr("tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache", "image_id", "img-eb30mz89"), + ), + }, + { + ResourceName: "tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache", + ImportState: true, + ImportStateVerify: true, + }, + }, + }) +} + +const testAccCdcDedicatedClusterImageCache = ` +resource "tencentcloud_cdc_dedicated_cluster_image_cache" "cdc_dedicated_cluster_image_cache" { + dedicated_cluster_id = "cluster-262n63e8" + image_id = "img-eb30mz89" +} +` diff --git a/tencentcloud/services/cdc/service_tencentcloud_cdc.go b/tencentcloud/services/cdc/service_tencentcloud_cdc.go index 78a7f90405..aea071544c 100644 --- a/tencentcloud/services/cdc/service_tencentcloud_cdc.go +++ b/tencentcloud/services/cdc/service_tencentcloud_cdc.go @@ -2,9 +2,12 @@ package cdc import ( "context" + "fmt" "log" + "github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource" cdc "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214" + cvm "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312" tccommon "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/common" "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/connectivity" "github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/internal/helper" @@ -312,3 +315,66 @@ func (me *CdcService) DescribeCdcDedicatedClustersByFilter(ctx context.Context, return } + +func (me *CdcService) DescribeImages(ctx context.Context, dedicatedClusterId string, imageId string, cdcCacheStatus string) (images []*cvm.Image, errRet error) { + logId := tccommon.GetLogId(ctx) + request := cvm.NewDescribeImagesRequest() + request.Filters = []*cvm.Filter{ + { + Name: helper.String("image-id"), + Values: helper.Strings([]string{imageId}), + }, + { + Name: helper.String("image-state"), + Values: helper.Strings([]string{"NORMAL", "SYNCING", "EXPORTING"}), + }, + { + Name: helper.String("dedicated-cluster-id"), + Values: helper.Strings([]string{dedicatedClusterId}), + }, + { + Name: helper.String("cdc-cache-status"), + Values: helper.Strings([]string{cdcCacheStatus}), + }, + } + + err := resource.Retry(20*tccommon.ReadRetryTimeout, func() *resource.RetryError { + ratelimit.Check(request.GetAction()) + response, err := me.client.UseCvmClient().DescribeImages(request) + if err != nil { + return resource.RetryableError(err) + } + if response != nil && response.Response != nil { + if len(response.Response.ImageSet) > 0 { + images = response.Response.ImageSet + } + return nil + } + return resource.NonRetryableError(fmt.Errorf("response is null")) + }) + + if err != nil { + log.Printf("[CRITAL]%s api[%s] fail, request body [%s], reason[%s]", + logId, request.GetAction(), request.ToJsonString(), err.Error()) + errRet = err + return + } + return +} + +func (me *CdcService) DedicatedClusterImageCacheStateRefreshFunc(dedicatedClusterId string, imageId string, cdcCacheStatus string, failStates []string) resource.StateRefreshFunc { + return func() (interface{}, string, error) { + ctx := tccommon.ContextNil + images, err := me.DescribeImages(ctx, dedicatedClusterId, imageId, cdcCacheStatus) + + if err != nil { + return nil, "", err + } + + if len(images) < 1 { + return nil, "", fmt.Errorf("Not found image.") + } + + return images[0], helper.PString(images[0].CdcCacheStatus), nil + } +} diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/client.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/client.go index 559d50ed06..c0769b40d6 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/client.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/client.go @@ -100,6 +100,61 @@ func (c *Client) CreateDedicatedClusterWithContext(ctx context.Context, request return } +func NewCreateDedicatedClusterImageCacheRequest() (request *CreateDedicatedClusterImageCacheRequest) { + request = &CreateDedicatedClusterImageCacheRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdc", APIVersion, "CreateDedicatedClusterImageCache") + + + return +} + +func NewCreateDedicatedClusterImageCacheResponse() (response *CreateDedicatedClusterImageCacheResponse) { + response = &CreateDedicatedClusterImageCacheResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// CreateDedicatedClusterImageCache +// 创建云上镜像缓存到本地专用集群中 +// +// 可能返回的错误码: +// INTERNALERROR = "InternalError" +// INVALIDPARAMETER_IMAGEISCACHEDINCDC = "InvalidParameter.ImageIsCachedInCdc" +// LIMITEXCEEDED_CDCIMAGETASKQUOTA = "LimitExceeded.CdcImageTaskQuota" +// UNSUPPORTEDOPERATION_SYNCCDCIMAGENOTSUPPORT = "UnsupportedOperation.SyncCdcImageNotSupport" +func (c *Client) CreateDedicatedClusterImageCache(request *CreateDedicatedClusterImageCacheRequest) (response *CreateDedicatedClusterImageCacheResponse, err error) { + return c.CreateDedicatedClusterImageCacheWithContext(context.Background(), request) +} + +// CreateDedicatedClusterImageCache +// 创建云上镜像缓存到本地专用集群中 +// +// 可能返回的错误码: +// INTERNALERROR = "InternalError" +// INVALIDPARAMETER_IMAGEISCACHEDINCDC = "InvalidParameter.ImageIsCachedInCdc" +// LIMITEXCEEDED_CDCIMAGETASKQUOTA = "LimitExceeded.CdcImageTaskQuota" +// UNSUPPORTEDOPERATION_SYNCCDCIMAGENOTSUPPORT = "UnsupportedOperation.SyncCdcImageNotSupport" +func (c *Client) CreateDedicatedClusterImageCacheWithContext(ctx context.Context, request *CreateDedicatedClusterImageCacheRequest) (response *CreateDedicatedClusterImageCacheResponse, err error) { + if request == nil { + request = NewCreateDedicatedClusterImageCacheRequest() + } + + if c.GetCredential() == nil { + return nil, errors.New("CreateDedicatedClusterImageCache require credential") + } + + request.SetContext(ctx) + + response = NewCreateDedicatedClusterImageCacheResponse() + err = c.Send(request, response) + return +} + func NewCreateDedicatedClusterOrderRequest() (request *CreateDedicatedClusterOrderRequest) { request = &CreateDedicatedClusterOrderRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -212,6 +267,61 @@ func (c *Client) CreateSiteWithContext(ctx context.Context, request *CreateSiteR return } +func NewDeleteDedicatedClusterImageCacheRequest() (request *DeleteDedicatedClusterImageCacheRequest) { + request = &DeleteDedicatedClusterImageCacheRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdc", APIVersion, "DeleteDedicatedClusterImageCache") + + + return +} + +func NewDeleteDedicatedClusterImageCacheResponse() (response *DeleteDedicatedClusterImageCacheResponse) { + response = &DeleteDedicatedClusterImageCacheResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DeleteDedicatedClusterImageCache +// 删除本地专用集群的云上镜像缓存 +// +// 可能返回的错误码: +// FAILEDOPERATION_INVALIDIMAGESTATE = "FailedOperation.InvalidImageState" +// INTERNALERROR = "InternalError" +// INVALIDPARAMETER_IMAGENOTCACHEINCDC = "InvalidParameter.ImageNotCacheInCdc" +// UNSUPPORTEDOPERATION_SYNCCDCIMAGENOTSUPPORT = "UnsupportedOperation.SyncCdcImageNotSupport" +func (c *Client) DeleteDedicatedClusterImageCache(request *DeleteDedicatedClusterImageCacheRequest) (response *DeleteDedicatedClusterImageCacheResponse, err error) { + return c.DeleteDedicatedClusterImageCacheWithContext(context.Background(), request) +} + +// DeleteDedicatedClusterImageCache +// 删除本地专用集群的云上镜像缓存 +// +// 可能返回的错误码: +// FAILEDOPERATION_INVALIDIMAGESTATE = "FailedOperation.InvalidImageState" +// INTERNALERROR = "InternalError" +// INVALIDPARAMETER_IMAGENOTCACHEINCDC = "InvalidParameter.ImageNotCacheInCdc" +// UNSUPPORTEDOPERATION_SYNCCDCIMAGENOTSUPPORT = "UnsupportedOperation.SyncCdcImageNotSupport" +func (c *Client) DeleteDedicatedClusterImageCacheWithContext(ctx context.Context, request *DeleteDedicatedClusterImageCacheRequest) (response *DeleteDedicatedClusterImageCacheResponse, err error) { + if request == nil { + request = NewDeleteDedicatedClusterImageCacheRequest() + } + + if c.GetCredential() == nil { + return nil, errors.New("DeleteDedicatedClusterImageCache require credential") + } + + request.SetContext(ctx) + + response = NewDeleteDedicatedClusterImageCacheResponse() + err = c.Send(request, response) + return +} + func NewDeleteDedicatedClustersRequest() (request *DeleteDedicatedClustersRequest) { request = &DeleteDedicatedClustersRequest{ BaseRequest: &tchttp.BaseRequest{}, diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/errors.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/errors.go index 3cab5c23a2..b33ae80f78 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/errors.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/errors.go @@ -23,6 +23,18 @@ const ( // 删除site失败。 FAILEDOPERATION_FAILDELETESITE = "FailedOperation.FailDeleteSite" + // 镜像的状态不支持镜像同步 + FAILEDOPERATION_INVALIDIMAGESTATE = "FailedOperation.InvalidImageState" + + // 内部错误。 + INTERNALERROR = "InternalError" + + // 当前镜像已经在本地专用集群中缓存 + INVALIDPARAMETER_IMAGEISCACHEDINCDC = "InvalidParameter.ImageIsCachedInCdc" + + // 当前镜像没有在本地专用集群中缓存 + INVALIDPARAMETER_IMAGENOTCACHEINCDC = "InvalidParameter.ImageNotCacheInCdc" + // 该机型暂不支持。 INVALIDPARAMETER_INSTANCETYPENOTSUPPORT = "InvalidParameter.InstanceTypeNotSupport" @@ -56,6 +68,9 @@ const ( // 当前可用区暂未支持。 INVALIDPARAMETERVALUE_ZONENOTSUPPORTED = "InvalidParameterValue.ZoneNotSupported" + // 当前集群的镜像任务数量已达上限 + LIMITEXCEEDED_CDCIMAGETASKQUOTA = "LimitExceeded.CdcImageTaskQuota" + // 缺少参数错误。 MISSINGPARAMETER = "MissingParameter" @@ -79,4 +94,7 @@ const ( // 不支持非CUSTOMER类型的app id。 UNSUPPORTEDOPERATION_NONCUSTOMERAPPIDNOTSUPPORT = "UnsupportedOperation.NonCustomerAppIdNotSupport" + + // 账户不支持cdc镜像同步,需要先加白 + UNSUPPORTEDOPERATION_SYNCCDCIMAGENOTSUPPORT = "UnsupportedOperation.SyncCdcImageNotSupport" ) diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/models.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/models.go index 28df0ca565..7c8c6f55cd 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/models.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214/models.go @@ -47,6 +47,70 @@ type CosInfo struct { Type *string `json:"Type,omitnil,omitempty" name:"Type"` } +// Predefined struct for user +type CreateDedicatedClusterImageCacheRequestParams struct { + // 集群ID + DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` + + // 镜像ID + ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` +} + +type CreateDedicatedClusterImageCacheRequest struct { + *tchttp.BaseRequest + + // 集群ID + DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` + + // 镜像ID + ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` +} + +func (r *CreateDedicatedClusterImageCacheRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *CreateDedicatedClusterImageCacheRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "DedicatedClusterId") + delete(f, "ImageId") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateDedicatedClusterImageCacheRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type CreateDedicatedClusterImageCacheResponseParams struct { + // 任务id + TaskId *int64 `json:"TaskId,omitnil,omitempty" name:"TaskId"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type CreateDedicatedClusterImageCacheResponse struct { + *tchttp.BaseResponse + Response *CreateDedicatedClusterImageCacheResponseParams `json:"Response"` +} + +func (r *CreateDedicatedClusterImageCacheResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *CreateDedicatedClusterImageCacheResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type CreateDedicatedClusterOrderRequestParams struct { // 专用集群id @@ -64,7 +128,7 @@ type CreateDedicatedClusterOrderRequestParams struct { // 购买来源,默认为cloudApi PurchaseSource *string `json:"PurchaseSource,omitnil,omitempty" name:"PurchaseSource"` - // 当调用API接口提交订单时,需要提交DedicatedClusterOrderId + // 当调用API接口提交订单时,需要提交DedicatedClusterOrderId,此处DedicatedClusterOrderId是之前创建的订单,可通过DescribeDedicatedClusterOrders接口查询,这里传入DedicatedClusterOrderId用于调整订单和支付。 DedicatedClusterOrderId *string `json:"DedicatedClusterOrderId,omitnil,omitempty" name:"DedicatedClusterOrderId"` } @@ -86,7 +150,7 @@ type CreateDedicatedClusterOrderRequest struct { // 购买来源,默认为cloudApi PurchaseSource *string `json:"PurchaseSource,omitnil,omitempty" name:"PurchaseSource"` - // 当调用API接口提交订单时,需要提交DedicatedClusterOrderId + // 当调用API接口提交订单时,需要提交DedicatedClusterOrderId,此处DedicatedClusterOrderId是之前创建的订单,可通过DescribeDedicatedClusterOrders接口查询,这里传入DedicatedClusterOrderId用于调整订单和支付。 DedicatedClusterOrderId *string `json:"DedicatedClusterOrderId,omitnil,omitempty" name:"DedicatedClusterOrderId"` } @@ -117,7 +181,6 @@ func (r *CreateDedicatedClusterOrderRequest) FromJsonString(s string) error { // Predefined struct for user type CreateDedicatedClusterOrderResponseParams struct { // 专用集群订单id - // 注意:此字段可能返回 null,表示取不到有效值。 DedicatedClusterOrderId *string `json:"DedicatedClusterOrderId,omitnil,omitempty" name:"DedicatedClusterOrderId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -241,7 +304,7 @@ type CreateSiteRequestParams struct { // 注意事项 Note *string `json:"Note,omitnil,omitempty" name:"Note"` - // 您将使用光纤类型将CDC设备连接到网络。有单模和多模两种选项。 + // 您将使用光纤类型将CDC设备连接到网络。有单模和多模两种选项。取值范围:"MM","SM" FiberType *string `json:"FiberType,omitnil,omitempty" name:"FiberType"` // 您将CDC连接到网络时采用的光学标准。此字段取决于上行链路速度、光纤类型和到上游设备的距离。 @@ -250,7 +313,7 @@ type CreateSiteRequestParams struct { // 电源连接器类型 PowerConnectors *string `json:"PowerConnectors,omitnil,omitempty" name:"PowerConnectors"` - // 从机架上方还是下方供电。 + // 从机架上方还是下方供电。取值范围:["UP","DOWN"] PowerFeedDrop *string `json:"PowerFeedDrop,omitnil,omitempty" name:"PowerFeedDrop"` // 最大承重(KG) @@ -259,7 +322,7 @@ type CreateSiteRequestParams struct { // 功耗(KW) PowerDrawKva *int64 `json:"PowerDrawKva,omitnil,omitempty" name:"PowerDrawKva"` - // 网络到腾讯云Region区域的上行链路速度 + // 网络到腾讯云Region区域的上行链路速度(Gbps) UplinkSpeedGbps *int64 `json:"UplinkSpeedGbps,omitnil,omitempty" name:"UplinkSpeedGbps"` // 将CDC连接到网络时,每台CDC网络设备(每个机架 2 台设备)使用的上行链路数量。 @@ -322,7 +385,7 @@ type CreateSiteRequest struct { // 注意事项 Note *string `json:"Note,omitnil,omitempty" name:"Note"` - // 您将使用光纤类型将CDC设备连接到网络。有单模和多模两种选项。 + // 您将使用光纤类型将CDC设备连接到网络。有单模和多模两种选项。取值范围:"MM","SM" FiberType *string `json:"FiberType,omitnil,omitempty" name:"FiberType"` // 您将CDC连接到网络时采用的光学标准。此字段取决于上行链路速度、光纤类型和到上游设备的距离。 @@ -331,7 +394,7 @@ type CreateSiteRequest struct { // 电源连接器类型 PowerConnectors *string `json:"PowerConnectors,omitnil,omitempty" name:"PowerConnectors"` - // 从机架上方还是下方供电。 + // 从机架上方还是下方供电。取值范围:["UP","DOWN"] PowerFeedDrop *string `json:"PowerFeedDrop,omitnil,omitempty" name:"PowerFeedDrop"` // 最大承重(KG) @@ -340,7 +403,7 @@ type CreateSiteRequest struct { // 功耗(KW) PowerDrawKva *int64 `json:"PowerDrawKva,omitnil,omitempty" name:"PowerDrawKva"` - // 网络到腾讯云Region区域的上行链路速度 + // 网络到腾讯云Region区域的上行链路速度(Gbps) UplinkSpeedGbps *int64 `json:"UplinkSpeedGbps,omitnil,omitempty" name:"UplinkSpeedGbps"` // 将CDC连接到网络时,每台CDC网络设备(每个机架 2 台设备)使用的上行链路数量。 @@ -453,7 +516,6 @@ type DedicatedCluster struct { Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 专用集群的描述。 - // 注意:此字段可能返回 null,表示取不到有效值。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 专用集群的名称。 @@ -467,6 +529,9 @@ type DedicatedCluster struct { // 专用集群所属的站点id。 SiteId *string `json:"SiteId,omitnil,omitempty" name:"SiteId"` + + // 专用集群的运营状态 + RunningStatus *string `json:"RunningStatus,omitnil,omitempty" name:"RunningStatus"` } type DedicatedClusterInstanceType struct { @@ -512,7 +577,7 @@ type DedicatedClusterInstanceType struct { // 机型描述 Remark *string `json:"Remark,omitnil,omitempty" name:"Remark"` - // 实例是否售卖。取值范围:
  • SELL:表示实例可购买
  • SOLD_OUT:表示实例已售罄。 + // 实例是否售卖。取值范围:
  • SELL:表示实例可购买
  • SOLD_OUT:表示实例已售罄。
  • Status *string `json:"Status,omitnil,omitempty" name:"Status"` } @@ -551,39 +616,30 @@ type DedicatedClusterOrder struct { Action *string `json:"Action,omitnil,omitempty" name:"Action"` // 子订单详情列表 - // 注意:此字段可能返回 null,表示取不到有效值。 DedicatedClusterOrderItems []*DedicatedClusterOrderItem `json:"DedicatedClusterOrderItems,omitnil,omitempty" name:"DedicatedClusterOrderItems"` // cpu值 - // 注意:此字段可能返回 null,表示取不到有效值。 Cpu *int64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` // mem值 - // 注意:此字段可能返回 null,表示取不到有效值。 Mem *int64 `json:"Mem,omitnil,omitempty" name:"Mem"` // gpu值 - // 注意:此字段可能返回 null,表示取不到有效值。 Gpu *int64 `json:"Gpu,omitnil,omitempty" name:"Gpu"` // 0代表未支付,1代表已支付 - // 注意:此字段可能返回 null,表示取不到有效值。 PayStatus *int64 `json:"PayStatus,omitnil,omitempty" name:"PayStatus"` // 支付方式,一次性、按月、按年 - // 注意:此字段可能返回 null,表示取不到有效值。 PayType *string `json:"PayType,omitnil,omitempty" name:"PayType"` // 购买时长的单位 - // 注意:此字段可能返回 null,表示取不到有效值。 TimeUnit *string `json:"TimeUnit,omitnil,omitempty" name:"TimeUnit"` // 购买时长 - // 注意:此字段可能返回 null,表示取不到有效值。 TimeSpan *int64 `json:"TimeSpan,omitnil,omitempty" name:"TimeSpan"` // 订单类型 - // 注意:此字段可能返回 null,表示取不到有效值。 OrderType *string `json:"OrderType,omitnil,omitempty" name:"OrderType"` // 验收状态 @@ -665,15 +721,12 @@ type DedicatedClusterOrderItem struct { TypeName *string `json:"TypeName,omitnil,omitempty" name:"TypeName"` // 规格展示 - // 注意:此字段可能返回 null,表示取不到有效值。 ComputeFormat *string `json:"ComputeFormat,omitnil,omitempty" name:"ComputeFormat"` // 规格类型 - // 注意:此字段可能返回 null,表示取不到有效值。 TypeFamily *string `json:"TypeFamily,omitnil,omitempty" name:"TypeFamily"` // 0未支付,1已支付 - // 注意:此字段可能返回 null,表示取不到有效值。 SubOrderPayStatus *int64 `json:"SubOrderPayStatus,omitnil,omitempty" name:"SubOrderPayStatus"` } @@ -682,7 +735,6 @@ type DedicatedClusterType struct { DedicatedClusterTypeId *string `json:"DedicatedClusterTypeId,omitnil,omitempty" name:"DedicatedClusterTypeId"` // 配置描述,对应描述 - // 注意:此字段可能返回 null,表示取不到有效值。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 配置名称,对应计算资源类型 @@ -718,6 +770,67 @@ type DedicatedClusterTypeInfo struct { Count *int64 `json:"Count,omitnil,omitempty" name:"Count"` } +// Predefined struct for user +type DeleteDedicatedClusterImageCacheRequestParams struct { + // 集群id + DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` + + // 镜像id + ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` +} + +type DeleteDedicatedClusterImageCacheRequest struct { + *tchttp.BaseRequest + + // 集群id + DedicatedClusterId *string `json:"DedicatedClusterId,omitnil,omitempty" name:"DedicatedClusterId"` + + // 镜像id + ImageId *string `json:"ImageId,omitnil,omitempty" name:"ImageId"` +} + +func (r *DeleteDedicatedClusterImageCacheRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DeleteDedicatedClusterImageCacheRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "DedicatedClusterId") + delete(f, "ImageId") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DeleteDedicatedClusterImageCacheRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DeleteDedicatedClusterImageCacheResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DeleteDedicatedClusterImageCacheResponse struct { + *tchttp.BaseResponse + Response *DeleteDedicatedClusterImageCacheResponseParams `json:"Response"` +} + +func (r *DeleteDedicatedClusterImageCacheResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DeleteDedicatedClusterImageCacheResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type DeleteDedicatedClustersRequestParams struct { // 要删除的专用集群id @@ -840,7 +953,7 @@ type DescribeDedicatedClusterCbsStatisticsRequestParams struct { // 结束时间 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 时间范围精度,1分钟/5分钟 + // 时间范围精度,1分钟(ONE_MINUTE)/5分钟(FIVE_MINUTE) Period *string `json:"Period,omitnil,omitempty" name:"Period"` // 偏移量,默认为0。 @@ -865,7 +978,7 @@ type DescribeDedicatedClusterCbsStatisticsRequest struct { // 结束时间 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 时间范围精度,1分钟/5分钟 + // 时间范围精度,1分钟(ONE_MINUTE)/5分钟(FIVE_MINUTE) Period *string `json:"Period,omitnil,omitempty" name:"Period"` // 偏移量,默认为0。 @@ -903,11 +1016,9 @@ func (r *DescribeDedicatedClusterCbsStatisticsRequest) FromJsonString(s string) // Predefined struct for user type DescribeDedicatedClusterCbsStatisticsResponseParams struct { // 云硬盘仓库信息 - // 注意:此字段可能返回 null,表示取不到有效值。 SetList []*SetInfo `json:"SetList,omitnil,omitempty" name:"SetList"` // 总数 - // 注意:此字段可能返回 null,表示取不到有效值。 TotalCount *uint64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -1001,7 +1112,7 @@ type DescribeDedicatedClusterHostStatisticsRequestParams struct { // 结束时间 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 时间范围精度,1分钟/5分钟 + // 时间范围精度,1分钟(ONE_MINUTE)/5分钟(FIVE_MINUTE) Period *string `json:"Period,omitnil,omitempty" name:"Period"` } @@ -1020,7 +1131,7 @@ type DescribeDedicatedClusterHostStatisticsRequest struct { // 结束时间 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 时间范围精度,1分钟/5分钟 + // 时间范围精度,1分钟(ONE_MINUTE)/5分钟(FIVE_MINUTE) Period *string `json:"Period,omitnil,omitempty" name:"Period"` } @@ -1121,7 +1232,6 @@ func (r *DescribeDedicatedClusterHostsRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeDedicatedClusterHostsResponseParams struct { // 宿主机信息 - // 注意:此字段可能返回 null,表示取不到有效值。 HostInfoSet []*HostInfo `json:"HostInfoSet,omitnil,omitempty" name:"HostInfoSet"` // 宿主机总数 @@ -1347,31 +1457,24 @@ type DescribeDedicatedClusterOverviewResponseParams struct { HostCount *uint64 `json:"HostCount,omitnil,omitempty" name:"HostCount"` // vpn通道状态 - // 注意:此字段可能返回 null,表示取不到有效值。 VpnConnectionState *string `json:"VpnConnectionState,omitnil,omitempty" name:"VpnConnectionState"` // vpn网关监控数据 - // 注意:此字段可能返回 null,表示取不到有效值。 VpngwBandwidthData *VpngwBandwidthData `json:"VpngwBandwidthData,omitnil,omitempty" name:"VpngwBandwidthData"` // 本地网关信息 - // 注意:此字段可能返回 null,表示取不到有效值。 LocalNetInfo *LocalNetInfo `json:"LocalNetInfo,omitnil,omitempty" name:"LocalNetInfo"` // vpn网关通道监控数据 - // 注意:此字段可能返回 null,表示取不到有效值。 VpnConnectionBandwidthData []*VpngwBandwidthData `json:"VpnConnectionBandwidthData,omitnil,omitempty" name:"VpnConnectionBandwidthData"` // 宿主机资源概览信息 - // 注意:此字段可能返回 null,表示取不到有效值。 HostDetailInfo []*HostDetailInfo `json:"HostDetailInfo,omitnil,omitempty" name:"HostDetailInfo"` // 热备宿主机数量 - // 注意:此字段可能返回 null,表示取不到有效值。 HostStandbyCount *uint64 `json:"HostStandbyCount,omitnil,omitempty" name:"HostStandbyCount"` // 普通宿主机数量 - // 注意:此字段可能返回 null,表示取不到有效值。 HostNormalCount *uint64 `json:"HostNormalCount,omitnil,omitempty" name:"HostNormalCount"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -1805,33 +1908,26 @@ func (r *DescribeSitesResponse) FromJsonString(s string) error { type DetailData struct { // 时间戳 - // 注意:此字段可能返回 null,表示取不到有效值。 Timestamps []*float64 `json:"Timestamps,omitnil,omitempty" name:"Timestamps"` // 对应的具体值 - // 注意:此字段可能返回 null,表示取不到有效值。 Values []*float64 `json:"Values,omitnil,omitempty" name:"Values"` } type HostDetailInfo struct { // 类型族 - // 注意:此字段可能返回 null,表示取不到有效值。 HostTypeFamily *string `json:"HostTypeFamily,omitnil,omitempty" name:"HostTypeFamily"` // 总CPU - // 注意:此字段可能返回 null,表示取不到有效值。 CpuTotal *float64 `json:"CpuTotal,omitnil,omitempty" name:"CpuTotal"` // 可用CPU - // 注意:此字段可能返回 null,表示取不到有效值。 CpuAvailable *float64 `json:"CpuAvailable,omitnil,omitempty" name:"CpuAvailable"` // 总内存 - // 注意:此字段可能返回 null,表示取不到有效值。 MemTotal *float64 `json:"MemTotal,omitnil,omitempty" name:"MemTotal"` // 可用内存 - // 注意:此字段可能返回 null,表示取不到有效值。 MemAvailable *float64 `json:"MemAvailable,omitnil,omitempty" name:"MemAvailable"` } @@ -1867,7 +1963,6 @@ type HostInfo struct { ExpireTime *string `json:"ExpireTime,omitnil,omitempty" name:"ExpireTime"` // 宿主机id - // 注意:此字段可能返回 null,表示取不到有效值。 HostId *string `json:"HostId,omitnil,omitempty" name:"HostId"` } @@ -1888,59 +1983,46 @@ type HostStatistic struct { Count *uint64 `json:"Count,omitnil,omitempty" name:"Count"` // 平均cpu负载百分比 - // 注意:此字段可能返回 null,表示取不到有效值。 CpuAverage *float64 `json:"CpuAverage,omitnil,omitempty" name:"CpuAverage"` // 平均内存使用率百分比 - // 注意:此字段可能返回 null,表示取不到有效值。 MemAverage *float64 `json:"MemAverage,omitnil,omitempty" name:"MemAverage"` // 平均网络流量 - // 注意:此字段可能返回 null,表示取不到有效值。 NetAverage *float64 `json:"NetAverage,omitnil,omitempty" name:"NetAverage"` // cpu详细监控数据 - // 注意:此字段可能返回 null,表示取不到有效值。 CpuDetailData *DetailData `json:"CpuDetailData,omitnil,omitempty" name:"CpuDetailData"` // 内存详细数据 - // 注意:此字段可能返回 null,表示取不到有效值。 MemDetailData *DetailData `json:"MemDetailData,omitnil,omitempty" name:"MemDetailData"` // 网络速率详细数据 - // 注意:此字段可能返回 null,表示取不到有效值。 NetRateDetailData *DetailData `json:"NetRateDetailData,omitnil,omitempty" name:"NetRateDetailData"` // 网速包详细数据 - // 注意:此字段可能返回 null,表示取不到有效值。 NetPacketDetailData *DetailData `json:"NetPacketDetailData,omitnil,omitempty" name:"NetPacketDetailData"` } type InBandwidth struct { // 时间戳 - // 注意:此字段可能返回 null,表示取不到有效值。 Timestamps []*float64 `json:"Timestamps,omitnil,omitempty" name:"Timestamps"` // 时间对应的值 - // 注意:此字段可能返回 null,表示取不到有效值。 Values []*float64 `json:"Values,omitnil,omitempty" name:"Values"` } type LocalNetInfo struct { // 协议 - // 注意:此字段可能返回 null,表示取不到有效值。 Protocol *string `json:"Protocol,omitnil,omitempty" name:"Protocol"` // 网络id - // 注意:此字段可能返回 null,表示取不到有效值。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 路由信息 - // 注意:此字段可能返回 null,表示取不到有效值。 BGPRoute *string `json:"BGPRoute,omitnil,omitempty" name:"BGPRoute"` // 本地IP - // 注意:此字段可能返回 null,表示取不到有效值。 LocalIp *string `json:"LocalIp,omitnil,omitempty" name:"LocalIp"` } @@ -2031,10 +2113,10 @@ type ModifyOrderStatusRequestParams struct { // 要更新成的状态 Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 大订单ID + // 大订单ID,可以在本地专用集群的基础信息页获取大订单ID DedicatedClusterOrderId *string `json:"DedicatedClusterOrderId,omitnil,omitempty" name:"DedicatedClusterOrderId"` - // 小订单ID + // 小订单ID,进入大订单的详情页,可以看到小订单ID SubOrderIds []*string `json:"SubOrderIds,omitnil,omitempty" name:"SubOrderIds"` } @@ -2044,10 +2126,10 @@ type ModifyOrderStatusRequest struct { // 要更新成的状态 Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 大订单ID + // 大订单ID,可以在本地专用集群的基础信息页获取大订单ID DedicatedClusterOrderId *string `json:"DedicatedClusterOrderId,omitnil,omitempty" name:"DedicatedClusterOrderId"` - // 小订单ID + // 小订单ID,进入大订单的详情页,可以看到小订单ID SubOrderIds []*string `json:"SubOrderIds,omitnil,omitempty" name:"SubOrderIds"` } @@ -2108,7 +2190,7 @@ type ModifySiteDeviceInfoRequestParams struct { // 电源连接器类型 PowerConnectors *string `json:"PowerConnectors,omitnil,omitempty" name:"PowerConnectors"` - // 从机架上方还是下方供电。 + // 从机架上方还是下方供电。取值范围:["UP","DOWN"] PowerFeedDrop *string `json:"PowerFeedDrop,omitnil,omitempty" name:"PowerFeedDrop"` // 最大承重(KG) @@ -2117,7 +2199,7 @@ type ModifySiteDeviceInfoRequestParams struct { // 功耗(KW) PowerDrawKva *int64 `json:"PowerDrawKva,omitnil,omitempty" name:"PowerDrawKva"` - // 网络到腾讯云Region区域的上行链路速度 + // 网络到腾讯云Region区域的上行链路速度(Gbps) UplinkSpeedGbps *int64 `json:"UplinkSpeedGbps,omitnil,omitempty" name:"UplinkSpeedGbps"` // 将CDC连接到网络时,每台CDC网络设备(每个机架 2 台设备)使用的上行链路数量。 @@ -2165,7 +2247,7 @@ type ModifySiteDeviceInfoRequest struct { // 电源连接器类型 PowerConnectors *string `json:"PowerConnectors,omitnil,omitempty" name:"PowerConnectors"` - // 从机架上方还是下方供电。 + // 从机架上方还是下方供电。取值范围:["UP","DOWN"] PowerFeedDrop *string `json:"PowerFeedDrop,omitnil,omitempty" name:"PowerFeedDrop"` // 最大承重(KG) @@ -2174,7 +2256,7 @@ type ModifySiteDeviceInfoRequest struct { // 功耗(KW) PowerDrawKva *int64 `json:"PowerDrawKva,omitnil,omitempty" name:"PowerDrawKva"` - // 网络到腾讯云Region区域的上行链路速度 + // 网络到腾讯云Region区域的上行链路速度(Gbps) UplinkSpeedGbps *int64 `json:"UplinkSpeedGbps,omitnil,omitempty" name:"UplinkSpeedGbps"` // 将CDC连接到网络时,每台CDC网络设备(每个机架 2 台设备)使用的上行链路数量。 @@ -2374,11 +2456,9 @@ func (r *ModifySiteInfoResponse) FromJsonString(s string) error { type OutBandwidth struct { // 时间戳 - // 注意:此字段可能返回 null,表示取不到有效值。 Timestamps []*float64 `json:"Timestamps,omitnil,omitempty" name:"Timestamps"` // 对应时间的值 - // 注意:此字段可能返回 null,表示取不到有效值。 Values []*float64 `json:"Values,omitnil,omitempty" name:"Values"` } @@ -2392,51 +2472,39 @@ type RegionZoneInfo struct { type SetInfo struct { // 云硬盘仓库id - // 注意:此字段可能返回 null,表示取不到有效值。 SetId *string `json:"SetId,omitnil,omitempty" name:"SetId"` // 云硬盘仓库名称 - // 注意:此字段可能返回 null,表示取不到有效值。 SetName *string `json:"SetName,omitnil,omitempty" name:"SetName"` // 云硬盘仓库类型 - // 注意:此字段可能返回 null,表示取不到有效值。 SetType *string `json:"SetType,omitnil,omitempty" name:"SetType"` // 云硬盘仓库容量 - // 注意:此字段可能返回 null,表示取不到有效值。 SetSize *float64 `json:"SetSize,omitnil,omitempty" name:"SetSize"` // 云硬盘仓库状态 - // 注意:此字段可能返回 null,表示取不到有效值。 SetStatus *string `json:"SetStatus,omitnil,omitempty" name:"SetStatus"` // 云硬盘仓库创建时间 - // 注意:此字段可能返回 null,表示取不到有效值。 CreateTime *string `json:"CreateTime,omitnil,omitempty" name:"CreateTime"` // 读流量 - // 注意:此字段可能返回 null,表示取不到有效值。 ReadTraffic *DetailData `json:"ReadTraffic,omitnil,omitempty" name:"ReadTraffic"` // 写流量 - // 注意:此字段可能返回 null,表示取不到有效值。 WriteTraffic *DetailData `json:"WriteTraffic,omitnil,omitempty" name:"WriteTraffic"` // 读IO - // 注意:此字段可能返回 null,表示取不到有效值。 ReadIO *DetailData `json:"ReadIO,omitnil,omitempty" name:"ReadIO"` // 写IO - // 注意:此字段可能返回 null,表示取不到有效值。 WriteIO *DetailData `json:"WriteIO,omitnil,omitempty" name:"WriteIO"` // 平均等待时间 - // 注意:此字段可能返回 null,表示取不到有效值。 Await *DetailData `json:"Await,omitnil,omitempty" name:"Await"` // 利用率 - // 注意:此字段可能返回 null,表示取不到有效值。 Util *DetailData `json:"Util,omitnil,omitempty" name:"Util"` } @@ -2448,7 +2516,6 @@ type Site struct { SiteId *string `json:"SiteId,omitnil,omitempty" name:"SiteId"` // 站点描述 - // 注意:此字段可能返回 null,表示取不到有效值。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 站点创建时间 @@ -2539,7 +2606,6 @@ type SiteDetail struct { type VpngwBandwidthData struct { // 出带宽流量 - // 注意:此字段可能返回 null,表示取不到有效值。 OutBandwidth *OutBandwidth `json:"OutBandwidth,omitnil,omitempty" name:"OutBandwidth"` // 入带宽流量 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 e45128c4df..c81551dbd1 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 @@ -3,6 +3,7 @@ package common import ( "context" "io" + //"log" "math/rand" "net/url" 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 78923f98ee..1e750ef206 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 @@ -138,6 +138,12 @@ func NewAssociateInstancesKeyPairsResponse() (response *AssociateInstancesKeyPai // // // +// * 仅支持对 `Linux` 操作系统实例进行绑定操作。 +// +// * 非强制关机场景下,仅支持对 [STOPPED](https://cloud.tencent.com/document/product/213/15753#InstanceStatus) 状态实例进行绑定操作。 +// +// * 强制关机场景下,先执行强制关机,再绑定密钥;如实例原状态为 [RUNNING](https://cloud.tencent.com/document/product/213/15753#InstanceStatus),绑定完成后实例会自动开机。 +// // * 将密钥的公钥写入到实例的`SSH`配置当中,用户就可以通过该密钥的私钥来登录实例。 // // * 如果实例原来绑定过密钥,那么原来的密钥将失效。 @@ -185,6 +191,12 @@ func (c *Client) AssociateInstancesKeyPairs(request *AssociateInstancesKeyPairsR // // // +// * 仅支持对 `Linux` 操作系统实例进行绑定操作。 +// +// * 非强制关机场景下,仅支持对 [STOPPED](https://cloud.tencent.com/document/product/213/15753#InstanceStatus) 状态实例进行绑定操作。 +// +// * 强制关机场景下,先执行强制关机,再绑定密钥;如实例原状态为 [RUNNING](https://cloud.tencent.com/document/product/213/15753#InstanceStatus),绑定完成后实例会自动开机。 +// // * 将密钥的公钥写入到实例的`SSH`配置当中,用户就可以通过该密钥的私钥来登录实例。 // // * 如果实例原来绑定过密钥,那么原来的密钥将失效。 @@ -4032,7 +4044,11 @@ func NewDisassociateInstancesKeyPairsResponse() (response *DisassociateInstances // // // -// * 只支持[`STOPPED`](https://cloud.tencent.com/document/product/213/15753#InstanceStatus)状态的`Linux`操作系统的实例。 +// * 仅支持对 Linux 操作系统实例进行解绑操作。 +// +// * 非强制关机场景下,仅支持对 [STOPPED](https://cloud.tencent.com/document/product/213/15753#InstanceStatus) 状态实例进行解绑操作。 +// +// * 强制关机场景下,先执行强制关机,再解绑密钥;如实例原状态为 [RUNNING](https://cloud.tencent.com/document/product/213/15753#InstanceStatus),解绑完成后实例会自动开机。 // // * 解绑密钥后,实例可以通过原来设置的密码登录。 // @@ -4075,7 +4091,11 @@ func (c *Client) DisassociateInstancesKeyPairs(request *DisassociateInstancesKey // // // -// * 只支持[`STOPPED`](https://cloud.tencent.com/document/product/213/15753#InstanceStatus)状态的`Linux`操作系统的实例。 +// * 仅支持对 Linux 操作系统实例进行解绑操作。 +// +// * 非强制关机场景下,仅支持对 [STOPPED](https://cloud.tencent.com/document/product/213/15753#InstanceStatus) 状态实例进行解绑操作。 +// +// * 强制关机场景下,先执行强制关机,再解绑密钥;如实例原状态为 [RUNNING](https://cloud.tencent.com/document/product/213/15753#InstanceStatus),解绑完成后实例会自动开机。 // // * 解绑密钥后,实例可以通过原来设置的密码登录。 // @@ -4218,7 +4238,7 @@ func NewEnterRescueModeResponse() (response *EnterRescueModeResponse) { } // EnterRescueMode -// 进入救援模式 +// 本接口(EnterRescueMode)用于进入救援模式。 // // 可能返回的错误码: // INVALIDINSTANCE_NOTSUPPORTED = "InvalidInstance.NotSupported" @@ -4251,7 +4271,7 @@ func (c *Client) EnterRescueMode(request *EnterRescueModeRequest) (response *Ent } // EnterRescueMode -// 进入救援模式 +// 本接口(EnterRescueMode)用于进入救援模式。 // // 可能返回的错误码: // INVALIDINSTANCE_NOTSUPPORTED = "InvalidInstance.NotSupported" @@ -4315,7 +4335,7 @@ func NewExitRescueModeResponse() (response *ExitRescueModeResponse) { } // ExitRescueMode -// 退出救援模式 +// 本接口(ExitRescueMode)用于退出救援模式。 // // 可能返回的错误码: // INVALIDINSTANCE_NOTSUPPORTED = "InvalidInstance.NotSupported" @@ -4337,7 +4357,7 @@ func (c *Client) ExitRescueMode(request *ExitRescueModeRequest) (response *ExitR } // ExitRescueMode -// 退出救援模式 +// 本接口(ExitRescueMode)用于退出救援模式。 // // 可能返回的错误码: // INVALIDINSTANCE_NOTSUPPORTED = "InvalidInstance.NotSupported" @@ -4556,7 +4576,7 @@ func NewImportInstancesActionTimerResponse() (response *ImportInstancesActionTim } // ImportInstancesActionTimer -// 导入定时任务 +// 本接口(ImportInstancesActionTimer)用于导入定时任务 // // 可能返回的错误码: // FAILEDOPERATION_MUTACTIONTIMEREXIST = "FailedOperation.MutActionTimerExist" @@ -4571,7 +4591,7 @@ func (c *Client) ImportInstancesActionTimer(request *ImportInstancesActionTimerR } // ImportInstancesActionTimer -// 导入定时任务 +// 本接口(ImportInstancesActionTimer)用于导入定时任务 // // 可能返回的错误码: // FAILEDOPERATION_MUTACTIONTIMEREXIST = "FailedOperation.MutActionTimerExist" @@ -4621,7 +4641,7 @@ func NewImportKeyPairResponse() (response *ImportKeyPairResponse) { // // // -// * 本接口的功能是将密钥对导入到用户账户,并不会自动绑定到实例。如需绑定可以使用[AssociasteInstancesKeyPair](https://cloud.tencent.com/document/api/213/9404)接口。 +// * 本接口的功能是将密钥对导入到用户账户,并不会自动绑定到实例。如需绑定可以使用[AssociateInstancesKeyPairs](https://cloud.tencent.com/document/product/213/15698)接口。 // // * 需指定密钥对名称以及该密钥对的公钥文本。 // @@ -4649,7 +4669,7 @@ func (c *Client) ImportKeyPair(request *ImportKeyPairRequest) (response *ImportK // // // -// * 本接口的功能是将密钥对导入到用户账户,并不会自动绑定到实例。如需绑定可以使用[AssociasteInstancesKeyPair](https://cloud.tencent.com/document/api/213/9404)接口。 +// * 本接口的功能是将密钥对导入到用户账户,并不会自动绑定到实例。如需绑定可以使用[AssociateInstancesKeyPairs](https://cloud.tencent.com/document/product/213/15698)接口。 // // * 需指定密钥对名称以及该密钥对的公钥文本。 // @@ -5280,6 +5300,7 @@ func NewInquiryPriceResetInstancesTypeResponse() (response *InquiryPriceResetIns // RESOURCEUNAVAILABLE_INSTANCETYPE = "ResourceUnavailable.InstanceType" // RESOURCESSOLDOUT_SPECIFIEDINSTANCETYPE = "ResourcesSoldOut.SpecifiedInstanceType" // UNSUPPORTEDOPERATION_HETEROGENEOUSCHANGEINSTANCEFAMILY = "UnsupportedOperation.HeterogeneousChangeInstanceFamily" +// UNSUPPORTEDOPERATION_INSTANCEMIXEDRESETINSTANCETYPE = "UnsupportedOperation.InstanceMixedResetInstanceType" // UNSUPPORTEDOPERATION_LOCALDATADISKCHANGEINSTANCEFAMILY = "UnsupportedOperation.LocalDataDiskChangeInstanceFamily" // UNSUPPORTEDOPERATION_ORIGINALINSTANCETYPEINVALID = "UnsupportedOperation.OriginalInstanceTypeInvalid" // UNSUPPORTEDOPERATION_STOPPEDMODESTOPCHARGING = "UnsupportedOperation.StoppedModeStopCharging" @@ -5337,6 +5358,7 @@ func (c *Client) InquiryPriceResetInstancesType(request *InquiryPriceResetInstan // RESOURCEUNAVAILABLE_INSTANCETYPE = "ResourceUnavailable.InstanceType" // RESOURCESSOLDOUT_SPECIFIEDINSTANCETYPE = "ResourcesSoldOut.SpecifiedInstanceType" // UNSUPPORTEDOPERATION_HETEROGENEOUSCHANGEINSTANCEFAMILY = "UnsupportedOperation.HeterogeneousChangeInstanceFamily" +// UNSUPPORTEDOPERATION_INSTANCEMIXEDRESETINSTANCETYPE = "UnsupportedOperation.InstanceMixedResetInstanceType" // UNSUPPORTEDOPERATION_LOCALDATADISKCHANGEINSTANCEFAMILY = "UnsupportedOperation.LocalDataDiskChangeInstanceFamily" // UNSUPPORTEDOPERATION_ORIGINALINSTANCETYPEINVALID = "UnsupportedOperation.OriginalInstanceTypeInvalid" // UNSUPPORTEDOPERATION_STOPPEDMODESTOPCHARGING = "UnsupportedOperation.StoppedModeStopCharging" @@ -5385,9 +5407,11 @@ func NewInquiryPriceResizeInstanceDisksResponse() (response *InquiryPriceResizeI // // // -// * 目前只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)询价。 +// * 目前只支持扩容非弹性数据盘([DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)询价。 +// +// * 目前不支持[CDH](https://cloud.tencent.com/document/product/416)实例使用该接口扩容数据盘询价。 // -// * 目前不支持[CDH](https://cloud.tencent.com/document/product/416)实例使用该接口扩容数据盘询价。* 仅支持包年包月实例随机器购买的数据盘。* 目前只支持扩容一块数据盘询价。 +// * 目前只支持扩容一块数据盘询价。 // // 可能返回的错误码: // INTERNALERROR_TRADEUNKNOWNERROR = "InternalError.TradeUnknownError" @@ -5417,9 +5441,11 @@ func (c *Client) InquiryPriceResizeInstanceDisks(request *InquiryPriceResizeInst // // // -// * 目前只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)询价。 +// * 目前只支持扩容非弹性数据盘([DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)询价。 // -// * 目前不支持[CDH](https://cloud.tencent.com/document/product/416)实例使用该接口扩容数据盘询价。* 仅支持包年包月实例随机器购买的数据盘。* 目前只支持扩容一块数据盘询价。 +// * 目前不支持[CDH](https://cloud.tencent.com/document/product/416)实例使用该接口扩容数据盘询价。 +// +// * 目前只支持扩容一块数据盘询价。 // // 可能返回的错误码: // INTERNALERROR_TRADEUNKNOWNERROR = "InternalError.TradeUnknownError" @@ -6200,7 +6226,7 @@ func NewModifyInstanceDiskTypeResponse() (response *ModifyInstanceDiskTypeRespon // // * 若实例同时存在本地系统盘和本地数据盘,需同时调整系统盘和数据盘的介质类型,不支持单独针对本地系统盘或本地数据盘修改介质类型。 // -// * 修改前请确保账户余额充足。可通过[DescribeAccountBalance](https://cloud.tencent.com/document/product/378/4397)接口查询账户余额。 +// * 修改前请确保账户余额充足。可通过[ DescribeAccountBalance ](https://cloud.tencent.com/document/product/555/20253)接口查询账户余额。 // // 可能返回的错误码: // ACCOUNTQUALIFICATIONRESTRICTIONS = "AccountQualificationRestrictions" @@ -6243,7 +6269,7 @@ func (c *Client) ModifyInstanceDiskType(request *ModifyInstanceDiskTypeRequest) // // * 若实例同时存在本地系统盘和本地数据盘,需同时调整系统盘和数据盘的介质类型,不支持单独针对本地系统盘或本地数据盘修改介质类型。 // -// * 修改前请确保账户余额充足。可通过[DescribeAccountBalance](https://cloud.tencent.com/document/product/378/4397)接口查询账户余额。 +// * 修改前请确保账户余额充足。可通过[ DescribeAccountBalance ](https://cloud.tencent.com/document/product/555/20253)接口查询账户余额。 // // 可能返回的错误码: // ACCOUNTQUALIFICATIONRESTRICTIONS = "AccountQualificationRestrictions" @@ -6305,7 +6331,7 @@ func NewModifyInstancesAttributeResponse() (response *ModifyInstancesAttributeRe } // ModifyInstancesAttribute -// 本接口 (ModifyInstancesAttribute) 用于修改实例的属性(目前只支持修改实例的名称和关联的安全组)。 +// 本接口 (ModifyInstancesAttribute) 用于修改实例的属性。 // // // @@ -6371,7 +6397,7 @@ func (c *Client) ModifyInstancesAttribute(request *ModifyInstancesAttributeReque } // ModifyInstancesAttribute -// 本接口 (ModifyInstancesAttribute) 用于修改实例的属性(目前只支持修改实例的名称和关联的安全组)。 +// 本接口 (ModifyInstancesAttribute) 用于修改实例的属性。 // // // @@ -6499,6 +6525,7 @@ func NewModifyInstancesChargeTypeResponse() (response *ModifyInstancesChargeType // MISSINGPARAMETER = "MissingParameter" // OPERATIONDENIED_INSTANCEOPERATIONINPROGRESS = "OperationDenied.InstanceOperationInProgress" // RESOURCEINSUFFICIENT_CLOUDDISKUNAVAILABLE = "ResourceInsufficient.CloudDiskUnavailable" +// UNSUPPORTEDOPERATION_COMMERCIALIMAGECHANGECHARGETYPE = "UnsupportedOperation.CommercialImageChangeChargeType" // UNSUPPORTEDOPERATION_INSTANCECHARGETYPE = "UnsupportedOperation.InstanceChargeType" // UNSUPPORTEDOPERATION_INSTANCEMIXEDZONETYPE = "UnsupportedOperation.InstanceMixedZoneType" // UNSUPPORTEDOPERATION_INSTANCESTATEBANNING = "UnsupportedOperation.InstanceStateBanning" @@ -6547,6 +6574,7 @@ func (c *Client) ModifyInstancesChargeType(request *ModifyInstancesChargeTypeReq // MISSINGPARAMETER = "MissingParameter" // OPERATIONDENIED_INSTANCEOPERATIONINPROGRESS = "OperationDenied.InstanceOperationInProgress" // RESOURCEINSUFFICIENT_CLOUDDISKUNAVAILABLE = "ResourceInsufficient.CloudDiskUnavailable" +// UNSUPPORTEDOPERATION_COMMERCIALIMAGECHANGECHARGETYPE = "UnsupportedOperation.CommercialImageChangeChargeType" // UNSUPPORTEDOPERATION_INSTANCECHARGETYPE = "UnsupportedOperation.InstanceChargeType" // UNSUPPORTEDOPERATION_INSTANCEMIXEDZONETYPE = "UnsupportedOperation.InstanceMixedZoneType" // UNSUPPORTEDOPERATION_INSTANCESTATEBANNING = "UnsupportedOperation.InstanceStateBanning" @@ -8553,6 +8581,8 @@ func NewResizeInstanceDisksResponse() (response *ResizeInstanceDisksResponse) { // // * 如果是系统盘,目前只支持扩容,不支持缩容。 // +// * 如果是运行中的实例,必须指定ForceStop或ResizeOnline任意一个参数为true,否则操作失败。 +// // 可能返回的错误码: // FAILEDOPERATION_INVALIDINSTANCEAPPLICATIONROLE = "FailedOperation.InvalidInstanceApplicationRole" // INTERNALERROR = "InternalError" @@ -8610,6 +8640,8 @@ func (c *Client) ResizeInstanceDisks(request *ResizeInstanceDisksRequest) (respo // // * 如果是系统盘,目前只支持扩容,不支持缩容。 // +// * 如果是运行中的实例,必须指定ForceStop或ResizeOnline任意一个参数为true,否则操作失败。 +// // 可能返回的错误码: // FAILEDOPERATION_INVALIDINSTANCEAPPLICATIONROLE = "FailedOperation.InvalidInstanceApplicationRole" // INTERNALERROR = "InternalError" @@ -9327,7 +9359,11 @@ func NewSyncImagesResponse() (response *SyncImagesResponse) { // // * 该接口每次调用只支持同步一个镜像。 // -// * 该接口支持多个同步地域。 +// * 该接口支持自定义镜像向多个地域同步。 +// +// * 共享镜像仅支持同步为源地域(单个)的自定义镜像。 +// +// * 自定义镜像仅支持同步为源地域(单个)的加密自定义镜像。 // // * 单个账号在每个地域最多支持存在500个自定义镜像。 // @@ -9362,7 +9398,11 @@ func (c *Client) SyncImages(request *SyncImagesRequest) (response *SyncImagesRes // // * 该接口每次调用只支持同步一个镜像。 // -// * 该接口支持多个同步地域。 +// * 该接口支持自定义镜像向多个地域同步。 +// +// * 共享镜像仅支持同步为源地域(单个)的自定义镜像。 +// +// * 自定义镜像仅支持同步为源地域(单个)的加密自定义镜像。 // // * 单个账号在每个地域最多支持存在500个自定义镜像。 // 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 86818a5adc..b341628e51 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 @@ -146,7 +146,7 @@ const ( // 无效的过滤器。 INVALIDFILTER = "InvalidFilter" - // [`Filter`](/document/api/213/15753#Filter)。 + // [`Filter`](/document/api/213/15753#Filter)传值超出限制。 INVALIDFILTERVALUE_LIMITEXCEEDED = "InvalidFilterValue.LimitExceeded" // 不支持该宿主机实例执行指定的操作。 @@ -878,6 +878,9 @@ const ( // cbs远端ssd盘不支持该操作 UNSUPPORTEDOPERATION_CBSREMOTESSDNOTSUPPORT = "UnsupportedOperation.CbsRemoteSsdNotSupport" + // 实例使用商业镜像暂不支持调整付费模式。 + UNSUPPORTEDOPERATION_COMMERCIALIMAGECHANGECHARGETYPE = "UnsupportedOperation.CommercialImageChangeChargeType" + // 实例创建快照的时间距今不到24小时。 UNSUPPORTEDOPERATION_DISKSNAPCREATETIMETOOOLD = "UnsupportedOperation.DiskSnapCreateTimeTooOld" 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 efdd98d38e..3373f7d4b4 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 @@ -52,20 +52,16 @@ type ActionTimer struct { // 执行时间,按照ISO8601标准表示,并且使用UTC时间。格式为 YYYY-MM-DDThh:mm:ssZ。例如 2018-05-29T11:26:40Z,执行时间必须大于当前时间5分钟。 ActionTime *string `json:"ActionTime,omitnil,omitempty" name:"ActionTime"` - // 扩展数据 + // 扩展数据。仅做出参使用。 Externals *Externals `json:"Externals,omitnil,omitempty" name:"Externals"` - // 定时器ID。 + // 定时器ID。仅做出参使用。 ActionTimerId *string `json:"ActionTimerId,omitnil,omitempty" name:"ActionTimerId"` - // 定时器状态,取值范围: - // - // UNDO:未触发 - // DOING:触发中 - // DONE:已经触发 + // 定时器状态,仅做出参使用。取值范围:
  • UNDO:未执行
  • DOING:正在执行
  • DONE:执行完成。
  • Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 定时器对应的实例ID。 + // 定时器对应的实例ID。仅做出参使用。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -170,26 +166,38 @@ func (r *AllocateHostsResponse) FromJsonString(s string) error { // Predefined struct for user type AssociateInstancesKeyPairsRequestParams struct { - // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。
    可以通过以下方式获取可用的实例ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ,取返回信息中的`InstanceId`获取实例ID。
  • + // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。可以通过以下方式获取可用的实例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"` - // 一个或多个待操作的密钥对ID,每次请求批量密钥对的上限为100。密钥对ID形如:`skey-3glfot13`。
    可以通过以下方式获取可用的密钥ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的`KeyId`获取密钥对ID。
  • + // 一个或多个待操作的密钥对ID,每次请求批量密钥对的上限为100。可以通过以下方式获取可用的密钥ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的`KeyId`获取密钥对ID。
  • KeyIds []*string `json:"KeyIds,omitnil,omitempty" name:"KeyIds"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再绑定密钥。取值范围:
  • true:表示在正常关机失败后进行强制关机。
  • false:表示在正常关机失败后不进行强制关机。
  • 默认取值:false。 + // 是否强制关机,默认值为 false。常规场景下,建议手动关机后绑定密钥。取值范围: + //
  • true:先执行强制关机,再绑定密钥。
  • + //
  • false:不执行强制关机,仅支持对已关机状态实例进行绑定操作。
  • ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } type AssociateInstancesKeyPairsRequest struct { *tchttp.BaseRequest - // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。
    可以通过以下方式获取可用的实例ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ,取返回信息中的`InstanceId`获取实例ID。
  • + // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。可以通过以下方式获取可用的实例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"` - // 一个或多个待操作的密钥对ID,每次请求批量密钥对的上限为100。密钥对ID形如:`skey-3glfot13`。
    可以通过以下方式获取可用的密钥ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的`KeyId`获取密钥对ID。
  • + // 一个或多个待操作的密钥对ID,每次请求批量密钥对的上限为100。可以通过以下方式获取可用的密钥ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的`KeyId`获取密钥对ID。
  • KeyIds []*string `json:"KeyIds,omitnil,omitempty" name:"KeyIds"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再绑定密钥。取值范围:
  • true:表示在正常关机失败后进行强制关机。
  • false:表示在正常关机失败后不进行强制关机。
  • 默认取值:false。 + // 是否强制关机,默认值为 false。常规场景下,建议手动关机后绑定密钥。取值范围: + //
  • true:先执行强制关机,再绑定密钥。
  • + //
  • false:不执行强制关机,仅支持对已关机状态实例进行绑定操作。
  • ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } @@ -238,20 +246,20 @@ func (r *AssociateInstancesKeyPairsResponse) FromJsonString(s string) error { // Predefined struct for user type AssociateSecurityGroupsRequestParams struct { - // 要绑定的`安全组ID`,类似sg-efil73jd,只支持绑定单个安全组。 + // 要绑定的`安全组ID`,类似sg-efil73jd,只支持绑定单个安全组。可通过 [DescribeSecurityGroups](https://cloud.tencent.com/document/product/215/15808) 接口返回值中的`SecurityGroupId`获取。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - // 被绑定的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。 + // 被绑定的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } type AssociateSecurityGroupsRequest struct { *tchttp.BaseRequest - // 要绑定的`安全组ID`,类似sg-efil73jd,只支持绑定单个安全组。 + // 要绑定的`安全组ID`,类似sg-efil73jd,只支持绑定单个安全组。可通过 [DescribeSecurityGroups](https://cloud.tencent.com/document/product/215/15808) 接口返回值中的`SecurityGroupId`获取。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - // 被绑定的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。 + // 被绑定的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -629,32 +637,42 @@ func (r *ConfigureChcDeployVpcResponse) FromJsonString(s string) error { // Predefined struct for user type ConvertOperatingSystemsRequestParams struct { - // 执行操作系统转换的实例 ID + // 执行操作系统转换的实例 ID。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 + // 仅支持操作系统为 CentOS 7、CentOS 8 的实例执行转换。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 是否最小规模转换 + // 是否最小规模转换。 + // 默认值:false MinimalConversion *bool `json:"MinimalConversion,omitnil,omitempty" name:"MinimalConversion"` - // 是否只预检 + // 是否只预检。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 转换的目标操作系统类型。仅支持 TencentOS。 + // 默认值:TencentOS TargetOSType *string `json:"TargetOSType,omitnil,omitempty" name:"TargetOSType"` } type ConvertOperatingSystemsRequest struct { *tchttp.BaseRequest - // 执行操作系统转换的实例 ID + // 执行操作系统转换的实例 ID。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 + // 仅支持操作系统为 CentOS 7、CentOS 8 的实例执行转换。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 是否最小规模转换 + // 是否最小规模转换。 + // 默认值:false MinimalConversion *bool `json:"MinimalConversion,omitnil,omitempty" name:"MinimalConversion"` - // 是否只预检 + // 是否只预检。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 转换的目标操作系统类型。仅支持 TencentOS。 + // 默认值:TencentOS TargetOSType *string `json:"TargetOSType,omitnil,omitempty" name:"TargetOSType"` } @@ -911,13 +929,17 @@ func (r *CreateHpcClusterResponse) FromJsonString(s string) error { // Predefined struct for user type CreateImageRequestParams struct { - // 镜像名称 + // 镜像名称。 + // 最多支持60个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` // 需要制作镜像的实例ID。基于实例创建镜像时,为必填参数。 + // InstanceId 和 SnapshotIds 为二选一必填参数。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 镜像描述 + // 镜像描述。 + // 最多支持 256 个字符。 ImageDescription *string `json:"ImageDescription,omitnil,omitempty" name:"ImageDescription"` // 是否执行强制关机以制作镜像。 @@ -930,16 +952,21 @@ type CreateImageRequestParams struct { // 关于Sysprep的详情请参考[链接](https://cloud.tencent.com/document/product/213/43498)。 Sysprep *string `json:"Sysprep,omitnil,omitempty" name:"Sysprep"` - // 基于实例创建整机镜像时,指定包含在镜像里的数据盘ID + // 基于实例创建整机镜像时,指定包含在镜像里的数据盘ID。 + // DataDiskIds 只能在指定 InstanceId 实例所包含的数据盘范围内指定。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的 `DataDisks` 获取。 DataDiskIds []*string `json:"DataDiskIds,omitnil,omitempty" name:"DataDiskIds"` - // 基于快照创建镜像,指定快照ID,必须包含一个系统盘快照。不可与InstanceId同时传入。 + // 基于快照创建镜像,指定快照ID,必须包含一个系统盘快照。不可与 InstanceId 同时传入。 + // InstanceId 和 SnapshotIds 为二选一必填参数。 + // 可通过 [DescribeSnapshots](https://cloud.tencent.com/document/product/362/15647) 接口返回值中的`SnapshotId`获取。 SnapshotIds []*string `json:"SnapshotIds,omitnil,omitempty" name:"SnapshotIds"` // 检测本次请求的是否成功,但不会对操作的资源产生任何影响。默认取值为false。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 标签描述列表。通过指定该参数可以同时绑定标签到自定义镜像。 + // 可通过 [DescribeTags](https://cloud.tencent.com/document/api/651/35316) 接口返回值中的 `TagKey` 和 `TagValue` 获取。 TagSpecification []*TagSpecification `json:"TagSpecification,omitnil,omitempty" name:"TagSpecification"` // 镜像族 @@ -949,13 +976,17 @@ type CreateImageRequestParams struct { type CreateImageRequest struct { *tchttp.BaseRequest - // 镜像名称 + // 镜像名称。 + // 最多支持60个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` // 需要制作镜像的实例ID。基于实例创建镜像时,为必填参数。 + // InstanceId 和 SnapshotIds 为二选一必填参数。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 镜像描述 + // 镜像描述。 + // 最多支持 256 个字符。 ImageDescription *string `json:"ImageDescription,omitnil,omitempty" name:"ImageDescription"` // 是否执行强制关机以制作镜像。 @@ -968,16 +999,21 @@ type CreateImageRequest struct { // 关于Sysprep的详情请参考[链接](https://cloud.tencent.com/document/product/213/43498)。 Sysprep *string `json:"Sysprep,omitnil,omitempty" name:"Sysprep"` - // 基于实例创建整机镜像时,指定包含在镜像里的数据盘ID + // 基于实例创建整机镜像时,指定包含在镜像里的数据盘ID。 + // DataDiskIds 只能在指定 InstanceId 实例所包含的数据盘范围内指定。 + // 可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的 `DataDisks` 获取。 DataDiskIds []*string `json:"DataDiskIds,omitnil,omitempty" name:"DataDiskIds"` - // 基于快照创建镜像,指定快照ID,必须包含一个系统盘快照。不可与InstanceId同时传入。 + // 基于快照创建镜像,指定快照ID,必须包含一个系统盘快照。不可与 InstanceId 同时传入。 + // InstanceId 和 SnapshotIds 为二选一必填参数。 + // 可通过 [DescribeSnapshots](https://cloud.tencent.com/document/product/362/15647) 接口返回值中的`SnapshotId`获取。 SnapshotIds []*string `json:"SnapshotIds,omitnil,omitempty" name:"SnapshotIds"` // 检测本次请求的是否成功,但不会对操作的资源产生任何影响。默认取值为false。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 标签描述列表。通过指定该参数可以同时绑定标签到自定义镜像。 + // 可通过 [DescribeTags](https://cloud.tencent.com/document/api/651/35316) 接口返回值中的 `TagKey` 和 `TagValue` 获取。 TagSpecification []*TagSpecification `json:"TagSpecification,omitnil,omitempty" name:"TagSpecification"` // 镜像族 @@ -1042,7 +1078,7 @@ type CreateKeyPairRequestParams struct { // 密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` - // 密钥对创建后所属的项目ID。 + // 密钥对创建后所属的项目ID,ProjectId为0表示默认项目。 // 可以通过以下方式获取项目ID: //
  • 通过项目列表查询项目ID。
  • //
  • 通过调用接口 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725),取返回信息中的`projectId `获取项目ID。
  • @@ -1058,7 +1094,7 @@ type CreateKeyPairRequest struct { // 密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` - // 密钥对创建后所属的项目ID。 + // 密钥对创建后所属的项目ID,ProjectId为0表示默认项目。 // 可以通过以下方式获取项目ID: //
  • 通过项目列表查询项目ID。
  • //
  • 通过调用接口 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725),取返回信息中的`projectId `获取项目ID。
  • @@ -1627,7 +1663,7 @@ func (r *CreateLaunchTemplateVersionResponse) FromJsonString(s string) error { } type DataDisk struct { - // 数据盘大小,单位:GB。最小调整步长为10G,不同数据盘类型取值范围不同,具体限制详见:[存储概述](https://cloud.tencent.com/document/product/213/4952)。默认值为0,表示不购买数据盘。更多限制详见产品文档。 + // 数据盘大小,单位: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`接口无效。
  • @@ -1637,25 +1673,13 @@ type DataDisk struct { // 该参数目前仅用于`DescribeInstances`等查询类接口的返回参数,不可用于`RunInstances`等写接口的入参。 DiskId *string `json:"DiskId,omitnil,omitempty" name:"DiskId"` - // 数据盘是否随子机销毁。取值范围: - //
  • true:子机销毁时,销毁数据盘,只支持按小时后付费云盘
  • - //
  • - // false:子机销毁时,保留数据盘
    - // 默认取值:true
    - // 该参数目前仅用于 `RunInstances` 接口。 - //
  • + // 数据盘是否随子机销毁。取值范围:
  • true:子机销毁时,销毁数据盘,只支持按小时后付费云盘
  • false:子机销毁时,保留数据盘

  • 默认取值:true
    该参数目前仅用于 `RunInstances` 接口。 DeleteWithInstance *bool `json:"DeleteWithInstance,omitnil,omitempty" name:"DeleteWithInstance"` // 数据盘快照ID。选择的数据盘快照大小需小于数据盘大小。 SnapshotId *string `json:"SnapshotId,omitnil,omitempty" name:"SnapshotId"` - // 数据盘是加密。取值范围: - //
  • true:加密
  • - //
  • - // false:不加密
    - // 默认取值:false
    - // 该参数目前仅用于 `RunInstances` 接口。 - //
  • + // 数据盘是否加密。取值范围:
  • true:加密
  • false:不加密

  • 默认取值:false
    该参数目前仅用于 `RunInstances` 接口。 Encrypt *bool `json:"Encrypt,omitnil,omitempty" name:"Encrypt"` // 自定义CMK对应的ID,取值为UUID或者类似kms-abcd1234。用于加密云盘。 @@ -1663,7 +1687,8 @@ type DataDisk struct { // 该参数目前仅用于 `RunInstances` 接口。 KmsKeyId *string `json:"KmsKeyId,omitnil,omitempty" name:"KmsKeyId"` - // 云硬盘性能,单位:MB/s + // 云硬盘性能,单位:MiB/s。使用此参数可给云硬盘购买额外的性能。 + // 当前仅支持极速型云盘(CLOUD_TSSD)和增强型SSD云硬盘(CLOUD_HSSD) ThroughputPerformance *int64 `json:"ThroughputPerformance,omitnil,omitempty" name:"ThroughputPerformance"` // 所属的独享集群ID。 @@ -1675,8 +1700,6 @@ type DataDisk struct { BurstPerformance *bool `json:"BurstPerformance,omitnil,omitempty" name:"BurstPerformance"` // 磁盘名称,长度不超过128 个字符。 - // - // 该参数正在邀测中,暂未开放使用。 DiskName *string `json:"DiskName,omitnil,omitempty" name:"DiskName"` } @@ -1790,26 +1813,32 @@ func (r *DeleteHpcClustersResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteImagesRequestParams struct { - // 准备删除的镜像Id列表 + // 删除的镜像 ID 列表。 + // 可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回值中的`ImageId`获取。 ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` - // 是否删除镜像关联的快照 + // 是否删除镜像关联的快照。 + // 默认值:false DeleteBindedSnap *bool `json:"DeleteBindedSnap,omitnil,omitempty" name:"DeleteBindedSnap"` - // 检测是否支持删除镜像 + // 检测是否支持删除镜像。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` } type DeleteImagesRequest struct { *tchttp.BaseRequest - // 准备删除的镜像Id列表 + // 删除的镜像 ID 列表。 + // 可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回值中的`ImageId`获取。 ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` - // 是否删除镜像关联的快照 + // 是否删除镜像关联的快照。 + // 默认值:false DeleteBindedSnap *bool `json:"DeleteBindedSnap,omitnil,omitempty" name:"DeleteBindedSnap"` - // 检测是否支持删除镜像 + // 检测是否支持删除镜像。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` } @@ -1858,14 +1887,14 @@ func (r *DeleteImagesResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteInstancesActionTimerRequestParams struct { - // 定时任务ID列表,可以通过DescribeInstancesActionTimer接口查询。只能删除未执行的定时任务。 + // 定时任务ID列表,可以通过[ DescribeInstancesActionTimer ](https://cloud.tencent.com/document/product/213/103950)接口查询。只能删除未执行的定时任务。 ActionTimerIds []*string `json:"ActionTimerIds,omitnil,omitempty" name:"ActionTimerIds"` } type DeleteInstancesActionTimerRequest struct { *tchttp.BaseRequest - // 定时任务ID列表,可以通过DescribeInstancesActionTimer接口查询。只能删除未执行的定时任务。 + // 定时任务ID列表,可以通过[ DescribeInstancesActionTimer ](https://cloud.tencent.com/document/product/213/103950)接口查询。只能删除未执行的定时任务。 ActionTimerIds []*string `json:"ActionTimerIds,omitnil,omitempty" name:"ActionTimerIds"` } @@ -1966,14 +1995,14 @@ func (r *DeleteKeyPairsResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteLaunchTemplateRequestParams struct { - // 启动模板ID。 + // 启动模板ID。可通过 [DescribeLaunchTemplates](https://cloud.tencent.com/document/api/213/66322) 接口返回值中的`LaunchTemplateId`获取。 LaunchTemplateId *string `json:"LaunchTemplateId,omitnil,omitempty" name:"LaunchTemplateId"` } type DeleteLaunchTemplateRequest struct { *tchttp.BaseRequest - // 启动模板ID。 + // 启动模板ID。可通过 [DescribeLaunchTemplates](https://cloud.tencent.com/document/api/213/66322) 接口返回值中的`LaunchTemplateId`获取。 LaunchTemplateId *string `json:"LaunchTemplateId,omitnil,omitempty" name:"LaunchTemplateId"` } @@ -2020,20 +2049,20 @@ func (r *DeleteLaunchTemplateResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteLaunchTemplateVersionsRequestParams struct { - // 启动模板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`获取。 LaunchTemplateVersions []*int64 `json:"LaunchTemplateVersions,omitnil,omitempty" name:"LaunchTemplateVersions"` } type DeleteLaunchTemplateVersionsRequest struct { *tchttp.BaseRequest - // 启动模板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`获取。 LaunchTemplateVersions []*int64 `json:"LaunchTemplateVersions,omitnil,omitempty" name:"LaunchTemplateVersions"` } @@ -2084,7 +2113,7 @@ type DescribeAccountQuotaRequestParams struct { //
  • zone
  • //

    按照【可用区】进行过滤。可用区形如:ap-guangzhou-1。

    类型:String

    必选:否

    可选项:可用区列表

    //
  • quota-type
  • - //

    按照【配额类型】进行过滤。配额类型形如:PostPaidQuotaSet。

    类型:String

    必选:否

    可选项:PostPaidQuotaSet,DisasterRecoverGroupQuotaSet,PrePaidQuotaSet,SpotPaidQuotaSet

    + //

    按照【配额类型】进行过滤。配额类型形如:PostPaidQuotaSet。

    类型:String

    必选:否

    可选项:

    PostPaidQuotaSet: 后付费配额

    PrePaidQuotaSet: 预付费配额

    SpotPaidQuotaSet: 竞价配额

    ImageQuotaSet: 镜像配额

    DisasterRecoverGroupQuotaSet: 置放群组配额

    Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` } @@ -2094,7 +2123,7 @@ type DescribeAccountQuotaRequest struct { //
  • zone
  • //

    按照【可用区】进行过滤。可用区形如:ap-guangzhou-1。

    类型:String

    必选:否

    可选项:可用区列表

    //
  • quota-type
  • - //

    按照【配额类型】进行过滤。配额类型形如:PostPaidQuotaSet。

    类型:String

    必选:否

    可选项:PostPaidQuotaSet,DisasterRecoverGroupQuotaSet,PrePaidQuotaSet,SpotPaidQuotaSet

    + //

    按照【配额类型】进行过滤。配额类型形如:PostPaidQuotaSet。

    类型:String

    必选:否

    可选项:

    PostPaidQuotaSet: 后付费配额

    PrePaidQuotaSet: 预付费配额

    SpotPaidQuotaSet: 竞价配额

    ImageQuotaSet: 镜像配额

    DisasterRecoverGroupQuotaSet: 置放群组配额

    Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` } @@ -3218,14 +3247,14 @@ func (r *DescribeInstanceTypeConfigsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeInstanceVncUrlRequestParams struct { - // 一个操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。 + // 一个操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DescribeInstanceVncUrlRequest struct { *tchttp.BaseRequest - // 一个操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。 + // 一个操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -3278,19 +3307,19 @@ type DescribeInstancesActionTimerRequestParams struct { // 定时任务ID列表。 ActionTimerIds []*string `json:"ActionTimerIds,omitnil,omitempty" name:"ActionTimerIds"` - // 按照一个或者多个实例ID查询。 + // 按照一个或者多个实例ID查询。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 定时器动作,目前仅支持销毁一个值:TerminateInstances。 TimerAction *string `json:"TimerAction,omitnil,omitempty" name:"TimerAction"` - // 执行时间的结束范围,用于条件筛选,格式如2018-05-01 19:00:00。 + // 定时任务执行时间的结束范围,用于条件筛选,格式如2018-05-01 19:00:00。 EndActionTime *string `json:"EndActionTime,omitnil,omitempty" name:"EndActionTime"` - // 执行时间的开始范围,用于条件筛选,格式如2018-05-01 19:00:00。 + // 定时任务执行时间的开始范围,用于条件筛选,格式如2018-05-01 19:00:00。 StartActionTime *string `json:"StartActionTime,omitnil,omitempty" name:"StartActionTime"` - // 定时任务状态列表。
  • UNDO:未执行

  • DOING:正在执行

  • DONE:执行完成。
  • + // 定时任务状态列表。
  • UNDO:未执行
  • DOING:正在执行
  • DONE:执行完成。
  • StatusList []*string `json:"StatusList,omitnil,omitempty" name:"StatusList"` } @@ -3300,19 +3329,19 @@ type DescribeInstancesActionTimerRequest struct { // 定时任务ID列表。 ActionTimerIds []*string `json:"ActionTimerIds,omitnil,omitempty" name:"ActionTimerIds"` - // 按照一个或者多个实例ID查询。 + // 按照一个或者多个实例ID查询。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 定时器动作,目前仅支持销毁一个值:TerminateInstances。 TimerAction *string `json:"TimerAction,omitnil,omitempty" name:"TimerAction"` - // 执行时间的结束范围,用于条件筛选,格式如2018-05-01 19:00:00。 + // 定时任务执行时间的结束范围,用于条件筛选,格式如2018-05-01 19:00:00。 EndActionTime *string `json:"EndActionTime,omitnil,omitempty" name:"EndActionTime"` - // 执行时间的开始范围,用于条件筛选,格式如2018-05-01 19:00:00。 + // 定时任务执行时间的开始范围,用于条件筛选,格式如2018-05-01 19:00:00。 StartActionTime *string `json:"StartActionTime,omitnil,omitempty" name:"StartActionTime"` - // 定时任务状态列表。
  • UNDO:未执行

  • DOING:正在执行

  • DONE:执行完成。
  • + // 定时任务状态列表。
  • UNDO:未执行
  • DOING:正在执行
  • DONE:执行完成。
  • StatusList []*string `json:"StatusList,omitnil,omitempty" name:"StatusList"` } @@ -3371,7 +3400,7 @@ type DescribeInstancesAttributesRequestParams struct { // UserData: 实例自定义数据 Attributes []*string `json:"Attributes,omitnil,omitempty" name:"Attributes"` - // 实例ID列表 + // 实例ID列表。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -3382,7 +3411,7 @@ type DescribeInstancesAttributesRequest struct { // UserData: 实例自定义数据 Attributes []*string `json:"Attributes,omitnil,omitempty" name:"Attributes"` - // 实例ID列表 + // 实例ID列表。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -3437,7 +3466,7 @@ type DescribeInstancesModificationRequestParams struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` //
  • status
  • - //

    按照【配置规格状态】进行过滤。配置规格状态形如:SELL、UNAVAILABLE。

    类型:String

    必选:否

    + //

    按照【配置规格状态】进行过滤。配置规格状态形如:SELL(表示实例可售卖)、UNAVAILABLE(表示实例不可用)。

    类型:String

    必选:否

    // 每次请求的`Filters`的上限为10,`Filter.Values`的上限为2。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` } @@ -3449,7 +3478,7 @@ type DescribeInstancesModificationRequest struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` //
  • status
  • - //

    按照【配置规格状态】进行过滤。配置规格状态形如:SELL、UNAVAILABLE。

    类型:String

    必选:否

    + //

    按照【配置规格状态】进行过滤。配置规格状态形如:SELL(表示实例可售卖)、UNAVAILABLE(表示实例不可用)。

    类型:String

    必选:否

    // 每次请求的`Filters`的上限为10,`Filter.Values`的上限为2。 Filters []*Filter `json:"Filters,omitnil,omitempty" name:"Filters"` } @@ -3508,7 +3537,7 @@ type DescribeInstancesOperationLimitRequestParams struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 实例操作。 - //
  • INSTANCE_DEGRADE:实例降配操作
  • + //
  • INSTANCE_DEGRADE:实例降配操作
  • INTERNET_CHARGE_TYPE_CHANGE:实例调整带宽付费模式操作
  • Operation *string `json:"Operation,omitnil,omitempty" name:"Operation"` } @@ -3519,7 +3548,7 @@ type DescribeInstancesOperationLimitRequest struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 实例操作。 - //
  • INSTANCE_DEGRADE:实例降配操作
  • + //
  • INSTANCE_DEGRADE:实例降配操作
  • INTERNET_CHARGE_TYPE_CHANGE:实例调整带宽付费模式操作
  • Operation *string `json:"Operation,omitnil,omitempty" name:"Operation"` } @@ -4570,7 +4599,7 @@ type DescribeZoneInstanceConfigInfosRequestParams struct { //
  • instance-type
  • //

    按照【实例机型】进行过滤。不同实例机型指定了不同的资源规格,具体取值可通过调用接口 [DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/product/213/15749) 来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则默认查询筛选条件下所有机型。

    类型:String

    必选:否

    //
  • instance-charge-type
  • - //

    按照【实例计费模式】进行过滤。(PREPAID:表示预付费,即包年包月 | POSTPAID_BY_HOUR:表示后付费,即按量计费 )

    类型:String

    必选:否

    + //

    按照【实例计费模式】进行过滤。(PREPAID:表示预付费,即包年包月 | POSTPAID_BY_HOUR:表示后付费,即按量计费 | CDHPAID:表示独享子机 | SPOTPAID:表示竞价付费 | CDCPAID:表示专用集群付费)

    类型:String

    必选:否

    //
  • sort-keys
  • //

    按关键字进行排序,格式为排序字段加排序方式,中间用冒号分隔。 例如: 按cpu数逆序排序 "cpu:desc", 按mem大小顺序排序 "mem:asc"

    类型:String

    必选:否

    // 每次请求的`Filters`的上限为10,`Filter.Values`的上限为100。 @@ -4587,7 +4616,7 @@ type DescribeZoneInstanceConfigInfosRequest struct { //
  • instance-type
  • //

    按照【实例机型】进行过滤。不同实例机型指定了不同的资源规格,具体取值可通过调用接口 [DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/product/213/15749) 来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则默认查询筛选条件下所有机型。

    类型:String

    必选:否

    //
  • instance-charge-type
  • - //

    按照【实例计费模式】进行过滤。(PREPAID:表示预付费,即包年包月 | POSTPAID_BY_HOUR:表示后付费,即按量计费 )

    类型:String

    必选:否

    + //

    按照【实例计费模式】进行过滤。(PREPAID:表示预付费,即包年包月 | POSTPAID_BY_HOUR:表示后付费,即按量计费 | CDHPAID:表示独享子机 | SPOTPAID:表示竞价付费 | CDCPAID:表示专用集群付费)

    类型:String

    必选:否

    //
  • sort-keys
  • //

    按关键字进行排序,格式为排序字段加排序方式,中间用冒号分隔。 例如: 按cpu数逆序排序 "cpu:desc", 按mem大小顺序排序 "mem:asc"

    类型:String

    必选:否

    // 每次请求的`Filters`的上限为10,`Filter.Values`的上限为100。 @@ -4697,26 +4726,38 @@ func (r *DescribeZonesResponse) FromJsonString(s string) error { // Predefined struct for user type DisassociateInstancesKeyPairsRequestParams struct { - // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。

    可以通过以下方式获取可用的实例ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ,取返回信息中的 `InstanceId` 获取实例ID。 + // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。
    可以通过以下方式获取可用的实例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"` - // 密钥对ID列表,每次请求批量密钥对的上限为100。密钥对ID形如:`skey-11112222`。

    可以通过以下方式获取可用的密钥ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的 `KeyId` 获取密钥对ID。 + // 密钥对ID列表,列表长度上限为100。可以通过以下方式获取可用的密钥ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的 `KeyId` 获取密钥对ID。
  • KeyIds []*string `json:"KeyIds,omitnil,omitempty" name:"KeyIds"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再解绑密钥。取值范围:
  • true:表示在正常关机失败后进行强制关机。
  • false:表示在正常关机失败后不进行强制关机。

    默认取值:false。 + // 是否强制关机,默认值为 false。常规场景下,建议手动关机后解绑密钥。取值范围: + //
  • true:先执行强制关机,再解绑密钥。
  • + //
  • false:不执行强制关机,仅支持对已关机状态实例进行解绑操作。
  • ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } type DisassociateInstancesKeyPairsRequest struct { *tchttp.BaseRequest - // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。

    可以通过以下方式获取可用的实例ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/index)查询实例ID。
  • 通过调用接口 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) ,取返回信息中的 `InstanceId` 获取实例ID。 + // 一个或多个待操作的实例ID,每次请求批量实例的上限为100。
    可以通过以下方式获取可用的实例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"` - // 密钥对ID列表,每次请求批量密钥对的上限为100。密钥对ID形如:`skey-11112222`。

    可以通过以下方式获取可用的密钥ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的 `KeyId` 获取密钥对ID。 + // 密钥对ID列表,列表长度上限为100。可以通过以下方式获取可用的密钥ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/15699) ,取返回信息中的 `KeyId` 获取密钥对ID。
  • KeyIds []*string `json:"KeyIds,omitnil,omitempty" name:"KeyIds"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再解绑密钥。取值范围:
  • true:表示在正常关机失败后进行强制关机。
  • false:表示在正常关机失败后不进行强制关机。

    默认取值:false。 + // 是否强制关机,默认值为 false。常规场景下,建议手动关机后解绑密钥。取值范围: + //
  • true:先执行强制关机,再解绑密钥。
  • + //
  • false:不执行强制关机,仅支持对已关机状态实例进行解绑操作。
  • ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } @@ -4765,20 +4806,20 @@ func (r *DisassociateInstancesKeyPairsResponse) FromJsonString(s string) error { // Predefined struct for user type DisassociateSecurityGroupsRequestParams struct { - // 要解绑的`安全组ID`,类似sg-efil73jd,只支持解绑单个安全组。 + // 要解绑的`安全组ID`,类似sg-efil73jd,只支持解绑单个安全组。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`SecurityGroupIds`获取实例绑定的安全组。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - // 被解绑的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。 + // 被解绑的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } type DisassociateSecurityGroupsRequest struct { *tchttp.BaseRequest - // 要解绑的`安全组ID`,类似sg-efil73jd,只支持解绑单个安全组。 + // 要解绑的`安全组ID`,类似sg-efil73jd,只支持解绑单个安全组。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`SecurityGroupIds`获取实例绑定的安全组。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - // 被解绑的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。 + // 被解绑的`实例ID`,类似ins-lesecurk,支持指定多个实例,每次请求批量实例的上限为100。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -4846,7 +4887,7 @@ type DisasterRecoverGroup struct { // 分散置放群组内,云服务器id列表。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 分散置放群组创建时间。 + // 分散置放群组创建时间。按照`ISO8601`标准表示,并且使用`UTC`时间。格式为:`YYYY-MM-DDThh:mm:ssZ`。 CreateTime *string `json:"CreateTime,omitnil,omitempty" name:"CreateTime"` // 置放群组亲和度 @@ -4886,10 +4927,10 @@ type EnhancedService struct { // Predefined struct for user type EnterRescueModeRequestParams struct { - // 需要进入救援模式的实例id + // 需要进入救援模式的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 救援模式下系统密码 + // 救援模式下系统密码。不同操作系统类型密码复杂度限制不一样,具体如下:
  • Linux实例密码必须8到30位,至少包括两项[a-z],[A-Z]、[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ]中的特殊符号。
  • Windows实例密码必须12到30位,至少包括三项[a-z],[A-Z],[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? /]中的特殊符号。
  • Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 救援模式下系统用户名 @@ -4907,10 +4948,10 @@ type EnterRescueModeRequestParams struct { type EnterRescueModeRequest struct { *tchttp.BaseRequest - // 需要进入救援模式的实例id + // 需要进入救援模式的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 救援模式下系统密码 + // 救援模式下系统密码。不同操作系统类型密码复杂度限制不一样,具体如下:
  • Linux实例密码必须8到30位,至少包括两项[a-z],[A-Z]、[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ]中的特殊符号。
  • Windows实例密码必须12到30位,至少包括三项[a-z],[A-Z],[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? /]中的特殊符号。
  • Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 救援模式下系统用户名 @@ -4970,14 +5011,14 @@ func (r *EnterRescueModeResponse) FromJsonString(s string) error { // Predefined struct for user type ExitRescueModeRequestParams struct { - // 退出救援模式的实例id + // 退出救援模式的实例id。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type ExitRescueModeRequest struct { *tchttp.BaseRequest - // 退出救援模式的实例id + // 退出救援模式的实例id。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -5024,22 +5065,27 @@ func (r *ExitRescueModeResponse) FromJsonString(s string) error { // Predefined struct for user type ExportImagesRequestParams struct { - // COS存储桶名称 + // COS存储桶名称。 + // 可通过 [List Buckets](https://cloud.tencent.com/document/product/436/8291) 接口查询请求者名下的所有存储桶列表或特定地域下的存储桶列表。 BucketName *string `json:"BucketName,omitnil,omitempty" name:"BucketName"` // 镜像ID列表。调用 ExportImages 接口时,参数 ImageIds 和 SnapshotIds 为二选一必填参数,目前参数 SnapshotIds 暂未对外开放。 + // 可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回值中的`ImageId`获取。 ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` // 镜像文件导出格式。取值范围:RAW,QCOW2,VHD,VMDK。默认为RAW ExportFormat *string `json:"ExportFormat,omitnil,omitempty" name:"ExportFormat"` - // 导出文件的名称前缀列表 + // 导出文件的名称前缀列表。 + // 默认导出文件无名称前缀。 FileNamePrefixList []*string `json:"FileNamePrefixList,omitnil,omitempty" name:"FileNamePrefixList"` - // 是否只导出系统盘 + // 是否只导出系统盘。 + // 默认值:false OnlyExportRootDisk *bool `json:"OnlyExportRootDisk,omitnil,omitempty" name:"OnlyExportRootDisk"` - // 检测镜像是否支持导出 + // 检测镜像是否支持导出。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 角色名称。默认为CVM_QcsRole,发起请求前请确认是否存在该角色,以及是否已正确配置COS写入权限。 @@ -5049,22 +5095,27 @@ type ExportImagesRequestParams struct { type ExportImagesRequest struct { *tchttp.BaseRequest - // COS存储桶名称 + // COS存储桶名称。 + // 可通过 [List Buckets](https://cloud.tencent.com/document/product/436/8291) 接口查询请求者名下的所有存储桶列表或特定地域下的存储桶列表。 BucketName *string `json:"BucketName,omitnil,omitempty" name:"BucketName"` // 镜像ID列表。调用 ExportImages 接口时,参数 ImageIds 和 SnapshotIds 为二选一必填参数,目前参数 SnapshotIds 暂未对外开放。 + // 可通过 [DescribeImages](https://cloud.tencent.com/document/api/213/15715) 接口返回值中的`ImageId`获取。 ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` // 镜像文件导出格式。取值范围:RAW,QCOW2,VHD,VMDK。默认为RAW ExportFormat *string `json:"ExportFormat,omitnil,omitempty" name:"ExportFormat"` - // 导出文件的名称前缀列表 + // 导出文件的名称前缀列表。 + // 默认导出文件无名称前缀。 FileNamePrefixList []*string `json:"FileNamePrefixList,omitnil,omitempty" name:"FileNamePrefixList"` - // 是否只导出系统盘 + // 是否只导出系统盘。 + // 默认值:false OnlyExportRootDisk *bool `json:"OnlyExportRootDisk,omitnil,omitempty" name:"OnlyExportRootDisk"` - // 检测镜像是否支持导出 + // 检测镜像是否支持导出。 + // 默认值:false DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 角色名称。默认为CVM_QcsRole,发起请求前请确认是否存在该角色,以及是否已正确配置COS写入权限。 @@ -5101,7 +5152,9 @@ type ExportImagesResponseParams struct { // 导出镜像任务ID TaskId *uint64 `json:"TaskId,omitnil,omitempty" name:"TaskId"` - // 导出镜像的COS文件名列表 + // 导出镜像的COS文件名列表。其中,文件名格式如下。 + // * 系统盘:前缀名_镜像ID_system_快照ID.镜像格式 + // * 数据盘:前缀名_镜像ID_data_快照ID.镜像格式 CosPaths []*string `json:"CosPaths,omitnil,omitempty" name:"CosPaths"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5280,10 +5333,14 @@ type Image struct { // 镜像操作系统 OsName *string `json:"OsName,omitnil,omitempty" name:"OsName"` - // 镜像类型 + // 镜像类型。镜像类型返回值包括: + // * `PUBLIC_IMAGE` 公共镜像 + // * `PRIVATE_IMAGE` 自定义镜像 + // * `SHARED_IMAGE` 共享镜像 ImageType *string `json:"ImageType,omitnil,omitempty" name:"ImageType"` - // 镜像创建时间 + // 镜像创建时间。 + // 按照 ISO8601 标准表示,并且使用 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。 CreatedTime *string `json:"CreatedTime,omitnil,omitempty" name:"CreatedTime"` // 镜像名称 @@ -5292,10 +5349,13 @@ type Image struct { // 镜像描述 ImageDescription *string `json:"ImageDescription,omitnil,omitempty" name:"ImageDescription"` - // 镜像大小 + // 镜像大小,单位 GiB。 ImageSize *int64 `json:"ImageSize,omitnil,omitempty" name:"ImageSize"` - // 镜像架构 + // 镜像架构。镜像架构返回值包括: + // * `x86_64` + // * `arm` + // * `i386` Architecture *string `json:"Architecture,omitnil,omitempty" name:"Architecture"` // 镜像状态: @@ -5314,7 +5374,10 @@ type Image struct { // 镜像创建者 ImageCreator *string `json:"ImageCreator,omitnil,omitempty" name:"ImageCreator"` - // 镜像来源 + // 镜像来源。镜像来源返回值包括: + // * `OFFICIAL` 官方镜像 + // * `CREATE_IMAGE` 用户自建镜像 + // * `EXTERNAL_IMPORT` 用户外部导入镜像 ImageSource *string `json:"ImageSource,omitnil,omitempty" name:"ImageSource"` // 同步百分比 @@ -5330,7 +5393,9 @@ type Image struct { // 镜像关联的标签列表。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` - // 镜像许可类型 + // 镜像许可类型。镜像许可类型返回值包括: + // * `TencentCloud` 腾讯云官方许可 + // * `BYOL` 用户自带许可 LicenseType *string `json:"LicenseType,omitnil,omitempty" name:"LicenseType"` // 镜像族 @@ -5338,6 +5403,9 @@ type Image struct { // 镜像是否废弃 ImageDeprecated *bool `json:"ImageDeprecated,omitnil,omitempty" name:"ImageDeprecated"` + + // CDC镜像缓存状态 + CdcCacheStatus *string `json:"CdcCacheStatus,omitnil,omitempty" name:"CdcCacheStatus"` } type ImageOsList struct { @@ -5510,7 +5578,7 @@ func (r *ImportImageResponse) FromJsonString(s string) error { // Predefined struct for user type ImportInstancesActionTimerRequestParams struct { - // 实例id列表,可以通过DescribeInstances接口查询到。 + // 实例id列表,可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 定时器任务信息,目前仅支持定时销毁。 @@ -5520,7 +5588,7 @@ type ImportInstancesActionTimerRequestParams struct { type ImportInstancesActionTimerRequest struct { *tchttp.BaseRequest - // 实例id列表,可以通过DescribeInstances接口查询到。 + // 实例id列表,可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 定时器任务信息,目前仅支持定时销毁。 @@ -5577,9 +5645,7 @@ type ImportKeyPairRequestParams struct { // 密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` - // 密钥对创建后所属的[项目](https://cloud.tencent.com/document/product/378/10861)ID。

    可以通过以下方式获取项目ID:
  • 通过[项目列表](https://console.cloud.tencent.com/project)查询项目ID。
  • 通过调用接口 [DescribeProject](https://cloud.tencent.com/document/api/378/4400),取返回信息中的 `projectId ` 获取项目ID。 - // - // 如果是默认项目,直接填0就可以。 + // 密钥对创建后所属的[项目](https://cloud.tencent.com/document/product/378/10861)ID。
    可以通过以下方式获取项目ID:
  • 通过[项目列表](https://console.cloud.tencent.com/project)查询项目ID。
  • 通过调用接口 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725),取返回信息中的 `projectId ` 获取项目ID。
  • 如果是默认项目,直接填0就可以。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 密钥对的公钥内容,`OpenSSH RSA` 格式。 @@ -5595,9 +5661,7 @@ type ImportKeyPairRequest struct { // 密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` - // 密钥对创建后所属的[项目](https://cloud.tencent.com/document/product/378/10861)ID。

    可以通过以下方式获取项目ID:
  • 通过[项目列表](https://console.cloud.tencent.com/project)查询项目ID。
  • 通过调用接口 [DescribeProject](https://cloud.tencent.com/document/api/378/4400),取返回信息中的 `projectId ` 获取项目ID。 - // - // 如果是默认项目,直接填0就可以。 + // 密钥对创建后所属的[项目](https://cloud.tencent.com/document/product/378/10861)ID。
    可以通过以下方式获取项目ID:
  • 通过[项目列表](https://console.cloud.tencent.com/project)查询项目ID。
  • 通过调用接口 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725),取返回信息中的 `projectId ` 获取项目ID。
  • 如果是默认项目,直接填0就可以。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 密钥对的公钥内容,`OpenSSH RSA` 格式。 @@ -6195,29 +6259,43 @@ func (r *InquiryPriceResetInstancesTypeResponse) FromJsonString(s string) error // Predefined struct for user type InquiryPriceResizeInstanceDisksRequestParams struct { - // 待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考硬盘产品简介。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 + // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘[ DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考硬盘产品简介。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机

  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` + + // 待扩容的系统盘配置信息。只支持扩容云盘。 + // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 + SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` + + // 是否在线扩容 + ResizeOnline *bool `json:"ResizeOnline,omitnil,omitempty" name:"ResizeOnline"` } type InquiryPriceResizeInstanceDisksRequest struct { *tchttp.BaseRequest - // 待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考硬盘产品简介。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 + // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘[ DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考硬盘产品简介。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机

  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` + + // 待扩容的系统盘配置信息。只支持扩容云盘。 + // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 + SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` + + // 是否在线扩容 + ResizeOnline *bool `json:"ResizeOnline,omitnil,omitempty" name:"ResizeOnline"` } func (r *InquiryPriceResizeInstanceDisksRequest) ToJsonString() string { @@ -6235,6 +6313,8 @@ func (r *InquiryPriceResizeInstanceDisksRequest) FromJsonString(s string) error delete(f, "InstanceId") delete(f, "DataDisks") delete(f, "ForceStop") + delete(f, "SystemDisk") + delete(f, "ResizeOnline") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "InquiryPriceResizeInstanceDisksRequest has unknown keys!", "") } @@ -6282,7 +6362,8 @@ type InquiryPriceRunInstancesRequestParams struct { // 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 InstanceChargePrepaid *InstanceChargePrepaid `json:"InstanceChargePrepaid,omitnil,omitempty" name:"InstanceChargePrepaid"` - // 实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则默认机型为S1.SMALL1。 + // 实例机型。不同实例机型指定了不同的资源规格。 + //
  • 对于付费模式为PREPAID或POSTPAID_BY_HOUR的实例创建,具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则系统将根据当前地域的资源售卖情况动态指定默认机型。

  • 对于付费模式为CDHPAID的实例创建,该参数以"CDH_"为前缀,根据CPU和内存配置生成,具体形式为:CDH_XCXG,例如对于创建CPU为1核,内存为1G大小的专用宿主机的实例,该参数应该为CDH_1C1G。
  • InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` // 实例系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。 @@ -6306,7 +6387,7 @@ type InquiryPriceRunInstancesRequestParams 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"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数,则默认开启云监控、云安全服务。 @@ -6351,7 +6432,8 @@ type InquiryPriceRunInstancesRequest struct { // 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 InstanceChargePrepaid *InstanceChargePrepaid `json:"InstanceChargePrepaid,omitnil,omitempty" name:"InstanceChargePrepaid"` - // 实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则默认机型为S1.SMALL1。 + // 实例机型。不同实例机型指定了不同的资源规格。 + //
  • 对于付费模式为PREPAID或POSTPAID_BY_HOUR的实例创建,具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。若不指定该参数,则系统将根据当前地域的资源售卖情况动态指定默认机型。

  • 对于付费模式为CDHPAID的实例创建,该参数以"CDH_"为前缀,根据CPU和内存配置生成,具体形式为:CDH_XCXG,例如对于创建CPU为1核,内存为1G大小的专用宿主机的实例,该参数应该为CDH_1C1G。
  • InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` // 实例系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。 @@ -6375,7 +6457,7 @@ type InquiryPriceRunInstancesRequest 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"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数,则默认开启云监控、云安全服务。 @@ -6546,7 +6628,7 @@ type Instance struct { // 实例名称。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` - // 实例计费模式。取值范围:
  • `PREPAID`:表示预付费,即包年包月
  • `POSTPAID_BY_HOUR`:表示后付费,即按量计费
  • `CDHPAID`:`专用宿主机`付费,即只对`专用宿主机`计费,不对`专用宿主机`上的实例计费。
  • `SPOTPAID`:表示竞价实例付费。
  • + // 实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。取值范围:
  • PREPAID:预付费,即包年包月

  • POSTPAID_BY_HOUR:按小时后付费

  • CDHPAID:独享子机(基于专用宿主机创建,宿主机部分的资源不收费)

  • SPOTPAID:竞价付费

  • CDCPAID:专用集群付费
  • InstanceChargeType *string `json:"InstanceChargeType,omitnil,omitempty" name:"InstanceChargeType"` // 实例系统盘信息。 @@ -6590,7 +6672,7 @@ type Instance struct { // 实例登录设置。目前只返回实例所关联的密钥。 LoginSettings *LoginSettings `json:"LoginSettings,omitnil,omitempty" name:"LoginSettings"` - // 实例状态。取值范围:
  • PENDING:表示创建中
  • LAUNCH_FAILED:表示创建失败
  • RUNNING:表示运行中
  • STOPPED:表示关机
  • STARTING:表示开机中
  • STOPPING:表示关机中
  • REBOOTING:表示重启中
  • SHUTDOWN:表示停止待销毁
  • TERMINATING:表示销毁中。
  • + // 实例状态。状态类型详见[实例状态表](https://cloud.tencent.com/document/api/213/15753#InstanceStatus) InstanceState *string `json:"InstanceState,omitnil,omitempty" name:"InstanceState"` // 实例关联的标签列表。 @@ -6726,7 +6808,7 @@ type InstanceTypeConfig struct { // CPU核数,单位:核。 CPU *int64 `json:"CPU,omitnil,omitempty" name:"CPU"` - // 内存容量,单位:`GB`。 + // 内存容量,单位:`GiB`。 Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` // FPGA核数,单位:核。 @@ -6754,7 +6836,7 @@ type InstanceTypeQuotaItem struct { // 实例机型。 InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` - // 实例计费模式。取值范围:
  • PREPAID:表示预付费,即包年包月
  • POSTPAID_BY_HOUR:表示后付费,即按量计费
  • CDHPAID:表示[专用宿主机](https://cloud.tencent.com/document/product/416)付费,即只对`专用宿主机`计费,不对`专用宿主机`上的实例计费。
  • `SPOTPAID`:表示竞价实例付费。 + // 实例计费模式。取值范围:
  • PREPAID:表示预付费,即包年包月
  • POSTPAID_BY_HOUR:表示后付费,即按量计费
  • CDHPAID:表示[专用宿主机](https://cloud.tencent.com/document/product/416)付费,即只对`专用宿主机`计费,不对`专用宿主机`上的实例计费。
  • SPOTPAID:表示竞价实例付费。
  • InstanceChargeType *string `json:"InstanceChargeType,omitnil,omitempty" name:"InstanceChargeType"` // 网卡类型,例如:25代表25G网卡 @@ -6778,7 +6860,7 @@ type InstanceTypeQuotaItem struct { // 本地磁盘规格列表。当该参数返回为空值时,表示当前情况下无法创建本地盘。 LocalDiskTypeList []*LocalDiskType `json:"LocalDiskTypeList,omitnil,omitempty" name:"LocalDiskTypeList"` - // 实例是否售卖。取值范围:
  • SELL:表示实例可购买
  • SOLD_OUT:表示实例已售罄。 + // 实例是否售卖。取值范围:
  • SELL:表示实例可购买
  • SOLD_OUT:表示实例已售罄。
  • Status *string `json:"Status,omitnil,omitempty" name:"Status"` // 实例的售卖价格。 @@ -6815,10 +6897,7 @@ type InstanceTypeQuotaItem struct { Frequency *string `json:"Frequency,omitnil,omitempty" name:"Frequency"` // 描述库存情况。取值范围: - //
  • EnoughStock:表示对应库存非常充足
  • - //
  • NormalStock:表示对应库存供应有保障
  • - //
  • UnderStock:表示对应库存即将售罄
  • - //
  • WithoutStock:表示对应库存已经售罄
  • + //
  • EnoughStock:表示对应库存非常充足
  • NormalStock:表示对应库存供应有保障
  • UnderStock:表示对应库存即将售罄
  • WithoutStock:表示对应库存已经售罄
  • StatusCategory *string `json:"StatusCategory,omitnil,omitempty" name:"StatusCategory"` } @@ -6832,7 +6911,7 @@ type InternetAccessible struct { // 是否分配公网IP。取值范围:
  • true:表示分配公网IP
  • false:表示不分配公网IP

  • 当公网带宽大于0Mbps时,可自由选择开通与否,默认开通公网IP;当公网带宽为0,则不允许分配公网IP。该参数仅在RunInstances接口中作为入参使用。 PublicIpAssigned *bool `json:"PublicIpAssigned,omitnil,omitempty" name:"PublicIpAssigned"` - // 带宽包ID。可通过[`DescribeBandwidthPackages`](https://cloud.tencent.com/document/api/215/19209)接口返回值中的`BandwidthPackageId`获取。该参数仅在RunInstances接口中作为入参使用。 + // 带宽包ID。可通过[ DescribeBandwidthPackages ](https://cloud.tencent.com/document/api/215/19209)接口返回值中的`BandwidthPackageId`获取。该参数仅在RunInstances接口中作为入参使用。 BandwidthPackageId *string `json:"BandwidthPackageId,omitnil,omitempty" name:"BandwidthPackageId"` } @@ -6848,7 +6927,7 @@ type InternetBandwidthConfig struct { } type InternetChargeTypeConfig struct { - // 网络计费模式。 + // 网络计费类型。取值范围:
  • BANDWIDTH_PREPAID:预付费按带宽结算
  • TRAFFIC_POSTPAID_BY_HOUR:流量按小时后付费
  • BANDWIDTH_POSTPAID_BY_HOUR:带宽按小时后付费
  • BANDWIDTH_PACKAGE:带宽包用户
  • 默认取值:非带宽包用户默认与子机付费类型保持一致,比如子机付费类型为预付费,网络计费类型默认为预付费;子机付费类型为后付费,网络计费类型默认为后付费。 InternetChargeType *string `json:"InternetChargeType,omitnil,omitempty" name:"InternetChargeType"` // 网络计费模式描述信息。 @@ -6930,7 +7009,7 @@ type KeyPair struct { // 密钥对名称。 KeyName *string `json:"KeyName,omitnil,omitempty" name:"KeyName"` - // 密钥对所属的项目`ID`。 + // 密钥对所属的项目 `ID`,ProjectId 为 0 时表示默认项目。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 密钥对描述信息。 @@ -7085,7 +7164,7 @@ type LaunchTemplateVersionInfo struct { // 实例启动模板版本描述信息。 LaunchTemplateVersionDescription *string `json:"LaunchTemplateVersionDescription,omitnil,omitempty" name:"LaunchTemplateVersionDescription"` - // 创建者。 + // 创建者的AppId。 CreatedBy *string `json:"CreatedBy,omitnil,omitempty" name:"CreatedBy"` } @@ -7563,7 +7642,7 @@ func (r *ModifyImageSharePermissionResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyInstanceDiskTypeRequestParams struct { - // 待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/9388) 接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 实例数据盘配置信息,只需要指定要转换的目标云硬盘的介质类型,指定DiskType的值,当前只支持一个数据盘转化。只支持CDHPAID类型实例指定CdcId参数。 @@ -7576,7 +7655,7 @@ type ModifyInstanceDiskTypeRequestParams struct { type ModifyInstanceDiskTypeRequest struct { *tchttp.BaseRequest - // 待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/9388) 接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 实例数据盘配置信息,只需要指定要转换的目标云硬盘的介质类型,指定DiskType的值,当前只支持一个数据盘转化。只支持CDHPAID类型实例指定CdcId参数。 @@ -7635,13 +7714,12 @@ type ModifyInstancesAttributeRequestParams struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 修改后实例名称。可任意命名,但不得超过60个字符。 - // 必须指定InstanceName与SecurityGroups的其中一个,但不能同时设置 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 提供给实例使用的用户数据,需要以 base64 方式编码,支持的最大数据大小为 16 KB。关于获取此参数的详细介绍,请参阅 [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"` - // 指定实例的修改后的安全组Id列表,子机将重新关联指定列表的安全组,原本关联的安全组会被解绑。必须指定SecurityGroups与InstanceName的其中一个,但不能同时设置 + // 指定实例的修改后的安全组Id列表,子机将重新关联指定列表的安全组,原本关联的安全组会被解绑。 SecurityGroups []*string `json:"SecurityGroups,omitnil,omitempty" name:"SecurityGroups"` // 给实例绑定用户角色,传空值为解绑操作 @@ -7672,13 +7750,12 @@ type ModifyInstancesAttributeRequest struct { InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 修改后实例名称。可任意命名,但不得超过60个字符。 - // 必须指定InstanceName与SecurityGroups的其中一个,但不能同时设置 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 提供给实例使用的用户数据,需要以 base64 方式编码,支持的最大数据大小为 16 KB。关于获取此参数的详细介绍,请参阅 [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"` - // 指定实例的修改后的安全组Id列表,子机将重新关联指定列表的安全组,原本关联的安全组会被解绑。必须指定SecurityGroups与InstanceName的其中一个,但不能同时设置 + // 指定实例的修改后的安全组Id列表,子机将重新关联指定列表的安全组,原本关联的安全组会被解绑。 SecurityGroups []*string `json:"SecurityGroups,omitnil,omitempty" name:"SecurityGroups"` // 给实例绑定用户角色,传空值为解绑操作 @@ -7756,13 +7833,13 @@ type ModifyInstancesChargeTypeRequestParams struct { // 一个或多个待操作的实例ID。可通过[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为30。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 修改后实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID:预付费,即包年包月。
  • POSTPAID_BY_HOUR:后付费,即按量付费。 + // 修改后实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID:预付费,即包年包月。
  • POSTPAID_BY_HOUR:后付费,即按量付费。
  • InstanceChargeType *string `json:"InstanceChargeType,omitnil,omitempty" name:"InstanceChargeType"` // 修改后预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 InstanceChargePrepaid *InstanceChargePrepaid `json:"InstanceChargePrepaid,omitnil,omitempty" name:"InstanceChargePrepaid"` - // 是否同时切换弹性数据云盘计费模式。取值范围:
  • true:表示切换弹性数据云盘计费模式
  • false:表示不切换弹性数据云盘计费模式

    默认取值:false。 + // 是否同时切换弹性数据云盘计费模式。取值范围:
  • true:表示切换弹性数据云盘计费模式
  • false:表示不切换弹性数据云盘计费模式
  • 默认取值:false。 ModifyPortableDataDisk *bool `json:"ModifyPortableDataDisk,omitnil,omitempty" name:"ModifyPortableDataDisk"` } @@ -7772,13 +7849,13 @@ type ModifyInstancesChargeTypeRequest struct { // 一个或多个待操作的实例ID。可通过[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。每次请求批量实例的上限为30。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 修改后实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID:预付费,即包年包月。
  • POSTPAID_BY_HOUR:后付费,即按量付费。 + // 修改后实例[计费类型](https://cloud.tencent.com/document/product/213/2180)。
  • PREPAID:预付费,即包年包月。
  • POSTPAID_BY_HOUR:后付费,即按量付费。
  • InstanceChargeType *string `json:"InstanceChargeType,omitnil,omitempty" name:"InstanceChargeType"` // 修改后预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。若指定实例的付费模式为预付费则该参数必传。 InstanceChargePrepaid *InstanceChargePrepaid `json:"InstanceChargePrepaid,omitnil,omitempty" name:"InstanceChargePrepaid"` - // 是否同时切换弹性数据云盘计费模式。取值范围:
  • true:表示切换弹性数据云盘计费模式
  • false:表示不切换弹性数据云盘计费模式

    默认取值:false。 + // 是否同时切换弹性数据云盘计费模式。取值范围:
  • true:表示切换弹性数据云盘计费模式
  • false:表示不切换弹性数据云盘计费模式
  • 默认取值:false。 ModifyPortableDataDisk *bool `json:"ModifyPortableDataDisk,omitnil,omitempty" name:"ModifyPortableDataDisk"` } @@ -7899,7 +7976,7 @@ type ModifyInstancesProjectRequestParams struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。每次请求允许操作的实例数量上限是100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[`DescribeProject`](https://cloud.tencent.com/document/api/651/78725) API返回值中的`projectId`获取。后续使用[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口查询实例时,项目ID可用于过滤结果。 + // 项目ID。项目可以使用[ AddProject ](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[ DescribeProject ](https://cloud.tencent.com/document/api/651/78725) 接口返回值中的`projectId`获取。后续使用[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口查询实例时,项目ID可用于过滤结果。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } @@ -7909,7 +7986,7 @@ type ModifyInstancesProjectRequest struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。每次请求允许操作的实例数量上限是100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 项目ID。项目可以使用[AddProject](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[`DescribeProject`](https://cloud.tencent.com/document/api/651/78725) API返回值中的`projectId`获取。后续使用[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口查询实例时,项目ID可用于过滤结果。 + // 项目ID。项目可以使用[ AddProject ](https://cloud.tencent.com/document/api/651/81952)接口创建。可通过[ DescribeProject ](https://cloud.tencent.com/document/api/651/78725) 接口返回值中的`projectId`获取。后续使用[DescribeInstances](https://cloud.tencent.com/document/api/213/15728)接口查询实例时,项目ID可用于过滤结果。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } @@ -8093,7 +8170,9 @@ func (r *ModifyInstancesVpcAttributeResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyKeyPairAttributeRequestParams struct { - // 密钥对ID,密钥对ID形如:`skey-xxxxxxxx`。

    可以通过以下方式获取可用的密钥 ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥 ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/9403) ,取返回信息中的 `KeyId` 获取密钥对 ID。 + // 密钥对ID。可以通过以下方式获取可用的密钥 ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥 ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/9403) ,取返回信息中的 `KeyId` 获取密钥对 ID。
  • KeyId *string `json:"KeyId,omitnil,omitempty" name:"KeyId"` // 修改后的密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 @@ -8106,7 +8185,9 @@ type ModifyKeyPairAttributeRequestParams struct { type ModifyKeyPairAttributeRequest struct { *tchttp.BaseRequest - // 密钥对ID,密钥对ID形如:`skey-xxxxxxxx`。

    可以通过以下方式获取可用的密钥 ID:
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥 ID。
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/9403) ,取返回信息中的 `KeyId` 获取密钥对 ID。 + // 密钥对ID。可以通过以下方式获取可用的密钥 ID: + //
  • 通过登录[控制台](https://console.cloud.tencent.com/cvm/sshkey)查询密钥 ID。
  • + //
  • 通过调用接口 [DescribeKeyPairs](https://cloud.tencent.com/document/api/213/9403) ,取返回信息中的 `KeyId` 获取密钥对 ID。
  • KeyId *string `json:"KeyId,omitnil,omitempty" name:"KeyId"` // 修改后的密钥对名称,可由数字,字母和下划线组成,长度不超过25个字符。 @@ -8161,20 +8242,20 @@ func (r *ModifyKeyPairAttributeResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyLaunchTemplateDefaultVersionRequestParams struct { - // 启动模板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`获取。 DefaultVersion *int64 `json:"DefaultVersion,omitnil,omitempty" name:"DefaultVersion"` } type ModifyLaunchTemplateDefaultVersionRequest struct { *tchttp.BaseRequest - // 启动模板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`获取。 DefaultVersion *int64 `json:"DefaultVersion,omitnil,omitempty" name:"DefaultVersion"` } @@ -8300,7 +8381,7 @@ type Price struct { // Predefined struct for user type ProgramFpgaImageRequestParams struct { - // 实例的ID信息。 + // 实例的ID信息。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // FPGA镜像文件的COS URL地址。 @@ -8316,7 +8397,7 @@ type ProgramFpgaImageRequestParams struct { type ProgramFpgaImageRequest struct { *tchttp.BaseRequest - // 实例的ID信息。 + // 实例的ID信息。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // FPGA镜像文件的COS URL地址。 @@ -8463,10 +8544,10 @@ type RebootInstancesRequestParams struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常重启失败后选择强制重启实例。取值范围:
  • true:表示在正常重启失败后进行强制重启
  • false:表示在正常重启失败后不进行强制重启

    默认取值:false。 + // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常重启失败后选择强制重启实例。取值范围:
  • true:表示在正常重启失败后进行强制重启
  • false:表示在正常重启失败后不进行强制重启

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

    默认取值:SOFT。 + // 关机类型。取值范围:
  • SOFT:表示软关机
  • HARD:表示硬关机
  • SOFT_FIRST:表示优先软关机,失败再执行硬关机

  • 默认取值:SOFT。 StopType *string `json:"StopType,omitnil,omitempty" name:"StopType"` } @@ -8476,10 +8557,10 @@ type RebootInstancesRequest struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常重启失败后选择强制重启实例。取值范围:
  • true:表示在正常重启失败后进行强制重启
  • false:表示在正常重启失败后不进行强制重启

    默认取值:false。 + // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常重启失败后选择强制重启实例。取值范围:
  • true:表示在正常重启失败后进行强制重启
  • false:表示在正常重启失败后不进行强制重启

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

    默认取值:SOFT。 + // 关机类型。取值范围:
  • SOFT:表示软关机
  • HARD:表示硬关机
  • SOFT_FIRST:表示优先软关机,失败再执行硬关机

  • 默认取值:SOFT。 StopType *string `json:"StopType,omitnil,omitempty" name:"StopType"` } @@ -9342,15 +9423,13 @@ type ResetInstancesPasswordRequestParams struct { // 一个或多个待操作的实例ID。可通过[DescribeInstances](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。每次请求允许操作的实例数量上限是100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 重置后的实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下: - // Linux 实例密码必须8-30位,推荐使用12位以上密码,不能以“/”开头,至少包含以下字符中的三种不同字符,字符种类:
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字:0-9
  • 特殊字符: ()\`\~!@#$%^&\*-+=\_|{}[]:;'<>,.?/ - // Windows 实例密码必须12\~30位,不能以“/”开头且不包括用户名,至少包含以下字符中的三种不同字符
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字: 0-9
  • 特殊字符:()\`\~!@#$%^&\*-+=\_|{}[]:;' <>,.?/
  • 如果实例即包含 `Linux` 实例又包含 `Windows` 实例,则密码复杂度限制按照 `Windows` 实例的限制。 + // 重置后的实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下:Linux 实例密码必须8-30位,推荐使用12位以上密码,不能以“/”开头,至少包含以下字符中的三种不同字符,字符种类:
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字:0-9
  • 特殊字符: ()\`\~!@#$%^&\*-+=\_|{}[]:;'<>,.?/Windows 实例密码必须12\~30位,不能以“/”开头且不包括用户名,至少包含以下字符中的三种不同字符
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字: 0-9
  • 特殊字符:()\`\~!@#$%^&\*-+=\_|{}[]:;' <>,.?/
  • 如果实例即包含 `Linux` 实例又包含 `Windows` 实例,则密码复杂度限制按照 `Windows` 实例的限制。
  • Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 待重置密码的实例操作系统的用户名。不得超过64个字符。 UserName *string `json:"UserName,omitnil,omitempty" name:"UserName"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机
  • false:表示在正常关机失败后不进行强制关机

    默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机
  • false:表示在正常关机失败后不进行强制关机
  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } @@ -9360,15 +9439,13 @@ type ResetInstancesPasswordRequest struct { // 一个或多个待操作的实例ID。可通过[DescribeInstances](https://cloud.tencent.com/document/api/213/15728) API返回值中的`InstanceId`获取。每次请求允许操作的实例数量上限是100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 重置后的实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下: - // Linux 实例密码必须8-30位,推荐使用12位以上密码,不能以“/”开头,至少包含以下字符中的三种不同字符,字符种类:
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字:0-9
  • 特殊字符: ()\`\~!@#$%^&\*-+=\_|{}[]:;'<>,.?/ - // Windows 实例密码必须12\~30位,不能以“/”开头且不包括用户名,至少包含以下字符中的三种不同字符
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字: 0-9
  • 特殊字符:()\`\~!@#$%^&\*-+=\_|{}[]:;' <>,.?/
  • 如果实例即包含 `Linux` 实例又包含 `Windows` 实例,则密码复杂度限制按照 `Windows` 实例的限制。 + // 重置后的实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下:Linux 实例密码必须8-30位,推荐使用12位以上密码,不能以“/”开头,至少包含以下字符中的三种不同字符,字符种类:
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字:0-9
  • 特殊字符: ()\`\~!@#$%^&\*-+=\_|{}[]:;'<>,.?/Windows 实例密码必须12\~30位,不能以“/”开头且不包括用户名,至少包含以下字符中的三种不同字符
  • 小写字母:[a-z]
  • 大写字母:[A-Z]
  • 数字: 0-9
  • 特殊字符:()\`\~!@#$%^&\*-+=\_|{}[]:;' <>,.?/
  • 如果实例即包含 `Linux` 实例又包含 `Windows` 实例,则密码复杂度限制按照 `Windows` 实例的限制。
  • Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 待重置密码的实例操作系统的用户名。不得超过64个字符。 UserName *string `json:"UserName,omitnil,omitempty" name:"UserName"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机
  • false:表示在正常关机失败后不进行强制关机

    默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机
  • false:表示在正常关机失败后不进行强制关机
  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` } @@ -9421,7 +9498,7 @@ type ResetInstancesTypeRequestParams struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。本接口目前仅支持每次操作1个实例。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 调整后的实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[`DescribeInstanceTypeConfigs`](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。 + // 调整后的实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[ DescribeInstanceTypeConfigs ](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。 InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 @@ -9434,7 +9511,7 @@ type ResetInstancesTypeRequest struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。本接口目前仅支持每次操作1个实例。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 调整后的实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[`DescribeInstanceTypeConfigs`](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。 + // 调整后的实例机型。不同实例机型指定了不同的资源规格,具体取值可通过调用接口[ DescribeInstanceTypeConfigs ](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例类型](https://cloud.tencent.com/document/product/213/11518)描述。 InstanceType *string `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 @@ -9486,17 +9563,17 @@ func (r *ResetInstancesTypeResponse) FromJsonString(s string) error { // Predefined struct for user type ResizeInstanceDisksRequestParams struct { - // 待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考[硬盘产品简介](https://cloud.tencent.com/document/product/362/2353)。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 + // 待扩容的数据盘配置信息,仅支持指定待扩容盘的目的容量。只支持扩容非弹性数据盘([ DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GiB。最小扩容步长:10GiB。关于数据盘类型的选择请参考[硬盘产品简介](https://cloud.tencent.com/document/product/362/2353)。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再扩容实例磁盘。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` - // 待扩容的系统盘配置信息。只支持扩容云盘。 + // 待扩容的系统盘配置信息,仅支持指定待扩容盘的目的容量。只支持扩容云盘。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` @@ -9507,17 +9584,17 @@ type ResizeInstanceDisksRequestParams struct { type ResizeInstanceDisksRequest struct { *tchttp.BaseRequest - // 待操作的实例ID。可通过[`DescribeInstances`](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 + // 待操作的实例ID。可通过[ DescribeInstances ](https://cloud.tencent.com/document/api/213/15728)接口返回值中的`InstanceId`获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 待扩容的数据盘配置信息。只支持扩容非弹性数据盘([`DescribeDisks`](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GB。最小扩容步长:10G。关于数据盘类型的选择请参考[硬盘产品简介](https://cloud.tencent.com/document/product/362/2353)。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 + // 待扩容的数据盘配置信息,仅支持指定待扩容盘的目的容量。只支持扩容非弹性数据盘([ DescribeDisks ](https://cloud.tencent.com/document/api/362/16315)接口返回值中的`Portable`为`false`表示非弹性)。数据盘容量单位:GiB。最小扩容步长:10GiB。关于数据盘类型的选择请参考[硬盘产品简介](https://cloud.tencent.com/document/product/362/2353)。可选数据盘类型受到实例类型`InstanceType`限制。另外允许扩容的最大容量也因数据盘类型的不同而有所差异。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 DataDisks []*DataDisk `json:"DataDisks,omitnil,omitempty" name:"DataDisks"` - // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再重置用户密码。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 + // 是否对运行中的实例选择强制关机。建议对运行中的实例先手动关机,然后再扩容实例磁盘。取值范围:
  • true:表示在正常关机失败后进行强制关机

  • false:表示在正常关机失败后不进行强制关机


  • 默认取值:false。

    强制关机的效果等同于关闭物理计算机的电源开关。强制关机可能会导致数据丢失或文件系统损坏,请仅在服务器不能正常关机时使用。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` - // 待扩容的系统盘配置信息。只支持扩容云盘。 + // 待扩容的系统盘配置信息,仅支持指定待扩容盘的目的容量。只支持扩容云盘。 // 您必须指定参数DataDisks与SystemDisk的其中一个,但不能同时指定。 SystemDisk *SystemDisk `json:"SystemDisk,omitnil,omitempty" name:"SystemDisk"` @@ -9616,7 +9693,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) 的返回值中的 sgId 字段来获取。若不指定该参数,则绑定指定项目下的默认安全组,如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数,则默认公共镜像开启云监控、云安全服务;自定义镜像与镜像市场镜像默认不开启云监控,云安全服务,而使用镜像里保留的服务。 @@ -9714,7 +9791,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) 的返回值中的 sgId 字段来获取。若不指定该参数,则绑定指定项目下的默认安全组,如默认安全组不存在则将自动创建。 SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` // 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数,则默认公共镜像开启云监控、云安全服务;自定义镜像与镜像市场镜像默认不开启云监控,云安全服务,而使用镜像里保留的服务。 @@ -9869,7 +9946,7 @@ type Snapshot struct { // DATA_DISK:数据盘。 DiskUsage *string `json:"DiskUsage,omitnil,omitempty" name:"DiskUsage"` - // 创建此快照的云硬盘大小,单位GB。 + // 创建此快照的云硬盘大小,单位 GiB。 DiskSize *int64 `json:"DiskSize,omitnil,omitempty" name:"DiskSize"` } @@ -9954,15 +10031,15 @@ type StopInstancesRequestParams struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常关闭失败后选择强制关闭实例。取值范围:
  • true:表示在正常关闭失败后进行强制关闭
  • false:表示在正常关闭失败后不进行强制关闭

    默认取值:false。 + // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常关闭失败后选择强制关闭实例。取值范围:
  • true:表示在正常关闭失败后进行强制关闭
  • false:表示在正常关闭失败后不进行强制关闭

  • 默认取值:false。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` - // 实例的关闭模式。取值范围:
  • SOFT_FIRST:表示在正常关闭失败后进行强制关闭
  • HARD:直接强制关闭
  • SOFT:仅软关机
    默认取值:SOFT。 + // 实例的关闭模式。取值范围:
  • SOFT_FIRST:表示在正常关闭失败后进行强制关闭
  • HARD:直接强制关闭
  • SOFT:仅软关机
  • 默认取值:SOFT。 StopType *string `json:"StopType,omitnil,omitempty" name:"StopType"` // 按量计费实例关机收费模式。 - // 取值范围:
  • KEEP_CHARGING:关机继续收费
  • STOP_CHARGING:关机停止收费
    默认取值:KEEP_CHARGING。 - // 该参数只针对部分按量计费云硬盘实例生效,详情参考[按量计费实例关机不收费说明](https://cloud.tencent.com/document/product/213/19918) + // 取值范围:
  • KEEP_CHARGING:关机继续收费
  • STOP_CHARGING:关机停止收费

  • 默认取值:KEEP_CHARGING。 + // 该参数只针对部分按量计费实例生效,详情参考[按量计费实例关机不收费说明](https://cloud.tencent.com/document/product/213/19918) StoppedMode *string `json:"StoppedMode,omitnil,omitempty" name:"StoppedMode"` } @@ -9972,15 +10049,15 @@ type StopInstancesRequest struct { // 一个或多个待操作的实例ID。可通过 [DescribeInstances](https://cloud.tencent.com/document/api/213/15728) 接口返回值中的`InstanceId`获取。每次请求批量实例的上限为100。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常关闭失败后选择强制关闭实例。取值范围:
  • true:表示在正常关闭失败后进行强制关闭
  • false:表示在正常关闭失败后不进行强制关闭

    默认取值:false。 + // 本参数已弃用,推荐使用StopType,不可以与参数StopType同时使用。表示是否在正常关闭失败后选择强制关闭实例。取值范围:
  • true:表示在正常关闭失败后进行强制关闭
  • false:表示在正常关闭失败后不进行强制关闭

  • 默认取值:false。 ForceStop *bool `json:"ForceStop,omitnil,omitempty" name:"ForceStop"` - // 实例的关闭模式。取值范围:
  • SOFT_FIRST:表示在正常关闭失败后进行强制关闭
  • HARD:直接强制关闭
  • SOFT:仅软关机
    默认取值:SOFT。 + // 实例的关闭模式。取值范围:
  • SOFT_FIRST:表示在正常关闭失败后进行强制关闭
  • HARD:直接强制关闭
  • SOFT:仅软关机
  • 默认取值:SOFT。 StopType *string `json:"StopType,omitnil,omitempty" name:"StopType"` // 按量计费实例关机收费模式。 - // 取值范围:
  • KEEP_CHARGING:关机继续收费
  • STOP_CHARGING:关机停止收费
    默认取值:KEEP_CHARGING。 - // 该参数只针对部分按量计费云硬盘实例生效,详情参考[按量计费实例关机不收费说明](https://cloud.tencent.com/document/product/213/19918) + // 取值范围:
  • KEEP_CHARGING:关机继续收费
  • STOP_CHARGING:关机停止收费

  • 默认取值:KEEP_CHARGING。 + // 该参数只针对部分按量计费实例生效,详情参考[按量计费实例关机不收费说明](https://cloud.tencent.com/document/product/213/19918) StoppedMode *string `json:"StoppedMode,omitnil,omitempty" name:"StoppedMode"` } @@ -10032,10 +10109,10 @@ type StorageBlock struct { // HDD本地存储类型,值为:LOCAL_PRO. Type *string `json:"Type,omitnil,omitempty" name:"Type"` - // HDD本地存储的最小容量 + // HDD本地存储的最小容量。单位:GiB。 MinSize *int64 `json:"MinSize,omitnil,omitempty" name:"MinSize"` - // HDD本地存储的最大容量 + // HDD本地存储的最大容量。单位:GiB。 MaxSize *int64 `json:"MaxSize,omitnil,omitempty" name:"MaxSize"` } @@ -10049,10 +10126,10 @@ type SyncImage struct { // Predefined struct for user type SyncImagesRequestParams struct { - // 镜像ID列表 ,镜像ID可以通过如下方式获取:
  • 通过[DescribeImages](https://cloud.tencent.com/document/api/213/15715)接口返回的`ImageId`获取。
  • 通过[镜像控制台](https://console.cloud.tencent.com/cvm/image)获取。
    镜像ID必须满足限制:
  • 镜像ID对应的镜像状态必须为`NORMAL`。
  • 镜像状态请参考[镜像数据表](https://cloud.tencent.com/document/product/213/15753#Image)。 + // 镜像ID列表 ,镜像ID可以通过如下方式获取:
  • 通过[DescribeImages](https://cloud.tencent.com/document/api/213/15715)接口返回的`ImageId`获取,镜像ID对应的镜像状态必须为`NORMAL`。
  • 通过[镜像控制台](https://console.cloud.tencent.com/cvm/image)获取。
  • ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` - // 目的同步地域列表,必须满足如下限制:
  • 必须是一个合法的Region。
  • 如果是自定义镜像,则目标同步地域不能为源地域。
  • 如果是共享镜像,则目的同步地域仅支持源地域,表示将共享镜像复制为源地域的自定义镜像。
  • 暂不支持部分地域同步,请参考[复制镜像](https://cloud.tencent.com/document/product/213/4943#.E5.A4.8D.E5.88.B6.E8.AF.B4.E6.98.8E)。
  • 具体地域参数请参考[Region](https://cloud.tencent.com/document/product/213/6091)。 + // 目的同步地域列表,必须满足如下限制:
  • 必须是一个合法的Region。
  • 如果是自定义镜像,则目标同步地域不能为源地域。
  • 如果是共享镜像,则目的同步地域仅支持源地域,表示将共享镜像复制为源地域的自定义镜像。
  • 如果是自定义镜像复制为加密自定义镜像,则目的同步地域仅支持源地域,表示将自定义镜像复制为源地域的加密自定义镜像。
  • 暂不支持部分地域同步,请参考[复制镜像](https://cloud.tencent.com/document/product/213/4943#.E5.A4.8D.E5.88.B6.E8.AF.B4.E6.98.8E)。
  • 具体地域参数请参考[Region](https://cloud.tencent.com/document/product/213/6091)。 DestinationRegions []*string `json:"DestinationRegions,omitnil,omitempty" name:"DestinationRegions"` // 检测是否支持发起同步镜像。 @@ -10060,6 +10137,7 @@ type SyncImagesRequestParams struct { DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 目标镜像名称。默认使用源镜像名称。 + // 最多支持 60 个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` // 是否需要返回目的地域的镜像ID。 @@ -10068,22 +10146,23 @@ type SyncImagesRequestParams struct { // 是否复制为加密自定义镜像。 // 默认值为 false。 - // 复制加密自定义镜像仅支持同地域。 + // 复制加密自定义镜像仅支持同地域, 即 DestinationRegions 仅支持填写指定镜像所在地域。 Encrypt *bool `json:"Encrypt,omitnil,omitempty" name:"Encrypt"` // 加密自定义镜像使用的 KMS 密钥 ID。 // 仅当复制加密镜像时,即 Encrypt 为 true 时,此参数有效; // 不指定 KmsKeyId,默认使用 CBS 云产品 KMS 密钥。 + // KMS 密钥 ID 通过[KMS 控制台](https://console.cloud.tencent.com/kms2)获取。 KmsKeyId *string `json:"KmsKeyId,omitnil,omitempty" name:"KmsKeyId"` } type SyncImagesRequest struct { *tchttp.BaseRequest - // 镜像ID列表 ,镜像ID可以通过如下方式获取:
  • 通过[DescribeImages](https://cloud.tencent.com/document/api/213/15715)接口返回的`ImageId`获取。
  • 通过[镜像控制台](https://console.cloud.tencent.com/cvm/image)获取。
    镜像ID必须满足限制:
  • 镜像ID对应的镜像状态必须为`NORMAL`。
  • 镜像状态请参考[镜像数据表](https://cloud.tencent.com/document/product/213/15753#Image)。 + // 镜像ID列表 ,镜像ID可以通过如下方式获取:
  • 通过[DescribeImages](https://cloud.tencent.com/document/api/213/15715)接口返回的`ImageId`获取,镜像ID对应的镜像状态必须为`NORMAL`。
  • 通过[镜像控制台](https://console.cloud.tencent.com/cvm/image)获取。
  • ImageIds []*string `json:"ImageIds,omitnil,omitempty" name:"ImageIds"` - // 目的同步地域列表,必须满足如下限制:
  • 必须是一个合法的Region。
  • 如果是自定义镜像,则目标同步地域不能为源地域。
  • 如果是共享镜像,则目的同步地域仅支持源地域,表示将共享镜像复制为源地域的自定义镜像。
  • 暂不支持部分地域同步,请参考[复制镜像](https://cloud.tencent.com/document/product/213/4943#.E5.A4.8D.E5.88.B6.E8.AF.B4.E6.98.8E)。
  • 具体地域参数请参考[Region](https://cloud.tencent.com/document/product/213/6091)。 + // 目的同步地域列表,必须满足如下限制:
  • 必须是一个合法的Region。
  • 如果是自定义镜像,则目标同步地域不能为源地域。
  • 如果是共享镜像,则目的同步地域仅支持源地域,表示将共享镜像复制为源地域的自定义镜像。
  • 如果是自定义镜像复制为加密自定义镜像,则目的同步地域仅支持源地域,表示将自定义镜像复制为源地域的加密自定义镜像。
  • 暂不支持部分地域同步,请参考[复制镜像](https://cloud.tencent.com/document/product/213/4943#.E5.A4.8D.E5.88.B6.E8.AF.B4.E6.98.8E)。
  • 具体地域参数请参考[Region](https://cloud.tencent.com/document/product/213/6091)。 DestinationRegions []*string `json:"DestinationRegions,omitnil,omitempty" name:"DestinationRegions"` // 检测是否支持发起同步镜像。 @@ -10091,6 +10170,7 @@ type SyncImagesRequest struct { DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 目标镜像名称。默认使用源镜像名称。 + // 最多支持 60 个字符。 ImageName *string `json:"ImageName,omitnil,omitempty" name:"ImageName"` // 是否需要返回目的地域的镜像ID。 @@ -10099,12 +10179,13 @@ type SyncImagesRequest struct { // 是否复制为加密自定义镜像。 // 默认值为 false。 - // 复制加密自定义镜像仅支持同地域。 + // 复制加密自定义镜像仅支持同地域, 即 DestinationRegions 仅支持填写指定镜像所在地域。 Encrypt *bool `json:"Encrypt,omitnil,omitempty" name:"Encrypt"` // 加密自定义镜像使用的 KMS 密钥 ID。 // 仅当复制加密镜像时,即 Encrypt 为 true 时,此参数有效; // 不指定 KmsKeyId,默认使用 CBS 云产品 KMS 密钥。 + // KMS 密钥 ID 通过[KMS 控制台](https://console.cloud.tencent.com/kms2)获取。 KmsKeyId *string `json:"KmsKeyId,omitnil,omitempty" name:"KmsKeyId"` } @@ -10175,15 +10256,13 @@ type SystemDisk struct { // 该参数目前仅用于`DescribeInstances`等查询类接口的返回参数,不可用于`RunInstances`等写接口的入参。 DiskId *string `json:"DiskId,omitnil,omitempty" name:"DiskId"` - // 系统盘大小,单位:GB。默认值为 50 + // 系统盘大小,单位:GiB。默认值为 50 DiskSize *int64 `json:"DiskSize,omitnil,omitempty" name:"DiskSize"` // 所属的独享集群ID。 CdcId *string `json:"CdcId,omitnil,omitempty" name:"CdcId"` // 磁盘名称,长度不超过128 个字符。 - // - // 该参数正在邀测中,暂未开放使用。 DiskName *string `json:"DiskName,omitnil,omitempty" name:"DiskName"` } @@ -10278,7 +10357,7 @@ 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网络。 VpcId *string `json:"VpcId,omitnil,omitempty" name:"VpcId"` - // 私有网络子网ID,形如`subnet-xxx`。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet?rid=1)查询;也可以调用接口 [DescribeSubnets](/document/api/215/15784) ,从接口返回中的`unSubnetId`字段获取。若在创建子机时SubnetId与VpcId同时传入`DEFAULT`,则强制使用默认vpc网络。 + // 私有网络子网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网络。 SubnetId *string `json:"SubnetId,omitnil,omitempty" name:"SubnetId"` // 是否用作公网网关。公网网关只有在实例拥有公网IP以及处于私有网络下时才能正常使用。取值范围:
  • true:表示用作公网网关
  • false:表示不作为公网网关
  • 默认取值:false。 diff --git a/vendor/modules.txt b/vendor/modules.txt index c7a5767f37..9130c7510a 100644 --- a/vendor/modules.txt +++ b/vendor/modules.txt @@ -1127,7 +1127,7 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs/v20170312 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320 -# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.970 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc/v20201214 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdn v1.0.1010 @@ -1180,7 +1180,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.1128 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm v1.0.1153 ## 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/cdc_dedicated_cluster_image_cache.html.markdown b/website/docs/r/cdc_dedicated_cluster_image_cache.html.markdown new file mode 100644 index 0000000000..fc984f0694 --- /dev/null +++ b/website/docs/r/cdc_dedicated_cluster_image_cache.html.markdown @@ -0,0 +1,45 @@ +--- +subcategory: "CDC" +layout: "tencentcloud" +page_title: "TencentCloud: tencentcloud_cdc_dedicated_cluster_image_cache" +sidebar_current: "docs-tencentcloud-resource-cdc_dedicated_cluster_image_cache" +description: |- + Provides a resource to create a CDC dedicated cluster image cache +--- + +# tencentcloud_cdc_dedicated_cluster_image_cache + +Provides a resource to create a CDC dedicated cluster image cache + +## Example Usage + +```hcl +resource "tencentcloud_cdc_dedicated_cluster_image_cache" "cdc_dedicated_cluster_image_cache" { + dedicated_cluster_id = "cluster-262n63e8" + image_id = "img-eb30mz89" +} +``` + +## Argument Reference + +The following arguments are supported: + +* `dedicated_cluster_id` - (Required, String, ForceNew) Cluster ID. +* `image_id` - (Required, String, ForceNew) Image ID. + +## Attributes Reference + +In addition to all arguments above, the following attributes are exported: + +* `id` - ID of the resource. + + + +## Import + +CDC dedicated cluster image cache can be imported using the id, e.g. + +``` +terraform import tencentcloud_cdc_dedicated_cluster_image_cache.cdc_dedicated_cluster_image_cache ${dedicated_cluster_id}#${image_id} +``` + diff --git a/website/tencentcloud.erb b/website/tencentcloud.erb index eeeb4b0871..ceeea39ca1 100644 --- a/website/tencentcloud.erb +++ b/website/tencentcloud.erb @@ -555,6 +555,9 @@
  • tencentcloud_cdc_dedicated_cluster
  • +
  • + tencentcloud_cdc_dedicated_cluster_image_cache +
  • tencentcloud_cdc_site