Integrasikan SDK .NET V1.0 - Alibaba Cloud SDK - Alibaba Cloud Documentation Center

Untuk mengembangkan aplikasi menggunakan Alibaba Cloud SDK V1.0 untuk .NET, Anda perlu mengintegrasikan Core SDK dan SDK layanan Alibaba Cloud tertentu sebagai dependensi.

Informasi dependensi SDK V1.0 untuk produk cloud

SDK V1.0 untuk .NET dari layanan Alibaba Cloud menyediakan objek permintaan dan respons untuk operasi API serta objek unmarshaller untuk melakukan serialisasi nilai kembali. Contoh berikut menunjukkan cara menambahkan SDK Elastic Compute Service (ECS) sebagai dependensi:

.NET CLI

dotnet add package aliyun-net-sdk-ecs

# Tentukan versi menggunakan --version.
dotnet add package aliyun-net-sdk-ecs --version 4.24.18

Package Manager

Install-Package aliyun-net-sdk-ecs

# Tentukan versi menggunakan -version.
Install-Package aliyun-net-sdk-ecs -Version 4.24.18

PackageReference

<PackageReference Include="aliyun-net-sdk-ecs" Version="4.24.18" />

Paket CLI

paket add aliyun-net-sdk-ecs --version 4.24.18

F# Interactive

#r "nuget: aliyun-net-sdk-ecs, 4.24.18"

Catatan

SDK V1.0 menggunakan format penamaan aliyun-net-sdk-${Product name}. Untuk informasi lebih lanjut tentang SDK V1.0 untuk produk cloud tertentu, lihat SDK Center.

Dependensi Core SDK

Core SDK menangani permintaan HTTP ke OpenAPI, autentikasi, algoritma signature, dan penanganan exception. Tambahkan dependensi sebagai berikut:

dotnet add package aliyun-net-sdk-core

Gunakan SDK

1. Inisialisasi client

Pada SDK V1.0 untuk .NET, semua SDK layanan Alibaba Cloud berbagi pustaka inti yang sama. Anda dapat menggunakan pustaka inti tersebut untuk menginisialisasi client SDK yang memproses permintaan API. Contoh berikut menunjukkan cara menginisialisasi client. Untuk informasi lebih lanjut tentang metode inisialisasi, lihat Kelola kredensial akses.

static void Main(string[] args)
{
    IClientProfile profile = DefaultProfile.GetProfile(
        // ID wilayah.
        "<REGION_ID>",
        // Dapatkan ID AccessKey Pengguna RAM dari variabel lingkungan.
        Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
        // Dapatkan Rahasia AccessKey Pengguna RAM dari variabel lingkungan.
        Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
    DefaultAcsClient client = new DefaultAcsClient(profile);
}

Catatan

Jika satu client SDK digunakan dalam beberapa thread, masalah keamanan dapat terjadi. Jika beberapa layanan Alibaba Cloud berbagi profil yang sama, akses tidak sah mungkin terjadi. Kami menyarankan Anda menggunakan SDK V2.0 untuk .NET sebagai gantinya.

2. Buat objek permintaan dan kirim permintaan

SDK V1.0 untuk .NET mengirim permintaan API melalui pustaka inti. Anda meneruskan parameter permintaan menggunakan objek permintaan dari SDK layanan, lalu memanggil client yang telah diinisialisasi untuk mengirim permintaan dan menerima objek respons. Contoh berikut menggunakan SDK ECS untuk mengkueri informasi instans ECS.

Catatan

Setiap operasi API memiliki objek permintaan dan responsnya sendiri. Penamaannya mengikuti format berikut:

${API}${Request}. Contohnya, objek permintaan dapat berupa DescribeInstancesRequest.
${API}${Response}. Contohnya, objek respons dapat berupa DescribeInstancesResponse.

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Ecs.Model.V20140526;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample 
    {
        static void Main(string[] args)
        {
            IClientProfile profile = DefaultProfile.GetProfile(
                // ID wilayah.
                "<REGION_ID>",
                // Dapatkan ID AccessKey Pengguna RAM dari variabel lingkungan.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Dapatkan Rahasia AccessKey Pengguna RAM dari variabel lingkungan.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            DefaultAcsClient client = new DefaultAcsClient(profile);
            // Buat objek permintaan.
            DescribeInstancesRequest request = new DescribeInstancesRequest{
                RegionId = "<REGION_ID>"
            };;
            // Kirim permintaan dari client dan serialisasi hasilnya ke dalam objek Response.
            DescribeInstancesResponse response = client.GetAcsResponse(request);
            System.Console.WriteLine(response.TotalCount);
        }
    }
}