实体的筛选、排序和分页

本主题讨论在列出 Azure 媒体服务 v3 实体时可以使用的 OData 查询选项和分页支持。

注意事项

• 属于 Datetime 类型的实体的属性始终采用 UTC 格式。
• 在发送请求之前，应将查询字符串中的空格进行 URL 编码。

比较运算符

可以使用以下运算符将字段与常量值进行比较：

相等性运算符：

• eq：测试某个字段是否等于某个常量值。
• ne：测试某个字段是否不等于某个常量值。

范围运算符：

• gt：测试某个字段是否大于某个常量值。
• lt：测试某个字段是否小于某个常量值。
• ge：测试某个字段是否大于或等于 某个常数值。
• le：测试某个字段是否小于或等于某个常量值。

筛选器

使用 $filter 提供一个 OData 筛选器参数，以便只查找感兴趣的对象。

下面的 REST 示例根据资产的 alternateId 值进行筛选：

GET https://management.chinacloudapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01&$filter=properties/alternateId%20eq%20'unique identifier'

下面的 C# 示例根据资产的创建日期进行筛选：

var odataQuery = new ODataQuery<Asset>("properties/created lt 2018-05-11T17:39:08.387Z");
var firstPage = await MediaServicesArmClient.Assets.ListAsync(CustomerResourceGroup, CustomerAccountName, odataQuery);

排序依据

使用 $orderby 按指定的参数对返回的对象排序。 例如：

GET https://management.chinacloudapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01$orderby=properties/created%20gt%202018-05-11T17:39:08.387Z

若要按升序或降序对结果排序，请将用空格分隔的 asc 或 desc 追加到字段名称。 例如：$orderby properties/created desc。

跳过令牌

如果查询响应包含许多项，则服务将返回一个 $skiptoken (@odata.nextLink) 值，用于获取下一页结果。 使用它可以逐页浏览整个结果集。

在媒体服务 v3 中，无法配置页面大小。 页面大小因实体类型而异。 请阅读以下各个部分，了解详细信息。

如果在对集合进行分页时创建或删除了实体，则返回的结果中会反映这些更改（如果这些更改位于集合中尚未下载的部分中）。

考虑以下使用 $skiptoken 的示例。 请务必将 amstestaccount 替换为你的帐户名，并将 api-version 值设置为最新版本。

如果按如下所示请求列出资产：

GET  https://management.chinacloudapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01 HTTP/1.1
x-ms-client-request-id: dd57fe5d-f3be-4724-8553-4ceb1dbe5aab
Content-Type: application/json; charset=utf-8

将返回类似于以下内容的响应：

HTTP/1.1 200 OK

{
"value":[
{
"name":"Asset 0","id":"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/amstestaccount/assets/Asset 0","type":"Microsoft.Media/mediaservices/assets","properties":{
"assetId":"00000000-0000-0000-0000-000000000000","created":"2018-12-11T22:12:44.98Z","lastModified":"2018-12-11T22:15:48.003Z","container":"asset-00000000-0000-0000-0000-0000000000000","storageAccountName":"amsacctname","storageEncryptionFormat":"None"
}
},
// lots more assets
{
"name":"Asset 517","id":"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/amstestaccount/assets/Asset 517","type":"Microsoft.Media/mediaservices/assets","properties":{
"assetId":"00000000-0000-0000-0000-000000000000","created":"2018-12-11T22:14:08.473Z","lastModified":"2018-12-11T22:19:29.657Z","container":"asset-00000000-0000-0000-0000-000000000000","storageAccountName":"amsacctname","storageEncryptionFormat":"None"
}
}
],"@odata.nextLink":"https:// management.chinaclouapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01&$skiptoken=Asset+517"
}

然后通过发送 Get 请求来请求显示下一页：

https://management.chinacloudapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01&$skiptoken=Asset+517

以下 C# 示例显示如何枚举帐户中的所有流式处理定位符。

var firstPage = await MediaServicesArmClient.StreamingLocators.ListAsync(CustomerResourceGroup, CustomerAccountName);

var currentPage = firstPage;
while (currentPage.NextPageLink != null)
{
    currentPage = await MediaServicesArmClient.StreamingLocators.ListNextAsync(currentPage.NextPageLink);
}

使用逻辑运算符来组合查询选项

媒体服务 v3 支持 OR 和 AND 逻辑运算符。

以下 REST 示例检查作业的状态：

https://management.chinacloudapi.cn/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/qbtest/providers/Microsoft.Media/mediaServices/qbtest/transforms/AdaptiveStreaming/jobs?$filter=properties/state%20eq%20Microsoft.Media.JobState'Scheduled'%20or%20properties/state%20eq%20Microsoft.Media.JobState'Processing'&api-version=2018-07-01

可以在 C# 中构造同一查询，如下所示：

var odataQuery = new ODataQuery<Job>("properties/state eq Microsoft.Media.JobState'Scheduled' or properties/state eq Microsoft.Media.JobState'Processing'");
client.Jobs.List(config.ResourceGroup, config.AccountName, VideoAnalyzerTransformName, odataQuery);

实体的筛选和排序选项

下表显示了如何将筛选和排序选项应用于不同实体：