文档首页/ 天筹求解器服务 OptVerse/ SDK参考/ Go SDK
更新时间：2024-03-04 GMT+08:00
查看PDF
分享

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

相关文档