Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 24, 2026

Crie uma instância de conjunto de réplicas do ApsaraDB for MongoDB utilizando o Alibaba Cloud CLI.

Para uma introdução ao Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI?.

Arquitetura de recursos

image.png

O modelo crie uma VPC e um vSwitch em uma região especificada e, em seguida, crie uma instância de conjunto de réplicas do MongoDB.

Instale o CLI

  • Para instale e configure o Alibaba Cloud CLI no seu computador, consulte a Installation Guide.

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

Configure permissões

O Alibaba Cloud CLI utiliza as credenciais do usuário atual. Certifique-se de que esse usuário possua as seguintes permissões:

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

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

Gerar um exemplo de CLI

  1. Faça logon no OpenAPI Explorer.

  2. No topo da página, clique em Select Cloud Products e selecione o product desejado.

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

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

    • Clique em no botão Run Command运行命令.png para abrir o Cloud Shell e depurar o comando rapidamente.

    • Clique em no botão Copy复制.png para copiar o exemplo de CLI. Em seguida, 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 dos comandos do Alibaba Cloud CLI, consulte Parameter formats.

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

Chamar uma API

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

aliyun <product> <APIName> [--parameter1 value1 --parameter2 value2 ...]
  • product: o código do product do cloud service de destino. Por exemplo, o código do product para o MongoDB é dds.

  • APIName: a operação de API a ser chamada. Por exemplo, para crie uma instância de conjunto de réplicas, chame CreateDBInstance.

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

Crie uma VPC

Para informações sobre os parâmetros de CreateVpc, consulte CreateVpc.

Exemplo:

aliyun vpc CreateVpc --RegionId cn-hangzhou

Saída de exemplo:

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

Crie um vSwitch

Para informações sobre os parâmetros de CreateVSwitch, consulte CreateVSwitch.

Exemplo:

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

Saída de exemplo:

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

Crie uma instância do MongoDB

Para informações sobre os parâmetros de CreateDBInstance, consulte CreateDBInstance.

Exemplo:

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

Saída de exemplo:

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