Client adalah klien Java SDK untuk Simple Log Service yang menyediakan metode untuk membuat Proyek dan penyimpanan log, menulis log, serta membaca log. Sebelum mengirim permintaan menggunakan Java SDK, inisialisasi instance Client dan sesuaikan konfigurasi default sesuai kebutuhan.
Prasyarat
-
Anda telah menyelesaikan instalasi Java SDK.
Prosedur
Tersedia dua metode inisialisasi. Pilih metode yang sesuai dengan skenario Anda:
-
Inisialisasi AK: Pasangan AccessKey merupakan kredensial jangka panjang yang dapat langsung digunakan untuk panggilan API. Metode ini cocok untuk skenario stabil yang tidak memerlukan rotasi kredensial secara berkala.
-
Inisialisasi STS: Security Token Service (STS) menghasilkan kredensial akses sementara. Metode ini cocok untuk skenario yang memerlukan otorisasi dinamis berdurasi pendek.
Inisialisasi menggunakan pasangan AccessKey
Inisialisasi klien
public Client(String endpoint, String accessKeyId, String accessKeySecret)Parameter permintaan
|
Variabel |
Type |
Wajib |
Deskripsi |
Contoh nilai |
|
endpoint |
String |
Ya |
Titik akhir yang digunakan untuk mengakses Simple Log Service. Titik akhir adalah URL yang menentukan protokol akses, hostname, port, dan path untuk komunikasi antara klien dan layanan. Simple Log Service menyediakan jenis titik akhir berikut:
|
|
|
accessKeyId |
String |
Ya |
|
LTAI**************** |
|
accessKeySecret |
String |
Ya |
Jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses, Rahasia AccessKey berasal dari Akun Alibaba Cloud atau Pengguna RAM. Rahasia AccessKey mengautentikasi ID AccessKey. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. |
yourAccessKeySecret |
Kode contoh
Algoritma signature V4 menawarkan keamanan lebih tinggi melalui enkripsi dan penandatanganan yang lebih kompleks, sedangkan algoritma signature V1 lebih sederhana. Pilih algoritma signature berdasarkan kebutuhan Anda:
Signature V4
package com.test.controller;
import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.http.client.ClientConfiguration;
import com.aliyun.openservices.log.http.signer.SignVersion;
public class Sample {
public static void main(String[] args) throws Exception {
// Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Beijing). Ganti dengan titik akhir yang sebenarnya.
String endpoint = "cn-beijing.log.aliyuncs.com";
// Contoh ini mengambil ID AccessKey dan Rahasia AccessKey dari variabel lingkungan.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
ClientConfiguration clientConfiguration = new ClientConfiguration();
clientConfiguration.setRegion("cn-beijing");
clientConfiguration.setSignatureVersion(SignVersion.V4);
Client client = new Client(endpoint,
accessKeyId,
accessKeySecret,
clientConfiguration);
}
}Signature V1
package com.test.controller;
import com.aliyun.openservices.log.Client;
public class Sample {
public static void main(String[] args) throws Exception {
// Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Beijing). Ganti dengan titik akhir yang sebenarnya.
String endpoint = "cn-beijing.log.aliyuncs.com";
// Contoh ini mengambil ID AccessKey dan Rahasia AccessKey dari variabel lingkungan.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
Client client = new Client(endpoint, accessKeyId, accessKeySecret);
}
}Inisialisasi menggunakan STS
Inisialisasi klien
Client(String endpoint, CredentialsProvider credentialsProvider) ;Parameter permintaan
|
Variabel |
Tipe |
Wajib |
Deskripsi |
Contoh |
|
endpoint |
String |
Ya |
Titik akhir yang digunakan untuk mengakses Simple Log Service. Titik akhir adalah URL yang menentukan protokol akses, hostname, port, dan path untuk komunikasi antara klien dan layanan. Simple Log Service menyediakan jenis titik akhir berikut:
|
|
|
accessKeyId |
String |
Ya |
Jika Anda menggunakan STS untuk mengonfigurasi kredensial akses, AccessKeyId berasal dari parameter Credentials yang dikembalikan oleh operasi API AssumeRole. |
LTAI**************** |
|
accessKeySecret |
String |
Ya |
Jika Anda menggunakan STS untuk mengonfigurasi kredensial akses, AccessKeySecret berasal dari parameter Credentials yang dikembalikan oleh operasi API AssumeRole. |
yourAccessKeySecret |
|
securityToken |
String |
Ya |
Jika Anda menggunakan STS untuk mengonfigurasi kredensial akses, SecurityToken berasal dari parameter Credentials yang dikembalikan oleh operasi API AssumeRole. |
**************** |
Kode contoh
package com.test.controller;
import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.common.auth.DefaultCredentials;
import com.aliyun.openservices.log.common.auth.StaticCredentialsProvider;
public class Sample {
public static void main(String[] args) throws Exception {
// Titik akhir Simple Log Service. Contoh ini menggunakan titik akhir wilayah Tiongkok (Beijing). Ganti dengan titik akhir yang sebenarnya.
String endpoint = "cn-beijing.log.aliyuncs.com";
// Contoh ini mengambil AccessKeyId dari parameter Credentials yang dikembalikan oleh operasi AssumeRole dari variabel lingkungan.
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
// Contoh ini mengambil AccessKeySecret dari parameter Credentials yang dikembalikan oleh operasi AssumeRole dari variabel lingkungan.
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// Contoh ini mengambil SecurityToken dari parameter Credentials yang dikembalikan oleh operasi AssumeRole dari variabel lingkungan.
String securityToken = System.getenv("ALIBABA_CLOUD_STS_TOKEN");
Client client = new Client(endpoint, new StaticCredentialsProvider(
new DefaultCredentials(accessKeyId, accessKeySecret, securityToken)
));
}
}Referensi
-
Setelah menginisialisasi klien, Anda dapat memanggil operasi API untuk membuat Proyek, menulis log, atau melakukan operasi lainnya. Untuk informasi lebih lanjut, lihat Panduan Cepat Java SDK.