OpenAPI 統合の例 - ENS - Alibaba Cloud ドキュメントセンター

このトピックでは、OpenAPI を使用して DescribeEnsRegions 操作を呼び出し、利用可能な ENS エッジゾーンのリストをクエリする方法について説明します。

ステップ 1: OpenAPI ドキュメントの表示

OpenAPI を呼び出す前に、対応する API ドキュメント「DescribeEnsRegions」を読み、必須パラメーターと権限について確認します。詳細については、「API の概要」をご参照ください。

[スタック] ページで、[スタックの作成] をクリックします。[テンプレートの指定] セクションで、[既存テンプレートの選択] をクリックします。
説明
- [テンプレートの作成] または [Infrastructure Composer] を選択した場合、対応するページにリダイレクトされます。
テンプレートのインポート方法 を テンプレート内容の入力 に設定し、テンプレート内容 を [ROS] に設定します。次に、コードを入力します。

ステップ 2: RAM ユーザーの作成と権限付与

重要

Alibaba Cloud アカウントは、すべての API 操作に対するアクセス権限を持っています。API アクセスまたは日常の O&M のために、RAM ユーザーを作成して使用してください。

この操作は、Alibaba Cloud アカウント、Resource Access Management (RAM) ユーザー、または RAM ロールを使用して呼び出すことができます。これらの ID の違いに関する詳細については、「ID」をご参照ください。

このトピックでは、RAM ユーザー を使用して API 操作を呼び出します。

RAM ユーザーの作成。
1. RAM コンソールにログインします。
2. 左側のナビゲーションウィンドウで、[ID 管理] > [ユーザー] を選択します。
3. [ユーザー] ページで、[ユーザーの作成] をクリックします。
4. [ユーザーの作成] ページで、[ログイン名] と [表示名] を設定します。[アクセスモード] を [コンソールアクセス] に設定します。
5. [OK] をクリックします。
  RAM ユーザーを作成したら、ログイン名とパスワードを記録します。Alibaba Cloud OpenAPI Developer Portal にログインして OpenAPI 操作を呼び出す際に必要になります。
RAM ユーザーに権限を付与します。
説明
AliyunENSFullAccess: Edge Node Service (ENS) リソースを管理する権限を付与します。
AliyunENSReadOnlyAccess: ENS リソースに対する読み取り専用権限を付与します。
カスタムポリシーを作成するには、「権限付与情報」をご参照ください。
1. RAM ユーザーリストに移動します。
2. ターゲット RAM ユーザーを見つけ、[操作] 列の [権限を追加] をクリックします。
3. テキストボックスに、キーワード ENS を入力して、アタッチするポリシーを検索します。AliyunENSFullAccess ポリシーを選択します。
4. [確認] をクリックして権限付与を完了します。
RAM ユーザー の詳細ページに移動します。[認証] タブで、[AccessKey の作成] をクリックします。
詳細については、「AccessKey ペアの作成」をご参照ください。

ステップ 3: OpenAPI の呼び出し

このトピックでは、Java SDK を使用して OpenAPI を呼び出します。他の言語の SDK も同様の方法で使用されます。詳細については、「Edge Node Service SDK」をご参照ください。他のメソッドを選択して操作を呼び出すこともできます。呼び出しメソッドの詳細については、「呼び出しメソッド」をご参照ください。

環境変数の設定

環境変数は、オペレーティングシステムに固有のシステムレベルのパラメーターです。これらには、アプリケーションにランタイム設定を提供する名前と値が含まれています。さまざまなオペレーティングシステムで Alibaba Cloud AccessKey ペアを環境変数として設定する方法の詳細については、「Linux、macOS、および Windows で環境変数を設定する」をご参照ください。

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

DescribeEnsRegions に移動します。
左側の [パラメーター設定] タブで、必須パラメーターを入力します。
右側の [SDK サンプル] タブで、SDK バージョンを v2.0 に設定し、言語を [Java] に設定します。[プロジェクト全体のダウンロード] をクリックして、サンプルコードパッケージをダウンロードします。
コンピューターでパッケージを解凍し、alibabacloud_sample フォルダに移動します。

プロジェクトを開く

IntelliJ IDEA を使用してプロジェクトをロードします。依存関係がロードされたら、src/main/java/com/aliyun/sample/Sample.java ファイルを開きます。ファイル内のコメントに基づいて、戻り値を表示するコードを追加します。

プロジェクトの実行

IDE の右上隅にある [実行] をクリックして、出力ログを表示します。この例では、次の内容が返されます。

{
  "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"
  }
}