Go SDK

准备工作

• 已注册华为云帐号，并完成实名认证，帐号不能处于欠费或冻结状态。
• 已具备开发环境，Go SDK 支持 go 1.14 及以上版本，可执行 go version 检查当前 Go 的版本信息。
• 登录“我的凭证 > 访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。
• 登录“我的凭证 ”页面，获取“IAM用户名”“、帐号名”以及待使用区域的“项目ID”。
• 登录“OptVerse控制台”进入授权管理页面，点击对应的应用进入应用详情，复制AppCode。

  调用服务时会用到这些信息，请提前保存。

  本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。

  图1 我的凭证
  
  图2 应用详情
  

安装SDK

使用SDK前需要安装华为云Go SDK库。

// 安装华为云 Go SDK 库
go get github.com/huaweicloud/huaweicloud-sdk-go-v3

开始使用

详细的SDK介绍请参见SDK中心、Go SDK使用指导、Go SDK使用视频。

1. 导入依赖模块

   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"
       optverse "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/optverse/v1"
       "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/optverse/v1/model"
       region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/optverse/v1/region"
   )

2. 配置客户端连接参数
   • 默认配置

     // 使用默认配置
     httpConfig := config.DefaultHttpConfig()

   • 网络配置（可选）

     // 根据需要配置代理
     httpConfig.WithProxy(config.NewProxy().
          WithSchema("http").
          WithHost("proxy.huaweicloud.com").
          WithPort(80).
          WithUsername("username").
          WithPassword("password"))))

   • 超时配置（可选）

     // 默认超时时间为120秒，可根据需要配置
     httpConfig.WithTimeout(120);

   • SSL配置（可选）

     // 根据需要配置是否跳过SSL证书校验
     httpConfig.WithIgnoreSSLVerification(true);

3. 配置认证信息

   配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。

   • 使用永久AK和SK

     basicAuth := basic.NewCredentialsBuilder().
          WithAk(ak).
          WithSk(sk).
          WithProjectId(projectId).
          Build()

   认证参数说明：

   • ak、sk：访问秘钥信息，获取方法请参见准备工作。
   • projectId：华为云项目ID，获取方法请参见准备工作。
   • AppCode：获取方法请参见准备工作。
4. 初始化客户端
   • 指定云服务region方式（推荐）

     // 增加region依赖
     import (
         "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/optverse/v1/region"
     )
     
     // 初始化客户端认证信息，使用当前客户端初始化方式可不填 projectId/domainId，以初始化basic.NewCredentialsBuilder()为例
     basicAuth := basic.NewCredentialsBuilder().
         WithAk(ak).
         WithSk(sk).
         Build()  
     
     // 初始化指定云服务的客户端 New{Service}Client ，以初始化 Region 级服务 OptVerse 的 NewOptVerseClient 为例
     client := optverse.NewOptVerseClient(
         optverse.OptVerseClientBuilder().
             WithRegion(region.ValueOf("cn-north-4")).
             WithCredential(basicAuth).
             WithHttpConfig(config.DefaultHttpConfig()).
             Build())

   • 指定云服务endpoint方式

     // 指定终端节点，以 OptVerse 服务北京四的 endpoint 为例
     endpoint:="https://optverse.cn-north-4.myhuaweicloud.com"
     // 初始化客户端认证信息，需要填写相应 projectId/domainId，以初始化 basic.NewCredentialsBuilder() 为例
     basicAuth:=basic.NewCredentialsBuilder().
         WithAk(ak).
         WithSk(sk).
         WithProjectId(projectId).
         Build()   
     
     // 初始化指定云服务的客户端 New{Service}Client ，以初始化 Region 级服务 OptVerse 的 NewOptVerseClient 为例
     client := optverse.NewOptVerseClient(
         optverse.OptVerseClientBuilder().
             WithEndpoint(endpoint).
             WithCredential(basicAuth).
             WithHttpConfig(config.DefaultHttpConfig()).
             Build())

     endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。

5. 发送请求并查看响应

   // 以调用天筹求解器查询任务列表接口ListTask为例
   request := &model.ListTaskRequest{}
   request.ServiceGroup = "2dcut"
   request.ServiceType = "irregular-textile"
   request.XApigAppCode = "bbexxxxxxxxxx2089e3377xxxxxxxxxx92c49018afc04e64xxxxx29c980f56aa"
   response, err := client.ListTask(request)
   if err == nil {
       fmt.Printf("%+v\n", response)
   } else {
       fmt.Println(err)
   }

6. 异常处理

   表1 异常处理

   一级分类	一级分类说明
   ServiceResponseError	服务响应异常
   url.Error	url异常

   // 异常处理
   response, err := client.ListTask(request)
   if err == nil {
       fmt.Printf("%+v\n", response)
   } else {
       fmt.Println(err)
   }

自动生成SDK代码示例

API Explorer提供API检索及平台调试，支持全量快速检索、可视化调试、帮助文档查看、在线咨询。

您只需要在API Explorer中修改接口参数，即可自动生成对应的代码示例。同时，可在集成开发环境CloudIDE中完成代码的构建、调试、运行等操作。

图3 API Explorer