本文為您演示如何通過阿里云CLI創建一個云數據庫 MongoDB 版副本集實例。
如果您還不了解阿里云CLI,請參見文檔什么是阿里云CLI。
資源架構
在指定地域創建一個VPC網絡和一臺交換機,然后創建一個MongoDB副本集實例。
安裝CLI
您如果想要在本地安裝和配置CLI,請參見安裝指南。
如果您不想安裝CLI,可以使用阿里云提供的在線服務Cloud Shell,其中內置了CLI的運行環境。
配置權限
在本案例中,您需要創建專有網絡(VPC)、交換機(vSwitch)和MongoDB實例。默認情況下CLI會直接使用當前登錄控制臺的用戶憑證,要求當前用戶必須具備以下權限:
AliyunVPCFullAccess:管理專有網絡 VPC的權限。
AliyunMongoDBFullAccess:管理云數據庫 MongoDB 版的權限。
生成CLI命令示例
登錄OpenAPI門戶。
在頁面上方,單擊選擇云產品,選擇目標云產品。
在左側導航欄中,單擊調試。
在API調試界面左側搜索框中可搜索您需要使用的API。在參數配置中根據API文檔信息填寫參數,單擊參數配置右側的CLI示例頁簽即可生成攜帶參數的命令示例。
單擊運行命令按鈕,可喚出云命令行Cloud Shell并在其中快速完成命令調試。
單擊復制按鈕,將CLI示例復制到剪貼板中,可粘貼至本地Shell工具中運行。
復制CLI示例到本地Shell工具中進行調試時請注意參數格式。關于阿里云CLI命令參數使用格式的詳細信息,請參見參數格式說明。
OpenAPI門戶生成示例中會默認添加
--region
選項,復制命令到本地調用時阿里云CLI將忽略默認身份憑證配置及環境變量設置中的地域信息,優先使用指定的地域調用命令,您可根據需要刪除或保留該選項。
調用API
阿里云CLI中調用RPC API時,基本命令結構如下。
aliyun <product> <APIName> [--parameter1 value1 --parameter2 value2 ...]
product
:需要調用的云產品code。例如MongoDB的產品code為dds
。APIName
:需要調用的API。例如創建副本集實例需要使用CreateDBInstance
接口。--parameter
:需要傳入的請求參數。
創建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
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****"
}
創建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****"
}