Inisialisasi Simple Log Service SDK untuk Go - Simple Log Service

Client adalah klien Go SDK yang digunakan untuk mengakses Layanan Log Sederhana. Client menyediakan berbagai metode untuk membuat Proyek, mengonfigurasi penyimpanan log, menulis log, dan membaca log. Untuk menggunakan Simple Log Service SDK untuk Go, Anda harus menginisialisasi instance Client dan menyesuaikan pengaturan default sesuai kebutuhan bisnis Anda.

Prasyarat

Simple Log Service SDK untuk Go telah diinstal. Untuk informasi lebih lanjut, lihat Instal Simple Log Service SDK untuk Go.
Kredensial akses telah dikonfigurasi. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses.
Titik akhir yang diperlukan telah diperoleh.
Titik akhir digunakan untuk mengakses layanan Alibaba Cloud. Dalam banyak kasus, titik akhir merupakan URL yang mencakup protokol akses, nama host, port, dan jalur. Klien dapat menggunakan informasi ini untuk mengakses layanan. Untuk informasi lebih lanjut, lihat Titik Akhir. Layanan Log Sederhana mendukung titik akhir publik, titik akhir virtual private cloud (VPC), dan titik akhir percepatan.
- Titik akhir publik: Jika data ditarik melalui titik akhir publik Layanan Log Sederhana, lalu lintas baca melalui Internet akan terjadi. Untuk informasi lebih lanjut tentang penagihan, lihat Item tagihan pay-by-ingested-data dan Item tagihan pay-by-feature. Untuk informasi lebih lanjut tentang titik akhir, lihat Titik Akhir.
- Titik akhir VPC: Jika Anda ingin mengakses Layanan Log Sederhana dari layanan Alibaba Cloud lainnya dalam wilayah yang sama dengan proyek Anda, kami sarankan menggunakan titik akhir VPC. Untuk informasi lebih lanjut, lihat Titik Akhir.
- Percepatan titik akhir: Jika server Anda dan Layanan Log Sederhana berada di wilayah yang berbeda, seperti di dalam dan luar Tiongkok, latensi jaringan tinggi dan transmisi tidak stabil ketika data ditransmisikan melalui Internet. Dalam hal ini, Anda dapat menggunakan titik akhir percepatan. Untuk informasi lebih lanjut, lihat Gunakan fitur transfer percepatan.

Inisialisasi instance Client

Operasi API

// Gunakan pasangan AccessKey untuk menginisialisasi instance Client.
func CreateNormalInterface(endpoint, accessKeyID, accessKeySecret, securityToken string) ClientInterface
// Gunakan kredensial akses kustom untuk menginisialisasi instance Client.
func CreateNormalInterfaceV2(endpoint string, credentialsProvider CredentialsProvider) ClientInterface

Parameter Permintaan

Parameter	Tipe	Diperlukan	Deskripsi	Contoh
endpoint	String	Ya	Titik akhir. Untuk informasi lebih lanjut, lihat Dapatkan titik akhir.	`cn-hangzhou.log.aliyuncs.com`
accessKeyID	String	Ya	Jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses, atur parameter ini ke ID AccessKey dari akun Alibaba Cloud atau Pengguna Resource Access Management (RAM) Anda. ID AccessKey digunakan untuk mengidentifikasi pengguna. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. Peringatan Pasangan AccessKey dari akun Alibaba Cloud memiliki izin penuh pada sumber daya. Kami sarankan Anda tidak menggunakan pasangan AccessKey dari akun Alibaba Cloud untuk menghindari risiko yang disebabkan oleh kebocoran pasangan AccessKey. Kami sarankan Anda menggunakan pasangan AccessKey dari Pengguna RAM yang diberi izin berdasarkan prinsip hak istimewa minimal. Jika Anda menggunakan Security Token Service (STS) untuk mengonfigurasi kredensial akses, atur parameter ini ke nilai parameter AccessKeyId di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.	LTAI****************
accessKeySecret	String	Ya	Jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses, atur parameter ini ke Rahasia AccessKey dari akun Alibaba Cloud atau Pengguna RAM Anda. Rahasia AccessKey digunakan untuk memverifikasi ID AccessKey Anda. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. Jika Anda menggunakan STS untuk mengonfigurasi kredensial akses, atur parameter ini ke nilai parameter AccessKeySecret di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.	yourAccessKeySecret
securityToken	String	Tidak	Parameter ini hanya diperlukan jika Anda menggunakan STS untuk mengonfigurasi kredensial akses. Atur parameter ini ke nilai parameter SecurityToken di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole. Alibaba Cloud STS tidak memberlakukan batasan pada panjang token STS. Kami sarankan Anda tidak menentukan panjang maksimum untuk token STS. Untuk informasi lebih lanjut tentang cara mendapatkan token STS, lihat AssumeRole.	****************

Contoh

Inisialisasi berbasis pasangan AccessKey (AuthV4 untuk penandatanganan)

package main

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


func main() {
  // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Hangzhou) digunakan. Ganti nilai parameter dengan titik akhir sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Dapatkan 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 klien Layanan Log Sederhana.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
  // Gunakan AuthV4 untuk penandatanganan.
  client.SetAuthVersion(sls.AuthV4)
  // Tentukan wilayah.
  client.SetRegion("cn-hangzhou")
}

Inisialisasi berbasis pasangan AccessKey (AuthV1 untuk penandatanganan)

package main

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

func main() {
  // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Hangzhou) digunakan. Ganti nilai parameter dengan titik akhir sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Dapatkan 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 klien Layanan Log Sederhana.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, "")
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

Inisialisasi berbasis STS

package main

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

func main() {
  // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Hangzhou) digunakan. Ganti nilai parameter dengan titik akhir sebenarnya.
  endpoint := "cn-hangzhou.log.aliyuncs.com"
  
  // Dalam contoh ini, dapatkan nilai parameter AccessKeyId di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
  accessKeyId := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
  // Dalam contoh ini, dapatkan nilai parameter AccessKeySecret di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
  accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
   // Dalam contoh ini, dapatkan nilai parameter SecurityToken di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
  securityToken := ""
  
  // Buat klien Layanan Log Sederhana.
  provider := sls.NewStaticCredentialsProvider(accessKeyId, accessKeySecret, securityToken)
  client := sls.CreateNormalInterfaceV2(endpoint, provider)
}

Referensi

Setelah menginisialisasi instance Client, Anda dapat memanggil Simple Log Service SDK untuk Go guna membuat proyek dan menulis log. Untuk informasi lebih lanjut, lihat Memulai dengan Simple Log Service SDK untuk Go.