Alibaba Cloud SDK:Integrate Alibaba Cloud SDK V2.0 for Go

Prerequisites

• Go 1.10.x or later is installed.

1. Install the SDK for Go

go get github.com/alibabacloud-go/darabonba-openapi/v2/client

2. Configure an access credential

You must configure an access credential before you use Alibaba Cloud SDK V2.0 to call API operations. The following types of credentials are commonly used on Alibaba Cloud: AccessKey pairs and Security Token Service (STS) tokens. For more information, see Credential. To prevent leaks of credentials, you can configure the information about credentials in environment variables. For more information about other security solutions, see Credential security solutions. In this example, the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured.

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::User)

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI4GDty8ab9W4Y1D****', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'IrVTNZNy5yQelTETg0cZML3TQn****', [System.EnvironmentVariableTarget]::Machine)

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "LTAI4GDty8ab9W4Y1D****"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "IrVTNZNy5yQelTETg0cZML3TQn****"

3. Call an API operation

In this example, the sample code of a specialized call is used. For more information about how to make a generic call, see Generic calls.

3.1 Initialize a request client

You can use multiple methods to initialize a request client. In this example, an AccessKey pair is used to initialize a request client. For more information, see Manage access credentials.

package main

import (
  dysmsapi20170525  "github.com/alibabacloud-go/dysmsapi-20170525/v4/client"
  openapi  "github.com/alibabacloud-go/darabonba-openapi/v2/client"
)


func CreateClient () (_result *dysmsapi20170525.Client, _err error) {
  // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources within your Alibaba Cloud account may be compromised. The following lines are provided for reference only. 
  config := &openapi.Config{
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment. 
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment. 
    AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  }
  config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
  _result = &dysmsapi20170525.Client{}
  _result, _err = dysmsapi20170525.NewClient(config)
  return _result, _err
}

3.2 Create a request object and configure runtime configurations

In most cases, you can create a request object and specify the parameters based on your business requirements. You can also customize runtime configurations.

// Create a request object and specify the parameters.
sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
        // The code of the SMS template.
        TemplateCode: tea.String("<YOUR_VALUE>"),
        // The variables of the SMS template. Example: {\"code\":\"1234\"}.
        TemplateParam: tea.String("{\"code\":\"1234\"}"),
        // The mobile numbers to which you want to send a text message.
	PhoneNumbers: tea.String("<YOUR_VALUE>"),
	// The name of the SMS signature.
	SignName: tea.String("<YOUR_VALUE>"),
}
// Create a runtime configuration object.
runtime := &util.RuntimeOptions{}

3.3 Initiate an API request

In Alibaba Cloud SDK V2.0, the client of each Alibaba Cloud service contains all the API operations provided by the service. In addition, Alibaba Cloud SDK V2.0 provides three methods to define each API operation. This design aims to improve the flexibility and efficiency of development, and ensure that you can call API operations in an optimal way based on your project requirements.

• <API operation name>: uses the default runtime configurations to initiate a request. You do not need to specify runtime parameters.

  package main
  
  import (
  	"fmt"
  
  	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v4/client"
  	util "github.com/alibabacloud-go/tea-utils/v2/service"
  	"github.com/alibabacloud-go/tea/tea"
  	
  )
  
  func CreateClient() (_result *dysmsapi20170525.Client, _err error) {
  	config := &openapi.Config{
  		 // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment. 
  		 AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
  		 // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment. 
  		 AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  	}
  	// The endpoint. For more information, visit https://api.aliyun.com/product/Dysmsapi.
  	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
  	_result = &dysmsapi20170525.Client{}
  	_result, _err = dysmsapi20170525.NewClient(config)
  	return _result, _err
  }
  
  func main() {
  	client, _err := CreateClient()
  	if _err != nil {
  		panic(_err)
  	}
  
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
  		 // The code of the SMS template.
  		 TemplateCode: tea.String("<YOUR_VALUE>"),
  		 // The variables of the SMS template. Example: {\"code\":\"1234\"}.
  		 TemplateParam: tea.String("{\"code\":\"1234\"}"),
  		 // The mobile numbers to which you want to send a text message.
  	         PhoneNumbers: tea.String("<YOUR_VALUE>"),
  	         // The name of the SMS signature.
  	         SignName: tea.String("<YOUR_VALUE>"),
  	}
  	
  
  	resp, tryErr := func() (response *dysmsapi20170525.SendSmsResponse, _e error) {
  		defer func() {
  			if r := tea.Recover(recover()); r != nil {
  				_e = r
  			}
  		}()
  		// If you copy and run the sample code, write your own code to display the response of the API operation.
  		response, _err = client.SendSms(sendSmsRequest)
  		if _err != nil {
  			return response, _err
  		}
  		return response, nil
  	}()
  
  	if tryErr != nil {
  		if sdkError, ok := tryErr.(*tea.SDKError); ok {
  			// Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only. 
  			fmt.Println(tea.StringValue(sdkError.Message))
  			fmt.Println(tea.StringValue(sdkError.Code))
  			fmt.Println(tea.StringValue(sdkError.Data))
  		} else {
  			// Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only. 
  			fmt.Println(tea.String(tryErr.Error()))
  		}
  	} else {
  		fmt.Println("Response:", resp) // The response.
  	}
  }

• <API operation name>WithOptions: uses the custom runtime configurations to initiate a request. For more information, see Advanced configuration.

  package main
  
  import (
  	"fmt"
  	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  	dysmsapi20170525 "github.com/alibabacloud-go/dysmsapi-20170525/v4/client"
  	util "github.com/alibabacloud-go/tea-utils/v2/service"
  	"github.com/alibabacloud-go/tea/tea"
  	
  )
  
  func CreateClient() (_result *dysmsapi20170525.Client, _err error) {
  	config := &openapi.Config{
  		 // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment. 
  		 AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
  		 // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment. 
  		 AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  	}
  	// The endpoint. For more information, visit https://api.aliyun.com/product/Dysmsapi.
  	config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
  	_result = &dysmsapi20170525.Client{}
  	_result, _err = dysmsapi20170525.NewClient(config)
  	return _result, _err
  }
  
  func main() {
  	client, _err := CreateClient()
  	if _err != nil {
  		panic(_err)
  	}
  
  	sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
  		 // The code of the SMS template.
  		 TemplateCode: tea.String("<YOUR_VALUE>"),
  		 // The variables of the SMS template. Example: {\"code\":\"1234\"}.
  		 TemplateParam: tea.String("{\"code\":\"1234\"}"),
  		 // The mobile numbers to which you want to send a text message.
  	         PhoneNumbers: tea.String("<YOUR_VALUE>"),
  	         // The name of the SMS signature.
  	         SignName: tea.String("<YOUR_VALUE>"),
  	}
  	runtime := &util.RuntimeOptions{}
  
  	resp, tryErr := func() (response *dysmsapi20170525.SendSmsResponse, _e error) {
  		defer func() {
  			if r := tea.Recover(recover()); r != nil {
  				_e = r
  			}
  		}()
  		// If you copy and run the sample code, write your own code to display the response of the API operation.
  		response, _err = client.SendSmsWithOptions(sendSmsRequest, runtime)
  		if _err != nil {
  			return response, _err
  		}
  		return response, nil
  	}()
  
  	if tryErr != nil {
  		if sdkError, ok := tryErr.(*tea.SDKError); ok {
  			// Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only. 
  			fmt.Println(tea.StringValue(sdkError.Message))
  			fmt.Println(tea.StringValue(sdkError.Code))
  			fmt.Println(tea.StringValue(sdkError.Data))
  		} else {
  			// Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only. 
  			fmt.Println(tea.String(tryErr.Error()))
  		}
  	} else {
  		fmt.Println("Response:", resp) // The response.
  	}
  }

• <API operation name>Advance: used for API operations that require file uploading. By default, you must specify runtime parameters. The following sample code provides an example on how to initiate a request to upload a file and call an API operation to use the human face and body recognition feature of Visual Intelligence API (VIAPI).

  go get github.com/alibabacloud-go/facebody-20191230/v5

  package main
  
  import (
    "encoding/json"
    "strings"
    "fmt"
    "os"
    facebody20191230  "github.com/alibabacloud-go/facebody-20191230/v5/client"
    openapi  "github.com/alibabacloud-go/darabonba-openapi/v2/client"
    util  "github.com/alibabacloud-go/tea-utils/v2/service"
    "github.com/alibabacloud-go/tea/tea"
  )
  
  
  func CreateClient () (_result *facebody20191230.Client, _err error) {
    // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources within your Alibaba Cloud account may be compromised. The following lines are provided for reference only. 
    config := &openapi.Config{
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment. 
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment. 
    AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
    }
    config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
    _result = &facebody20191230.Client{}
    _result, _err = facebody20191230.NewClient(config)
    return _result, _err
  }
  
  func _main (args []*string) (_err error) {
    client, _err := CreateClient()
    if _err != nil {
      return _err
    }
   
    // The file path.
    file, _err := os.Open("<filepath>")
      if _err != nil {
      panic(_err)
      }
    // Initialize a request to call the DescribeRegions operation.
    detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
  		ImageURLObject: file,
  		}
    // Configure the runtime object.
    runtime := &util.RuntimeOptions{}
  
    tryErr := func()(_e error) {
      defer func() {
        if r := tea.Recover(recover()); r != nil {
          _e = r
        }
      }()
      // If you copy and run the sample code, write your own code to display the response of the API operation.
      _, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
      if _err != nil {
        return _err
      }
  
      return nil
    }()
  
    if tryErr != nil {
      var error = &tea.SDKError{}
      if _t, ok := tryErr.(*tea.SDKError); ok {
        error = _t
      } else {
        error.Message = tea.String(tryErr.Error())
      }
      // Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only. 
      // The error message.
      fmt.Println(tea.StringValue(error.Message))
      // The URL of the corresponding error diagnostics.
      var data interface{}
      d := json.NewDecoder(strings.NewReader(tea.StringValue(error.Data)))
      d.Decode(&data)
      if m, ok := data.(map[string]interface{}); ok {
        recommend, _ := m["Recommend"]
        fmt.Println(recommend)
      }
      _, _err = util.AssertAsString(error.Message)
      if _err != nil {
        return _err
      }
    }
    return _err
  }
  
  
  func main() {
    err := _main(tea.StringSlice(os.Args[1:]))
    if err != nil {
      panic(err)
    }
  }