Question

我一直在阅读有关此新SaaS产品的文档，但是我没有看到有关能够向设备发送消息的任何提及，例如：打开/关闭设备。

https://docs.microsoft.com/en-us/azure/iot-central/tutorial-add-device

我确实看到可以通过更改设备双胞胎来更改设备的设置。另外，我读到有一种方法可以向设备发送“回声”。但是，这些都不符合我的确切目的。

那么，有没有一种方法可以使用连接字符串发送C2D消息，该字符串可以使用例程构建？ https://docs.microsoft.com/en-us/azure/iot-central/tutorial-add-device#prepare-the-client-code

我想通过AzureFunction发送此C2D，但最好知道是否可以以某种方式将其集成到IoT-Central UI中。

满足我的要求的任何其他输入（打开/关闭设备）也将有很大帮助！

感谢和问候，

Answer 1

正如我在评论中提到的那样，Azure IoT Central对内部IoT Hub服务面向端点具有完全控制权。但是，存在一种方法，其中Azure IoT中心允许对此面向服务的终结点进行有限访问，并使用REST API处理设备孪生并在设备上调用直接方法。

以下是如何获取REST Api调用所需的授权标头的sas令牌的步骤：

从Azure IoT中心应用程序获取访问令牌。

格式为：
```
SharedAccessSignature sr=appId&sig=xxxxx&skn=myTokenName&se=1577730019340
```
请注意， appId 显示的是您的Azure IoT中心应用程序的应用程序ID

调用REST POST请求以获得 iothubTenantSasToken.sasToken

POST https://api.azureiotcentral.com/v1-beta/applications/{appId}/diagnostics/sasTokens  
Authorization:SharedAccessSignature sr=appId&sig=xxxxx&skn=myTokenName&se=1577730019340

响应具有以下格式：

{
  "iothubTenantSasToken": {
    "sasToken": "SharedAccessSignature sr=saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net&sig=xxxxx&se=1546197703&skn=service"
    },
  "eventhubSasToken": {
    "sasToken": "SharedAccessSignature sr=sb%3A%2F%2Fep-ns-saas-ep-15-262-xxxxxxxxxx.servicebus.windows.net%2Fep-ehub-saas-iothu-1044564-xxxxxxxxxx&sig=xxxxxx&se=1546197703&skn=service",
    "entityPath": "ep-ehub-saas-iothu-1044564-xxxxxxxxxx",
    "hostname": "sb://ep-ns-saas-ep-15-262-xxxxxxxxxx.servicebus.windows.net/"
    },
  "expiry": 1546197703
}

面向服务的端点调用的sasToken为：

SharedAccessSignature sr=saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net&sig=xxxxx&se=1546197703&skn=service

现在，我们可以使用一些Azure IoT中心REST API，基本上是在uri路径中使用 twins 进行的调用，例如：

https://docs.microsoft.com/en-us/rest/api/iothub/service/gettwin

https://docs.microsoft.com/en-us/rest/api/iothub/service/updatetwin

https://docs.microsoft.com/en-us/rest/api/iothub/service/replacetwin

https://docs.microsoft.com/en-us/rest/api/iothub/service/invokedevicemethod

在设备1上调用直接方法的示例：

POST https://saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net/twins/device1/methods?api-version=2018-06-30
Authorization:SharedAccessSignature sr=saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net&sig=xxxxx&se=1546197703&skn=service

body:
    {
      "methodName": "writeLine",
      "timeoutInSeconds": 20,
      "payload": {
         "input1": 12345,
         "input2": "HelloDevice"
         }
    }

更新设备孪生标签属性的示例：

PATCH https://saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net/twins/device1?api-version=2018-06-30
Authorization:SharedAccessSignature sr=saas-iothub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azure-devices.net&sig=xxxxx&se=1546197703&skn=service

body:
    {
      "tags": {
        "test":12345
        }
    }

请注意，sasToken 到期时间为60分钟。我确实建议缓存第2步中的响应对象，并根据到期时间进行刷新。

更新：

以下是使用IoT Central访问令牌在azure函数中处理设备孪生和设备直接方法的步骤。

在IoT Central应用程序中生成访问令牌，请参见以下屏幕片段：

将此访问令牌添加到功能应用程序设置中。在此示例中，使用 App设置名称 AzureIoTCAccessToken 。请注意，此访问令牌可以存储在Azure Key Vault中，请参阅更多详细信息here。
在Function App中创建HttpTrigger函数。

用以下代码替换run.csx：

#r "Newtonsoft.Json"
#r "Microsoft.Azure.WebJobs.Extensions.Http"

using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System.Linq;
using System.Text;

// reusable client proxy
static HttpClientHelper iothub = new HttpClientHelper(Environment.GetEnvironmentVariable("AzureIoTCAccessToken"));

public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    var atype = new { device = new { deviceId = "", properties = new JObject(), measurements = new JObject() } };
    var iotcobj = JsonConvert.DeserializeAnonymousType(await req.ReadAsStringAsync(), atype);

    // get deviceId, for test puspose use the device1
    string deviceId = iotcobj?.device?.deviceId ?? "device1";

    // get a device twins
    var response = await iothub.Client.GetAsync($"/twins/{deviceId}?api-version=2018-06-30");
    string jsontext = await response.Content.ReadAsStringAsync();
    log.LogInformation($"DeviceTwin: {JsonConvert.DeserializeObject(jsontext)}");

   // patch on desired property
   var patch = JsonConvert.SerializeObject(new { properties = new { desired = new { ping = DateTime.UtcNow } } });
   response = await iothub.Client.PatchAsync($"/twins/{deviceId}?api-version=2018-06-30", new StringContent(patch, Encoding.UTF8, "application/json"));
   jsontext = await response.Content.ReadAsStringAsync();
   log.LogInformation($"Patch: {JsonConvert.DeserializeObject(jsontext)}");

   // invoke a device method
   var method = new { methodName = "writeLine", timeoutInSeconds = 30, payload = new {input1 = 12345, input2 = "HelloDevice" } };
   response = await iothub.Client.PostAsJsonAsync($"/twins/{deviceId}/methods?api-version=2018-06-30", method );
   jsontext = await response.Content.ReadAsStringAsync();
   log.LogInformation($"DirectMethod: {JsonConvert.DeserializeObject(jsontext)}");

   return new OkObjectResult(jsontext);      
}

class HttpClientHelper
{
    HttpClient client;
    string accessToken;
    dynamic iothub;
    long toleranceInSeconds = 60;

    public HttpClientHelper(string accessToken)
    {
        this.accessToken = accessToken;
        this.iothub = GetIoTHubTenant(accessToken);
        string hostname = GetHostNameFromSaSToken(this.iothub.iothubTenantSasToken.sasToken);
        client = new HttpClient() { BaseAddress = new Uri($"https://{hostname}") };
        client.DefaultRequestHeaders.Add("Authorization", iothub.iothubTenantSasToken.sasToken);
    }
    public HttpClient Client
    {
        get
        {
            if((new DateTime(1970, 1, 1)).AddSeconds(this.iothub.expiry - toleranceInSeconds) < DateTime.UtcNow)
                SetAuthorizationHeader();
            return client;
        }
    }
    private void SetAuthorizationHeader()
    {
        lock (client)
        {
            if ((new DateTime(1970, 1, 1)).AddSeconds(this.iothub.expiry - toleranceInSeconds) < DateTime.UtcNow)
            {
                if (client.DefaultRequestHeaders.Contains("Authorization"))
                    client.DefaultRequestHeaders.Remove("Authorization");
                this.iothub = GetIoTHubTenant(this.accessToken);
                client.DefaultRequestHeaders.Add("Authorization", this.iothub.iothubTenantSasToken.sasToken);
            }
        }
    }
    private string GetHostNameFromSaSToken(string sastoken)
    {
        var parts = sastoken.Replace("SharedAccessSignature", "").Split(new[] { '&' }, StringSplitOptions.RemoveEmptyEntries).Select(s => s.Split(new[] { '=' }, 2)).ToDictionary(x => x[0].Trim(), x => x[1].Trim());
        return parts["sr"] ?? "";
    }

    private dynamic GetIoTHubTenant(string iotcAccessToken)
    {
        string appId = GetHostNameFromSaSToken(iotcAccessToken);
        using (var hc = new HttpClient())
        {
            hc.DefaultRequestHeaders.Add("Authorization", accessToken);
            string address = $"https://api.azureiotcentral.com/v1-beta/applications/{appId}/diagnostics/sasTokens";
            var response = hc.PostAsync(address, new StringContent("{}", Encoding.UTF8, "application/json")).Result;
            return JsonConvert.DeserializeAnonymousType(response.Content.ReadAsStringAsync().Result, new { iothubTenantSasToken = new { sasToken = "" }, expiry = 0L });
        }
    }
}

注意：，以上实现基于您的IoT Central应用程序生成的访问令牌，就像它最近已发布以提供一般可用性一样，请参见here。在更改格式等的情况下，上述解决方案中包括的所有客户端，测试人员等都将受到影响。

Answer 2

对于您的特定用例，今天要做的唯一方法是从Azure Functions中trigger a Logic App workflow using its HTTP endpoint。在Logic应用中，您可以使用 Azure IoT Central连接器来构建工作流，该连接器会更新设备属性和设置。

我们正在IoT Central中开发API，这些API可以照亮您的用例，所以请继续关注！

Answer 3

您可以尝试使用设置，该设置类型称为“切换”。为了实现它，您可以从Azure门户转到IoT Central应用程序。然后：

转到“设备资源管理器”标签
选择设备
点击设备的“设置”标签
单击右上角的“编辑模板”按钮
在“库”下找到并单击“切换”

输入切换功能的设置

如果您打算大规模进行此操作，则可以Create and Run a Job

在IoT Central中，您可以使用作业大规模管理连接的设备。作业功能使您可以对设备属性，设置和命令执行批量更新。

Answer 4

现在可以使用API来实现此目的：

https://docs.microsoft.com/en-us/rest/api/iotcentral/devices/executecomponentcommand

为通过IoT中心认证的设备发送Cloud-to-Device消息

4 个答案: