調用步驟

1. 已完成SDK客戶端初始化。具體內容，請參見初始化SDK。

2. 創建對應API的調用請求，生成${API名稱}+"Request"類對象實例request。

3. 通過對象實例request，使用request.${請求參數的名稱}方法，設置AIP所需的請求參數值。

4. 創建${API名稱}+"Response"類的對象實例response承載響應結果：使用Client對象實例client的${API名稱}(request)方法，獲取API對應request的響應結果，包含服務端響應的body和headers。

5. 通過對象實例response的body成員對象，使用response.body.${返回參數的名稱}方法，可獲取對應返回參數的值。

   例如：response.body.RequestId用于獲取阿里云為API請求生成的唯一標識符，其中RequestId為API的通用返回參數。通用返回參數還包含Success、ErrorMessage和Code。

6. 使用catch()方法處理異常報錯。

物聯網平臺云端API，請參見API列表。有關request中請求參數說明，及response中返回參數說明，請參見對應API文檔。

本文以調用Pub接口發布消息到Topic為例。請求參數信息，請參見Pub。

AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
{
    // 物聯網平臺實例ID。
    IotInstanceId = "${iotInstanceId}",
    // 產品ProductKey。
    ProductKey = "${productKey}",
    // 要發送的消息主體，hello world Base64 String。
    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
    // 要接收消息的設備的自定義Topic。
    TopicFullName = "/${productKey}/${deviceName}/user/get",
    // 指定消息的發送方式，支持QoS0和QoS1。
    Qos = 0,
};
//通過client對象獲得對應request的響應對象response。
try
{
    AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
    Console.WriteLine("publish message result: " + response.Body.Success);
    Console.WriteLine(response.Body.Code);
    Console.WriteLine(response.Body.ErrorMessage);
}
catch (TeaException error)
{
    Console.WriteLine(error.Code);
    Console.WriteLine(error.Message);
}
catch (Exception _error)
{
    Console.WriteLine(_error.Message);
    Console.WriteLine(_error.StackTrace);
}

完整代碼示例

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Threading.Tasks;

using Tea;
using Tea.Utils;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
        /**
         * 使用AK&SK初始化Client。
         * @param accessKeyId 
         * @param accessKeySecret
         * @param regionId
         * @return Client
         * @throws Exception
         */
        public static AlibabaCloud.SDK.Iot20180120.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
            // 您的AccessKey ID。
            config.AccessKeyId = Environment.GetEnvironmentVariable("ACCESS_KEY_ID");
            // 您的AccessKey Secret。
            config.AccessKeySecret = Environment.GetEnvironmentVariable("ACCESS_KEY_SECRET");
            // 您的可用區ID。
            config.RegionId = "cn-shanghai";
            return new AlibabaCloud.SDK.Iot20180120.Client(config);
        }


        public static void Main(string[] args)
        {
            try
            {
                AlibabaCloud.SDK.Iot20180120.Client client = CreateClient("${accessKey}", "${accessKeySecret}");
                AlibabaCloud.SDK.Iot20180120.Models.PubRequest request = new AlibabaCloud.SDK.Iot20180120.Models.PubRequest
                {
                    // 物聯網平臺實例ID。
                    IotInstanceId = "${iotInstanceId}",
                    // 產品ProductKey。
                    ProductKey = "${productKey}",
                    // 要發送的消息主體，hello world Base64 String。
                    MessageContent = Convert.ToBase64String(Encoding.Default.GetBytes("Hello World.")),
                    // 要接收消息的設備的自定義Topic。
                    TopicFullName = "/${productKey}/${deviceName}/user/get",
                    // 指定消息的發送方式，支持QoS0和QoS1。
                    Qos = 0,
                };
                AlibabaCloud.SDK.Iot20180120.Models.PubResponse response = client.Pub(request);
                Console.WriteLine("publish message result: " + response.Body.Success);
                Console.WriteLine(response.Body.Code);
                Console.WriteLine(response.Body.ErrorMessage);
            }
            catch (TeaException error)
            {
                Console.WriteLine(error.Code);
                Console.WriteLine(error.Message);
            }
            catch (Exception _error)
            {
                Console.WriteLine(_error.Message);
                Console.WriteLine(_error.StackTrace);
            }
        }
    }
}