API操作の呼び出し例 - ENS - Alibaba Cloud ドキュメントセンター

このトピックでは、DescribeEnsRegions操作を呼び出して、使用できるENSノードを照会する方法について説明します。

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

DescribeEnsRegions操作を呼び出す前に、この操作を呼び出すために必要なパラメーターとアクセス許可についてのトピックを読むことをお勧めします。詳細については、「関数別の操作の一覧」をご参照ください。

手順2: RAMユーザーを作成し、RAMユーザーに権限を付与する

重要

Alibaba Cloudアカウントには、すべてのAPI操作に対するアクセス権限があります。 RAMユーザーを使用してAPI操作を呼び出したり、ルーチンのO&Mを実行することを推奨します。

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

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

RAMユーザーの作成
1. RAM コンソールにログインします。
2. 左側のナビゲーションウィンドウで、[ID] > [ユーザー] を選択します。
3. [ユーザー] ページで、[ユーザーの作成] をクリックします。
4. [ユーザーの作成] ページで、[ログイン名] および [表示名] パラメーターを指定し、[アクセスモード] パラメーターを [コンソールアクセス] に設定します。
5. [OK] をクリックします。
  RAMユーザーを作成した後、RAMユーザーのログイン名とパスワードを記録します。 API操作を呼び出すときは、RAMユーザーを使用してOpenAPI Explorerにログインする必要があります。
RAMユーザーに権限を付与します。
説明
AliyunENSFullAccess: ENSリソースへのフルアクセス。
AliyunENSReadOnlyAccess: ENSリソースに対する読み取り専用権限。
カスタムポリシーの作成方法の詳細については、
RAM権限付与を行います。
1. RAMユーザーリストにアクセスします。
2. [ユーザー] ページでRAMユーザーを見つけ、[操作] 列の [権限の追加] をクリックします。
3. 検索ボックスにENSと入力し、AliyunENSFullAccessポリシーを選択します。
4. [権限付与] をクリックします。
RAMユーザーの詳細ページに移動します。 [認証] タブで、[AccessKeyの作成] をクリックします。
詳細については、「AccessKey の作成」をご参照ください。

ステップ3: 操作を呼び出す

このトピックでは、ENS SDK for Javaを使用します。他のプログラミング言語にも同様の方法でENS SDKを使用できます。詳細については、「

ENS SDKページ他の方法を使用して、ビジネス要件に基づいてAPI操作を呼び出すことができます。詳細については、「概要」をご参照ください。

環境変数の設定

環境変数は、オペレーティングシステム固有のグローバルパラメータです。環境変数には変数名と変数値が含まれており、オペレーティングシステムで実行されているアプリケーションのランタイム環境を設定できます。異なるシステムの環境変数で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"
  }
}