Alibaba Cloud SDK:Gunakan Alibaba Cloud SDK untuk Java di IDE

Buka halaman OpenAPI Explorer, lalu pilih produk dan API. Sebagai contoh, untuk memanggil API DescribeInstanceTypeFamilies dari ECS, masukkan DescribeInstanceTypeFamilies di kotak pencarian dan klik hasilnya untuk membuka halaman OpenAPI Explorer.

Pada tab Parameters di kolom tengah, tentukan parameter sesuai kebutuhan bisnis Anda. Saat menentukan parameter, baca informasi pada tab Document di kolom paling kanan. Pastikan Anda memahami catatan penggunaan operasi dan deskripsi setiap parameter. Perhatikan informasi terkait penagihan. Dalam contoh ini, operasi DescribeInstanceTypeFamilies mendukung dua parameter permintaan. Anda harus menentukan nilai seperti cn-hangzhou untuk parameter RegionId. Parameter Generation bersifat opsional. Anda dapat mengatur parameter ini ke ecs-5, yang menunjukkan keluarga instans seri V. Nilai valid parameter dapat dilihat pada tab Document.

Pada tab SDK Sample Code di kolom paling kanan, pilih bahasa pemrograman dan klik Download Project untuk mengunduh proyek SDK lengkap ke komputer Anda, lalu ekstrak paket tersebut.

Buka IntelliJ IDEA, klik File > Open, pilih folder proyek yang telah diekstrak, dan tunggu hingga Maven menginstal dependensi secara otomatis.

Sebelum memanggil operasi ini, Anda harus memperoleh Pasangan Kunci Akses sebagai kredensial akses. Disarankan untuk menggunakan Pasangan Kunci Akses milik Pengguna Resource Access Management (RAM). Untuk informasi selengkapnya, lihat bagian Buat Pasangan Kunci Akses untuk Pengguna RAM dalam topik "Buat Pasangan Kunci Akses".

Jalankan kode demo SDK.

Pada struktur direktori di sebelah kiri, klik ganda folder Sample untuk membukanya, lalu klik ikon Run di pojok kanan atas editor untuk menjalankan kode.

// File ini dibuat secara otomatis, jangan diedit. Terima kasih.
package com.aliyun.sample;
import com.aliyun.tea.*;
public class Sample {
    /**
     * Inisialisasi client akun dengan Pasangan Kunci Akses.
     * @return Client
     * @throws Exception
     */
    public static com.aliyun.ecs20140526.Client createClient() throws Exception {
        // Kebocoran kode proyek dapat menyebabkan kebocoran AccessKey dan mengancam keamanan semua resource di bawah akun Anda. Kode berikut hanya sebagai referensi.
        // Kami menyarankan agar Anda menggunakan metode yang lebih aman, seperti STS. Untuk metode autentikasi lainnya, lihat https://www.alibabacloud.com/help/document_detail/378657.html.
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur di lingkungan runtime Anda.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur di lingkungan runtime Anda.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // Untuk endpoint, lihat https://api.aliyun.com/product/Ecs
        config.endpoint = "ecs.cn-beijing.aliyuncs.com";
        return new com.aliyun.ecs20140526.Client(config);
    }
}

Lihat hasilnya. Klik di mana saja pada jendela Run di bagian bawah konsol dan tekan Ctrl+F untuk mencari statusCode. Jika muncul "statusCode":200, panggilan berhasil.

Peroleh SDK.

Buka SDK Center, lalu pilih SDK untuk produk cloud yang ingin Anda gunakan. Contoh ini menggunakan ECS. Untuk SDK Version, pilih V2.0. Untuk Language, pilih Java. Untuk installation method, contoh ini menggunakan Apache Maven.

SDK ini memerlukan Java 8 atau versi lebih baru. Di file pom.xml proyek Anda, tambahkan konfigurasi dependensi dengan groupId bernilai com.aliyun, artifactId bernilai ecs20140526, dan version bernilai 5.1.2.

Impor SDK.

Buka proyek Maven Anda di IntelliJ IDEA. Di file pom.xml, buat tag <dependencies></dependencies> baru dan salin dependensi Apache Maven dari langkah sebelumnya ke dalam tag tersebut.

    <dependencies>
        <!--ECS V2.0 SDK -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>ecs20140526</artifactId>
            <version>5.1.2</version>
        </dependency>
    </dependencies>

Klik kanan nama proyek dan pilih Maven > Reload project untuk mengunduh dependensi Maven.

Buat kelas Java.

Di direktori src/main/java proyek, klik kanan folder java dan pilih New > Java Class. Dalam contoh ini, kelas Java diberi nama Sample.

Inisialisasi client layanan cloud.

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;
public class Sample {
    public static void main(String[] args) throws Exception {
        Config config = new Config()
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
        Client client = new Client(config);
    }
}

Panggil operasi API.

Sebelum memanggil API, pahami detailnya terlebih dahulu. Untuk informasi selengkapnya, lihat dokumentasi API.

Dalam dependensi Maven untuk layanan cloud, SDK menyediakan kelas request dan kelas response untuk setiap operasi API. Kelas request mendefinisikan parameter dan tipe nilainya, sedangkan kelas response mendefinisikan parameter respons. Hal ini membantu mencegah kesalahan penulisan saat memanggil operasi.

Sebagai contoh, untuk operasi describeInstanceTypeFamilies, kelas request-nya adalah DescribeInstanceTypeFamiliesRequest dan kelas response-nya adalah DescribeInstanceTypeFamiliesResponse.

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesRequest;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesResponse;
import com.aliyun.teaopenapi.models.Config;
public class Sample {
    public static void main(String[] args) throws Exception {
            Config config = new Config()
                    .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                    .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
            Client client = new Client(config);
            DescribeInstanceTypeFamiliesRequest describeInstanceTypeFamiliesRequest = new DescribeInstanceTypeFamiliesRequest();
            describeInstanceTypeFamiliesRequest.setRegionId("cn-hangzhou");
            DescribeInstanceTypeFamiliesResponse describeInstanceTypeFamiliesResponse = client.describeInstanceTypeFamilies(describeInstanceTypeFamiliesRequest);
    }
}
              

Tangani exception. Alibaba Cloud SDK menangani exception secara terpadu.

TeaException: Jenis exception ini disebabkan oleh kesalahan bisnis. Tiga parameter berikut disediakan untuk menangani exception semacam ini:

• code: kode kesalahan yang dikembalikan saat exception terjadi.

• message: pesan kesalahan yang dikembalikan saat exception terjadi. Pesan ini berisi ID permintaan API tempat exception dilemparkan.

• data: informasi kesalahan detail yang dikembalikan oleh server saat exception terjadi.

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesRequest;
import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.teaopenapi.models.Config;
public class Sample {
    public static void main(String[] args) {
        try {
            Config config = new Config()
                    .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                    .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
            Client client = new Client(config);
            DescribeInstanceTypeFamiliesRequest describeInstanceTypeFamiliesRequest = new DescribeInstanceTypeFamiliesRequest();
            describeInstanceTypeFamiliesRequest.setRegionId("cn-hangzhou");
            DescribeInstanceTypeFamiliesResponse describeInstanceTypeFamiliesResponse = client.describeInstanceTypeFamilies(describeInstanceTypeFamiliesRequest);
        } catch (TeaException teaException) {
            // Ini hanya untuk demonstrasi. Tangani exception dengan hati-hati di proyek Anda dan jangan mengabaikannya.
            // Cetak kode kesalahan.
            System.out.println(teaException.getCode());
            // Cetak pesan kesalahan, yang mencakup RequestId.
            System.out.println(teaException.getMessage());
            // Cetak informasi kesalahan detail yang dikembalikan oleh server.
            System.out.println(teaException.getData());
        } catch (Exception e) {
            TeaException error = new TeaException(e.getMessage(), e);
            // Ini hanya untuk demonstrasi. Tangani exception dengan hati-hati di proyek Anda dan jangan mengabaikannya.
            // Pesan kesalahan.
            System.out.println(error.getMessage());
            // Alamat diagnostik.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }
    }
}