Consulte instâncias do ApsaraDB for MongoDB em uma região específica chamando uma operação de API por meio de um SDK.
Consulte a documentação da API
Verifique List of operations by function para encontrar uma operação de API que consulte instâncias em uma região específica, como DescribeDBInstances. Revise o tópico DescribeDBInstances para conhecer os parâmetros de solicitação e as permissões necessários.
Crie um usuário RAM e conceda permissões a ele
Identidades
Você pode chamar a operação usando uma conta Alibaba Cloud, uma função RAM ou um usuário RAM. Para mais informações, consulte Identity, credential, and authorization. Este exemplo usa um usuário RAM para chamar a operação DescribeDBInstances. Acesse o console RAM, crie um usuário RAM e anote o par AccessKey. Para mais informações, consulte Create a RAM user.
Autorização
Acesse a página Users, localize o usuário RAM desejado e clique em Add Permissions na coluna Actions.
-
Na seção Policies, pesquise pela palavra-chave
MongoDBe selecione a política que deseja anexar.NotaAliyunMongoDBFullAccess: concede acesso total ao ApsaraDB for MongoDB.
AliyunMongoDBReadOnlyAccess: concede acesso somente leitura ao ApsaraDB for MongoDB.
Para obter informações sobre como criar uma política personalizada, consulte RAM authorization.
Clique em OK.
Credencial
O sistema gera um AccessKey padrão quando você cria um usuário RAM. Para criar um AccessKey adicional, acesse a página de detalhes do usuário RAM, navegue até a aba Certification management e clique em Create AccessKey. Para mais informações, consulte Create an AccessKey.
Chame a operação DescribeDBInstances
O exemplo a seguir usa o SDK para Java para chamar a operação DescribeDBInstances.
Configure variáveis de ambiente
Armazene o par AccessKey em variáveis de ambiente para evitar codificar credenciais diretamente no código.
Para mais informações, consulte Configure environment variables in Linux, macOS, and Windows.
Baixe o código de exemplo
Acesse a página DescribeDBInstances.
-
Na aba Parameter Configuration, defina o parâmetro necessário.
RegionId: o ID da região onde você deseja consultar as instâncias.
No lado direito, na aba SDK Sample, selecione v2.0 para a versão do SDK e Java para a linguagem. Em seguida, clique em Download Project.
Descompacte o pacote de código de exemplo no computador e abra o diretório alibabacloud_sample.
Abra e execute o projeto
Carregue o projeto no IntelliJ IDEA. Após a resolução das dependências, abra o arquivo src/main/java/com/aliyun/sample/Sample.java e adicione código para imprimir os valores retornados conforme os comentários no código.
Clique em Run no canto superior direito da IDE para visualizar o log de saída. O exemplo a seguir mostra uma resposta de amostra:
{
"headers": {
"access-control-allow-origin": "*",
"date": "Wed, 26 Jul 2023 05:45:58 GMT",
"keep-alive": "timeout=25",
"transfer-encoding": "chunked",
"vary": "Accept-Encoding",
"x-acs-request-id": "CF00C412-4BB5-5D02-803C-46D0AF71DC23",
"connection": "keep-alive",
"content-type": "application/json;charset=utf-8",
"access-control-expose-headers": "*",
"x-acs-trace-id": "48df4a01d258338ee5327a6a48628426"
},
"statusCode": 200,
"body": {
"DBInstances": {
"DBInstance": [
{
"capacityUnit": "",
"chargeType": "PostPaid",
"creationTime": "2023-07-25T06:32:25Z",
"DBInstanceClass": "mdb.shard.2x.xlarge.d",
"DBInstanceId": "dds-***",
"DBInstanceStatus": "Running",
"DBInstanceStorage": 500,
"DBInstanceType": "replicate",
"engine": "MongoDB",
"engineVersion": "5.0",
"expireTime": "2999-09-08T16:00Z",
"kindCode": "18",
"lockMode": "Unlock",
"mongosList": { "mongosAttribute": [] },
"networkType": "VPC",
"regionId": "cn-shanghai",
"replicationFactor": "3",
"resourceGroupId": "rg-***",
"shardList": { "shardAttribute": [] },
"storageType": "cloud_essd1",
"tags": { "tag": [] },
"zoneId": "cn-shanghai-m"
}
]
},
"pageNumber": 1,
"pageSize": 30,
"requestId": "CF00C412-4BB5-5D02-803C-***",
"totalCount": 3
}
}