你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DeviceUpdateClient.GetVersionsAsync 方法

定义

命名空间:

Azure.IoT.DeviceUpdate

程序集:

Azure.IoT.DeviceUpdate.dll

包:

Azure.IoT.DeviceUpdate v1.0.0

Source:

DeviceUpdateClient.cs

获取与指定提供程序和名称匹配的所有更新版本的列表。

public virtual Azure.AsyncPageable<BinaryData> GetVersionsAsync (string provider, string name, string filter = default, Azure.RequestContext context = default);

abstract member GetVersionsAsync : string * string * string * Azure.RequestContext -> Azure.AsyncPageable<BinaryData>
override this.GetVersionsAsync : string * string * string * Azure.RequestContext -> Azure.AsyncPageable<BinaryData>

Public Overridable Function GetVersionsAsync (provider As String, name As String, Optional filter As String = Nothing, Optional context As RequestContext = Nothing) As AsyncPageable(Of BinaryData)

参数

provider

String

更新提供程序。

name

String

更新名称。

filter

String

可选，用于按 isDeployable 属性筛选更新。

context

RequestContext

请求上下文，它可以基于每个调用替代客户端管道的默认行为。

返回

AsyncPageable<BinaryData>

AsyncPageable<T>包含对象列表的服务中的 BinaryData 。 集合中每个项目的正文架构的详细信息，请参阅下面的“备注”部分。

例外

ArgumentNullException

provider 或 name 为 null。

ArgumentException

provider 或 name 是空字符串，预期为非空。

RequestFailedException

服务返回了不成功状态代码。

示例

此示例演示如何使用所需的参数调用 GetVersionsAsync 并分析结果。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new DeviceUpdateClient(endpoint, "<instanceId>", credential);

await foreach (var data in client.GetVersionsAsync("<provider>", "<name>"))
{
    JsonElement result = JsonDocument.Parse(data.ToStream()).RootElement;
    Console.WriteLine(result.ToString());
}

此示例演示如何使用所有参数调用 GetVersionsAsync，以及如何分析结果。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new DeviceUpdateClient(endpoint, "<instanceId>", credential);

await foreach (var data in client.GetVersionsAsync("<provider>", "<name>", "<filter>"))
{
    JsonElement result = JsonDocument.Parse(data.ToStream()).RootElement;
    Console.WriteLine(result.ToString());
}

注解

的 Response Body架构：

{
              value: [string],
              nextLink: string
            }

的 Response Error架构：

{
              error: {
                code: string,
                message: string,
                target: string,
                details: [Error],
                innererror: {
                  code: string,
                  message: string,
                  errorDetail: string,
                  innerError: InnerError
                },
                occurredDateTime: string (ISO 8601 Format)
              }
            }