パブリック IP アドレスを持たない仮想プライベートクラウド (VPC) 内の Elastic Compute Service (ECS) インスタンスからは、API オペレーションを呼び出すことはできません。このトピックでは、これらのインスタンスから Alibaba Cloud 内部ネットワーク経由で API オペレーションを呼び出す方法について説明します。
背景情報
ECS はパブリックエンドポイントを提供します。ECS インスタンスにパブリック帯域幅またはパブリック IP アドレスがない場合、Alibaba Cloud コマンドラインインターフェイス (CLI) やソフトウェア開発キット (SDK) などのツールを使用して API オペレーションを呼び出すことはできません。この場合、以下の 2 つの方法のいずれかを使用して、Alibaba Cloud 内部ネットワーク経由で API オペレーションを呼び出すことができます。
-
SDK:Java 用の SDK コアライブラリ V4.5.3 以降では、VPC 内の内部ネットワーク経由での API オペレーションの呼び出しをサポートしています。
-
CLI:CLI を使用する場合、対応するリージョンのエンドポイントに変更することで、内部ネットワーク経由で API オペレーションを呼び出します。
注:
-
これら 2 つの方法はリージョン固有です。エンドポイントを使用して、ECS インスタンスと同じリージョン内のリソースのみを管理できます。クロスリージョンでのオペレーションはサポートしていません。
-
ECS インスタンスを作成するには、Alibaba Cloud CLI または SDK がすでにデプロイされているカスタムイメージを使用してください。これにより、インスタンスがインターネットにアクセスできないために依存関係の読み込みに失敗するのを防ぎます。
次の表に、内部ネットワーク経由での API オペレーションの呼び出しをサポートする ECS エンドポイントを示します。使用するエンドポイントがこの表に記載されていることを確認してください。
|
Alibaba Cloud リージョン |
リージョン ID |
エンドポイント |
|
中国 (杭州) |
cn-hangzhou |
ecs-vpc.cn-hangzhou.aliyuncs.com |
|
中国 (上海) |
cn-shanghai |
ecs-vpc.cn-shanghai.aliyuncs.com |
|
中国 (青島) |
cn-qingdao |
ecs-vpc.cn-qingdao.aliyuncs.com |
|
中国 (北京) |
cn-beijing |
ecs-vpc.cn-beijing.aliyuncs.com |
|
中国 (張家口) |
cn-zhangjiakou |
ecs-vpc.cn-zhangjiakou.aliyuncs.com |
|
中国 (フフホト) |
cn-huhehaote |
ecs-vpc.cn-huhehaote.aliyuncs.com |
|
中国 (ウランチャブ) |
cn-wulanchabu |
ecs-vpc.cn-wulanchabu.aliyuncs.com |
|
中国 (深圳) |
cn-shenzhen |
ecs-vpc.cn-shenzhen.aliyuncs.com |
|
中国 (河源) |
cn-heyuan |
ecs-vpc.cn-heyuan.aliyuncs.com |
|
中国 (広州) |
cn-guangzhou |
ecs-vpc.cn-guangzhou.aliyuncs.com |
|
中国 (成都) |
cn-chengdu |
ecs-vpc.cn-chengdu.aliyuncs.com |
|
中国 (香港) |
cn-hongkong |
ecs-vpc.cn-hongkong.aliyuncs.com |
|
シンガポール |
ap-southeast-1 |
ecs-vpc.ap-southeast-1.aliyuncs.com |
|
マレーシア (クアラルンプール) |
ap-southeast-3 |
ecs-vpc.ap-southeast-3.aliyuncs.com |
|
インドネシア (ジャカルタ) |
ap-southeast-5 |
ecs-vpc.ap-southeast-5.aliyuncs.com |
|
フィリピン (マニラ) |
ap-southeast-6 |
ecs-vpc.ap-southeast-6.aliyuncs.com |
|
タイ (バンコク) |
ap-southeast-7 |
ecs-vpc.ap-southeast-7.aliyuncs.com |
|
日本 (東京) |
ap-northeast-1 |
ecs-vpc.ap-northeast-1.aliyuncs.com |
|
韓国 (ソウル) |
ap-northeast-2 |
ecs-vpc.ap-northeast-2.aliyuncs.com |
|
ドイツ (フランクフルト) |
eu-central-1 |
ecs-vpc.eu-central-1.aliyuncs.com |
|
英国 (ロンドン) |
eu-west-1 |
ecs-vpc.eu-west-1.aliyuncs.com |
|
米国 (シリコンバレー) |
us-west-1 |
ecs-vpc.us-west-1.aliyuncs.com |
|
米国 (バージニア) |
us-east-1 |
ecs-vpc.us-east-1.aliyuncs.com |
|
UAE (ドバイ) |
me-east-1 |
ecs-vpc.me-east-1.aliyuncs.com |
方法1 (推奨):SDK による内部ネットワーク経由のオペレーション呼び出し
SDK を使用する場合、簡単な設定で内部ネットワーク経由で API オペレーションを呼び出すことができます。以下に Java コードの例を示します。
import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeRegionsRequest;
import com.aliyun.ecs20140526.models.DescribeRegionsResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class Test {
public static void main(String[] args) throws Exception {
Config config = new Config();
// 必須:環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID が設定されていることを確認してください。
config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
// 必須:環境変数 ALIBABA_CLOUD_ACCESS_KEY_SECRET が設定されていることを確認してください。
config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
// エンドポイントについては、https://api.alibabacloud.com/product/Ecs をご参照ください。
config.setEndpoint("<ENDPOINT>");
// ECS クライアントを初期化します。
Client ecsClient = new Client(config);
// リージョン情報を照会するためのリクエストオブジェクトを作成します。
DescribeRegionsRequest describeRegionsRequest = new DescribeRegionsRequest();
// ランタイムオプションオブジェクトを作成します。
RuntimeOptions runtime = new RuntimeOptions();
// リクエストを送信し、リージョン情報を含むレスポンスを取得します。
DescribeRegionsResponse response = ecsClient.describeRegionsWithOptions(describeRegionsRequest, runtime);
System.out.println(response.body.toMap());
}
}
方法2:CLI による内部ネットワーク経由のオペレーション呼び出し
この例では、DescribeRegions API を使用します。コマンドの例は次のとおりです。
aliyun ecs DescribeRegions --endpoint ecs-vpc.cn-hangzhou.aliyuncs.com