Go SDK

Prerequisites

• You have registered with Huawei Cloud and completed real-name authentication.
  NOTE:

  If you are a Huawei Cloud (International) user, you need to complete real-name authentication when you:

  • Purchase and use cloud services on Huawei Cloud nodes in the Chinese mainland. In this case, real-name authentication is required by the laws and regulations of the Chinese mainland.
  • Select the Chinese mainland region for MPC.
• The development environment (Go 1.14 or later) is available.
• You have obtained the access key (AK) and secret access key (SK) of the account. You can create and view your AK/SK on the My Credentials > Access Keys page of the console. For details, see Access Keys.
• You have obtained the project ID of the corresponding region of MPC. You can view the project ID on the My Credentials > API Credentials page of the console. For details, see API Credentials.
• You have uploaded the media asset files to an OBS bucket in the region of MPC, and authorized MPC to access the OBS bucket. For details, see Uploading Media Files and Authorizing Access to Cloud Resources.

Installing SDK

The Go SDK for media transcoding supports Go 1.14 or later. Run the go version command to check the Go version.

Run the go get command to install the Go SDK. Then run the following commands to install the Go SDK library and dependencies. For details about the SDK version, see SDK Center.

1
2
3
4

# Install the Go library.
go get github.com/huaweicloud/huaweicloud-sdk-go-v3
 # Install dependent libraries.
go get github.com/json-iterator/go

Procedure

1. Import the dependent module.

   1 2 3 4 5 6 7 8 9

   import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/config" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/httphandler" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mpc/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mpc/v1/model" "net/http" )

2. Configure client attributes.
   1. Use the default configuration.

      1 2	# Use default configuration httpConfig := config.DefaultHttpConfig()

   2. (Optional) Configure the proxy.

      1 2 3 4 5 6 7 8 9

      username := os.Getenv("USER_NAME") password := os.Getenv("USER_PASSWARD") // Configure the network proxy as required. httpConfig.WithProxy(config.NewProxy(). WithSchema("http"). WithHost("proxy.huaweicloud.com"). WithPort(80). WithUsername(username). WithPassword(password))

   3. (Optional) Configure SSL.

      1 2	// Configure whether to skip SSL certificate verification as required. httpConfig.WithIgnoreSSLVerification(true);

3. Initialize authentication information.

   You can use one of the following two authentication modes:

   • Permanent AK/SK

     Obtain the permanent AK, SK, and project ID. For details, see Prerequisites.

     1 2 3 4 5 6 7 8

     ak := os.Getenv("SDK_AK") sk := os.Getenv("SDK_SK") projectId := os.Getenv("PROJECT_ID") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build()

   • Temporary AK/SK

     Obtain a temporary AK, SK, and security token. For details, see Obtaining a Temporary Access Key and Security Token Through a Token or Obtaining a Temporary Access Key and Security Token Through an Agency.

     1 2 3 4 5 6 7 8 9 10

     ak := os.Getenv("SDK_AK") sk := os.Getenv("SDK_SK") projectId := os.Getenv("PROJECT_ID") securityToken := os.Getenv("SECURITY_TOKEN") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). WithSecurityToken(securityToken). Build()

   The related parameters are as follows:

   • ak: access key of an account
   • sk: secret access key of an account
   • projectId: ID of the project where MPC is provided. Select a project ID based on the region of the project.
   • securityToken: security token used for temporary AK/SK authentication

4. Initialize the client.

   1 2 3 4 5 6 7 8

   # Initialize the MPC client. client := mpc.NewMpcClient ( mpcMpcClientBuilder(). WithEndpoint(endpoint). // endpoint value, for example, "https://mpc.region01.myhuaweicloud.com" WithCredential(auth). WithHttpConfig(config.DefaultHttpConfig()). Build())

   endpoint: regions where MPC is used and endpoints of each service. For details, see Regions and Endpoints.

5. Send a request and view the response.

   1 2 3 4 5 6 7 8 9 10

   // Initialize the request. The following uses the API for querying transcoding templates as an example. request := &model.ListTranscodingTaskRequest{ TaskId:&[]int64{1900293}, } response, err := client.ListTranscodingTask(request) if err == nil { fmt.Printf("%+v\n",response) } else { fmt.Println(err) }

6. Perform troubleshooting.

   Table 1 Troubleshooting

   Level 1	Description
   ServiceResponseError	Service response error
   url.Error	Endpoint connection error

   1 2 3 4 5 6 7

   # Troubleshooting response, err := client.ListTranscodingTask(request) if err == nil { fmt.Println(response) } else { fmt.Println(err) }

7. Use the listener to obtain original HTTP requests and responses.

   The original HTTP requests and responses are required for debugging HTTP requests sent by the service side. The SDK provides the listener to obtain the original and encrypted HTTP requests and responses.

   CAUTION:

   Original information is printed only during debugging. Do not print the header and body of an original HTTP request in the production system because this information contains sensitive data but is not encrypted. If the request body is binary, that is, Content-Type is set to binary, the body will be displayed as *** without the detailed content.

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

   func RequestHandler(request http.Request) { fmt.Println(request) } func ResponseHandler(response http.Response) { fmt.Println(response) } ak := os.Getenv("SDK_AK") sk := os.Getenv("SDK_SK") projectId := os.Getenv("{your project id}") client := mpc.NewMpcClient( mpc.MpcClientBuilder(). WithEndpoint("{your endpoint}"). WithCredential( basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build()). WithHttpConfig(config.DefaultHttpConfig(). WithIgnoreSSLVerification(true). WithHttpHandler(httphandler. NewHttpHandler(). AddRequestHandler(RequestHandler). AddResponseHandler(ResponseHandler))).Build())

Sample Code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

package main

import (
    "fmt"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/config"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/httphandler"
    mpc "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mpc/v1"
    "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mpc/v1/model"
    "net/http"
)

func RequestHandler(request http.Request) {
    fmt.Println(request)
}

func ResponseHandler(response http.Response) {
    fmt.Println(response)
}
ak := os.Getenv("SDK_AK")
sk := os.Getenv("SDK_SK")
projectId := os.Getenv("{your project id}")
func main() {
    client := mpc.NewMpcClient(
        mpc.MpcClientBuilder().
            WithEndpoint("{your endpoint}").
            WithCredential(
                basic.NewCredentialsBuilder().
                    WithAk(ak).
                    WithSk(sk).
                    WithProjectId(projectId).
                    Build()).
            WithHttpConfig(config.DefaultHttpConfig().
                WithIgnoreSSLVerification(true).
                WithHttpHandler(httphandler.
                    NewHttpHandler().
                        AddRequestHandler(RequestHandler).
                        AddResponseHandler(ResponseHandler))).
            Build())

    request := &model.ListTranscodingTaskRequest{        
        TaskId:&[]int64{1900293},
    }
    response, err := client.ListTranscodingTask(request)
    if err == nil {
        fmt.Println("%+v\n",response)
    } else {
        fmt.Println(err)
    }
}