Panggil Cloud Control API melalui PrivateLink untuk mengakses layanan secara privat tanpa mengekspos lalu lintas ke internet publik.
Ikhtisar
Apa itu PrivateLink?
PrivateLink membuat koneksi privat antara VPC Anda dan layanan Alibaba Cloud, meningkatkan keamanan dan stabilitas dengan menjaga lalu lintas tetap di luar internet publik.
Kasus penggunaan
PrivateLink direkomendasikan untuk memanggil Cloud Control API dari lingkungan produksi. Kasus penggunaan umum meliputi:
-
Keamanan tinggi dan persyaratan kepatuhan: Kebijakan keamanan perusahaan Anda melarang atau membatasi akses ke internet publik.
-
Optimalisasi biaya: Anda ingin mengurangi biaya transfer data publik dan menekan total biaya kepemilikan (TCO).
-
Penerapan cross-region: Anda perlu menerapkan aplikasi di beberapa wilayah dengan arsitektur jaringan yang terpadu.
Manfaat
|
Manfaat |
Deskripsi |
|
Latensi rendah |
Koneksi privat langsung mengurangi latensi jaringan sebesar 30% hingga 50% dibandingkan akses melalui internet publik. |
|
Stabilitas tinggi |
Menghindari ketidakstabilan internet publik. |
|
Isolasi aman |
Trafik tidak melewati internet publik. |
Prasyarat
Persyaratan izin
Konfigurasi titik akhir PrivateLink memerlukan izin berikut:
-
AliyunVPCFullAccess: Akses penuh ke VPC. -
AliyunPrivateLinkFullAccess: Akses penuh ke PrivateLink.
Persyaratan resource
Pastikan resource berikut tersedia di wilayah layanan Cloud Control API yang ingin Anda panggil:
|
Wilayah layanan API |
Nama domain |
Wilayah VPC |
|
Layanan domestik |
cloudcontrol.aliyuncs.com |
cn-zhangjiakou (China (Zhangjiakou)) |
|
Layanan internasional |
cloudcontrol.ap-southeast-1.aliyuncs.com |
ap-southeast-1 (Singapura) |
Daftar periksa resource:
-
Instans VPC di wilayah target.
-
Setidaknya satu vSwitch yang tersedia di VPC.
-
Pastikan vSwitch memiliki alamat IP yang cukup tersedia.
Wilayah layanan
Cloud Control API tersedia di wilayah berikut. Pilih wilayah sesuai kebutuhan bisnis Anda.
Layanan domestik (cn-zhangjiakou)
-
Layanan titik akhir:
com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api -
Nama domain publik:
cloudcontrol.aliyuncs.com -
Nama domain pribadi:
cloudcontrol.vpc-proxy.aliyuncs.com
Layanan internasional (ap-southeast-1)
-
Layanan titik akhir:
com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol -
Nama domain publik:
cloudcontrol.ap-southeast-1.aliyuncs.com -
Nama domain pribadi:
cloudcontrol-vpc.ap-southeast-1.aliyuncs.com
Setelah mengonfigurasi PrivateLink, perbarui kode aplikasi Anda agar menggunakan nama domain pribadi yang sesuai.
Prosedur
Konfigurasi dalam satu wilayah
Jika aplikasi Anda diterapkan di wilayah yang sama dengan layanan Cloud Control API (cn-zhangjiakou atau ap-southeast-1), Anda dapat membuat titik akhir langsung di wilayah tersebut.
Langkah 1: Masuk ke konsol
-
Masuk ke Konsol VPC.
-
Di panel navigasi kiri, klik Endpoints.
-
Di tab Interface Endpoint, klik Enable PrivateLink .
Langkah 2: Pilih wilayah
Dari daftar drop-down Region, pilih wilayah:
-
Untuk mengakses layanan domestik, pilih China (Zhangjiakou).
-
Untuk mengakses layanan internasional, pilih Singapore.
Langkah 3: Konfigurasi informasi dasar
|
Parameter |
Deskripsi |
Contoh |
|
Endpoint Name |
Masukkan nama deskriptif untuk titik akhir. |
|
|
Endpoint Type |
Pilih Interface Endpoint. |
Interface Endpoint |
|
Resource Type |
Pilih Alibaba Cloud Service. |
Alibaba Cloud Service |
Langkah 4: Pilih layanan titik akhir
-
Di kotak pencarian Endpoint Service, masukkan nama layanan berdasarkan target layanan Anda:
-
Layanan domestik:
com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api -
Layanan internasional:
com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol
-
-
Pilih layanan titik akhir dari hasil pencarian.
Langkah 5: Aktifkan nama domain kustom
Pilih Enable Custom Domain Name. Sistem akan secara otomatis menetapkan nama domain pribadi.
-
Nama domain layanan domestik:
cloudcontrol.vpc-proxy.aliyuncs.com -
Nama domain layanan internasional:
cloudcontrol-vpc.ap-southeast-1.aliyuncs.com
Langkah 6: Konfigurasi pengaturan jaringan
|
Parameter |
Deskripsi |
Praktik terbaik |
|
VPC |
Pilih VPC tempat aplikasi Anda diterapkan. |
Verifikasi bahwa VPC sesuai dengan penerapan aplikasi Anda. |
|
Zone and vSwitch |
Pilih setidaknya satu vSwitch. Kami merekomendasikan memilih beberapa vSwitch untuk ketersediaan tinggi. |
Untuk lingkungan produksi, pilih vSwitch di dua hingga tiga zona berbeda. |
|
Security group |
Pilih security group untuk membatasi sumber akses. |
Konfigurasikan aturan yang hanya mengizinkan akses dari security group aplikasi Anda. |
Contoh konfigurasi multi-zona:
Zone A: vsw-xxxxx
Zone B: vsw-yyyyy
Langkah 7: Konfigurasi kebijakan titik akhir
Kebijakan titik akhir menentukan Akun Alibaba Cloud atau Pengguna RAM mana yang dapat mengakses layanan melalui titik akhir tersebut.
Berikan akses hanya kepada akun yang diperlukan berdasarkan prinsip hak istimewa minimal.
Kebijakan default (mengizinkan semua):
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Principal": "*",
"Action": "*",
"Resource": "*"
}
]
}
Kebijakan yang direkomendasikan (hanya mengizinkan akun saat ini):
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Aliyun": [
"acs:ram::YOUR_ACCOUNT_ID:root"
]
},
"Action": "*",
"Resource": "*"
}
]
}
Langkah 8: Buat dan verifikasi
-
Klik OK untuk membuat titik akhir.
-
Tunggu 2 hingga 5 menit hingga status titik akhir menjadi Active.
-
Status koneksi berubah menjadi Connected.
Deskripsi status:
-
Creating: Titik akhir sedang dibuat.
-
Active: Titik akhir siap digunakan.
-
Abnormal: Pembuatan gagal atau koneksi tidak berfungsi. Periksa konfigurasi Anda.
Setelah titik akhir dibuat, verifikasi hal berikut di halaman detailnya: pada bagian Basic Information, Status bernilai Active dan Connection Status bernilai Connected. Di bagian Endpoint Service Domain Name, pastikan Custom Domain Name diaktifkan dan menampilkan domain yang diharapkan.
Konfigurasi cross-region
Untuk terhubung dari wilayah selain cn-zhangjiakou atau ap-southeast-1, Anda harus menggunakan CEN untuk membuat koneksi cross-region.
Langkah 1: Buat titik akhir di wilayah target
-
Buat titik akhir di
cn-zhangjiakouatauap-southeast-1. Untuk petunjuknya, lihat Konfigurasi dalam satu wilayah. -
Catat ID VPC tempat titik akhir berada.
Langkah 2: Hubungkan wilayah dengan CEN
Untuk informasi tentang cara mengonfigurasi CEN, lihat Hubungkan VPC lintas wilayah.
Verifikasi dan pengujian
Verifikasi konektivitas
Masuk ke instans ECS atau kontainer tempat aplikasi Anda berjalan dan jalankan perintah berikut:
Verifikasi layanan domestik:
curl -v cloudcontrol.vpc-proxy.aliyuncs.com
Verifikasi layanan internasional:
curl -v cloudcontrol-vpc.ap-southeast-1.aliyuncs.com
Indikator keberhasilan:
Koneksi yang berhasil mencakup header x-acs-request-id dalam respons HTTP. Contoh output:
< HTTP/1.1 401 Unauthorized
< date: Thu, 09 Oct 2025 10:30:00 GMT
< content-type: application/json
< x-acs-request-id: 23C12345-1234-1234-1234-123456789ABC
< x-acs-trace-id: 0b12345678901234567890123456789a
...
API diharapkan mengembalikan kode status 401 karena permintaan tidak menyertakan kredensial.
Kehadiran header x-acs-request-id mengonfirmasi bahwa permintaan telah mencapai titik akhir layanan Alibaba Cloud melalui koneksi privat.
Contoh integrasi aplikasi
Contoh Java
import com.aliyun.cloudcontrol20220830.Client;
import com.aliyun.teaopenapi.models.Config;
public class PrivateLinkExample {
public static void main(String[] args) throws Exception {
// Konfigurasikan client.
Config config = new Config()
.setAccessKeyId("<YOUR-ACCESS-KEY-ID>")
.setAccessKeySecret("<YOUR-ACCESS-KEY-SECRET>")
// Gunakan titik akhir privat.
// Untuk layanan domestik
.setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com")
.setHost("cloudcontrol.aliyuncs.com")
// Untuk layanan internasional
// .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com")
.setProtocol("https");
Client client = new Client(config);
// Gunakan objek client untuk panggilan API selanjutnya.
try {
var response = client.listResources(...);
System.out.println("Permintaan berhasil: " + response.getBody().getRequestId());
} catch (Exception e) {
System.err.println("Permintaan gagal: " + e.getMessage());
}
}
}