このトピックでは、Alibaba Cloud CLIを使用してApsaraDB for MongoDBレプリカセットインスタンスを作成する方法について説明します。
Alibaba Cloud CLIの詳細については、「Alibaba Cloud CLIとは」をご参照ください。
リソースアーキテクチャ
特定のリージョンに仮想プライベートクラウド (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コマンドの生成
OpenAPI Explorerにログインします。
表示されるページの上部で、[クラウド製品] をクリックし、管理するクラウドサービスを選択します。
左側のナビゲーションウィンドウで、[デバッグ] をクリックします。
オンラインデバッグページの左側の検索ボックスで、呼び出すAPI操作を検索します。 [パラメーター] タブで、API操作のAPIドキュメントに基づいてパラメーター値を入力します。 次に、[パラメーター] タブの右側にある [CLIの例] タブをクリックして、設定されたパラメーターを含む例を生成します。
アイコンをクリックします。 Cloud Shellに移動します。 Cloud Shellでコマンドをデバッグできます。
アイコンをクリックして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****"
}