初始化日志服务Go SDK

Client是日志服务Go SDK的客户端，它为调用者提供了一系列的方法，可以用来创建Project和Logstore、写入日志、读取日志等。使用Go SDK发起请求，您需要初始化一个Client实例，并根据需要修改默认配置项。

前提条件

已安装日志服务Go SDK。
配置访问凭证。
获取Endpoint。
服务入口（Endpoint）是访问阿里云服务的入口点，通常是一个URL，它指定了服务的访问协议、主机名、端口和路径等信息，客户端可以使用这些信息与服务进行通信。日志服务的Endpoint分为：
- 公网服务地址：从日志服务公网域名所在接口拉取数据时，会产生外网读取流量，计费信息请参见按写入数据量计费模式计费项和按使用功能计费模式计费项。具体列表，请参见服务入口。
- VPC服务地址：如果您通过与Project同地域的其他阿里云产品访问日志服务，建议使用VPC服务地址，请参见服务入口。
- 传输加速域名：业务服务器、日志服务Project分别属于国内地域和国外地域，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，可以选择传输加速域名，请参见管理传输加速。

初始化Client

接口

// 使用 ak 初始化客户端
func CreateNormalInterface(endpoint, accessKeyID, accessKeySecret, securityToken string) ClientInterface
// 使用自定义配置凭证接口初始化客户端
func CreateNormalInterfaceV2(endpoint string, credentialsProvider CredentialsProvider) ClientInterface

请求参数

变量	类型	是否必填	说明	示例值
endpoint	String	是	服务接入点，具体参见获取Endpoint	`cn-hangzhou.log.aliyuncs.com`
accessKeyID	String	是	如果使用AK配置访问凭证，则为阿里云账号（主账号）和RAM用户（子账号）的AccessKey ID，用于标识用户。具体参见配置访问凭证。警告阿里云主账号拥有资源的全部权限，如果主账号的AK泄露，会给系统带来巨大风险，不建议使用。推荐使用最小化授权的RAM用户的AK。如果使用STS配置访问凭证，则为AssumeRole接口返回参数Credentials中的AccessKeyId。	LTAI****************
accessKeySecret	String	是	如果使用AK配置访问凭证，则为阿里云账号（主账号）和RAM用户（子账号）的AccessKey Secret，用于验证您拥有该AccessKey ID的密码。具体参见配置访问凭证。如果使用STS配置访问凭证，则为AssumeRole接口返回参数Credentials中的AccessKeySecret。	yourAccessKeySecret
securityToken	String	否	RAM角色的STS临时访问凭证，仅当使用STS Token时需要填写，为AssumeRole接口返回参数Credentials中的SecurityToken。安全令牌（SecurityToken）的长度不固定，我们强烈建议您不要对安全令牌的最大长度做任何限制。获取STS Token的接口，请参见AssumeRole - 获取扮演角色的临时身份凭证。	****************

示例

使用AK初始化（V4签名）

package main

import (
  sls "github.com/aliyun/aliyun-log-go-sdk"
  "os"
)


func main() {
  // 日志服务的服务入口。此处以杭州为例，其它地域请根据实际情况填写。
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // 本示例从环境变量中获取AccessKey ID和AccessKey Secret。
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  
  // 创建日志服务Client。
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
  // 设置使用 v4 签名
  client.SetAuthVersion(sls.AuthV4)
  // 设置地域
  client.SetRegion("cn-hangzhou")
}

使用AK初始化（V1签名）

package main

import (
  sls "github.com/aliyun/aliyun-log-go-sdk"
  "os"
)

func main() {
  // 日志服务的服务入口。此处以杭州为例，其它地域请根据实际情况填写。
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // 本示例从环境变量中获取AccessKey ID和AccessKey Secret。
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  
  // 创建日志服务Client。
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

使用STS初始化

package main

import (
  sls "github.com/aliyun/aliyun-log-go-sdk"
  "os"
)

func main() {
  // 日志服务的服务入口。此处以杭州为例，其它地域请根据实际情况填写。
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的AccessKeyId。
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  // 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的AccessKeySecret。
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
   // 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的SecurityToken。
  securityToken := ""
  
  // 创建日志服务Client。
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, securityToken)
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

前提条件

初始化Client

接口

请求参数

示例

使用AK初始化（V4签名）

使用AK初始化（V1签名）

使用STS初始化

相关文档

Go SDK概述 2025-04-22 10:33

安装Go SDK 2025-04-22 10:33

初始化日志服务Go SDK 2025-04-22 10:33

Go SDK快速入门 2025-04-22 10:33

使用Go SDK创建分层存储Logstore 2025-04-22 10:33

通过Go SDK管理告警 2025-04-22 10:33

目录