6.2. フィールドの検索


フィールド名にルックアップを追加することで、より高度なクエリーにフィールドルックアップを使用できます。

?field__lookup=value
Copy to Clipboard Toggle word wrap

以下のフィールドのルックアップがサポートされています。

  • exact: 完全一致 (指定されていない場合はデフォルトで検索されます。詳細は以下の注記を参照してください)。
  • iexact: exact の大文字と小文字を区別しないバージョン。
  • contains: フィールドに値を含む。
  • icontains: 大文字小文字の区別のない contains。
  • startswith: 値で始まるフィールド。
  • istartswith: startswith で大文字小文字の区別なし。
  • endswith: 値で終わるフィールド。
  • iendswith: 大文字小文字の区別のない endswith。
  • regex: 特定の正規表現に一致するフィールド。
  • iregex: 正規表現の大文字と小文字を区別しないバージョン。
  • gt: Greater than の比較条件。
  • gte: Greater than or equal to の比較条件。
  • lt: Less than の比較条件。
  • lte: Less than or equal to の比較条件。
  • isnull: 特定フィールドもしくは関連オブジェクトが null かどうかをチェック。ブール値を想定。
  • in: 特定フィールドの値が提供されたリストに存在するかどうかをチェック。アイテムのリストを想定。
  • ブール値は、True の場合は True または 1、False の場合は False または 0 として指定できます (どちらも大文字と小文字は区別されません)。

たとえば、?created__gte=2023-01-01 は、1/1/2023 以降で作成されたアイテムのリストを提供します。

null 値は None または Null (どちらも大文字と小文字は区別されません) として指定できますが、isnull ルックアップを使用して null 値を明示的にチェックすることを推奨します。

リスト (in ルックアップ用) を、コンマで区切られた値のリストとして指定できます。クエリー文字列のパラメーターによるユーザーのアクセスレベルの要求をもとにしたフィルタリング。

  • role_level: フィルタリングするロールのレベル (admin_role など)
注記

Ansible Automation Platform の以前のリリースでは、デフォルトで _exact の結果を含むクエリーが返されました。回避策として、デフォルトフィルターの limit?limit_exact に設定します。たとえば、/api/controller/v2/jobs/?limit_exact=example.domain.com の結果は次のようになります。

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
...
Copy to Clipboard Toggle word wrap
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る