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
|
|
|
|
|
|
|
|
|
|
|
|
Ö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:
|
|
|
|
|
|
|
|
|
|
|
|
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-apiGenel 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.cloudcontrolGenel etki alanı adı:
cloudcontrol.ap-southeast-1.aliyuncs.comÖzel etki alanı adı:
cloudcontrol-vpc.ap-southeast-1.aliyuncs.com
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
VPC konsoluna oturum açın.
Sol gezinme bölmesinde Endpoints öğesini tıklayın.
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Adım 4: Bir uç nokta hizmeti seçin
-
Endpoint Service arama kutusuna hedef hizmetinize göre hizmet adını girin:
Yerel hizmet:
com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-apiUluslararası hizmet:
com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol
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.comUluslararası hizmet etki alanı adı:
cloudcontrol-vpc.ap-southeast-1.aliyuncs.com
Adım 6: Ağ ayarlarını 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.
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
Uç noktayı oluşturmak için OK öğesini tıklayın.
Uç nokta durumunun Active olması için 2 ila 5 dakika bekleyin.
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-zhangjiakouveyaap-southeast-1bö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
...
İ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());
}
}
}