Alibaba Cloud SDK:.NET için Alibaba Cloud SDK V2.0 Entegrasyonu

1. SDK Center adresine gidin ve SDK'sını kullanmak istediğiniz hizmeti seçin. Bu örnekte, Short Message Service (SMS) seçilmiştir.

2. Short Message Service sayfasında , All languages bölümünden C# dilini seçin. Quick Start sekmesinde, Short Message Service (SMS) SDK'sının kurulum yöntemini edinin.

 public static AlibabaCloud.SDK.Dysmsapi20180501.Client CreateClient(){
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID is set.
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_SECRET is set.
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
            };
            config.Endpoint = "dysmsapi.aliyuncs.com";
            return new AlibabaCloud.SDK.Dysmsapi20180501.Client(config);
        }

// Create request object and set required input parameters
AlibabaCloud.SDK.Dysmsapi20180501.Models.SendMessageToGlobeRequest sendMessageToGlobeRequest = new AlibabaCloud.SDK.Dysmsapi20180501.Models.SendMessageToGlobeRequest
            {   
                // Please replace with the actual recipient number.
                To = "<PHONE_NUMBER>",
                // Please replace with the actual SMS content.
                Message = "<YOUR_MESSAGE>",
            };

 // Create runtime parameters.
 AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
 AlibabaCloud.SDK.Dysmsapi20180501.Client client = CreateClient();
 // Send a request.
 AlibabaCloud.SDK.Dysmsapi20180501.Models.SendMessageToGlobeResponse response = client.SendMessageToGlobeWithOptions(sendMessageToGlobeRequest, runtime);

Advance işlemiyle dosya yükleme

Image Search veya Visual Intelligence API (VIAPI) kullanarak yerel görüntüleri işlerken veya yüklerken standart API doğrudan dosya yüklemeyi desteklemez. Dosyaları akışlar aracılığıyla yüklemek için Advance işlemini kullanın. Hizmet, yüklenen dosyaları OSS'te geçici olarak depolar (varsayılan bölge: cn-shanghai) ve gerektiğinde bunları geri okur. Aşağıdaki örnek, VIAPI'nin DetectBodyCount işlemini çağırır:

1. Bir istemci nesnesini başlatın

   Hem RegionId hem de hizmet endpoint değerlerini belirtin. RegionId değeri, geçici dosya depolama için OSS bölgesini ayarlar. RegionId ayarlanmazsa hizmet farklı bir bölge kullanabilir ve bu durum API zaman aşımlarına neden olabilir.

   public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient()
   {
       AlibabaCloud.OpenApiClient.Models.Config config =
           new AlibabaCloud.OpenApiClient.Models.Config
           {
               // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
               AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
               // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
               AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
           };
       config.RegionId = "cn-shanghai";
       config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
       return new AlibabaCloud.SDK.Facebody20191230.Client(config);
   }

2. Bir istek nesnesi oluşturun

   <API işlemi>AdvanceRequest istek nesnesini oluşturun ve dosya akışını iletmek için ImageURLObject değerini ayarlayın.

   AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest detectBodyCountAdvanceRequest =
       new AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest
       {
           ImageURLObject = File.OpenRead(@"<FILE_PATH>"), // Replace <FILE_PATH> with the actual file path.
       };   

3. Bir istek başlatın

   İsteği göndermek için <API işlemi adı>Advance yöntemini çağırın.

   // Configure the runtime parameters.
   AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
   AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient();
   // Send the request.
   AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountResponse response = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
   Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(response));

// dotnet add package AlibabaCloud.SDK.Facebody20191230 --version 4.1.2

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
    {
        public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config =
                new AlibabaCloud.OpenApiClient.Models.Config
                {
                    // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
                    AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                    // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
                    AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                };
            config.RegionId = "cn-shanghai";
            config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
            return new AlibabaCloud.SDK.Facebody20191230.Client(config);
        }

        public static void Main(string[] args)
        {
            try
            {
                AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient();
                // Replace <FILE_PATH> with the actual file path.
                using (FileStream fileStream = File.OpenRead(@"<FILE_PATH>"))
                {
                    AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest detectBodyCountAdvanceRequest =
                        new AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest
                        {
                            ImageURLObject = fileStream,
                        };
                    AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
                    AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountResponse response =
                        client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
                    Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(response));
                }
            }
            catch (TeaException error)
            {
                // Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error messages displayed in this example are for reference only. 
                Console.WriteLine(error.Message);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(
                    new Dictionary<string, object> { { "message", _error.Message } }
                );
                // Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error messages displayed in this example are for reference only. 
                Console.WriteLine(error.Message);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
        }
    }
}

SSS

• Bir API işlemi tarafından oluşturulan "You are not authorized to perform this operation" hatasını nasıl işlerim?

  Neden: RAM kullanıcısının AccessKey çifti gerekli izinlere sahip değildir.

  Çözüm: RAM kullanıcısına gerekli izinleri verin. Daha fazla bilgi için bkz. RAM kullanıcı izinlerini yönetme.

  Örneğin, SendMessageToGlobe API işlemi "You are not authorized to perform this operation" hatasını oluşturuyorsa gerekli izinleri RAM kullanıcısına vermek için aşağıdaki özel ilkeyi oluşturun:

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": "dysms:SendMessageToGlobe",
        "Resource": "*"
      }
    ]
  }

• Bir API işlemi tarafından oluşturulan "System.UnretryableException: One or more errors occurred" hatasını nasıl işlerim?

  Neden: Belirtilen uç nokta bu API işlemi tarafından desteklenmiyor.

  Çözüm: Desteklenen bir uç nokta belirtin ve tekrar deneyin. Daha fazla bilgi için bkz. Uç noktaları yapılandırma.

• Bir API işlemi tarafından oluşturulan "ErrorCode":"InvalidAccessKeyId.NotFound","ErrorMessage":"Specified access key is not found" hatasını nasıl işlerim?

  Neden: AccessKey çifti doğru şekilde iletilmedi.

  Çözüm: İstemci başlatma sırasında AccessKey çiftinin doğru şekilde iletildiğini doğrulayın. Environment.GetEnvironmentVariable("XXX") ifadesi, XXX değerini ortam değişkenlerinden okur.

SDK hatalarının nasıl işleneceği hakkında daha fazla bilgi için bkz. .NET SDK SSS.