ApsaraDB for MongoDB:Exemplo de integração com CLI

Arquitetura de recursos

O modelo cria uma VPC e um vSwitch em uma região especificada e, em seguida, cria uma instância de replica set do MongoDB.

Instalar o CLI

• Para instalar e configurar o Alibaba Cloud CLI no seu computador, consulte o Guia de Instalação.

• Como alternativa, use o Cloud Shell, que oferece um ambiente com o CLI pré-instalado, sem necessidade de instalação local.

Configurar permissões

O Alibaba Cloud CLI usa as credenciais do usuário atual. Verifique se esse usuário tem as seguintes permissões:

• AliyunVPCFullAccess: permissão para gerenciar o Virtual Private Cloud.

• AliyunMongoDBFullAccess: permissão para gerenciar o ApsaraDB for MongoDB.

Gerar um exemplo de CLI

1. Faça login no OpenAPI Explorer.

2. Na parte superior da página, clique em Select Cloud Products e selecione o produto desejado.

3. No painel de navegação à esquerda, clique em Test.

4. Na página de depuração de API, use a left-side search box para localizar a operação de API desejada. Na aba Parameter Configuration, configure os parâmetros conforme a documentação da API. Clique na aba CLI Example, à direita de Parameter Configuration, para gerar o comando correspondente.

   • Clique no botão Run Command para abrir o Cloud Shell e depurar o comando rapidamente.

   • Clique no botão Copy para copiar o exemplo de CLI e, depois, cole-o em um shell local e execute o comando.

     • Ao colar o exemplo de CLI em um shell local, verifique se o formato dos parâmetros está correto. Para mais informações sobre formatos de parâmetros em comandos do Alibaba Cloud CLI, consulte Formatos de parâmetros.

     • O OpenAPI Explorer adiciona automaticamente a opção --region ao comando, substituindo a região padrão definida nas suas credenciais ou variáveis de ambiente. Remova essa opção caso não seja necessária.

Chamar uma API

O Alibaba Cloud CLI usa a seguinte sintaxe para chamar uma operação de API RPC:

aliyun <product> <APIName> [--parameter1 value1 --parameter2 value2 ...]

• product: O código do produto do serviço de nuvem de destino. Por exemplo, o código do produto para MongoDB é dds.

• APIName: A operação de API a ser chamada. Por exemplo, para criar uma instância de replica set, chame CreateDBInstance.

• --parameter: Os parâmetros de requisição da operação de API.

aliyun vpc CreateVpc --RegionId cn-hangzhou

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

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****"
}

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****"
}