すべてのプロダクト
Search
ドキュメントセンター

:CLIとプライベートDNSの統合

最終更新日:Mar 06, 2025

Alibaba Cloud CLIは、OpenAPI Explorerに基づいて開発された汎用のコマンドラインツールです。 Alibaba Cloud CLIをプライベートDNSと統合し、シェルツールを使用してプライベートDNSのリソースを管理できます。 このトピックでは、Alibaba Cloud CLIを使用してプライベートDNSの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ユーザーを作成して使用し、API操作を呼び出したり、ルーチンのO&M操作を実行したりすることを推奨します。 AliyunPvtzFullAccessポリシーをRAMユーザーにアタッチする必要があります。 このポリシーにより、RAMユーザーはプライベートDNSのリソースを管理できます。

Alibaba Cloud CLIを使用する前に、Alibaba Cloud CLIでID資格情報やリージョンIDなどの情報を設定する必要があります。 Alibaba Cloud CLIは、さまざまなID資格情報をサポートしています。 詳細については、「プロファイルの設定」トピックの [資格情報の種類] セクションをご参照ください。 この例では、AccessKey資格情報が使用されます。 Alibaba Cloud CLIを設定するには、次の手順を実行します。

  1. RAMユーザーを作成し、ビジネス要件に基づいてAlibaba Cloudサービスを管理する権限を付与します。 詳細については、「RAM ユーザーの作成」および「RAMユーザーへの権限付与」をご参照ください。

  2. RAMユーザーのAccessKeyペアを作成し、その後のID資格情報の設定のためにAccessKey IDAccessKey secretを記録します。 詳細については、「AccessKeyペアの作成」をご参照ください。

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

    説明

    Alibaba Cloud CLIを使用する場合、-- regionオプションを指定して、特定のリージョンでコマンドを実行できます。 このオプションを指定すると、Alibaba Cloud CLIはデフォルトの資格情報設定と環境変数設定のリージョン情報を無視します。 詳細については、「API呼び出しのコマンドラインオプション」をご参照ください。

  4. RAMユーザーのAccessKeyペアを使用して、AkProfileという名前の設定ファイルでID資格情報を設定します。 詳細については、プロファイルの設定トピックの構成例をご参照ください。

CLIコマンドの生成

  1. ECI インスタンスの割引額を照会するには、 プライベートDNS APIのデバッグページ。

  2. [デバッグ] ページの左側の検索ボックスで、呼び出すAPI操作を検索します。 API操作の [パラメーター] タブで、API参照に基づいてパラメーターを指定します。 右側の [CLIの例] タブをクリックして、指定されたパラメーターを含む生成されたサンプルコマンドを表示します。

    image

    • [CloudShellでコマンドを実行] imageアイコンをクリックしてCloud Shellを起動し、Cloud Shellでコマンドをデバッグします。

    • [コピー] imageアイコンをクリックして、サンプルコマンドをクリップボードにコピーします。 サンプルコマンドを実行するには、サンプルコマンドをローカルのシェルツールに貼り付けることができます。

      • CLIコマンドをコピーしてローカルシェルツールに貼り付けるときは、パラメーターの形式に注意してください。 Alibaba Cloud CLIコマンドのパラメーター形式の詳細については、「パラメーター形式」をご参照ください。

      • デフォルトでは、OpenAPI Explorerで生成されるサンプルコマンドに -- regionオプションが追加されます。 コマンドをローカルのシェルツールにコピーすると、Alibaba Cloud CLIはデフォルトの認証情報設定と環境変数設定のリージョン情報を無視し、指定されたリージョンで優先的にコマンドを実行します。 このオプションは、ビジネス要件に基づいて削除または保持できます。

Alibaba Cloud CLIを使用してプライベートDNSのAPI操作を呼び出す

構文

Alibaba Cloud CLIでは、次のコードブロックに示す構文を使用してコマンドを実行できます。 詳細については、CLIコマンドの生成と実行のトピックのCLI コマンドの生成と実行を参照してください。

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

コマンドオプション

Alibaba Cloud CLIを使用する場合、コマンドオプションを指定して、コマンドのデフォルトの動作を変更したり、コマンドの拡張機能を実装したりできます。 次のコマンドオプションがよく使用されます。

  • -- profile <profileName>: -- profileオプションとprofileNameパラメーターを使用して、構成プロファイルを指定できます。 有効な構成プロファイルを指定すると、Alibaba Cloud CLIはデフォルトの資格情報設定と環境変数設定の情報を無視し、指定した構成を優先的に使用してコマンドを実行します。

  • -- help: -- helpオプションを指定して、コマンドに関するヘルプ情報を取得できます。 詳細については、「ヘルプコマンドの使用」をご参照ください。

詳細については、「API呼び出しのコマンドラインオプション」をご参照ください。

説明

次の例では、コマンドはWindowsのコマンドプロンプトで実行されます。 コマンドのパラメータ形式は、他のオペレーティングシステムによって異なります。 Alibaba Cloud CLIコマンドのパラメーター形式の詳細については、「パラメーター形式」をご参照ください。

  • 例1: Alibaba Cloud CLIを使用してプライベートDNSのAddZone操作を呼び出し、組み込みの権限加速モジュールにzone_testという名前のゾーンを作成します。

    1. コマンドを実行します。

      aliyun pvtz AddZone --region cn-qingdao --ZoneName zone_test --DnsGroup FAST_ZONE
    2. コマンド出力を表示します。

      {
              "RequestId": "139C297E-8E9C-5E06-8758-CD4D6A4C89AF",
              "Success": true,
              "ZoneId": "79e6d8c6974042e9c9a4a988130****",
              "ZoneName": "zone_test"
      }
  • 例2: Alibaba Cloud CLIを使用してプライベートDNSのAddZoneRecord操作を呼び出し、zone_testという名前のゾーンのドメインネームシステム (DNS) レコードを追加します。

    1. コマンドを実行します。

      aliyun pvtz AddZoneRecord --region cn-qingdao --ZoneId 79e6d8c6974042e9c9a4a9881306**** --Rr www --Type A --Value '192.168.XX.XX'
    2. コマンド出力を表示します。

      {
              "RecordId": 440563****,
              "RequestId": "61DD3A77-9E25-5E86-A314-3E2B741BE44A",
              "Success": true
      }
  • 例3: Alibaba Cloud CLIを使用して、プライベートDNSのBindZoneVpc操作を呼び出します。 このAPI操作は、1つ以上の仮想プライベートクラウド (VPC) をzone_testという名前のゾーンに関連付けて、ゾーンの有効範囲を指定します。

    1. コマンドを実行します。

      aliyun pvtz BindZoneVpc --region cn-qingdao --ZoneId 79e6d8c6974042e9c9a4a9881306**** --Vpcs.1.VpcId 'vpc-0jl96awrjt75ezglc****'
    2. コマンド出力を表示します。

      {
              "RequestId": "9D48AF1B-A5DE-50B8-9882-481C8C5010F8"
      }
説明

プライベートDNSのAPI操作を呼び出した後にエラーコードが返された場合、返されたエラーコードに基づいてリクエストパラメーターとその値が有効かどうかを確認する必要があります。

を使用することもできます。 Alibaba Cloud OpenAPI Diagnosticsは、返されたリクエストIDまたはSDKエラー情報に基づいてセルフサービス診断を実行します。