V2.0 Java SDK (direkomendasikan) - Alibaba Cloud SDK

Topik ini menjelaskan paket dependensi umum dan kelas konfigurasi untuk SDK V2.0 guna membantu Anda menyelesaikan kesalahan lebih cepat dan mengembangkan secara lebih efisien.

Paket dependensi umum

Sebagian besar produk cloud dalam SDK V2.0 memerlukan paket dependensi umum berikut. Anda dapat memperoleh versi terbarunya dari Repositori Maven. Jika terjadi konflik paket dalam proyek Anda, tambahkan secara manual versi terbaru dari paket dependensi tersebut.

Catatan

Paket-paket dalam daftar akan dipasang secara otomatis saat Anda menginstal SDK produk cloud. Jika muncul kesalahan selama penggunaan, tambahkan secara manual versi terbarunya.

Nama paket	Alamat Maven	Alamat repositori kode GitHub
tea-util	Maven Central: com.aliyun:tea-util	tea-util
tea	Maven Central: com.aliyun:tea	tea-java
credentials-java	Maven Central: com.aliyun:credentials-java	credentials-java
credentials-api	Maven Central: com.aliyun:credentials-api	credentials-api
openapiutil	Maven Central: com.aliyun:openapiutil	openapiutil
alibabacloud-gateway-spi	Maven Central: com.aliyun:alibabacloud-gateway-spi	alibabacloud-gateway-spi
tea-xml	Maven Central: com.aliyun:tea-xml	tea-xml
tea-openapi	Maven Central: com.aliyun:tea-openapi	tea-openapi

Kelas konfigurasi

com.aliyun.teaopenapi.models.Config

Kelas ini mengonfigurasi parameter global, seperti informasi kredensial, titik akhir, konfigurasi proxy, dan pengaturan waktu habis. Tabel berikut menjelaskan parameter-parameter tersebut.

Catatan

Jangan gunakan parameter yang tidak tercantum dalam tabel karena mungkin sudah tidak digunakan lagi atau tidak memiliki arti praktis.

Nama parameter	Deskripsi
credential	Klien kredensial. Dalam SDK V2.0, informasi kredensial dikelola oleh alat kredensial. Untuk informasi selengkapnya, lihat Kelola kredensial akses.
accessKeyId	ID AccessKey. Tetapkan parameter ini atau `credential`. Jika kedua parameter `credential` dan `accessKeyId` ditetapkan, kredensial dalam `credential` yang digunakan.
accessKeySecret	Rahasia AccessKey. Tetapkan parameter ini atau `credential`. Jika kedua parameter `credential` dan `accessKeySecret` ditetapkan, kredensial dalam `credential` yang digunakan.
securityToken	Token Layanan Keamanan (STS). Tetapkan parameter ini atau `credential`. Jika kedua parameter `credential` dan `securityToken` ditetapkan, kredensial dalam `credential` yang digunakan.
bearerToken	Token bearer. Tetapkan parameter ini atau `credential`. Jika kedua parameter `credential` dan `bearerToken` ditetapkan, kredensial dalam `credential` yang digunakan.
endpoint	Titik akhir layanan untuk wilayah tempat sumber daya cloud Anda berada. Panggil API melalui titik akhir ini untuk mengakses sumber daya cloud Anda. Untuk informasi selengkapnya, lihat Konfigurasikan titik akhir.
regionId	Wilayah tempat sumber daya cloud Anda berada. Jika Anda tidak menetapkan parameter `endpoint`, Anda dapat menetapkan parameter ini untuk mendapatkan titik akhir layanan untuk `regionId` yang ditentukan. Untuk informasi selengkapnya, lihat Konfigurasikan titik akhir.
network	Saat Anda menetapkan `regionId`, Anda dapat menggunakan parameter ini untuk menentukan jenis titik akhir layanan yang akan didapatkan. Secara default, titik akhir Internet digunakan. Nilai yang valid: `vpc`: Mendapatkan titik akhir VPC. Saat Anda menggunakan SDK Simple Log Service (sls20201230), titik akhir Internet digunakan secara default. Anda dapat menggunakan nilai-nilai berikut untuk memilih titik akhir yang berbeda: `intranet`: Mendapatkan titik akhir VPC untuk Simple Log Service. `accelerate`: Mendapatkan titik akhir akselerasi transfer untuk Simple Log Service.
maxIdleConns	Jumlah maksimum koneksi menganggur yang disimpan dalam kolam koneksi. Saat jumlah koneksi melebihi nilai ini, koneksi menganggur berlebih akan ditutup untuk melepaskan sumber daya. Nilai default adalah 5. Untuk informasi selengkapnya, lihat Konfigurasikan kolam koneksi HTTP.
protocol	Protokol permintaan. Protokol yang didukung adalah HTTPS dan HTTP. Nilai default adalah HTTPS. Untuk informasi selengkapnya, lihat Konfigurasikan permintaan HTTPS.
readTimeout	Periode waktu habis baca. Nilai default adalah 10.000 milidetik. Untuk informasi selengkapnya, lihat Mekanisme waktu habis.
connectTimeout	Periode waktu habis koneksi. Nilai default adalah 5.000 milidetik. Untuk informasi selengkapnya, lihat Mekanisme waktu habis.
httpProxy	Menentukan alamat dan port server proxy. Formatnya adalah `http://proxyServer:port`. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.
httpsProxy	Menentukan alamat dan port server proxy. Formatnya adalah `https://username:password@proxyServer:port`. Jika autentikasi proxy tidak diperlukan, formatnya adalah `https://proxyServer:port`. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.
noProxy	Menentukan daftar alamat yang dapat diakses tanpa proxy. Pisahkan beberapa alamat dengan koma. Nama domain dan alamat IP didukung. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.

com.aliyun.teautil.models.RuntimeOptions

Kelas ini mengonfigurasi parameter runtime untuk permintaan API tertentu, seperti pengaturan proxy dan waktu habis. Tabel berikut menjelaskan parameter-parameter tersebut.

Catatan

Jangan gunakan parameter yang tidak tercantum dalam tabel karena mungkin sudah tidak digunakan lagi atau tidak memiliki arti praktis.

Nama parameter	Deskripsi
autoretry	Menentukan apakah fitur pengulangan diaktifkan. Fitur ini hanya berlaku untuk kesalahan yang disebabkan oleh masalah jaringan. Nilai default adalah `false`, yang berarti fitur pengulangan dinonaktifkan. Untuk informasi selengkapnya, lihat Mekanisme pengulangan.
maxAttempts	Saat fitur pengulangan diaktifkan, Anda dapat menggunakan parameter ini untuk mengatur jumlah pengulangan. Nilai default adalah 3. Untuk informasi selengkapnya, lihat Mekanisme pengulangan.
maxIdleConns	Jumlah maksimum koneksi menganggur yang disimpan dalam kolam koneksi. Saat jumlah koneksi melebihi nilai ini, koneksi menganggur berlebih akan ditutup untuk melepaskan sumber daya. Nilai default adalah 5. Untuk informasi selengkapnya, lihat Konfigurasikan kolam koneksi HTTP.
ignoreSSL	Saat `protocol` ditetapkan ke HTTPS, SDK secara default mengaktifkan validasi sertifikat SSL/TLS. Jika lingkungan runtime Anda tidak memiliki sertifikat SSL/TLS, Anda dapat menggunakan parameter ini untuk sementara mengabaikan validasi sertifikat. Nilai default adalah `false`, yang berarti validasi sertifikat diperlukan. Untuk informasi selengkapnya, lihat Konfigurasikan permintaan HTTPS. Catatan Untuk memastikan keamanan komunikasi di lingkungan produksi Anda, aktifkan validasi sertifikat.
readTimeout	Periode waktu habis baca. Nilai default adalah 10.000 milidetik. Untuk informasi selengkapnya, lihat Mekanisme waktu habis.
connectTimeout	Periode waktu habis koneksi. Nilai default adalah 5.000 milidetik. Untuk informasi selengkapnya, lihat Mekanisme waktu habis.
httpProxy	Menentukan alamat dan port server proxy. Formatnya adalah `http://proxyServer:port`. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.
httpsProxy	Menentukan alamat dan port server proxy. Formatnya adalah `https://username:password@proxyServer:port`. Jika autentikasi proxy tidak diperlukan, formatnya adalah `https://proxyServer:port`. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.
noProxy	Menentukan daftar alamat yang dapat diakses tanpa proxy. Pisahkan beberapa alamat dengan koma. Nama domain dan alamat IP didukung. Untuk informasi selengkapnya, lihat Konfigurasikan proxy.