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

Saat menggunakan SDK V2.0 untuk memanggil operasi OpenAPI, Anda harus mengonfigurasi titik akhir layanan Alibaba Cloud yang dituju. Saat membuat resource, pilih titik akhir wilayah yang secara fisik paling dekat dengan bisnis Anda guna mengurangi latensi jaringan dan meningkatkan kecepatan respons. Saat melakukan kueri, pembaruan, atau penghapusan resource, pilih titik akhir wilayah tempat resource tersebut berada karena penyimpanan resource bersifat spesifik per wilayah; operasi lintas wilayah dapat gagal atau menimbulkan risiko ketidakkonsistenan data. Topik ini menjelaskan cara mengonfigurasi titik akhir di SDK V2.0.

Jenis titik akhir

Titik akhir terbagi menjadi dua kategori: Titik akhir publik dan Titik akhir VPC. Jika bisnis Anda diterapkan di VPC—misalnya pada ECS atau ACK—Anda dapat mengakses resource cloud di VPC tersebut melalui Titik akhir VPC. Titik akhir VPC meningkatkan keamanan dan mengurangi latensi jaringan. Untuk informasi selengkapnya, lihat Endpoints.

Tetapkan titik akhir

SDK V2.0 menyediakan dua cara untuk menetapkan titik akhir: menentukan titik akhir secara eksplisit atau menentukan ID wilayah untuk mendapatkan titik akhir secara otomatis.

Metode 1: Tentukan titik akhir (disarankan)

Anda dapat menentukan titik akhir saat menginisialisasi objek client layanan cloud. Baik Titik akhir publik maupun Titik akhir VPC didukung.

Contoh berikut hanya menampilkan konfigurasi terkait titik akhir:

com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
// Set the endpoint.
config.setEndpoint("<ENDPOINT>");

Metode 2: Tentukan ID wilayah

Jika Anda tidak menentukan titik akhir, Anda dapat menentukan ID wilayah saat menginisialisasi objek client layanan cloud. SDK kemudian akan menyelesaikan titik akhir yang sesuai secara otomatis.

Logika penentuan alamat adalah sebagai berikut:

Sebagian besar SDK layanan cloud mendefinisikan endpointMap yang memetakan ID wilayah ke titik akhir. Sebagai contoh, endpointMap dalam SDK ECS adalah sebagai berikut:

{
    "ap-northeast-2-pop": "ecs.aliyuncs.com",
    "cn-beijing-finance-pop": "ecs.aliyuncs.com",
    "cn-beijing-gov-1": "ecs.aliyuncs.com",
    "cn-beijing-nu16-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-edge-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "cn-fujian": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-haidian-cm12-c01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-bj-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-finance": "ecs.aliyuncs.com",
    "cn-hangzhou-internal-prod-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-2": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-3": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-test-306": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hongkong-finance-pop": "ecs.aliyuncs.com",
    "cn-huhehaote-nebula-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "cn-north-2-gov-1": "ecs.aliyuncs.com",
    "cn-shanghai-et15-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-et2-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-finance-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-inner": "ecs.aliyuncs.com",
    "cn-shanghai-internal-test-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-finance-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-inner": "ecs.aliyuncs.com",
    "cn-shenzhen-st4-d01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-su18-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-wuhan": "ecs.aliyuncs.com",
    "cn-yushanfang": "ecs.aliyuncs.com",
    "cn-zhangbei": "ecs.aliyuncs.com",
    "cn-zhangbei-na61-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-zhangjiakou-na62-a01": "ecs.cn-zhangjiakou.aliyuncs.com",
    "cn-zhengzhou-nebula-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "eu-west-1-oxs": "ecs.cn-shenzhen-cloudstone.aliyuncs.com",
    "rus-west-1-pop": "ecs.aliyuncs.com"
}

Jika endpointMap tidak tersedia, SDK akan membentuk titik akhir berdasarkan aturan pembentukan.
Jika endpointMap tersedia dan berisi ID wilayah yang ditentukan, titik akhir adalah nilai yang dipetakan ke ID wilayah tersebut.
Jika endpointMap tidak berisi ID wilayah yang ditentukan, SDK akan membentuk titik akhir berdasarkan aturan pembentukan.

Aturan pembentukan adalah sebagai berikut:

Layanan regional: <PRODUCT_CODE><SUFFIX><NET_WORK>.<REGION_ID>.aliyuncs.com
Layanan terpusat: <PRODUCT_CODE><SUFFIX><NET_WORK>.aliyuncs.com

Jenis penerapan dan <PRODUCT_CODE> ditentukan oleh SDK layanan cloud yang Anda gunakan. Tentukan tiga parameter lainnya sesuai skenario Anda:

<SUFFIX>: sufiks dalam Titik akhir VPC. Tentukan parameter ini berdasarkan sufiks pada Titik akhir VPC layanan cloud tersebut. Jangan tambahkan tanda hubung (-).
<NET_WORK>: jenis titik akhir. Titik akhir publik digunakan secara default. Nilai yang valid:
- vpc: mendapatkan Titik akhir VPC layanan tersebut.
- intranet: saat menggunakan SDK Simple Log Service (sls20201230), mendapatkan Titik akhir VPC Simple Log Service.
- accelerate: saat menggunakan SDK Simple Log Service (sls20201230), mendapatkan titik akhir akselerasi transfer Simple Log Service.
<REGION_ID>: wilayah tempat resource berada.

Catatan

Format Titik akhir VPC sangat bervariasi. Untuk mengonfigurasi Titik akhir VPC, tentukan titik akhir tersebut dengan Metode 1, bukan dengan membentuknya dari ID wilayah.

Contoh berikut hanya menampilkan konfigurasi terkait titik akhir:

com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
// Specify the region ID.
config.setRegionId("<REGION_ID>");
config.setNetwork("<NET_WORK>"); // You do not need to set this parameter for a public endpoint. For a VPC endpoint, set it to vpc.
config.setSuffix("<SUFFIX>"); // You do not need to set this parameter for a public endpoint. For a VPC endpoint, specify it based on the suffix in the VPC endpoint of the cloud service and do not add a hyphen (-).

Lampiran: Temukan titik akhir

Anda dapat menemukan titik akhir layanan cloud di OpenAPI portal:

Dari menu atas portal, pilih Products dan pilih produk, seperti ECS.
Di product homepage, temukan list of service regions.
Pilih titik akhir yang sesuai dengan ID wilayah Anda, lalu salin dan tempel.

Alternatifnya, pada halaman debugging API, klik Regions di panel navigasi sebelah kiri untuk melihat titik akhir yang didukung oleh layanan cloud tersebut.