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

ApsaraDB for MongoDB:Alibaba Cloud CLIを使用したApsaraDB for MongoDBの統合

最終更新日:Sep 14, 2024

このトピックでは、Alibaba Cloud CLIを使用してApsaraDB for MongoDBレプリカセットインスタンスを作成する方法について説明します。

Alibaba Cloud CLIの詳細については、「Alibaba Cloud CLIとは」をご参照ください。

リソースアーキテクチャ

image.png

特定のリージョンに仮想プライベートクラウド (VPC) 、vSwitch、およびレプリカセットインスタンスを作成できます。

Alibaba Cloud CLIのインストール

  • ローカルコンピューターにAlibaba Cloud CLIをインストールします。 詳細については、次をご参照ください: インストールガイド

  • ローカルコンピューターにAlibaba Cloud CLIをインストールしない場合は、Cloud Shellを使用してAlibaba Cloud CLIをインストールします。 Cloud Shellは、Alibaba Cloud CLIに組み込みのランタイム環境を提供します。

RAMユーザーに必要な権限を付与

このセクションで説明する例では、仮想プライベートクラウド (VPC) 、vSwitch、およびApsaraDB for MongoDBインスタンスを作成する必要があります。 デフォルトでは、Alibaba Cloud CLIはApsaraDB for MongoDBコンソールにログインする現在のユーザーの資格情報を使用します。 この場合、現在のユーザーには次の権限が付与されている必要があります。

  • AliyunVPCFullAccess: Virtual Private Cloudへのフルアクセスを提供します。

  • AliyunMongoDBFullAccess: ApsaraDB for MongoDBへのフルアクセスを提供します。

CLIコマンドの生成

  1. OpenAPI Explorerにログインします。

  2. 表示されるページの上部で、[クラウド製品] をクリックし、管理するクラウドサービスを選択します。

  3. 左側のナビゲーションウィンドウで、[デバッグ] をクリックします。

  4. オンラインデバッグページの左側の検索ボックスで、呼び出すAPI操作を検索します。 [パラメーター] タブで、API操作のAPIドキュメントに基づいてパラメーター値を入力します。 次に、[パラメーター] タブの右側にある [CLIの例] タブをクリックして、設定されたパラメーターを含む例を生成します。CLI-调试API

    • アイコン运行命令.pngをクリックします。 Cloud Shellに移動します。 Cloud Shellでコマンドをデバッグできます。

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

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

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

API操作の呼び出し

Alibaba Cloud CLIを使用してAPI操作を呼び出す場合は、基本的なコマンド構造に精通していることを確認してください。

aliyun <product> <APIName> [--parameter1 value1 --parameter2 value2 ...]
  • product: API操作を呼び出すAlibaba Cloudサービスのコード。 たとえば、ApsaraDB For MongoDBの製品コードはddsです。

  • APIName: 呼び出すAPI操作の名前。 たとえば、レプリカセットインスタンスを作成するには、CreateDBInstance操作を呼び出す必要があります。

  • -- parameter: 指定する必要があるリクエストパラメーター。

VPCの作成

VPCを作成するには、CreateVpc操作を呼び出します。 詳細については、「CreateVpc」をご参照ください。

例:

aliyun vpc CreateVpc --RegionId cn-hangzhou

サンプルコマンド出力:

{
        "RequestId": "E8410523-E996-5345-9E4D-35D6C47A****",
        "ResourceGroupId": "rg-acfmz7u4zzr****",
        "RouteTableId": "vtb-bp1dcxc8j4jys18id****",
        "VRouterId": "vrt-bp1w2lsqfm9f7k2dy****",
        "VpcId": "vpc-bp191olzz22cgl073****"
}

vSwitchの作成

vSwitchを作成するには、CreateVSwitch操作を呼び出します。 詳細については、「CreateVSwitch」をご参照ください。

例:

aliyun vpc CreateVSwitch --ZoneId cn-hangzhou-i --CidrBlock 172.16.1.0/24 --VpcId vpc-bp191olzz22cgl073****

サンプルコマンド出力:

{
        "RequestId": "D3316995-CAB6-58A3-97E5-F1CBFE2E****",
        "VSwitchId": "vsw-bp10cm6ujv0na2vlp****"
}

ApsaraDB for MongoDBインスタンスの作成

ApsaraDB for MongoDBインスタンスを作成するには、CreateDBInstance操作を呼び出します。 詳細は、「CreateDBInstance」をご参照ください。

例:

aliyun dds CreateDBInstance --RegionId cn-hangzhou --ZoneId cn-hangzhou-i --EngineVersion 7.0 --DBInstanceClass mdb.shard.4x.large.d --DBInstanceStorage 20 --VpcId vpc-bp191olzz22cgl073**** --VSwitchId vsw-bp10cm6ujv0na2vlp****

サンプルコマンド出力:

{
        "DBInstanceId": "dds-bp1df136c811****",
        "OrderId": "23705179664****",
        "RequestId": "1336E68C-86A4-5355-A12A-D0A0C27A****"
}