すべてのプロダクト
Search
ドキュメントセンター

Cloud Control API:PrivateLink 経由でのクラウドコントロール API の呼び出し

最終更新日:Jan 27, 2026

PrivateLink 接続を介してクラウドコントロール API を呼び出し、クラウドサービスにアクセスできます。これにより、インターネットアクセスから生じる潜在的なセキュリティリスクを回避できます。

概要

PrivateLink とは

PrivateLink は、VPC (Virtual Private Cloud) と他の Alibaba Cloud サービスとの間にプライベートな接続を確立するサービスです。これらの接続はインターネットアクセスを回避し、セキュリティと安定性を向上させます。

利用シーン

ご利用のアプリケーションが Alibaba Cloud の本番環境で実行されており、クラウドコントロール API を呼び出す必要がある場合、PrivateLink を使用して内部ネットワーク経由で呼び出すことができます。このソリューションは、以下のユースケースに適しています:

  • 高いセキュリティとコンプライアンス要件:企業のセキュリティポリシーにより、インターネットアクセスが禁止または制限されている場合。

  • コストの最適化:データ転送コストを削減し、総所有コスト (TCO) を低減したい場合。

  • リージョン間デプロイメント:複数のリージョンにアプリケーションをデプロイする必要があり、統一されたネットワークアーキテクチャが求められる場合。

メリット

メリット

説明

低レイテンシー

イントラネットアクセスにより、インターネットアクセスと比較してネットワーク遅延が 30% から 50% 削減されます。

高い安定性

インターネットの変動性を回避することで、一貫したパフォーマンスを提供します。

セキュリティ分離

トラフィックはインターネットを経由しません。

前提条件

権限要件

PrivateLink エンドポイントを設定するには、以下の権限が必要です:

  • AliyunVPCFullAccess:VPC へのフルアクセスを提供します。

  • AliyunPrivateLinkFullAccess:PrivateLink へのフルアクセスを提供します。

VPC リージョンの要件

サポートされる VPC リージョンは、使用したいクラウドコントロール API サービスがデプロイされているリージョンによって異なります:

クラウドコントロール API サービス

パブリックドメイン名

サポートされる VPC リージョン

中国国内

cloudcontrol.aliyuncs.com

中国 (張家口) (リージョン ID: cn-zhangjiakou)

中国国外

cloudcontrol.ap-southeast-1.aliyuncs.com

シンガポール (リージョン ID: ap-southeast-1)

リソースのチェックリスト

  • ターゲットリージョン内の VPC。

  • VPC 内に少なくとも 1 つの利用可能な vSwitch。

  • vSwitch には十分な数の利用可能な IP アドレスが必要です。

サービスリージョンの詳細

クラウドコントロール API サービスは、以下のリージョンで利用可能です。必要に応じてリージョンを選択できます。

中国国内 (cn-zhangjiakou)

  • エンドポイントサービスcom.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

  • パブリックドメイン名cloudcontrol.aliyuncs.com

  • プライベートドメイン名cloudcontrol.vpc-proxy.aliyuncs.com

中国国外 (ap-southeast-1)

  • エンドポイントサービスcom.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

  • パブリックドメイン名cloudcontrol.ap-southeast-1.aliyuncs.com

  • プライベートドメイン名cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

重要

PrivateLink 接続を設定した後、アプリケーションコード内のクラウドコントロール API のパブリックドメイン名を、対応するプライベートドメイン名に変更する必要があります。

操作手順

同一リージョン内の設定

ご利用のアプリケーションが cn-zhangjiakou または ap-southeast-1 にデプロイされている場合、同一リージョン内に直接エンドポイントを作成できます。

ステップ 1:コンソールへのログイン

  1. VPC コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[エンドポイント] をクリックします。

  3. [インターフェイスエンドポイント] タブで、[エンドポイントの作成] をクリックします。

image

ステップ 2:リージョンの選択

[リージョン] ドロップダウンリストから、以下のいずれかのリージョンを選択します:

  • 中国国内のクラウドコントロール API サービスを使用する場合は、[中国 (張家口)] を選択します。

    image.png

  • 中国国外のクラウドコントロール API サービスを使用する場合は、[シンガポール] を選択します。

    image.png

ステップ 3:基本情報の設定

パラメーター

説明

エンドポイント名

エンドポイントの名前を入力します。分かりやすい名前を使用してください。

ep-cloudcontrol-prod

エンドポイントタイプ

インターフェイスエンドポイントを選択します。

インターフェイスエンドポイント

エンドポイントサービス

Alibaba Cloud サービスを選択します。

Alibaba Cloud サービス

ステップ 4:エンドポイントサービスの選択

  1. エンドポイントサービスの検索ボックスに、ターゲットサービスの名前を入力します:

    • 中国国内のクラウドコントロール API サービスを使用する場合com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

    • 中国国外のクラウドコントロール API サービスを使用する場合com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

  2. 検索により一意のエンドポイントサービスが返されます。そのサービスを選択します。

ステップ 5:カスタムドメイン名の有効化

[カスタムドメイン名の有効化] を選択します。システムによってプライベートドメイン名が自動的に割り当てられます。手動で入力する必要はありません。

  • 中国国内のクラウドコントロール API サービス:cloudcontrol.vpc-proxy.aliyuncs.com

  • 中国国外のクラウドコントロール API サービス:cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

image

ステップ 6:ネットワーク設定

パラメーター

説明

ベストプラクティス

VPC

ご利用のアプリケーションが配置されている VPC を選択します。

正しい VPC を選択していることを確認してください。

ゾーンと vSwitch

少なくとも 1 つの vSwitch を選択します。高可用性 (HA) のためには、複数の vSwitch を選択してください。

本番環境では、2 つまたは 3 つの異なるゾーンにある vSwitch を選択します。

セキュリティグループ

アクセス元を制限するためにセキュリティグループを選択します。

ご利用のアプリケーションのセキュリティグループに設定します。

マルチゾーン設定の例

ゾーン A:vsw-xxxxx 
ゾーン B:vsw-yyyyy 


image.png

ステップ 7:エンドポイントポリシーの設定

エンドポイントポリシーは、どの Alibaba Cloud アカウントまたは Resource Access Management (RAM) ユーザーがエンドポイント経由でサービスにアクセスできるかを制御します。

説明

最小権限の原則に従い、必要なアカウントにのみアクセスを許可してください。

デフォルトのエンドポイントポリシー (すべてを許可):

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

推奨ポリシー (現在のアカウントのみを許可):

{
  "Version": "1", 
  "Statement": [
    {
      "Effect": "Allow", 
      "Principal":{
        "Aliyun":[
          "acs:ram::ご利用のアカウントID:root"
        ]
      }, 
      "Action":"*", 
      "Resource":"*"
    }
  ]
}

ステップ 8:エンドポイントの作成と設定の確認

  1. [OK] をクリックしてエンドポイントを作成します。

  2. 2~5 分でエンドポイントのステータスが [アクティブ] に変わります。

  3. 接続ステータスが [接続済み] に変わります

ステータスの説明

  • 作成中:エンドポイントが作成中です。

  • アクティブ:エンドポイントが使用可能な状態です。

  • 異常:作成に失敗したか、接続が異常です。設定を確認してください。
    image.png

リージョン間の設定

ご利用のアプリケーションが cn-zhangjiakou または ap-southeast-1 以外のリージョンにデプロイされている場合、Cloud Enterprise Network (CEN) を使用してリージョン間の接続を確立する必要があります。

ステップ 1:ターゲットリージョンでのエンドポイントの作成

  • cn-zhangjiakou または ap-southeast-1 にエンドポイントを作成します。詳細については、本トピックの「同一リージョン内の設定」セクションをご参照ください。

  • エンドポイントが配置されている VPC の ID をメモしておきます。

ステップ 2:CEN インスタンスを作成してリージョンを接続

CEN の設定方法の詳細については、「異なるリージョン内の VPC を接続」をご参照ください。

検証とテスト

接続性の検証

ご利用のアプリケーションがデプロイされている ECS インスタンスまたはコンテナーにログインし、以下のコマンドを実行して接続性を検証します:

中国国内のクラウドコントロール API サービス

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

中国国外のクラウドコントロール API サービス

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

検証の成功

返された HTTP ヘッダーに x-acs-request-id が含まれている場合、リクエストは成功です。以下のコードは出力例です:

< 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 は 401 ステータスコードを返すことが想定されます。

このテストの目的は、リクエストが Alibaba Cloud API Gateway またはサービスによって適切に処理されていることを確認することです。これを行うには、応答ヘッダーに x-acs-request-id のような Alibaba Cloud 固有のフィールドが含まれていることを確認します。

アプリケーションの統合例

Java の例

import com.aliyun.cloudcontrol20220830.Client;
import com.aliyun.teaopenapi.models.Config;

public class PrivateLinkExample {
    public static void main(String[] args) throws Exception {
        // クライアントを設定します。
        Config config = new Config()
            .setAccessKeyId("<YOUR-ACCESS-KEY-ID>")
            .setAccessKeySecret("<YOUR-ACCESS-KEY-SECRET>")
            // プライベートドメイン名を使用します。
            . setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com") // 中国国内のクラウドコントロール API サービスの場合
            . setHost("cloudcontrol.aliyuncs.com") // 中国国内のクラウドコントロール API サービスの場合
            // .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com") // 中国国外のクラウドコントロール API サービスの場合
            .setProtocol("https");
        
        Client client = new Client(config);
        
        // クライアントオブジェクトを使用して API 呼び出しを行います
        try {
            var response = client.listResources(...);
            System.out.println("Request successful: " + response.getBody().getRequestId());
        } catch (Exception e) {
            System.err.println("Request failed: " + e.getMessage());
        }
    }
}