엔터티 필터링, 순서 지정 및 페이징

  • 아티클

Media Services 로고 v3

경고

Azure Media Services는 2024년 6월 30일에 사용 중지됩니다. 자세한 내용은 AMS 사용 중지 가이드를 참조하세요.

이 항목에서는 Azure Media Services v3 엔터티를 나열할 때 사용할 수 있는 OData 쿼리 옵션 및 페이지 매김 지원에 대해 설명합니다.

고려 사항

  • Datetime 형식의 엔터티 속성은 항상 UTC 형식입니다.
  • 쿼리 문자열의 공백은 요청을 보내기 전에 URL로 인코딩되어야 합니다.

비교 연산자

다음 연산자를 사용하여 필드를 상수 값과 비교할 수 있습니다.

같음 연산자:

  • eq: 필드가 상수 값과 같은지 여부를 테스트합니다.
  • ne: 필드가 상수 값과 같지 않은지 여부를 테스트합니다.

범위 연산자:

  • gt: 필드가 상수 값보다 큰지 여부를 테스트합니다.
  • lt: 필드가 상수 값보다 작은지 여부를 테스트합니다.
  • ge: 필드가 상수 값보다 크거나 같은지 여부를 테스트합니다.
  • le: 필드가 상수 값보다 작거나 같은지 여부를 테스트합니다.

Assert

$filter를 사용하여 OData 필터 매개 변수를 제공하면 원하는 개체만 찾을 수 있습니다.

다음 REST 예제는 자산의 alternateId 값을 필터링합니다.

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/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.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/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) 값을 반환합니다. 전체 결과 집합을 통해 페이징하는 데 사용합니다.

Media Services v3에서는 페이지 크기를 구성할 수 없습니다. 페이지 크기는 엔터티의 유형에 따라 달라집니다. 자세한 내용은 다음에 나오는 개별 섹션을 참조하세요.

컬렉션을 통해 페이징하는 동안 엔터티가 생성되거나 삭제되면 변경 내용이 반환된 결과에 반영됩니다(해당 변경 내용이 다운로드되지 않은 컬렉션의 일부인 경우).

팁

항상 nextLink를 사용하여 컬렉션을 열거하고, 특정 페이지 크기에 따라 달라지지 않아야 합니다.

nextLink 값은 엔터티 페이지가 둘 이상 있는 경우에만 표시됩니다.

다음 예제에서 $skiptoken이 사용되는 위치를 고려하세요. amstestaccount를 해당하는 계정 이름으로 바꾸고 api-version 값을 최신 버전으로 설정합니다.

다음과 같은 자산 목록을 요청하는 경우:

GET  https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/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.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mediaresources/providers/Microsoft.Media/mediaServices/amstestaccount/assets?api-version=2018-07-01&$skiptoken=Asset+517"
}

그 후 가져오기 요청을 보내서 다음 페이지를 요청합니다.

https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/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);
}

논리 연산자를 사용하여 쿼리 옵션 결합

Media Services v3는 OR 및 AND 논리 연산자를 지원합니다.

다음 REST 예제에서는 작업의 상태를 확인합니다.

https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qbtest/providers/Microsoft.Media/mediaServices/qbtest/transforms/VideoAnalyzerTransform/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);

엔터티의 필터링 및 순서 지정 옵션

다음 표에서는 필터링 및 순서 지정 옵션을 다른 엔터티에 적용하는 방법을 보여줍니다.

엔터티 이름 속성 이름 Assert 주문
Assets name eq, gt, lt, ge, le asc 및 desc
properties/alternateId eq
properties/assetId eq
properties/created eq, gt, lt asc 및 desc
콘텐츠 키 정책 name eq, ne, ge, le, gt, lt asc 및 desc
properties/created eq, ne, ge, le, gt, lt asc 및 desc
properties/description eq, ne, ge, le, gt, lt
properties/lastModified eq, ne, ge, le, gt, lt asc 및 desc
properties/policyId eq, ne
작업 name eq asc 및 desc
properties/state eq, ne
properties/created gt, ge, lt, le asc 및 desc
properties/lastModified gt, ge, lt, le asc 및 desc
스트리밍 로케이터 name eq, ne, ge, le, gt, lt asc 및 desc
properties/created eq, ne, ge, le, gt, lt asc 및 desc
properties/endTime eq, ne, ge, le, gt, lt asc 및 desc
스트리밍 정책 name eq, ne, ge, le, gt, lt asc 및 desc
properties/created eq, ne, ge, le, gt, lt asc 및 desc
변환 name eq asc 및 desc
properties/created gt, ge, lt, le asc 및 desc
properties/lastModified gt, ge, lt, le asc 및 desc

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 질문하거나 업데이트를 따를 수 있습니다.