Utiliser le SDK Java pour interroger une liste d'instances dans une région spécifique - ApsaraDB for MongoDB

Interrogez les instances ApsaraDB for MongoDB dans une région spécifique en appelant une opération d'API via un SDK.

Consulter la documentation de l'API

Consultez la Liste des opérations par fonction pour identifier une opération d'API permettant d'interroger les instances dans une région donnée, telle que DescribeDBInstances. Consultez la rubrique DescribeDBInstances pour connaître les paramètres de requête requis et les autorisations nécessaires.

Créer un utilisateur RAM et lui accorder des autorisations

Identités

Vous pouvez appeler l'opération à l'aide d'un compte Alibaba Cloud, d'un rôle RAM ou d'un utilisateur RAM. Pour plus d'informations, consultez la rubrique Identité, identifiants et autorisation. Cet exemple utilise un utilisateur RAM pour appeler l'opération DescribeDBInstances. Connectez-vous à la console RAM, créez un utilisateur RAM et notez la paire AccessKey. Pour plus d'informations, consultez la rubrique Créer un utilisateur RAM.

Autorisation

Accédez à la page Utilisateurs, localisez l'utilisateur RAM cible et cliquez sur Ajouter des autorisationsAdd Permissions dans la colonne ActionsActions.
Dans la section PolitiquesPolicies, recherchez le mot-clé MongoDB et sélectionnez la politique à associer.

Remarque
AliyunMongoDBFullAccess : accorde un accès complet à ApsaraDB for MongoDB.

AliyunMongoDBReadOnlyAccess : accorde un accès en lecture seule à ApsaraDB for MongoDB.

Pour savoir comment créer une politique personnalisée, consultez la rubrique Autorisation RAM.
Cliquez sur OKOK.

Identifiant

Un AccessKey par défaut est généré lors de la création d'un utilisateur RAM. Pour créer un AccessKey supplémentaire, accédez à la page de détails de l'utilisateur RAM, ouvrez l'onglet Gestion des certificationsCertification management et cliquez sur Créer un AccessKeyCreate AccessKey. Pour plus d'informations, consultez la rubrique Créer un AccessKey.

Appeler l'opération DescribeDBInstances

L'exemple suivant utilise le SDK pour Java afin d'appeler l'opération DescribeDBInstances.

Configurer les variables d'environnement

Stockez la paire AccessKey dans des variables d'environnement afin d'éviter d'inscrire les identifiants en dur dans votre code.

Pour plus d'informations, consultez la rubrique Configurer les variables d'environnement sous Linux, macOS et Windows.

Télécharger l'exemple de code

Accédez à la page DescribeDBInstances.
Dans l'onglet Configuration des paramètresParameter Configuration, définissez le paramètre requis.
- RegionId : ID de la région dans laquelle vous souhaitez interroger les instances.
Sur la droite, dans l'onglet Exemple de SDKSDK Sample, sélectionnez v2.0 comme version du SDK et Java comme langage. Cliquez ensuite sur Télécharger le projetDownload Project.
Décompressez le package d'exemple de code sur votre ordinateur et ouvrez le répertoire alibabacloud_sample.

Ouvrir et exécuter le projet

Chargez le projet dans IntelliJ IDEA. Une fois les dépendances résolues, ouvrez le fichier src/main/java/com/aliyun/sample/Sample.java et ajoutez du code pour afficher les valeurs renvoyées, en vous basant sur les commentaires présents dans le code.

Cliquez sur le bouton ExécuterRun situé dans le coin supérieur droit de l'IDE pour consulter le journal de sortie. L'exemple ci-dessous illustre une réponse type :

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