Tüm Ürünler
Search
Belge Merkezi

Cloud Control API:Call the Cloud Control API through PrivateLink

Son Güncelleme:Oct 07, 2026

Cloud Control API'yi PrivateLink üzerinden çağırarak trafiği genel internete açmadan hizmete özel olarak erişin.

Genel Bakış

PrivateLink nedir?

PrivateLink; VPC'niz ile Alibaba Cloud hizmetleri arasında özel bağlantılar kurar ve trafiği genel internetten uzak tutarak güvenliği ve kararlılığı artırır.

Kullanım senaryoları

Cloud Control API'yi üretim ortamlarından çağırmak için PrivateLink önerilir. Tipik kullanım senaryoları şunlardır:

  • Yüksek güvenlik ve uyumluluk gereksinimleri: Kurumsal güvenlik ilkeniz genel internet erişimini yasaklar veya kısıtlar.

  • Maliyet optimizasyonu: Genel veri aktarım ücretlerini azaltmak ve toplam sahip olma maliyetinizi (TCO) düşürmek istersiniz.

  • Bölgeler arası dağıtım: Uygulamaları tek bir ağ mimarisiyle birden çok bölgede dağıtmanız gerekir.

Avantajlar


Avantaj


Açıklama


Düşük gecikme süresi


Doğrudan özel bağlantılar, genel internet erişimine kıyasla ağ gecikme süresini %30 ila %50 oranında azaltır.


Yüksek kararlılık


Genel internetin değişkenliğinden kaçınır.


Güvenli yalıtım


Trafik genel internet üzerinden geçmez.

Ön Koşullar

İzin gereksinimleri

Bir PrivateLink uç noktası yapılandırmak için aşağıdaki izinler gerekir:

  • AliyunVPCFullAccess: VPC için tam erişim.

  • AliyunPrivateLinkFullAccess: PrivateLink için tam erişim.

Kaynak gereksinimleri

Çağırmak istediğiniz Cloud Control API hizmetinin bulunduğu bölgede aşağıdaki kaynakların mevcut olduğundan emin olun:


API hizmet bölgesi


Etki alanı adı


VPC bölgesi


Yerel hizmet


cloudcontrol.aliyuncs.com


cn-zhangjiakou (China (Zhangjiakou))


Uluslararası hizmet


cloudcontrol.ap-southeast-1.aliyuncs.com


ap-southeast-1 (Singapore)

Kaynak kontrol listesi:

  • Hedef bölgede bir VPC örneği.

  • VPC'de en az bir kullanılabilir vSwitch.

  • vSwitch'in yeterli kullanılabilir IP adresine sahip olduğundan emin olun.

Hizmet bölgeleri

Cloud Control API aşağıdaki bölgelerde kullanılabilir. İş ihtiyaçlarınıza göre bir bölge seçin.

Yerel hizmet (cn-zhangjiakou)

  • Uç nokta hizmeti: com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

  • Genel etki alanı adı: cloudcontrol.aliyuncs.com

  • Özel etki alanı adı: cloudcontrol.vpc-proxy.aliyuncs.com

Uluslararası hizmet (ap-southeast-1)

  • Uç nokta hizmeti: com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

  • Genel etki alanı adı: cloudcontrol.ap-southeast-1.aliyuncs.com

  • Özel etki alanı adı: cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

Önemli

PrivateLink'i yapılandırdıktan sonra uygulama kodunuzu ilgili özel etki alanı adını kullanacak şekilde güncelleyin.

Yordam

Aynı bölge yapılandırması

Uygulamanız Cloud Control API hizmetiyle aynı bölgede dağıtılmışsa (cn-zhangjiakou veya ap-southeast-1), uç noktayı doğrudan o bölgede oluşturabilirsiniz.

Adım 1: Konsola oturum açın

  1. VPC konsoluna oturum açın.

  2. Sol gezinme bölmesinde Endpoints öğesini tıklayın.

  3. Interface Endpoint sekmesinde Enable PrivateLink öğesini tıklayın.

Adım 2: Bir bölge seçin

Region açılır listesinden bir bölge seçin:

  • Yerel hizmete erişmek için China (Zhangjiakou) seçeneğini belirleyin.

  • Uluslararası hizmete erişmek için Singapore seçeneğini belirleyin.

Adım 3: Temel bilgileri yapılandırın


Parametre


Açıklama


Örnek


Endpoint Name


Uç nokta için açıklayıcı bir ad girin.


ep-cloudcontrol-prod


Endpoint Type


Interface Endpoint seçeneğini belirleyin.


Interface Endpoint


Resource Type


Alibaba Cloud Service seçeneğini belirleyin.


Alibaba Cloud Service

Adım 4: Bir uç nokta hizmeti seçin

  1. Endpoint Service arama kutusuna hedef hizmetinize göre hizmet adını girin:

    • Yerel hizmet: com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

    • Uluslararası hizmet: com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

  2. Arama sonuçlarından uç nokta hizmetini seçin.

Adım 5: Özel bir etki alanı adını etkinleştirin

Enable Custom Domain Name seçeneğini belirleyin. Sistem otomatik olarak bir özel etki alanı adı atar.

  • Yerel hizmet etki alanı adı: cloudcontrol.vpc-proxy.aliyuncs.com

  • Uluslararası hizmet etki alanı adı: cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

Adım 6: Ağ ayarlarını yapılandırın


Parametre


Açıklama


En iyi uygulama


VPC


Uygulamanızın dağıtıldığı VPC'yi seçin.


VPC'nin uygulama dağıtımınızla eşleştiğini doğrulayın.


Zone and vSwitch


En az bir vSwitch seçin. Yüksek kullanılabilirlik için birden çok vSwitch seçmenizi öneririz.


Üretim ortamları için iki ila üç farklı alandaki vSwitch'leri seçin.


Security group


Erişim kaynaklarını kısıtlamak için bir güvenlik grubu seçin.


Yalnızca uygulamanızın güvenlik grubundan erişime izin veren kuralları yapılandırın.

Çoklu alan yapılandırma örneği:

Zone A: vsw-xxxxx 
Zone B: vsw-yyyyy 

Adım 7: Bir uç nokta ilkesi yapılandırın

Bir uç nokta ilkesi, hangi Alibaba Cloud hesaplarının veya RAM kullanıcılarının uç nokta üzerinden hizmete erişebileceğini tanımlar.

Not

En az ayrıcalık ilkesine göre yalnızca gerekli hesaplara erişim izni verin.

Varsayılan ilke (tümüne izin verir):

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "*",
      "Resource": "*"
    }
  ]
}

Önerilen ilke (yalnızca geçerli hesaba izin verir):

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Aliyun": [
          "acs:ram::YOUR_ACCOUNT_ID:root"
        ]
      },
      "Action": "*",
      "Resource": "*"
    }
  ]
}

Adım 8: Oluşturun ve doğrulayın

  1. Uç noktayı oluşturmak için OK öğesini tıklayın.

  2. Uç nokta durumunun Active olması için 2 ila 5 dakika bekleyin.

  3. Bağlantı durumu Connected. olarak değişir.

Durum açıklamaları:

  • Creating: Uç nokta oluşturuluyor.

  • Active: Uç nokta kullanıma hazır.

  • Abnormal: Oluşturma başarısız oldu veya bağlantı çalışmıyor. Yapılandırmanızı kontrol edin. Uç nokta oluşturulduktan sonra ayrıntılar sayfasında şunları doğrulayın: Basic Information bölümünde Status değeri Active ve Connection Status değeri Connected olmalıdır. Endpoint Service Domain Name bölümünde Custom Domain Name özelliğinin etkinleştirildiğini ve beklenen etki alanını gösterdiğini onaylayın.

Bölgeler arası yapılandırma

cn-zhangjiakou veya ap-southeast-1 dışındaki bir bölgeden bağlanmak için bölgeler arası bağlantı kurmak amacıyla CEN kullanmanız gerekir.

Adım 1: Hedef bölgede uç nokta oluşturun

  • cn-zhangjiakou veya ap-southeast-1 bölgesinde bir uç nokta oluşturun. Talimatlar için Aynı bölge yapılandırması konusuna bakın.

  • Uç noktanın bulunduğu VPC'nin ID'sini kaydedin.

Adım 2: Bölgeleri CEN ile bağlayın

CEN'i nasıl yapılandıracağınız hakkında bilgi için Bölgeler arasında VPC'leri bağlama konusuna bakın.

Doğrulama ve test

Bağlantıyı doğrulayın

Uygulamanızı çalıştıran ECS veya konteyner örneğine oturum açın ve aşağıdaki komutu çalıştırın:

Yerel hizmet doğrulaması:

curl -v cloudcontrol.vpc-proxy.aliyuncs.com

Uluslararası hizmet doğrulaması:

curl -v cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

Başarı göstergesi:

Başarılı bir bağlantıda HTTP yanıtında bir x-acs-request-id başlığı bulunur. Örnek çıktı:

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

İstek kimlik bilgilerini içermediği için API'nin bir 401 durum kodu döndürmesi beklenir.

x-acs-request-id başlığının varlığı, isteğin özel bağlantı üzerinden Alibaba Cloud hizmet uç noktasına ulaştığını doğrular.

Uygulama entegrasyon örneği

Java örneği

import com.aliyun.cloudcontrol20220830.Client;
import com.aliyun.teaopenapi.models.Config;
public class PrivateLinkExample {
    public static void main(String[] args) throws Exception {
        // Configure the client.
        Config config = new Config()
            .setAccessKeyId("<YOUR-ACCESS-KEY-ID>")
            .setAccessKeySecret("<YOUR-ACCESS-KEY-SECRET>")
            // Use the private endpoint.
            // For the domestic service
            .setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com")
            .setHost("cloudcontrol.aliyuncs.com")
            // For the international service
            // .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com")
            .setProtocol("https");
        Client client = new Client(config);
        // Use the client object for subsequent API calls.
        try {
            var response = client.listResources(...);
            System.out.println("Request successful: " + response.getBody().getRequestId());
        } catch (Exception e) {
            System.err.println("Request failed: " + e.getMessage());
        }
    }
}