更新时间:2024-03-04 GMT+08:00
分享
Go SDK

Go SDK

本章节介绍天筹求解器服务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

相关文档