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

Titik akhir adalah nama domain yang digunakan untuk mengakses API layanan, seperti ecs.cn-hangzhou.aliyuncs.com untuk ECS di wilayah China (Hangzhou). Titik akhir bervariasi tergantung pada layanan dan wilayah. SDK V2.0 mendukung dua metode untuk mengonfigurasinya.

Jenis titik akhir

Tersedia dua jenis: titik akhir publik dan titik akhir VPC. Endpoints.

Pengaturan titik akhir

SDK V2.0 menyediakan dua metode untuk menetapkan titik akhir, yang diurutkan berdasarkan prioritas:

Catatan

Kami merekomendasikan agar Anda menentukan titik akhir kustom.

Tentukan titik akhir kustom: Tetapkan titik akhir saat menginisialisasi client. Temukan titik akhir layanan di halaman produk di OpenAPI Explorer, atau ikuti langkah-langkah dalam apendiks.

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"));
        // Set the endpoint.
        config.setEndpoint("<endpoint>");
        Client client = new Client(config);
    }
}

Tentukan ID wilayah:

Jika SDK berisi pemetaan wilayah ke titik akhir untuk layanan tersebut dan ID wilayah yang ditentukan tersedia dalam pemetaan tersebut, SDK akan menggunakan titik akhir yang sesuai.
Jika pemetaan tidak tersedia atau tidak mencakup ID wilayah yang ditentukan, SDK akan membuat titik akhir secara otomatis berdasarkan konvensi penamaan.

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"));
        // Map the region ID to an endpoint.
        config.setRegionId("<regionId>");
        Client client = new Client(config);
    }
}

Kasus penggunaan titik akhir VPC

Gunakan titik akhir VPC dalam skenario berikut:

Bisnis Anda berjalan di pusat data lokal dan cloud, dengan modul yang diisolasi oleh VPC terhubung melalui internet publik.
Anda menghubungkan pusat data cloud berbasis VPC ke lingkungan lokal melalui Express Connect untuk skenario cloud hibrida seperti keamanan data, kapasitas lonjakan (burst capacity), dan sinkronisasi data cepat.
Beberapa aplikasi dalam satu VPC dengan jam puncak berbeda berbagi bandwidth di antara alamat IP untuk meratakan lalu lintas dan mengurangi biaya.
Layanan Anda sepenuhnya berjalan di VPC di beberapa node dan memerlukan koneksi berkecepatan tinggi di antara mereka untuk pengguna yang tersebar secara geografis.

Titik akhir otorisasi unggah file

Beberapa operasi API menerima titik akhir platform terbuka kustom. Jika tidak ditentukan, SDK akan menggunakan titik akhir publik default. Secara internal, SDK memanggil layanan autentikasi unggah file untuk mendapatkan kredensial unggah dan informasi instans OSS default.

Contoh berikut menetapkan titik akhir VPC untuk API VIAPI body counting:

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>");
        // To upload files over a private network by using an OSS internal endpoint, uncomment the following line.
        // config.setEndpointType("internal");
        com.aliyun.facebody20191230.Client client = new com.aliyun.facebody20191230.Client(config);
        // Set the VPC endpoint for the authentication service based on the region ID. For example: openplatform-vpc.cn-hangzhou.aliyuncs.com.
        client._openPlatformEndpoint="openplatform-vpc.<regionId>.aliyuncs.com";
        RuntimeOptions runtimeOptions = new RuntimeOptions();
        // Read the file and create an input stream.
        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);
        // The response contains the body and headers returned by the server.
        System.out.println(new Gson().toJson(resp.body));
        System.out.println(new Gson().toJson(resp.headers));
    }
}

Apendiks: Menemukan titik akhir

Temukan titik akhir layanan di OpenAPI Explorer:

Dari menu atas, pilih Products, lalu pilih layanan seperti ECS.

2. Di product homepage, temukan list of regions.

3. Pilih titik akhir untuk ID wilayah Anda, lalu salin dan tempel.

Atau, di halaman Debugging API, klik Regions di panel navigasi kiri untuk melihat titik akhir yang tersedia.