Alibaba Cloud SDK：Panggilan generik

dotnet add package aliyun-net-sdk-core

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
        public static void Main(string[] args)
        {
            IClientProfile profile = DefaultProfile.GetProfile(
                // Tentukan ID wilayah.
                "<REGION_ID>",
                // Peroleh ID AccessKey dari pengguna Resource Access Management (RAM) dari variabel lingkungan.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Peroleh rahasia AccessKey dari pengguna RAM dari variabel lingkungan.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            DefaultAcsClient client = new DefaultAcsClient(profile);
        }
    }
}

       // 2. Buat permintaan API dan konfigurasikan parameter permintaan.
        CommonRequest request = new CommonRequest();
        // 2.1  Konfigurasikan parameter permintaan umum.
        request.Domain = "ecs-cn-hangzhou.aliyuncs.com"; // Titik akhir layanan.
        request.Version = "2014-05-26"; // Versi API layanan.
        request.Action = "DescribeInstanceStatus"; // Nama operasi API. Nama operasi diperlukan untuk operasi API RPC dan opsional untuk operasi API ROA.
        request.Method = MethodType.POST; // Metode permintaan. Nilai valid: MethodType.POST, MethodType.GET, MethodType.PUT, MethodType.DELETE, MethodType.HEAD, dan MethodType.OPTIONS.
        request.Protocol = ProtocolType.HTTPS; // Protokol permintaan. Nilai valid: ProtocolType.HTTPS dan ProtocolType.HTTP.
        request.TimeoutInMilliSeconds = 1000; // Periode timeout.
        // request.UriPattern = "/";  // Jalur sumber daya, yang diperlukan oleh operasi API bergaya ROA. Jangan konfigurasikan parameter ini untuk operasi API bergaya RPC. 

        // 2.2 Konfigurasikan parameter spesifik operasi.
        // Skenario 1: Tentukan parameter query di AddQueryParameters(string key,string value).
        request.AddQueryParameters("RegionId", "cn-hangzhou");
        List<string> instanceIds = new List<string> { "i-bp124uve8zq7XXXXXXXX", "i-bp1axhql4dqaXXXXXXXX" };
        for (int i = 0; i < instanceIds.Count; i++) {
		request.AddQueryParameters($"InstanceId.{i + 1}" , instanceIds[i]);
	    }
        request.AddQueryParameters("PageNumber", "1");
        request.AddQueryParameters("PageSize", "30");

        // Skenario 2: Tentukan parameter body di AddBodyParameters(string key,string value).
        // request.AddBodyParameters("key1", "value1");
        // request.AddBodyParameters("key2", "value2");

        // Skenario 3: Untuk mengunggah file, tentukan SetContent(byte[] content,string charset,FormatType formatType). Tetapkan formatType ke FormatType.RAW. 
        // byte[] content = File.ReadAllBytes(@"<FILE_PATH>");
        // request.SetContent(content, "UTF-8",FormatType.RAW); 
        

CommonResponse response = client.GetCommonResponse(request);
System.Console.WriteLine(response.Data);

Kode sampel berikut memberikan contoh tentang cara menggunakan CommonRequest untuk memanggil operasi DescribeInstanceStatus dari ECS:

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;
class Sample
{
    static void Main(string[] args)
    {
        // Buat instance klien untuk memulai permintaan.
        IClientProfile profile = DefaultProfile.GetProfile(
            // Tentukan ID wilayah.
            "cn-hangzhou",
            // Peroleh ID AccessKey dari pengguna RAM dari variabel lingkungan.
            Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Peroleh RAHASIA AccessKey dari pengguna RAM dari variabel lingkungan.
            Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        DefaultAcsClient client = new DefaultAcsClient(profile);
        try
        {
            // Bangun permintaan.
            CommonRequest request = new CommonRequest();
            request.Domain = "ecs.aliyuncs.com";
            request.Version = "2014-05-26";
            // Tentukan nilai parameter ApiName (Action) untuk operasi API RPC.
            request.Action = "DescribeInstanceStatus";
            request.AddQueryParameters("RegionId", "cn-hangzhou");
            List<string> instanceIds = new List<string> { "i-bp124uve8zq7XXXXXXXX", "i-bp1axhql4dqaXXXXXXXX" };
            for (int i = 0; i < instanceIds.Count; i++) {
                    request.AddQueryParameters($"InstanceId.{i + 1}" , instanceIds[i]);
                }
            request.AddQueryParameters("PageNumber", "1");
            request.AddQueryParameters("PageSize", "30");
            // Mulai permintaan dan peroleh respons.
            CommonResponse response = client.GetCommonResponse(request);
            System.Console.WriteLine(response.Data);
        }
        catch (ServerException ex)
        {
            System.Console.WriteLine(ex.ToString());
        }
        catch (ClientException ex)
        {
            System.Console.WriteLine(ex.ToString());
        }
    }
}

Kode sampel berikut memberikan contoh tentang cara menggunakan CommonRequest untuk memanggil operasi API ACK untuk menanyakan semua kluster:

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;
class Sample
{
    static void Main(string[] args)
    {
        // Buat instance klien untuk memulai permintaan.
        IClientProfile profile = DefaultProfile.GetProfile(
            // Tentukan ID wilayah.
            "<REGION-ID>",
            // Peroleh ID AccessKey dari pengguna RAM dari variabel lingkungan.
            Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Peroleh RAHASIA AccessKey dari pengguna RAM dari variabel lingkungan.
            Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        DefaultAcsClient client = new DefaultAcsClient(profile);
        try
        {
            // Bangun permintaan.
            CommonRequest request = new CommonRequest();
            request.Domain = "cs.aliyuncs.com";
            request.Version = "2015-12-15";
            // Tentukan nilai parameter UriPattern untuk operasi API Restful.
            request.UriPattern = "/clusters";
            // Mulai permintaan dan peroleh respons.
            CommonResponse response = client.GetCommonResponse(request);
            System.Console.WriteLine(response.Data);
        }
        catch (ServerException ex)
        {
            System.Console.WriteLine(ex.ToString());
        }
        catch (ClientException ex)
        {
            System.Console.WriteLine(ex.ToString());
        }
    }
}

FAQ

1. Apa yang harus saya lakukan jika pesan kesalahan "The input parameter \"AccessKeyId\" that is mandatory for processing this request is not supplied." dikembalikan?

   Penyebab: Pasangan AccessKey tidak dikonfigurasi dengan benar.

   Solusi:

   1. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET dikonfigurasi.

      Linux/macOS

      echo $ALIBABA_CLOUD_ACCESS_KEY_ID
      echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

      Windows

      echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
      echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

      Jika pasangan AccessKey yang valid dikembalikan, variabel lingkungan telah dikonfigurasi dengan benar. Jika tidak ada pasangan AccessKey atau pasangan AccessKey yang tidak valid dikembalikan, konfigurasikan variabel lingkungan sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Konfigurasikan Variabel Lingkungan di Linux, macOS, dan Windows.

   2. Periksa kesalahan terkait pasangan AccessKey dalam kode.

      Contoh permintaan kesalahan:

      AccessKeyId = Environment.GetEnvironmentVariable("yourAccessKeyID"),
      AccessKeySecret = Environment.GetEnvironmentVariable("yourAccessKeySecret"),

      Contoh permintaan sukses:

      Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), 
      Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET")

2. Apa yang harus saya lakukan jika pesan kesalahan "Unhandled exception. Aliyun.Acs.Core.Exceptions.ClientException: SDK.WebException : HttpWebRequest WebException occured, the request url is XXX.cn-hangzhou.aliyuncs.com System.Net.WebException: An eile sending the request." dikembalikan?

   Penyebab: Parameter UriPattern dikonfigurasi dalam parameter permintaan umum operasi API bergaya RPC.

   Solusi: Hapus parameter UriPattern dari parameter permintaan umum.