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

ENS:Java SDK の呼び出し例

最終更新日:Sep 10, 2026

このトピックでは、OpenAPI を使用して DescribeEnsRegions API を呼び出し、利用可能な Edge Node Service (ENS) のエッジゾーンを照会する方法について説明します。

手順1: API ドキュメントの確認

API オペレーションを呼び出す前に、API ドキュメントをお読みください。DescribeEnsRegions API の呼び出しに必要なリクエストパラメータと権限については、「DescribeEnsRegions」をご参照ください。詳細については、「API の概要」をご参照ください。

  1. スタック ページで、スタックの作成 をクリックします。テンプレートの指定 セクションで、既存テンプレートの使用 をクリックします。

    説明
    • テンプレートの作成 または Composer を選択すると、対応するページにリダイレクトされます。

  2. For [テンプレートのインポート方法], select [テンプレート内容の入力]. For [テンプレート内容], select ROS and enter the code.

手順2: RAM ユーザーの作成と権限の付与

重要

Alibaba Cloud アカウントは、すべての API オペレーションに対する完全な権限を持っています。セキュリティのため、API コールや日常の運用保守には RAM ユーザーを使用することを推奨します。

Alibaba Cloud アカウント (ルートアカウント)、RAM ユーザー、または RAM ロールを使用してこの API オペレーションを呼び出すことができます。これらのアイデンティティの違いの詳細については、「アイデンティティ」をご参照ください。

このトピックでは、RAM ユーザー を使用して API オペレーションを呼び出します。

  1. RAM ユーザーを作成します。

    1. Resource Access Management (RAM) コンソールにログインします。

    2. 左側のナビゲーションペインで、 を選択します。

    3. [Users] ページで [Create User] をクリックします。

    4. [Create User] ページで、[logon name] と [display name] を設定します。[access mode] で [console access] を選択します。

    5. [OK] をクリックします。

      RAM ユーザーの作成後、ログイン名とパスワードを記録します。これらの認証情報は、コンソールアクセスに使用します。

  2. RAM ユーザーに権限を付与します。

    説明

    AliyunENSFullAccess: Edge Node Service (ENS) リソースを管理する権限を付与します。

    AliyunENSReadOnlyAccess: ENS リソースに対する読み取り専用の権限を付与します。

    カスタムポリシーを作成するには、「認可情報」をご参照ください。

    1. [Users] リストに移動します。

    2. 対象の RAM ユーザーを見つけ、[Actions] 列で [Add Permissions] をクリックします。

    3. 検索ボックスに ENS と入力し、AliyunENSFullAccess ポリシーを選択します。

    4. [OK] をクリックします。

  3. RAM ユーザー の詳細ページに移動します。[Authentication] タブで、[Create AccessKey] をクリックします。

    詳細については、「AccessKey ペアの作成」をご参照ください。

手順3: API の呼び出し

このトピックでは、Java SDK を使用して OpenAPI を呼び出す例を示します。他の言語の SDK でも使用方法は同様です。詳細については、「Edge Node Service SDK」をご参照ください。ビジネス要件に応じて、他の呼び出し方法を選択することもできます。詳細については、「呼び出し方法」をご参照ください。

環境変数の設定

環境変数は、アプリケーションの実行環境を指定するための、名前と値を含むシステムレベルのパラメータです。さまざまなオペレーティングシステムで AccessKey ペアを環境変数として設定する方法については、「Linux、macOS、および Windows で環境変数を設定する」をご参照ください。

サンプルコードのダウンロード

  1. DescribeEnsRegions に移動します。

  2. 左側の [Parameters] タブで、必要なパラメータを指定します。

  3. 右側の [SDK sample] タブで、SDK バージョンを v2.0 に、言語を Java に設定します。[Download sample project] をクリックして、サンプルプロジェクトをダウンロードします。

  4. パッケージを解凍し、alibabacloud_sample ディレクトリに移動します。

プロジェクトを開く

IntelliJ IDEA を使用してプロジェクトを開きます。依存関係の読み込みが完了したら、src/main/java/com/aliyun/sample/Sample.java ファイルを開きます。ファイル内のコメントに基づいて、レスポンスを出力するコードを追加します。

プロジェクトの実行

IDE の右上隅にある [Run] をクリックして、出力ログを表示します。以下にレスポンスの例を示します。

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Tue, 18 Jul 2023 15:26:50 GMT",
    "content-length": "92",
    "keep-alive": "timeout=25",
    "x-acs-request-id": "1589E192-A47E-5224-95E2-A18F2D1ED186",
    "connection": "keep-alive",
    "content-type": "application/json;charset=utf-8",
    "etag": "9fcxMGIK+zckvQOS1NfD6GA2",
    "access-control-expose-headers": "*",
    "x-acs-trace-id": "bdfecedff57c1e8fc1b7970e909bca31"
  },
  "statusCode": 200,
  "body": {
    "code": 0,
    "ensRegions": {
      "ensRegions": [
        {
          "Area": "SouthWestChina",
          "EnName": "",
          "EnsRegionId": "cn-chongqing-unicom",
          "Province": "Chongqing",
          "Name": "China Unicom (Chongqing)"
        }
      ]
    },
    "requestId": "1589E192-A47E-5224-95E2-A18F2D1ED186"
  }
}