Alibaba Cloud SDK：Gunakan Alibaba Cloud SDK untuk .NET di IDE

Buka OpenAPI Explorer. Cari operasi API yang ingin Anda panggil. Dalam contoh ini, operasi DescribeRegions dari Elastic Compute Service (ECS) digunakan. Masukkan "DescribeRegions" di kotak pencarian dan klik nama operasi di hasil pencarian untuk membuka halaman debugging API.

Di tab Parameter, tentukan parameter sesuai kebutuhan Anda. Saat menentukan parameter, baca informasi di tab Dokumen di sisi kanan halaman debugging. Pastikan Anda memahami catatan penggunaan operasi dan deskripsi setiap parameter. Perhatikan informasi terkait penagihan.

Di tab SDK Sample Code di sisi kanan halaman debugging, pilih bahasa pemrograman C# dan klik Unduh Proyek untuk mengunduh paket proyek sampel lengkap ke komputer Anda. Kemudian, ekstrak paket tersebut.

Buka VS Code, klik Buka Folder, lalu pilih folder proyek yang telah diekstrak.

Sebelum memanggil operasi ini, Anda harus mendapatkan pasangan AccessKey sebagai kredensial akses. Kami merekomendasikan agar Anda menggunakan pasangan AccessKey dari pengguna Resource Access Management (RAM). Untuk informasi lebih lanjut, lihat bagian "Buat pasangan AccessKey untuk pengguna RAM" dari topik Buat pasangan AccessKey.

Setelah mengonfigurasi pasangan AccessKey di variabel lingkungan, jalankan perintah berikut untuk menjalankan proyek. Jika tidak ada pengecualian yang dilemparkan, pemanggilan API berhasil.

cd core
dotnet run 

Buat proyek aplikasi. Buka VS Code. Di bilah navigasi atas, pilih File > Buka Folder, lalu pilih folder proyek. Jalankan perintah dotnet new console -n V2SDKProject di terminal untuk membuat proyek aplikasi konsol. Kemudian, jalankan perintah cd V2SDKProject untuk masuk ke direktori proyek.

Instal SDK. Kunjungi SDK Center dan pilih layanan cloud yang ingin Anda kelola. Dalam contoh ini, ECS digunakan. Di halaman yang muncul, pilih V2.0 dari daftar drop-down SDK Generation dan C# di bagian Semua bahasa. Salin perintah yang digunakan untuk menginstal SDK dan jalankan perintah di terminal.

dotnet add package AlibabaCloud.SDK.Ecs20140526 --version 4.1.9

Inisialisasi klien. Jika Anda ingin memanggil API ECS, Anda harus menginisialisasi klien ECS.

        public static AlibabaCloud.SDK.Ecs20140526.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // Diperlukan. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dikonfigurasi di lingkungan runtime kode. 
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Diperlukan. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi di lingkungan runtime kode. 
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
            };
            config.Endpoint = "ecs.cn-shanghai.aliyuncs.com";
            return new AlibabaCloud.SDK.Ecs20140526.Client(config);
        }

Panggil operasi API. Sebelum memanggil operasi API, Anda harus membaca dokumentasi API yang sesuai. Dalam contoh ini, operasi DescribeRegions dari ECS digunakan.

            AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest describeRegionsRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest
            {
                AcceptLanguage = "zh-CN",
            };

Tangani pengecualian. Tangani pengecualian dengan hati-hati dalam skenario bisnis aktual dan jangan abaikan pengecualian di proyek Anda. Kami merekomendasikan agar Anda mengambil langkah-langkah yang masuk akal untuk menangani pengecualian, seperti menyebarkan pengecualian dengan cara yang tepat, mencatat log, dan pulih dari pengecualian. Ini membantu memastikan ketahanan dan stabilitas sistem. Untuk informasi lebih lanjut tentang cara menangani pengecualian di SDK V2.0 untuk .NET, lihat Penanganan Pengecualian.

// File ini dibuat secara otomatis, jangan edit. Terima kasih.

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

using Tea;
using Tea.Utils;


namespace AlibabaCloud.SDK.Sample
{
    public class Sample 
    {

        /**
         * Gunakan ID AccessKey dan rahasia AccessKey Anda untuk menginisialisasi klien.
         * @return Client
         * @throws Exception
         */
        public static AlibabaCloud.SDK.Ecs20140526.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // Diperlukan. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dikonfigurasi di lingkungan runtime kode. 
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Diperlukan. Pastikan bahwa variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi di lingkungan runtime kode. 
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
            };
            config.Endpoint = "ecs.cn-shanghai.aliyuncs.com";
            return new AlibabaCloud.SDK.Ecs20140526.Client(config);
        }

        public static void Main(string[] args)
        {
            AlibabaCloud.SDK.Ecs20140526.Client client = CreateClient();
            AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest describeRegionsRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest
            {
                AcceptLanguage = "zh-CN",
            };
            AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
            try
            {
                AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsResponse resp = client.DescribeRegionsWithOptions(describeRegionsRequest, runtime);
                Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(resp));
            }
            catch (TeaException error)
            {
                // Tangani pengecualian dengan hati-hati dalam skenario bisnis aktual dan jangan pernah abaikan pengecualian di proyek Anda. Dalam contoh ini, pesan kesalahan ditampilkan di konsol. 
                // Pesan kesalahan.
                Console.WriteLine(error.Message);
                // URL halaman diagnostik kesalahan yang sesuai.
                Console.WriteLine(error.Data["Recommend"]);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(new Dictionary<string, object>
                {
                    { "message", _error.Message }
                });
                // Tangani pengecualian dengan hati-hati dalam skenario bisnis aktual dan jangan pernah abaikan pengecualian di proyek Anda. Dalam contoh ini, pesan kesalahan ditampilkan di konsol. 
                // Pesan kesalahan.
                Console.WriteLine(error.Message);
                // URL halaman diagnostik kesalahan yang sesuai.
                Console.WriteLine(error.Data["Recommend"]);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
        }

    }
}

Jalankan kode sampel.

dotnet run