Cloud Control API:PrivateLink 経由での Cloud Control API の呼び出し

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

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

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

3. [Interface Endpoint] タブで、 [Enable PrivateLink] をクリックします。

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

[Region] ドロップダウンリストから、リージョンを選択します：

• 国内サービスにアクセスするには、[中国（張家口）] を選択します。

• 国際サービスにアクセスするには、[シンガポール]を選択します。

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

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

1. [エンドポイントサービス] 検索ボックスには、対象のサービスに応じてサービス名を入力します：

   • 国内サービス：com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

   • 国際サービス：com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

2. 検索結果からエンドポイントサービスを選択します。

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

[カスタムドメイン名を有効化] を選択します。システムが自動的にプライベートドメイン名を割り当てます。

• 国内サービスのドメイン名：cloudcontrol.vpc-proxy.aliyuncs.com

• 国際サービスのドメイン名：cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

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

複数ゾーン設定の例：

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

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

エンドポイントポリシーは、どのアカウントまたは RAM ユーザーがエンドポイント経由でサービスにアクセスできるかを定義します。

デフォルトポリシー (すべてを許可)：

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

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

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

ステップ8：作成と検証

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

2. エンドポイントのステータスが [アクティブ] になるまで 2〜5 分待ちます。

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

ステータスの説明：

• 作成中：エンドポイントが作成されています。

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

• 異常：作成に失敗したか、接続が機能していません。設定を確認してください。
  エンドポイントが作成された後、その詳細ページで以下を確認します：[Basic Information] セクションで、[Status] が アクティブ であり、[Connection Status] が 接続済み であること、[Endpoint Service Domain Name] セクションで、[Custom Domain Name] が有効になっており、想定されるドメインが表示されていることを確認します。
  
  
  
  

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

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

• エンドポイントが配置されている VPC の ID を記録します。

ステップ2：CEN を使用したリージョン間接続

CEN の設定方法については、「リージョン間での VPC 接続」をご参照ください。

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>")
            // プライベートエンドポイントを使用するようにクライアントを設定します。
            // ご利用のサービスに応じて、以下のいずれかの設定を有効にしてください。

            // --- 国内サービス (cn-zhangjiakou) の場合 ---
            .setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com")
            .setHost("cloudcontrol.aliyuncs.com")

            // --- 国際サービス (ap-southeast-1) の場合 ---
            // 上記の国内サービス用の設定をコメントアウトし、
            // 以下の2行のコメントを解除してください。
            // .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com")
            // .setHost("cloudcontrol.ap-southeast-1.aliyuncs.com")
            
            .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());
        }
    }
}