このトピックでは、OpenAPI を使用して DescribeEnsRegions API を呼び出し、利用可能な Edge Node Service (ENS) のエッジゾーンを照会する方法について説明します。
手順1: API ドキュメントの確認
API オペレーションを呼び出す前に、API ドキュメントをお読みください。DescribeEnsRegions API の呼び出しに必要なリクエストパラメータと権限については、「DescribeEnsRegions」をご参照ください。詳細については、「API の概要」をご参照ください。
-
スタック ページで、スタックの作成 をクリックします。テンプレートの指定 セクションで、既存テンプレートの使用 をクリックします。
説明-
テンプレートの作成 または Composer を選択すると、対応するページにリダイレクトされます。
-
-
For [テンプレートのインポート方法], select [テンプレート内容の入力]. For [テンプレート内容], select ROS and enter the code.
手順2: RAM ユーザーの作成と権限の付与
Alibaba Cloud アカウントは、すべての API オペレーションに対する完全な権限を持っています。セキュリティのため、API コールや日常の運用保守には RAM ユーザーを使用することを推奨します。
Alibaba Cloud アカウント (ルートアカウント)、RAM ユーザー、または RAM ロールを使用してこの API オペレーションを呼び出すことができます。これらのアイデンティティの違いの詳細については、「アイデンティティ」をご参照ください。
このトピックでは、RAM ユーザー を使用して API オペレーションを呼び出します。
-
-
Resource Access Management (RAM) コンソールにログインします。
-
左側のナビゲーションペインで、 を選択します。
-
[Users] ページで [Create User] をクリックします。
-
[Create User] ページで、[logon name] と [display name] を設定します。[access mode] で [console access] を選択します。
-
[OK] をクリックします。
RAM ユーザーの作成後、ログイン名とパスワードを記録します。これらの認証情報は、コンソールアクセスに使用します。
-
-
RAM ユーザーに権限を付与します。
説明AliyunENSFullAccess: Edge Node Service (ENS) リソースを管理する権限を付与します。
AliyunENSReadOnlyAccess: ENS リソースに対する読み取り専用の権限を付与します。
カスタムポリシーを作成するには、「認可情報」をご参照ください。
-
[Users] リストに移動します。
-
対象の RAM ユーザーを見つけ、[Actions] 列で [Add Permissions] をクリックします。
-
検索ボックスに
ENSと入力し、AliyunENSFullAccess ポリシーを選択します。 -
[OK] をクリックします。
-
-
RAM ユーザー の詳細ページに移動します。[Authentication] タブで、[Create AccessKey] をクリックします。
詳細については、「AccessKey ペアの作成」をご参照ください。
手順3: API の呼び出し
このトピックでは、Java SDK を使用して OpenAPI を呼び出す例を示します。他の言語の SDK でも使用方法は同様です。詳細については、「Edge Node Service SDK」をご参照ください。ビジネス要件に応じて、他の呼び出し方法を選択することもできます。詳細については、「呼び出し方法」をご参照ください。
環境変数の設定
環境変数は、アプリケーションの実行環境を指定するための、名前と値を含むシステムレベルのパラメータです。さまざまなオペレーティングシステムで AccessKey ペアを環境変数として設定する方法については、「Linux、macOS、および Windows で環境変数を設定する」をご参照ください。
サンプルコードのダウンロード
-
DescribeEnsRegions に移動します。
-
左側の [Parameters] タブで、必要なパラメータを指定します。
-
右側の [SDK sample] タブで、SDK バージョンを v2.0 に、言語を Java に設定します。[Download sample project] をクリックして、サンプルプロジェクトをダウンロードします。
-
パッケージを解凍し、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"
}
}