tencent cloud

package main

import (
     "fmt"
     "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
     "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors"
     "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
     "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/regions"
     cvm "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cvm/v20170312"
)

func main() {
     // Essential steps:
     // Instantiate an authentication object. The Tencent Cloud account key pair `secretId` and `secretKey` need to be passed in as the input parameters.
     // You can also write the key pair directly into the code, but be careful not to copy, upload, or share the code to others;
     // otherwise, the key pair may be leaked, causing damage to your properties.
     credential := common.NewCredential("secretId", "secretKey")

     // Nonessential steps
     // Instantiate a client configuration object. You can specify the timeout period and other configuration items
     cpf := profile.NewClientProfile()
     // The SDK uses the POST method by default.
     // If you have to use the GET method, you can set it here, but the GET method cannot handle some large requests.
     // Do not modify the default settings unless absolutely necessary.
     cpf.HttpProfile.ReqMethod = "POST"
     // The SDK has a default timeout period. Do not adjust it unless absolutely necessary.
     // If needed, check in the code to get the latest default value.
     cpf.HttpProfile.ReqTimeout = 30
     // The SDK automatically specifies the domain name. Generally, you don't need to specify a domain name, but if you are accessing a service in a finance availability zone,
     // you have to manually specify the domain name, such as cvm.ap-shanghai-fsi.tencentcloudapi.com for the Shanghai Finance availability zone
     cpf.HttpProfile.Endpoint = "cvm.tencentcloudapi.com"
     // The SDK uses `TC3-HMAC-SHA256` for signing by default, which is more secure but slightly reduces the performance.
     // Do not modify the default settings unless absolutely necessary.
     cpf.SignMethod = "TC3-HMAC-SHA256"
     // The SDK uses `zh-CN` calls to return Chinese content by default. You can also set it to `en-US` to return English content.
     // However, most products or APIs do not fully support returns in English.
     // Do not modify the default settings unless absolutely necessary.
     cpf.Language = "en-US"
     // Print logs. The default value is `false`
     // cpf.Debug = true
     // Instantiate the client object of the requested product (with CVM as an example)
     // The second parameter is the region information. You can directly enter the string `ap-guangzhou` or import the preset constant
     client, _ := cvm.NewClient(credential, regions.Guangzhou, cpf)
     // Instantiate a request object. You can further set the request parameters according to the API called and actual conditions
     // You can directly check the SDK source code to determine which attributes of `DescribeInstancesRequest` can be set.
     // An attribute may be of a basic type or import another data structure.
     // You are recommended to use the IDE for development where you can easily redirect to and view the documentation of each API and data structure.
     request := cvm.NewDescribeInstancesRequest()

     // Settings of a basic parameter.
     // This API allows setting the number of instances returned, which is specified as only one here.
     // The SDK uses the pointer style to specify parameters, so even for basic parameters, you need to use pointers to assign values to them.
     // The SDK provides encapsulation functions for importing the pointers of basic parameters
     request.Limit = common.Int64Ptr(1)

     // Settings of an array.
     // This API allows filtering by specified instance ID; however, as it conflicts with the `Filter` parameter to be demonstrated next, it is commented out here.
     // request.InstanceIds = common.StringPtrs([]string{"ins-r8hr2upy"})

     // Settings of a complex object.
     // In this API, `Filters` is an array whose elements are complex objects `Filter`, and the member `Values` of `Filter` are string arrays.
     request.Filters = []*cvm.Filter{
         &cvm.Filter{
          Name: common.StringPtr("zone"),
          Values: common.StringPtrs([]string{"ap-guangzhou-1"}),
         },
     }

     // Call the API you want to access through the client object. You need to pass in the request object
     response, err := client.DescribeInstances(request)
     // Handle the exception
     if _, ok := err.(*errors.TencentCloudSDKError); ok {
         fmt.Printf("An API error has returned: %s", err)
         return
     }
     // This is a direct failure instead of SDK exception. You can add other troubleshooting measures in the real code.
     if err != nil {
         panic(err)
     }
     // Print the returned JSON string
     fmt.Printf("%s\\n", response.ToJsonString())
}