初始化Tunnel client

Tunnel client是通道服务的客户端,它为调用者提供了一系列的方法,可以用来操作通道、消费数据等。如果要使用通道服务消费表中的数据,您需要初始化一个Tunnel client。

准备工作

初始化Tunnel client前,您需要完成配置访问密钥、获取实例Endpoint和安装表格存储Go SDK的准备工作。

获取实例Endpoint

创建实例后,您需要获取实例域名地址(Endpoint)用于后续通过Endpoint访问实例。

Endpoint是阿里云表格存储服务各个实例的域名地址,例如https://sun.cn-hangzhou.ots.aliyuncs.com,表示使用HTTPS协议通过公网网络访问华东1(杭州)地域的sun实例。更多信息,请参见服务地址

  1. 开通服务并创建实例。具体操作,请参见开通服务并创建实例

  2. 创建实例后获取实例的Endpoint。

    1. 登录表格存储控制台

    2. 概览页面,单击实例名称。

    3. 实例详情页签的实例访问地址区域即可查看该实例的服务地址(Endpoint)。

      image

安装表格存储Go SDK

具体操作,请参见安装表格存储Go SDK

配置访问凭证

要接入阿里云的表格存储服务,您需要拥有一个有效的访问密钥进行签名认证。具体操作,请参见配置访问凭证

初始化对接

请根据实际场景选择相应方式进行初始化。

  • 通过阿里云账号以及RAM用户的AccessKey进行初始化

    重要
    • 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。

    • 阿里云账号的AccessKey泄露会威胁该账号下所有资源的安全。为保证账号安全,强烈建议您给RAM用户创建AccessKey,不要给阿里云账号创建AccessKey。具体操作,请参见创建RAM用户的AccessKey

    获取到AccessKey IDAccessKey Secret后,您可以按照如下示例代码初始化Tunnel client。

    //endpoint是表格存储实例endpoint,例如https://instance.cn-hangzhou.ots.aliyun.com。
    //instance是实例名称。
    //accessKeyIdaccessKeySecret分别为阿里云账号或者RAM用户的AccessKey IDAccessKey Secret。
    accessKeyId := os.Getenv("OTS_AK_ENV")
    accessKeySecret := os.Getenv("OTS_SK_ENV")
    tunnelClient := tunnel.NewTunnelClient(endpoint, instance, accessKeyId, accessKeySecret)                    
  • 通过从STS获取的临时访问凭证进行初始化

    如果要进行临时访问授权,请使用此方式进行初始化。

    说明

    关于配置临时用户权限的更多信息,请参见通过RAM PolicyRAM用户授权

    Tunnel client内提供了NewTunnelClientWithToken接口用于使用临时访问凭证初始化Tunnel client。