ENS:CLI を使用した ENS リソースの管理

事前準備

Alibaba Cloud CLI の基本を理解しておいてください。詳細については、「Alibaba Cloud CLI とは」をご参照ください。

Alibaba Cloud CLI のインストール

Alibaba Cloud CLI は、Windows、Linux、macOS で利用できます。ご利用のオペレーティングシステムに対応するインストールパッケージを選択してください：

• Windows オペレーティングシステム： Windows。

• Linux オペレーティングシステム： Linux。

• macOS オペレーティングシステム： macOS。

また、Cloud Shell を使用して Alibaba Cloud CLI コマンドをデバッグすることもできます。詳細については、「Cloud Shell とは」をご参照ください。

Alibaba Cloud CLI の設定

Alibaba Cloud CLI を使用する前に、認証情報とリージョン ID を設定する必要があります。Alibaba Cloud CLI はさまざまな認証情報タイプをサポートしています。詳細については、「認証情報の種類」をご参照ください。この例では、AccessKey 認証情報を使用します。

1. RAM ユーザーを作成し、RAM ユーザーに必要な権限を付与します。詳細については、「RAM ユーザーの作成」および「RAM ユーザーへの権限付与」をご参照ください。

   重要

   この例では、RAM ユーザーに AliyunENSFullAccess ポリシーを付与する必要があります。このポリシーは、ENS インスタンスのクエリと変更に対する完全制御を許可します。必要に応じて、AliyunENSReadOnlyAccess ポリシーまたはカスタムポリシーを付与することもできます。詳細については、「ENS のカスタムポリシーリファレンス」をご参照ください。

2. RAM ユーザーを作成して権限を付与した後、そのユーザー用の AccessKey ペアを作成します。認証情報の設定のために、AccessKey ID と AccessKey Secret を記録しておきます。詳細については、「AccessKey ペアの作成」をご参照ください。

3. 利用可能なリージョンの ID を取得して記録します。Alibaba Cloud CLI は、指定されたリージョン ID を使用して API 呼び出しを開始します。利用可能なリージョンについては、「エンドポイント」をご参照ください。

   説明

   Alibaba Cloud CLI を使用する際、--region オプションを使用して、単一のコマンドに対してリージョンを指定できます。このオプションは、デフォルトの認証情報設定および環境変数内のリージョン設定をオーバーライドします。詳細については、「コマンドオプション」をご参照ください。

4. RAM ユーザーの AccessKey ペアを使用して、AccessKey ベースの認証情報を設定します。設定プロファイルに AkProfile という名前を付けます。詳細については、「ID 認証情報の設定と管理」をご参照ください。

CLI コマンドの生成

1. ENS の API デバッグページにログインします。

2. API デバッグページで、左側の検索ボックスを使用して、使用する API を検索します。[パラメーター設定] セクションで、必須パラメーターを入力します。次に、[パラメーター設定] セクションの隣にある [CLI の例] タブをクリックし、コマンドの例を生成します。

   • アイコンをクリックすると、Cloud Shell にリダイレクトされます。Cloud Shell でコマンドをデバッグできます。

   • アイコンをクリックして CLI コマンドをクリップボードにコピーし、ローカルのシェルに貼り付けます。

     • サンプルコマンドをシェルに貼り付けてデバッグする際は、パラメーターのフォーマットに注意してください。Alibaba Cloud CLI のパラメーターフォーマットの詳細については、「パラメーターのフォーマット」をご参照ください。

     • OpenAPI Explorer によって生成された例には、デフォルトで --region オプションが含まれています。コマンドをローカルで実行すると、Alibaba Cloud CLI はこのオプションを優先し、デフォルトの認証情報設定および環境変数内のリージョン設定を無視します。必要に応じて、このオプションを削除または保持できます。

API オペレーションの呼び出し

aliyun <command> <subcommand> [options and parameters]