Alibaba Cloud SDK:Integração do SDK

Para desenvolver com o Alibaba Cloud SDK V1.0 para .NET, é necessário integrar o Core SDK e os SDKs dos serviços individuais da Alibaba Cloud como dependências.

Informações de dependência do SDK V1.0 para produtos cloud

O SDK V1.0 para .NET de um serviço Alibaba Cloud fornece objetos de solicitação e resposta para operações de API, além de um objeto unmarshaller para serializar valores de retorno. O exemplo a seguir demonstra como adicionar o SDK do Elastic Compute Service (ECS) como dependência:

dotnet add package aliyun-net-sdk-ecs

# Specify the version using --version.
dotnet add package aliyun-net-sdk-ecs --version 4.24.18

Install-Package aliyun-net-sdk-ecs

# Specify the version using -version.
Install-Package aliyun-net-sdk-ecs -Version 4.24.18

<PackageReference Include="aliyun-net-sdk-ecs" Version="4.24.18" />

paket add aliyun-net-sdk-ecs --version 4.24.18

#r "nuget: aliyun-net-sdk-ecs, 4.24.18"

Dependências do Core SDK

O Core SDK gerencia solicitações HTTP para a OpenAPI, autenticação, algoritmos de assinatura e tratamento de exceções. Adicione a dependência conforme mostrado abaixo:

dotnet add package aliyun-net-sdk-core

Uso do SDK

1. Inicialize um cliente

No SDK V1.0 para .NET, todos os SDKs de serviços da Alibaba Cloud compartilham a mesma biblioteca principal. Utilize essa biblioteca para inicializar um cliente SDK que processará as solicitações de API. O exemplo a seguir ilustra a inicialização de um cliente. Para mais detalhes sobre os métodos de inicialização, consulte Manage access credentials.

static void Main(string[] args)
{
    IClientProfile profile = DefaultProfile.GetProfile(
        // The region ID.
        "<REGION_ID>",
        // Obtain the AccessKey ID of the RAM user from an environment variable.
        Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
        // Obtain the AccessKey secret of the RAM user from an environment variable.
        Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
    DefaultAcsClient client = new DefaultAcsClient(profile);
}

2. Construa um objeto de solicitação e inicie uma requisição

O SDK V1.0 para .NET envia solicitações de API por meio da biblioteca principal. Passe os parâmetros utilizando o objeto de solicitação do SDK do serviço e, em seguida, chame o cliente inicializado para enviar a requisição e receber um objeto de resposta. O exemplo abaixo usa o SDK do ECS para consultar informações de instâncias ECS.

using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Ecs.Model.V20140526;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample 
    {
        static void Main(string[] args)
        {
            IClientProfile profile = DefaultProfile.GetProfile(
                // The region ID.
                "<REGION_ID>",
                // Obtain the AccessKey ID of the RAM user from an environment variable.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // Obtain the AccessKey secret of the RAM user from an environment variable.
                Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
            DefaultAcsClient client = new DefaultAcsClient(profile);
            // Create a request object.
            DescribeInstancesRequest request = new DescribeInstancesRequest{
                RegionId = "<REGION_ID>"
            };;
            // Send the request from the client and serialize the result into a Response object.
            DescribeInstancesResponse response = client.GetAcsResponse(request);
            System.Console.WriteLine(response.TotalCount);
        }
    }
}

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas de idioma rigorosamente

6. Siga as regras de stopwords com tolerância zero

7. Use o modo imperativo em etapas numeradas e listas de procedimentos

8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum iniciador deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações