リソース検索結果のフィルタリング

フィルタを適用して、様々なリソース属性に従ってリソース結果のリストを絞り込みます。

リソースの検索から結果をフィルタする方法は、結果の検索に使用するモードによって異なります。

基本検索モードでは、コンソールを使用してリソース検索結果をフィルタリングする様々な方法がサポートされています。ページ内検索ボックスを使用するか、結果リストの列見出しを使用できます。このトピックでは、ページ内検索ボックスを使用してフィルタにアクセスする方法について説明しますが、結果リストの列見出しのフィルタの動作は同じです。

拡張問合せモードでは、問合せ言語構文を使用したリソースのフィルタリングおよびソートがサポートされます。条項を追加または削除したり、条項の内容を変更することで、結果を効果的にフィルタできます。結果をフィルタしない実行できる問合せは、すべてに対する問合せのみです。問合せによって返された結果のフィルタがコンソール自体に存在しません。

次の情報を理解すると、リソース検索結果をフィルタして、必要なものを見つけやすくなります。

デフォルトでは、フリー・テキスト検索または基本検索モードでそれらの間に空白を含む文字列が複数ある場合、コンソールは検索文字列のいずれかを含むリソースを検索します。検索では、検索文字列のすべてを含むリソースは検索されません。フリー・テキスト検索の詳細は、「フリー・テキスト検索」を参照してください。
ページ内検索ボックスまたは検索結果のリストの列見出しを使用して、結果にフィルタを適用できます。コンソールには、フィルタに対する変更が両方の場所で反映されます。
一部のフィルタには、デフォルトで可能なすべての属性値が含まれます。つまり、コンパートメント・フィルタには、フィルタから削除するコンパートメントを指定するまで、検索内のすべてのコンパートメントが含まれます。一方、デフォルトでは、他のフィルタは属性値と一致しません。
フィルタをクリアできます。詳細は、リソース検索フィルタのクリアを参照してください。
フィルタは変更できます。詳細は、リソース検索フィルタの変更を参照してください。
結果をソートできます。詳細は、リソース検索結果のソートを参照してください。

これらのステップでは、すでにフリー・テキスト検索を実行し、「フリー・テキスト検索の実行」の手順に従って結果の「リソース」カテゴリを選択していることを前提としています。
1. 「リソース」ページで、検索ボックスを選択し、フィルタされた検索結果に含めるリソース・タイプまたはリソース属性を入力または選択します。(使用可能な属性は、結果リストのリソース・タイプによって異なります。)
2. 続いて、次のいずれかを行います:
  
  事前定義済オプションを提供するフィルタを選択した場合は、メニューからオプションを選択するか、1つ以上のチェック・ボックスを選択します。
  
  潜在的な検索結果を比較するリソース属性の値を指定する必要があるフィルタを選択した場合は、フィルタ・ボックスを選択して適切な値を入力します。(ノート:カスタム値を入力できるフィルタでは、フィルタを適用する前に3文字以上入力する必要があります。)
  
  「表示名」または「OCID」フィルタを選択した場合、どちらのフィルタにも一度に1つの値のみを入力できます。
  
  「タグ」フィルタを選択した場合は、最初にメニュー・オプションからタグのタイプを選択します。次に、「いずれかの値と一致」と「一致する値を指定」のどちらを使用するかを指定します。最後に、フィルタを照合する値を指定します。
  
  時間ベースのフィルタを選択した場合、「開始日」、「開始時間」、「終了日」および「終了時間」を指定します。
3. 準備ができたら、「フィルタの適用」を選択します。
4. (オプション)別のフィルタを追加するには、前のステップを繰り返します。
リソースの検索時にフィルタを適用するには、oci search resource structured-searchコマンドと必要なパラメータを使用します:
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"
CLIコマンドのパラメータおよび値のリストは、CLIコマンド・リファレンスを参照してください。問合せの構文の詳細は、検索言語の構文を参照してください。

SearchResources操作を実行して、構造化問合せ言語を使用してリソースをフィルタ処理します。

例: 特定の文字列を含むリソースタイプのすべてのリソース属性の検索

この項では、APIを使用して、特定の文字列に一致する特定のリソース・タイプのすべての索引付きフィールドを問い合せる方法について説明します。

次の問合せは、「doe」を含む属性を持つユーザーを検索します。

query
 user resources
 matching
 'doe'

SearchResources操作を使用して問合せを発行すると、リクエストは次のようになります。(この例では、認可ヘッダーとその他のヘッダーが意図的に省略されています。)

POST /20180409/resources
Host: query.us-phoenix-1.oraclecloud.com
<authorization and other headers>
{
  "type": "Structured",
  "query": "query user resources matching 'doe'",
  "matchingContextType": "HIGHLIGHTS"
}

問合せで結果が生成される場合、レスポンスには、指定したリソース・タイプおよびタグに一致するリソースがリストされます。次のレスポンスが表示されます。

{
  "items" : [ {
    "resourceType" : "User",
    "identifier" : "ocid1.user.oc1..examplea26nj4iqy2mbfauxovw5viuyblsbdn3p6cvbdmbrjtalxgjqdnemq",
    "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq",
    "timeCreated" : "2020-12-10T14:41:02.185Z",
    "displayName" : "janedoe",
    "availabilityDomain" : "ABCd:PHX-AD-3",
    "lifecycleState" : "ACTIVE",
    "freeformTags" : { },
    "definedTags" : { },
    "systemTags" : { },
    "searchContext" : {
      "highlights" : {
        "displayName" : [ "<hl>janedoe</hl>" ],
        "name" : [ "<hl>janejdoe</hl>" ],
        "description" : [ "Jane <hl>Doe</hl> - <hl>jane.doe</hl>@example.com" ]
      }
    },
    "identityContext" : { },
    "additionalDetails" : { }
  }, {
    "resourceType" : "User",
    "identifier" : "ocid1.user.oc1..examplea27jaoic76zube2d6faux5hch5fsj36qetod474g57cvbhguoegfa",
    "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq",
    "timeCreated" : "2022-09-22T15:14:44.285Z",
    "displayName" : "sdoerner",
    "availabilityDomain" : "ABCd:PHX-AD-3",
    "lifecycleState" : "ACTIVE",
    "freeformTags" : { },
    "definedTags" : { },
    "systemTags" : { },
    "searchContext" : {
      "highlights" : {
        "displayName" : [ "<hl>sdoerner</hl>" ],
        "name" : [ "<hl>sdoerner</hl>" ],
        "description" : [ "Scott <hl>Doerner</hl> - <hl>scott.doerner</hl>@example.com" ]
      }
    },
    "identityContext" : { },
    "additionalDetails" : { }
  }, {
    "resourceType" : "User",
    "identifier" : "ocid1.user.oc1..examplea2agbfauxqj57pwe2txjdc6mjdkcncdt5m5bmcvbbzznxzscixd7a",
    "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq",
    "timeCreated" : "2020-09-11T22:00:26.311Z",
    "displayName" : "patdoerr",
    "availabilityDomain" : "ABCd:PHX-AD-2",
    "lifecycleState" : "ACTIVE",
    "freeformTags" : { },
    "definedTags" : { },
    "systemTags" : { },
    "searchContext" : {
      "highlights" : {
        "displayName" : [ "<hl>patdoerr</hl>" ],
        "name" : [ "<hl>patdoerr</hl>" ],
        "description" : [ "Pat <hl>Doerr</hl> - <hl>pat.doerr</hl>@example.com" ]
      }
    },
    "identityContext" : { },
    "additionalDetails" : { }
  } ]
}

これらの結果を使用すると、必要に応じてさらにアクションを実行できます。リソース・タイプ(その属性など)の詳細は、APIリファレンス・ガイドのその参照ページを参照してください。検索用に索引付けされたリソース・タイプの参照ページについては、サポートされるリソースを参照してください。

Oracle Cloud Infrastructureドキュメント

リソース検索結果のフィルタリング