ここでは、ApsaraDB for MongoDB の Java Software Developer Kit (SDK) の使用方法について説明します。 参考のために例も提供されています。

始める前に

  • AccessKey ペアが作成されていること。 詳細については、「AccessKey の作成」をご参照ください。
    警告 Alibaba Cloud アカウントの AccessKey ペアを保護するには、RAM ユーザーを作成し、RAM ユーザーに ApsaraDB for MongoDB にアクセスする権限を付与してから、RAM ユーザーの AccessKey を使用して Java SDK を呼び出すことを推奨します。 詳細は、「リソースアクセス管理」をご参照ください。
  • ApsaraDB for MongoDB 用の SDK インストールパッケージをダウンロードしていること。 詳細については、「SDK のダウンロード」をご参照ください。

SDK のインストール

詳細については、「Alibaba Cloud SDK for Java のインストール」をご参照ください。

手順

  1. リージョンと AccessKey ペアを設定します。 
    IClientProfile profile = DefaultProfile.getProfile("<RegonId>","<accessKeyId>","<accessSecret>");
    注
    • <RegonId>：リージョン ID。
    • <accessKeyId>：RAM ユーザーの AccessKey ID。
    • <accessSecret>：RAM ユーザーの AccessKey Secret。
  2. オプション: エンドポイントを設定します。
    エンドポイントは Alibaba Cloud サービスの API サーバーアドレスです。 各サービスは、リージョンごとにエンドポイントが異なる場合があります。 エンドポイント特定モジュールは、Alibaba Cloud SDKに組み込まれています。 SDK を呼び出してサービスへのリクエストを開始すると、SDK は、SDK クライアントの作成時に指定したリージョン ID とサービス ID に基づいてエンドポイントを自動的に識別します。 したがって、この手順はオプションです。 各リージョンのエンドポイントの詳細については、「エンドポイント」をご参照ください。 
    DefaultProfile.addEndpoint("<endpointName>","<RegonId>", "dds", "<domain>");
    注
    • <endpointName>：エンドポイントの名前。
    • <RegonId>：リージョン ID。 詳しくは、「リージョンとゾーン」をご参照ください。
    • <domain>：エンドポイント情報。 詳細については、「エンドポイント」をご参照ください。
  3. クライアントを初期化します。 
    DefaultAcsClient client = new DefaultAcsClient(profile);
  4. API リクエストを作成してパラメーターを設定します。

    次のコードでは、DescribeAccounts リクエストを例にします。

    DescribeAccountsRequest request = new DescribeAccountsRequest();
      request.setDBInstanceId("dds-********");
      request.setAccountName("root");
  5. レスポンスを確認します。 
    DescribeAccountsResponse response = client.getAcsResponse(request);

リクエストの例

port com.alibaba.fastjson.JSON;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.dds.model.v20151201.DescribeAccountsRequest;
import com.aliyuncs.dds.model.v20151201.DescribeAccountsResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

 public class ApiDescribeAccountsTest {
    IClientProfile profile = DefaultProfile.getProfile("cn-qingdao", "********", "**********");
        //Initialize the client.
        DefaultAcsClient client = new DefaultAcsClient(profile);
        DescribeAccountsRequest request = new DescribeAccountsRequest();
        request.setDBInstanceId("dds-********");
        request.setAccountName("root");
        try {
            DescribeAccountsResponse response = client.getAcsResponse(request);
            String s = JSON.toJSONString(response);
            System.out.println(s);
        }
        catch (Exception e) {
            e.printStackTrace();
        }
    }

レスポンスの例

{"accounts":[{"accountName":"root","accountStatus":"Available","dBInstanceId":"dds-********"}],"requestId":"4D********-9640ED88F3C4"}

参考資料

詳細については、「Alibaba Cloud SDK for Java の使用方法」をご参照ください。