All Products
Search
Document Center

Cloud Control API:Panggil Cloud Control API melalui PrivateLink

Last Updated:Aug 21, 2026

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

Penting

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

  1. Masuk ke Konsol VPC.

  2. Di panel navigasi kiri, klik Endpoints.

  3. 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.

ep-cloudcontrol-prod

Endpoint Type

Pilih Interface Endpoint.

Interface Endpoint

Resource Type

Pilih Alibaba Cloud Service.

Alibaba Cloud Service

Langkah 4: Pilih layanan titik akhir

  1. 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

  2. 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.

Catatan

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

  1. Klik OK untuk membuat titik akhir.

  2. Tunggu 2 hingga 5 menit hingga status titik akhir menjadi Active.

  3. 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-zhangjiakou atau ap-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
...
Catatan

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());
        }
    }
}