Inisialisasi SLS Go SDK | Simple Log Service - Simple Log Service

Client SLS Go SDK menyediakan metode untuk membuat Proyek dan Logstore, menulis log, serta membaca log. Inisialisasi instance Client dan sesuaikan konfigurasi default sesuai kebutuhan sebelum mengirim permintaan.

Prasyarat

SLS Go SDK telah diinstal.
Konfigurasikan kredensial akses.
Peroleh titik akhir.
Titik akhir adalah URL yang digunakan client Anda untuk mengakses layanan Alibaba Cloud. SLS menyediakan jenis titik akhir berikut:
- Titik akhir publik: Menarik data melalui titik akhir publik menghasilkan lalu lintas outbound yang ditagih berdasarkan Item yang dapat ditagih dalam mode bayar berdasarkan data yang diingest dan Item yang dapat ditagih dalam mode bayar berdasarkan fitur. Titik akhir.
- Titik akhir VPC: Gunakan titik akhir VPC untuk mengakses SLS dari layanan Alibaba Cloud lainnya di wilayah yang sama dengan Proyek Anda. Titik akhir.
- Acceleration endpoint: Gunakan acceleration endpoint ketika server Anda dan Proyek SLS berada di wilayah berbeda—misalnya, satu di Tiongkok Daratan dan lainnya di luar Tiongkok Daratan—untuk menghindari latensi tinggi dan ketidakstabilan melalui jaringan publik. Kelola akselerasi transfer.

Inisialisasi client

Referensi API

// Inisialisasi client dengan pasangan AccessKey.
func CreateNormalInterface(endpoint, accessKeyID, accessKeySecret, securityToken string) ClientInterface
// Inisialisasi client dengan kredensial akses kustom.
func CreateNormalInterfaceV2(endpoint string, credentialsProvider CredentialsProvider) ClientInterface

Parameter permintaan

Variabel	Tipe	Wajib	Deskripsi	Contoh
endpoint	String	Ya	Titik akhir SLS. Peroleh titik akhir.	`cn-hangzhou.log.aliyuncs.com`
accessKeyID	String	Ya	Jika Anda menggunakan pasangan AccessKey, atur nilai ini ke ID AccessKey Akun Alibaba Cloud atau RAM user Anda. Konfigurasikan kredensial akses. Peringatan Pasangan AccessKey Akun Alibaba Cloud memiliki izin penuh terhadap resource. Untuk mengurangi risiko kebocoran pasangan AccessKey, gunakan pasangan AccessKey RAM user dengan izin minimum yang diperlukan. Jika Anda menggunakan token STS, atur nilai ini ke nilai AccessKeyId dalam Credentials yang dikembalikan oleh operasi AssumeRole.	LTAI****************
accessKeySecret	String	Ya	Jika Anda menggunakan pasangan AccessKey, atur nilai ini ke Rahasia AccessKey Akun Alibaba Cloud atau RAM user Anda. Konfigurasikan kredensial akses. Jika Anda menggunakan token STS, atur nilai ini ke nilai AccessKeySecret dalam Credentials yang dikembalikan oleh operasi AssumeRole.	yourAccessKeySecret
securityToken	String	Tidak	Hanya diperlukan untuk token STS. Atur nilai ini ke nilai SecurityToken dalam Credentials yang dikembalikan oleh operasi AssumeRole. Panjang token STS bervariasi. Jangan memberlakukan batas panjang maksimum. AssumeRole.	****************

Contoh

Inisialisasi dengan pasangan AccessKey (signature V4)

package main

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


func main() {
  // Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Hangzhou). Ganti nilai ini dengan titik akhir yang sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Contoh ini memperoleh ID AccessKey dan Rahasia AccessKey dari variabel lingkungan.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  
  // Buat client Simple Log Service.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
  // Atur versi signature ke v4.
  client.SetAuthVersion(sls.AuthV4)
  // Atur wilayah.
  client.SetRegion("cn-hangzhou")
}

Inisialisasi dengan pasangan AccessKey (signature V1)

package main

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

func main() {
  // Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Hangzhou). Ganti nilai ini dengan titik akhir yang sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Contoh ini memperoleh ID AccessKey dan Rahasia AccessKey dari variabel lingkungan.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
  
  // Buat client Simple Log Service.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

Inisialisasi dengan token STS

package main

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

func main() {
  // Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Hangzhou). Ganti nilai ini dengan titik akhir yang sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Contoh ini memperoleh AccessKeyId dari parameter Credentials pada respons AssumeRole dari variabel lingkungan.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  // Contoh ini memperoleh AccessKeySecret dari parameter Credentials pada respons AssumeRole dari variabel lingkungan.
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
   // Contoh ini memperoleh SecurityToken dari parameter Credentials pada respons AssumeRole dari variabel lingkungan.
  securityToken := ""
  
  // Buat client Simple Log Service.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, securityToken)
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

Referensi

Setelah menginisialisasi klien, panggil operasi API untuk membuat proyek, menulis log, dan lainnya. Panduan Cepat Mulai Go SDK.