Alibaba Cloud CLIは、OpenAPIに基づいて開発された汎用のコマンドラインツールです。 Alibaba Cloud CLIを使用して、ENSリソースの自動管理とメンテナンスを実装できます。 このトピックでは、Alibaba Cloud CLIを使用してENS API操作を呼び出す方法について説明します。
始める前に
Alibaba Cloud CLIに慣れてください。 詳細については、「Alibaba Cloud CLI とは何か」をご参照ください。
Alibaba Cloud CLI のインストール
Alibaba Cloud CLIを使用する前に、Alibaba Cloud CLIをインストールする必要があります。 Alibaba Cloud CLIは、Windows、Linux、およびmacOSオペレーティングシステムにインストールできます。 デバイスのオペレーティングシステムに基づいて、Alibaba Cloud CLIのインストールパッケージを選択する必要があります。 詳細については、以下のトピックをご参照ください。
Alibaba Cloudが提供するCloud Shellを使用して、Alibaba Cloud CLIで実行するコマンドをデバッグすることもできます。 Cloud Shellの詳細については、「Cloud Shellとは」をご参照ください。
Alibaba Cloud CLI の設定
Alibaba Cloudアカウントには、すべてのAlibaba CloudサービスのAPIを管理およびアクセスする権限があります。 Alibaba Cloudアカウントを使用してAPI操作を呼び出すと、セキュリティリスクが発生する可能性があります。 RAM (Resource Access Management) ユーザーを作成して使用し、API操作を呼び出したり、通常のO&M操作を実行したりすることを推奨します。
Alibaba Cloud CLIを使用する前に、Alibaba Cloud CLIでID資格情報やリージョンIDなどの情報を設定する必要があります。 Alibaba Cloud CLIは、さまざまなID資格情報をサポートしています。 詳細については、「資格情報の種類」をご参照ください。 この例では、AccessKey資格情報が使用されます。
RAMユーザーを作成し、RAMユーザーに必要な権限を付与します。 詳細については、「RAM ユーザーの作成」および「RAMユーザーへの権限付与」をご参照ください。
重要この例では、
AliyunENSFullAccessポリシーをRAMユーザーにアタッチする必要があります。これにより、インスタンスのクエリや管理など、ENSインスタンスへのフルアクセスがユーザーに許可されます。AliyunENSReadOnlyAccessポリシーを使用するか、カスタムポリシーを作成できます。 詳細については、「ENSのカスタムポリシー」をご参照ください。RAMユーザーのAccessKeyペアを作成し、ID資格情報の設定用に
AccessKey IDとAccessKey secretを記録します。 詳細については、「RAMユーザーのAccessKeyペアの作成」をご参照ください。ID資格情報の設定に使用可能なリージョンのIDを取得して記録します。 Alibaba Cloud CLIは、指定されたリージョンIDを使用してAPI呼び出しを開始します。 使用可能なリージョンの詳細については、「エンドポイント」をご参照ください。
説明Alibaba Cloud CLIを使用する場合、
-- regionオプションを使用して、特定のリージョンでコマンドを実行できます。 このオプションを使用すると、Alibaba Cloud CLIはデフォルトの資格情報設定と環境変数設定のリージョン情報を無視します。 詳細については、「API呼び出しのコマンドラインオプション」をご参照ください。RAMユーザーのAccessKeyペアを使用して、
AkProfileという名前の設定ファイルでID資格情報を設定します。 詳細については、「構成例」をご参照ください。
CLIコマンドの生成
ENS APIのデバッグページに移動します。
表示されるページの左側の検索ボックスで、呼び出す操作を検索します。 [パラメーター] タブで、API操作のAPIドキュメントに基づいてパラメーター値を入力します。 次に、[パラメーター] タブの右側にある [CLIの例] タブをクリックして、設定されたパラメーターを含む例を生成します。
アイコンをクリックします。 Cloud Shellに移動します。 Cloud Shellでコマンドをデバッグできます。 
アイコンをクリックしてCLIコマンドをクリップボードにコピーし、ローカルシェルに貼り付けます。 サンプルコマンドをデバッグのためにシェルに貼り付けるときは、パラメータの形式に注意してください。 Alibaba Cloud CLIのパラメーター形式の詳細については、「パラメーター形式」をご参照ください。
デフォルトでは、OpenAPI Explorerは、生成されたCLIコマンドに
-- regionオプションを追加します。 コマンドをシェルにコピーすると、Alibaba Cloud CLIはデフォルトのID資格情報設定と環境変数設定のリージョン情報を無視し、指定されたリージョンで優先的にコマンドを実行します。 ビジネス要件に基づいてオプションを削除または保持できます。
API操作の呼び出し
構文
Alibaba Cloud CLIでは、次の構文を使用してコマンドを実行できます。 詳細は、「CLI コマンドの生成と実行」をご参照ください。
aliyun <command> <subcommand> [options and parameters]コマンドオプション
Alibaba Cloud CLIを使用する場合、コマンドオプションを指定して、コマンドの動作を変更したり、コマンドの拡張機能を実装したりできます。 ほとんどの場合、次のコマンドオプションが使用されます。
-- profile <profileName>:-- profileオプションとprofileNameパラメーターを使用して、構成プロファイルを指定できます。 有効な構成プロファイルを指定すると、Alibaba Cloud CLIはデフォルトの資格情報設定と環境変数設定の情報を無視し、指定した構成を優先的に使用してコマンドを実行します。-- help:-- helpオプションを使用して、コマンドに関するヘルプ情報を取得できます。 詳細については、「ヘルプコマンドの使用」をご参照ください。
詳細については、「API呼び出しのコマンドラインオプション」をご参照ください。
呼び出し例
次の例は、Alibaba Cloud CLIを使用してENSのRebootInstance操作を呼び出してインスタンスを再起動する方法を示しています。 RebootInstance操作の詳細については、「RebootInstance」をご参照ください。
以下のコマンドを実行します。
コマンド出力を表示します。
ENSのAPIを呼び出した後にエラーが返された場合は、エラーコードに基づいて入力パラメーターと値が有効かどうかを確認してください。
Alibaba Cloud OpenAPI Diagnostics
を使用して、返されたリクエストIDまたはSDKエラー情報に基づいてセルフサービス診断を実行します。