Konfigurasikan titik akhir di Alibaba Cloud SDK V2.0 untuk Java - Alibaba Cloud SDK

Titik akhir adalah nama domain dari layanan Alibaba Cloud. Sebagai contoh, titik akhir Elastic Compute Service (ECS) di wilayah Tiongkok (Hangzhou) adalah ecs.cn-hangzhou.aliyuncs.com. Setiap layanan Alibaba Cloud memiliki titik akhir yang unik, dan dapat bervariasi berdasarkan wilayah. Topik ini menjelaskan cara mengonfigurasi titik akhir di Alibaba Cloud SDK V2.0.

Jenis titik akhir

Titik akhir terbagi menjadi dua jenis: titik akhir publik dan titik akhir Virtual Private Cloud (VPC). Untuk informasi lebih lanjut, lihat Titik akhir.

Konfigurasikan titik akhir

Alibaba Cloud SDK V2.0 menyediakan dua metode untuk mengonfigurasi titik akhir. Bagian berikut menjelaskan metode tersebut berdasarkan prioritasnya dalam urutan menurun.

Catatan

Kami merekomendasikan Anda mengonfigurasi titik akhir dengan menentukan titik akhir kustom.

Tentukan titik akhir kustom. Anda dapat menentukan titik akhir saat menginisialisasi klien. Titik akhir dapat diperiksa di OpenAPI Explorer. Untuk informasi lebih lanjut, lihat bagian "Lampiran: Periksa titik akhir" dari topik ini.

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    public static void main(String[] args) throws Exception {
        com.aliyun.teaopenapi.models.Config config = new Config();
        config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
        config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // Konfigurasikan titik akhir.
        config.setEndpoint("<endpoint>");
        Client client = new Client(config);
    }
}

Tentukan ID wilayah kustom.

Jika SDK untuk layanan Alibaba Cloud mencakup objek hubungan antara ID wilayah dan titik akhir, serta ID wilayah yang ditentukan termasuk dalam objek tersebut, Anda dapat memperoleh titik akhir dari objek hubungan tersebut.
Jika SDK untuk layanan Alibaba Cloud tidak mencakup objek hubungan antara ID wilayah dan titik akhir, atau jika ID wilayah yang ditentukan tidak termasuk dalam objek tersebut, titik akhir akan digabungkan secara otomatis berdasarkan aturan penggabungan.

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    public static void main(String[] args) throws Exception {
        Config config = new Config();
        config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
        config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // Tentukan titik akhir berdasarkan ID wilayah.
        config.setRegionId("<regionId>");
        Client client = new Client(config);
    }
}

Skenario penggunaan titik akhir VPC

Kami merekomendasikan Anda mengonfigurasi titik akhir VPC jika menggunakan SDK Alibaba Cloud untuk memanggil operasi API dan bisnis Anda memiliki persyaratan berikut:

Sistem bisnis ditempatkan baik di pusat data lokal maupun di pusat data cloud. Modul bisnis yang berbeda dibangun berdasarkan jaringan VPC untuk membangun lingkungan cloud yang terisolasi. Pusat data berkomunikasi satu sama lain melalui Internet.
Pusat data cloud dikerahkan berdasarkan jaringan VPC. Ini berkomunikasi dengan pusat data lokal melalui sirkuit Express Connect untuk menerapkan koneksi hybrid cloud. Hal ini memastikan keamanan data pengguna inti dan membantu merespons fluktuasi beban kerja serta sinkronisasi data cepat.
Banyak aplikasi yang dikerahkan berdasarkan jaringan VPC perlu menyediakan layanan eksternal, dan beban kerja aplikasi tersebut berfluktuasi pada waktu yang berbeda. Dalam hal ini, beberapa alamat IP perlu berbagi bandwidth dan fluktuasi lalu lintas perlu dikurangi, sehingga mengurangi biaya.
Layanan cloud dibangun berdasarkan jaringan VPC. Untuk mengurangi latensi jaringan bagi pengguna di wilayah yang berbeda, sistem bisnis ditempatkan di node yang berbeda. Koneksi bandwidth tinggi antar node diperlukan untuk mengoptimalkan pengalaman pengguna.

Peroleh titik akhir untuk meminta informasi autentikasi

Beberapa operasi API dapat dipanggil untuk mengonfigurasi titik akhir platform terbuka. Jika Anda tidak mengonfigurasi titik akhir, titik akhir publik default yang digunakan. Anda dapat menggunakan titik akhir untuk memanggil layanan autentikasi unggah file dan kemudian memperoleh informasi autentikasi serta informasi tentang bucket Object Storage Service (OSS) default.

Contoh berikut menunjukkan cara mengonfigurasi titik akhir VPC dengan memanggil operasi deteksi jumlah orang dari Visual Intelligence API (VIAPI):

import com.aliyun.facebody20191230.models.DetectBodyCountAdvanceRequest;
import com.aliyun.facebody20191230.models.DetectBodyCountResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
import com.google.gson.Gson;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

public class Sample {
    public static void main(String[] args) throws Exception {
        Config config = new com.aliyun.teaopenapi.models.Config();
        config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
        config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.setRegionId("<regionId>");
        // Konfigurasikan titik akhir OSS yang ingin Anda gunakan untuk mengunggah file. Untuk mengunggah file menggunakan jaringan internal, hapus komentar baris berikut:
        // config.setEndpointType("internal");
        com.aliyun.facebody20191230.Client client = new com.aliyun.facebody20191230.Client(config);
        // Konfigurasikan titik akhir VPC layanan autentikasi berdasarkan ID wilayah seperti openplatform-vpc.cn-hangzhou.aliyuncs.com.
        client._openPlatformEndpoint="openplatform-vpc.<regionId>.aliyuncs.com";
        RuntimeOptions runtimeOptions = new RuntimeOptions();
        // Baca file dan buat instance aliran file.
        File f = new File("<your-file-path>");
        InputStream in =new FileInputStream(f);

        DetectBodyCountAdvanceRequest request = new DetectBodyCountAdvanceRequest();
        request.setImageURLObject(in);
        DetectBodyCountResponse resp = client.detectBodyCountAdvance(request, runtimeOptions);
        // Tanggapan, yang berisi body dan header yang dikembalikan oleh server.
        System.out.println(new Gson().toJson(resp.body));
        System.out.println(new Gson().toJson(resp.headers));
    }
}

Lampiran: Periksa titik akhir

Anda dapat memeriksa titik akhir di OpenAPI Explorer.

Pilih layanan Alibaba Cloud di halaman utama OpenAPI Explorer. Dalam contoh ini, ECS dipilih.

2. Di halaman utama ECS, klik tab Regions.

3. Temukan wilayah yang ingin Anda tentukan dan salin titik akhir ECS di wilayah tersebut.

Anda juga dapat memeriksa titik akhir ECS di halaman Debugging. Di halaman ini, gerakkan penunjuk ke Regions di panel navigasi di sebelah kiri untuk melihat titik akhir ECS.