6.2. 필드 조회
필드 이름에 조회를 추가하여 고급 쿼리에 필드 조회를 사용할 수 있습니다.
?field__lookup=value
다음과 같은 필드 조회가 지원됩니다.
- 정확한: Exact match(지정되지 않은 경우 기본 조회)을 참조하십시오. 자세한 내용은 다음 참고 사항을 참조하십시오.
- iexact: 대소문자를 구분하지 않는 버전입니다.
- contains: 필드에 값이 포함되어 있습니다.
- icontains: 대소문자를 구분하지 않는 버전이 포함되어 있습니다.
- startswith: 필드로 시작합니다.
- istartswith: startwith의 대소문자를 구분하지 않는 버전입니다.
- endwith: 필드가 값으로 끝납니다.
- iendswith: endwith의 대소문자를 구분하지 않는 버전입니다.
- regex: 지정된 정규식과 일치합니다.
- iregex: 대소문자를 구분하지 않는 정규식 버전입니다.
- gt: 비교 값보다 큽니다.
- GTE: 비교 값보다 크거나 같습니다.
- lt: 비교 값보다 적습니다.
- IKEv: 비교 값보다 적거나 같습니다.
- IsNull: 지정된 필드 또는 관련 개체가 null인지 여부를 확인합니다. 부울 값이 필요합니다.
- in: 지정된 필드의 값이 제공된 목록에 있는지 확인합니다. 항목 목록이 있어야 합니다.
-
true인 경우 부울 값을
True또는1로, false의 경우False또는0으로 지정할 수 있습니다(둘 다 대소문자를 구분하지 않음).
예를 들어 ?created__gte=2023-01-01 은 1/1/2023 이후에 생성된 항목 목록을 제공합니다.
null 값을 None 또는 Null (둘 다 대소문자를 구분하지 않음)으로 지정할 수 있지만 isnull 조회를 사용하여 null 값을 명시적으로 확인하는 것이 좋습니다.
목록을 쉼표로 구분된 값 목록으로 지정할 수 있습니다. 쿼리 문자열 매개변수를 통해 요청하는 사용자의 액세스 수준을 기준으로 필터링합니다.
-
role_level: 필터링할 역할의 수준 (예:admin_role)
이전 릴리스의 Ansible Automation Platform은 기본적으로 _exact 결과가 포함된 쿼리를 반환했습니다. 이 문제를 해결하려면 기본 필터에 대한 제한을 ?limit_exact 로 설정합니다. 예를 들어 /api/v2/jobs/?limit_exact=example.domain.com 의 결과는 다음과 같습니다.
{
"count": 1,
"next": null,
"previous": null,
"results": [
...