クライアントは、Simple Log Serviceへのアクセスに使用できるGo SDKクライアントです。 プロジェクトの作成、Logstoreの作成、ログの書き込み、およびログの読み取りを行うためのさまざまな方法を提供します。 Simple Log Service SDK for Goを使用してリクエストを開始するには、クライアントインスタンスを初期化し、ビジネス要件に基づいてクライアントインスタンスのデフォルト設定を変更する必要があります。
前提条件
Simple Log Service SDK for Goがインストールされています。 詳細については、「Simple Log Service SDK For Goのインストール」をご参照ください。
必要なアクセス資格情報が設定されます。 詳細については、「アクセス資格情報の設定」をご参照ください。
クライアントインスタンスの初期化
API 操作
// Use an AccessKey pair to initialize a Client instance.
func CreateNormalInterface(endpoint, accessKeyID, accessKeySecret, securityToken string) ClientInterface
// Use custom access credentials to initialize a Client instance.
func CreateNormalInterfaceV2(endpoint string, credentialsProvider CredentialsProvider) ClientInterface
リクエストパラメーター
パラメーター | 型 | 必須 / 任意 | 説明 | 例 |
endpoint | String | 対象 | エンドポイント。 詳細については、「エンドポイントの取得」をご参照ください。 |
|
accessKeyID | String | 対象 |
|
|
accessKeySecret | String | 対象 |
|
|
securityToken | String | 任意 |
|
|
例
AccessKeyペアベースの初期化 (署名用AuthV4)
package main
import (
sls "github.com/aliyun/aliyun-log-go-sdk"
"os"
)
func main() {
// Specify a Simple Log Service endpoint. In this example, the Simple Log Service endpoint for the China (Hangzhou) region is used. Replace the parameter value with the actual endpoint.
endpoint := "cn-hangzhou.log.aliyuncs.com"
// Obtain an AccessKey ID and an AccessKey secret from environment variables.
accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
// Create a Simple Log Service client.
provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
client := sls.CreateNormalInterfaceV2(endpoint, provider)
// Use AuthV4 for signing.
client.SetAuthVersion(sls.AuthV4)
// Specify a region.
client.SetRegion("cn-hangzhou")
}
AccessKeyペアベースの初期化 (署名のAuthV1)
package main
import (
sls "github.com/aliyun/aliyun-log-go-sdk"
"os"
)
func main() {
// Specify a Simple Log Service endpoint. In this example, the Simple Log Service endpoint for the China (Hangzhou) region is used. Replace the parameter value with the actual endpoint.
endpoint := "cn-hangzhou.log.aliyuncs.com"
// Obtain an AccessKey ID and an AccessKey secret from environment variables.
accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
// Create a Simple Log Service 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() {
// Specify a Simple Log Service endpoint. In this example, the Simple Log Service endpoint for the China (Hangzhou) region is used. Replace the parameter value with the actual endpoint.
endpoint := "cn-hangzhou.log.aliyuncs.com"
// In this example, obtain the value of the AccessKeyId parameter below the Credentials parameter that is returned by the AssumeRole operation.
accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
// In this example, obtain the value of the AccessKeySecret parameter below the Credentials parameter that is returned by the AssumeRole operation.
accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
// In this example, obtain the value of the SecurityToken parameter below the Credentials parameter that is returned by the AssumeRole operation.
securityToken := ""
// Create a Simple Log Service client.
provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, securityToken)
client := sls.CreateNormalInterfaceV2(endpoint, provider)
}
関連ドキュメント
クライアントインスタンスを初期化した後、Simple Log Service SDK for Goを呼び出してプロジェクトを作成し、ログを書き込むことができます。 詳細については、「Simple Log Service SDK For Goの使用を開始する」をご参照ください。