ГОСТ Р ИСО/МЭК 19831—2017
Ор. Считается, что Ресурс удовлетворяет критериям поиска, если какое-либо из свойств в Ресурсах
будет соответствовать указанному РгорЕхрг.
Каждый из них должен быть соответствующим образом закодирован в URL с использованием про
центов.
Выбор оператора (включая «and» и «ог») ограничен на основании типа значения и атрибута. До
пустимыми операторами являются:
«от», «and»: Булевское значемие/атрибут;
’<*,’>=’. «>’. ’!=’
- \ ’!=’
: Значемие/атрибут целого типа или дата;
: Строковое значение/атрибут.
Потребители могут включать несколько фильтров в один URI. Поставщик должен рассматривать
набор фильтров как последовательность выражений, объединенных оператором «and», и запись из На
бора должна быть включена в ответное сообщение, только если она удовлетворяет всем выражениям
фильтра.
Примеры
В данных примерах используют ся следующ ие демонстрационные ссылки URL
URI к MachineCollection Точки входа в облако следующее:
/Machines
URI экземпляра Machine:
/Machines/123
URI DiskCollection экземпляра Machine:
/Machines/123/disks
URI M achineVolumeCollection экземпляра Machine:
/Machines/123/Volumes
Чтобы отфильтровать MachineCollection так, чт обы возвращ ались только экземпляры Machine
с атрибутом “пате" равным "mine", используется следующ ий фильтр:
G ET/ Machines ?$filter=name=’mine’
Чтобы отфильтровать DiskCollection у экземпляра Machine так, чт обы бы ли возвращ ены т оль
ко экземпляры Disk с форматом "ntfs", используется следующ ий фильтр:
GET /M achines/123/disks?$filter=format=’ntfs’
Если используется атрибут Sfilter, то атрибут "count" Набора должен содержать число Ресур
сов, соответст вующ их выражению фильтра.
4.1.6.2 Подмножества Наборов
Получая представление Набора Потребители могут включать параметры запроса для определе
ния подмножества объектов Набора, которые должны быть возвращены. Поставщики должны интер
претировать и обработать эти параметры запроса в соответствии с требованиями настоящего раздела.
В предыдущем подпункте было указано, как выполнить фильтрацию данных Набора. Данный подпункт
использует порядковое положение в рамках Набора для выделения подмножества.
В настоящем стандарте определеныдва параметра запроса, которые при их использовании долж
ны указывать на первое и последнее порядковые положения объектов в пределах возвращенного На
бора. Параметры запроса должны иметь форму:
?$first=4uc/ro
?Slast=число.
где "Sfirst’ указывает на порядковое положение (начиная с 1) первого объекта Набора для включе
ния в ответ, a "$last” указывает на порядковое положение (начиная с 1) последнего объекта Набора для
включения в ответ. Потребители не обязаны использовать их одновременно. Если Sfirst будет опреде
лен, a Slast не будет, то подразумеваемым значением $last должно быть числовое значение последнего
объекта в Наборе. Сдругой стороны, если Slast будет определен, a Sfirst не будет, то подразумеваемым
значением Sfirst должна быть 1.
Если любая часть диапазона, выраженного с помощью Sfirst и Slast. выйдет за пределы границ
Набора, то будут возвращены только те Ресурсы Набора (если они имеются), которые содержатся в
пределах этого диапазона. Если какая-либо часть или весь выраженный диапазон будут за пределами
Набора, сообщение об ошибке не должно генерироваться.
Примечание — Если значение Sfirst более $iast. диапазон должен представлять собой пустой массив,
поэтомуникакие Ресурсы не будутвозвращаться.
7