Alibaba Cloud SDK:Integre o Alibaba Cloud SDK V2.0 para .NET

1. Acesse SDK Center e selecione o service cujo SDK você deseja usar. Neste exemplo, Short Message Service (SMS) está selecionado.

2. Na página Short Message Service, selecione C# na seção All languages. Na aba Quick Start, obtenha o método de instalação do SDK do Short Message Service (SMS).

Upload de arquivos com a operação Advance

Ao usar o Image Search ou o Visual Intelligence API (VIAPI) para processar ou fazer upload de imagens locais, a API padrão não oferece suporte a uploads diretos de arquivos. Use a operação Advance para fazer upload de arquivos por meio de streams. O service armazena temporariamente os arquivos enviados no OSS (região padrão: cn-shanghai) e os lê quando necessário. O exemplo a seguir chama a operação DetectBodyCount do VIAPI:

1. Inicialize um cliente de requisição

   Especifique tanto o RegionId quanto o endpoint do service. O RegionId define a região do OSS para o armazenamento temporário de arquivos. Se o RegionId não estiver definido, o service poderá usar uma região diferente, causando timeouts na API.

   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. Crie um objeto de requisição

   Crie o objeto de requisição <operação de API>AdvanceRequest e defina ImageURLObject para passar o stream do arquivo.

   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. Envie a requisição

   Chame o método <nome da operação de API>Advance para enviar a requisição.

   // 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);
            }
        }
    }
}

Perguntas frequentes

• Como tratar o erro "You are not authorized to perform this operation" lançado por uma operação de API?

  Causa: o par de AccessKey do usuário RAM não tem as permissões necessárias.

  Solução: conceda as permissões necessárias ao usuário RAM. Para mais informações, consulte Manage RAM user permissions.

  Por exemplo, se o erro "You are not authorized to perform this operation" for lançado pela operação de API SendMessageToGlobe, crie a seguinte política personalizada para conceder as permissões necessárias ao usuário RAM:

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

• Como tratar o erro "System.UnretryableException: One or more errors occurred" lançado por uma operação de API?

  Causa: o endpoint especificado não é compatível com esta operação de API.

  Solução: especifique um endpoint compatível e tente novamente. Para mais informações, consulte Configure endpoints.

• Como tratar o erro "ErrorCode":"InvalidAccessKeyId.NotFound","ErrorMessage":"Specified access key is not found" lançado por uma operação de API?

  Causa: o par de AccessKey não foi passado corretamente.

  Solução: verifique se o par de AccessKey está sendo passado corretamente durante a inicialização do client. Environment.GetEnvironmentVariable("XXX") lê o valor de XXX a partir das variáveis de ambiente.

Para mais informações sobre como tratar erros do SDK, consulte .NET SDK FAQ.