Tüm Ürünler
Search
Belge Merkezi

Alibaba Cloud SDK:IDE'de Alibaba Cloud SDK for .NET Kullanımı

Son Güncelleme:Oct 07, 2026

Windows üzerinde VS Code kullanarak ilk Alibaba Cloud SDK for .NET projenizi kurun ve çalıştırın.

Ön Koşullar

SDK'yı Kullanma

OpenAPI Explorer'dan örnek proje kullanma

Not

Örnek proje mevcut değilse SDK'yı mevcut bir projeye yükleme bölümüne bakın.

  1. OpenAPI Explorer içinde çağrılacak API işlemini (örneğin ECS DescribeRegions) arayın ve hata ayıklama sayfasını açmak için API adına tıklayın.

  2. Parametreler sekmesinde API parametrelerini yapılandırın. İşlem ayrıntıları ve faturalama bilgileri için belgeler sekmesini inceleyin.

  3. SDK Sample Code sekmesinde SDK projesini indirin ve çıkartın.

  4. VS Code'da çıkartılan proje klasörünü açın.

  5. Bir RAM kullanıcısı AccessKey çifti edinin. RAM kullanıcı için AccessKey oluşturma.

    Önemli

    AccessKey çiftini ortam değişkenleri olarak yapılandırın. Linux, macOS ve Windows sistemlerinde ortam değişkenlerini yapılandırma.

  6. Projeyi çalıştırın. Özel durum içermeyen bir yanıt işlemin başarılı olduğunu gösterir.

    cd core
    dotnet run 

SDK'yı mevcut bir projeye yükleme

  1. VS Code'da bir .NET proje klasörü açın. Bir konsol projesi oluşturmak için dotnet new console -n V2SDKProject komutunu çalıştırın, ardından projeye girmek için cd V2SDKProject komutunu çalıştırın.

  2. SDK'yı yükleyin. SDK Center içinde bir cloud ürünü seçin (bu örnekte ECS), SDK Version değerini V2.0 olarak, dili ise C# olarak ayarlayın ve yükleme komutunu kopyalayıp çalıştırın.

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

  3. ECS istemcisini başlatın.

    Önemli
    1. İstemciyi başlatırken kimlik doğrulamayı tamamlamak için bir AccessKey çifti kullanmanız gerekir. Bu durumda önceden bir AccessKey çifti edinmeniz gerekir. AccessKey çifti edinme hakkında daha fazla bilgi için bkz. AccessKey oluşturma.

    2. Bir RAM kullanıcısının AccessKey çiftini edindikten sonra bu çifti ortam değişkenlerinde yapılandırmanız gerekir. Daha fazla bilgi için bkz. Linux, macOS ve Windows'ta ortam değişkenlerini yapılandırma.

    3. Uç nokta yapılandırma hakkında daha fazla bilgi için bkz. Uç noktalar.

            public static AlibabaCloud.SDK.Ecs20140526.Client CreateClient()
            {
                AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
                {
                    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
                    AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
                    AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                };
                // For more information about endpoints, see https://api.alibabacloud.com/product/Ecs
                config.Endpoint = "ecs.cn-shanghai.aliyuncs.com";
                return new AlibabaCloud.SDK.Ecs20140526.Client(config);
            }
  4. API'yi çağırın. Hedef API için API Belgeleri bölümünü inceleyin. Aşağıdaki örnek ECS'nin DescribeRegions API'sini çağırır.

    Not

    Her API, ${APIName}${Request} adlandırma kuralını izleyen ayrı bir istek nesnesine sahiptir; örneğin DescribeRegionsRequest.

                AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest describeRegionsRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest
                {
                    AcceptLanguage = "en-US",
                };
  5. Hata işlemeyi ekleyin. Özel durum işleme.

    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 
        {
    
            /**
             * Use an AccessKey ID and AccessKey secret to initialize the client.
             * @return Client
             * @throws Exception
             */
            public static AlibabaCloud.SDK.Ecs20140526.Client CreateClient()
            {
                AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
                {
                    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
                    AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
                    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 = "en-US",
                };
                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)
                {
                    // This is for demonstration only. Handle exceptions with caution and do not ignore them in your project.
                    // Error message
                    Console.WriteLine(error.Message);
                    // Diagnosis URL
                    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 }
                    });
                    // This is for demonstration only. Handle exceptions with caution and do not ignore them in your project.
                    // Error message
                    Console.WriteLine(error.Message);
                    // Diagnosis URL
                    Console.WriteLine(error.Data["Recommend"]);
                    AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
                }
            }
    
        }
    }
  6. Örnek kodu çalıştırın.

    dotnet run

Referanslar

Gelişmiş Konular