Windows üzerinde VS Code kullanarak ilk Alibaba Cloud SDK for .NET projenizi kurun ve çalıştırın.
Ön Koşullar
.NET yüklü olmalıdır. Windows'a .NET yükleme.
VS Code yüklü olmalıdır. Windows'ta .NET geliştirme ortamı kurma.
SDK'yı Kullanma
OpenAPI Explorer'dan örnek proje kullanma
Örnek proje mevcut değilse SDK'yı mevcut bir projeye yükleme bölümüne bakın.
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.
Parametreler sekmesinde API parametrelerini yapılandırın. İşlem ayrıntıları ve faturalama bilgileri için belgeler sekmesini inceleyin.
SDK Sample Code sekmesinde SDK projesini indirin ve çıkartın.
VS Code'da çıkartılan proje klasörünü açın.
-
Bir RAM kullanıcısı AccessKey çifti edinin. RAM kullanıcı için AccessKey oluşturma.
ÖnemliAccessKey çiftini ortam değişkenleri olarak yapılandırın. Linux, macOS ve Windows sistemlerinde ortam değişkenlerini yapılandırma.
-
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
VS Code'da bir .NET proje klasörü açın. Bir konsol projesi oluşturmak için
dotnet new console -n V2SDKProjectkomutunu çalıştırın, ardından projeye girmek içincd V2SDKProjectkomutunu çalıştırın.-
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 -
ECS istemcisini başlatın.
Önemliİ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.
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.
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); } -
API'yi çağırın. Hedef API için API Belgeleri bölümünü inceleyin. Aşağıdaki örnek ECS'nin
DescribeRegionsAPI'sini çağırır.NotHer API,
${APIName}${Request}adlandırma kuralını izleyen ayrı bir istek nesnesine sahiptir; örneğinDescribeRegionsRequest.AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest describeRegionsRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeRegionsRequest { AcceptLanguage = "en-US", }; -
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); } } } } -
Örnek kodu çalıştırın.
dotnet run