Elastic Compute Service:ECS Java SDK V2.0 呼び出し例

前提条件

開始する前に、以下を確認してください。

• 最小限の必要な権限を持つ RAM ユーザー。Alibaba Cloud ルートアカウントの使用は避けてください。その AccessKey ペアが侵害されると、重大なセキュリティリスクを引き起こす可能性があります。

  • この例では、読み取り専用アクセスが必要です。AliyunECSReadonlyAccess システム権限ポリシーをアタッチするか、ニーズに基づいて カスタムポリシーを作成 します。利用可能な権限については、「ECS の RAM 認可」をご参照ください。

• 環境変数として設定された AccessKey ペア。コードを実行する前に以下を設定してください。設定手順については、「AccessKey 環境変数の設定」をご参照ください。

  環境変数	値
  ALIBABA_CLOUD_ACCESS_KEY_ID	ご利用の AccessKey ID
  ALIBABA_CLOUD_ACCESS_KEY_SECRET	ご利用の AccessKey シークレット

SDK のインストール

この例では Apache Maven を使用します。代替のインストール方法については、SDK Center をご参照ください。

pom.xml の <dependencies> セクションに ECS SDK 依存関係を追加し、Maven プロジェクトを更新します。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>ecs20140526</artifactId>
  <version>5.3.0</version>
</dependency>

SDK の使用

以下のステップは、このページの下部にある 完全なサンプル に向けて構築されています。

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;

private static Client createClient() throws Exception {
    Config config = new Config()
            // 環境変数から認証情報を読み取ります。
            .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
            .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
            // 利用可能なエンドポイントは https://api.aliyun.com/product/Ecs で確認できます。
            .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
    return new Client(config);
}

// リクエストオブジェクトを構築し、対象リージョンを設定します。
DescribeInstancesRequest request = new DescribeInstancesRequest().setRegionId("cn-hangzhou");

// タイムアウトやプロキシ設定などのランタイムパラメーターを設定します。
RuntimeOptions runtime = new RuntimeOptions();
// DescribeInstances を呼び出し、レスポンスボディを出力します。
DescribeInstancesResponse response = client.describeInstancesWithOptions(request, runtime);
System.out.println(response.body.toMap());

} catch (TeaUnretryableException ue) {
    // すべてのリトライ後のネットワークレベルの障害。
    ue.printStackTrace();
    System.out.println(ue.getMessage());
    System.out.println(ue.getLastRequest());
} catch (TeaException e) {
    // API からのビジネスエラー。
    e.printStackTrace();
    System.out.println(e.getCode());
    System.out.println(e.getMessage()); // サポートチケット用の RequestId を含みます。
    System.out.println(e.getData());
} catch (Exception e) {
    e.printStackTrace();
}

完全なサンプル

以下は、上記のすべてのステップを組み合わせた、完全で実行可能な例です。

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstancesRequest;
import com.aliyun.ecs20140526.models.DescribeInstancesResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class Sample {
    private static Client createClient() throws Exception {
        Config config = new Config()
                // 環境変数から認証情報を読み取ります。
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                // 利用可能なエンドポイントは https://api.aliyun.com/product/Ecs で確認できます。
                .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
        return new Client(config);
    }

    public static void main(String[] args) {
        try {
            Client client = Sample.createClient();
            DescribeInstancesRequest request = new DescribeInstancesRequest()
                    .setRegionId("cn-hangzhou");
            RuntimeOptions runtime = new RuntimeOptions();
            DescribeInstancesResponse response = client.describeInstancesWithOptions(request, runtime);
            System.out.println(response.body.toMap());
        } catch (TeaUnretryableException ue) {
            // すべてのリトライ後のネットワークレベルの障害。
            ue.printStackTrace();
            System.out.println(ue.getMessage());
            System.out.println(ue.getLastRequest());
        } catch (TeaException e) {
            // API からのビジネスエラー。
            e.printStackTrace();
            System.out.println(e.getCode());
            System.out.println(e.getMessage());
            System.out.println(e.getData());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

次のステップ

• 汎用呼び出し — 生成された SDK メソッドなしで任意の ECS OpenAPI 操作を呼び出します。

• V1.0 Java SDK — 以前の SDK バージョンのドキュメント。