自由形式のカスタム問合せの実行

フリーフォーム問合せでは、結果から必要な条件、リソース属性およびリソース値を指定できる構造化問合せ言語を使用して、リソースの検索をカスタマイズできます。

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

拡張リソース問合せの構文の詳細は、検索言語の構文に関する項を参照してください。

1. 上部のナビゲーション・バーで、「リソース、サービス、ドキュメントおよびマーケットプレイスの検索」を選択し、「拡張リソース問合せ」を選択します。
2. 問合せテキスト・ボックスに、問合せ言語構文に準拠する問合せを入力し、「検索」を選択します。構文の詳細は、検索言語の構文に関する項を参照してください。
3. 必要に応じて、検索するリージョンを変更します。「現在適用済」の横にある「リージョン」を選択し、含めるリージョンを最大3つまで横にあるチェック・ボックスを選択して、「フィルタの適用」を選択します。
4. 結果をさらにフィルタするには、問合せの言語を変更します。
  
  ノート
  
  拡張問合せモードでは、問合せ言語を変更して結果をフィルタおよびソートできますが、コンソールに表示される結果リストを使用して結果をフィルタまたはソートすることはできません。また、基本検索モードから拡張問合せモードに切り替えると、デフォルトでは、結果はリソースが作成された時間でソートされます。問合せ言語のsorted by句を削除することで、最適な一致による結果のソートに変更できます。
結果は最終的に一貫性がありますが、最近作成したリソースがすぐには含まれない場合があります。予想した結果が表示されない場合は、別のリージョンに変更したり、問合せを編集できます。
oci search resource structured-searchコマンドと必須パラメータを使用して、構造化問合せ言語を使用してリソースを検索します:
```
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"
```
CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。問合せの構文の詳細は、検索言語の構文を参照してください。

SearchResources操作を実行して、構造化問合せ言語を使用してリソースを検索します。

例: 特定の定義済タグを持つインスタンス・リソースの検索

この項では、APIを使用して、リソースの定義済タグに基づいて特定のタイプのリソースを問い合せる方法について説明します。

次の問合せでは、ネームスペース「rqs」内で定義済タグを持つインスタンスが検索されます。タグのキーは「costcenter」で、キーの値は「1234」です。

query
 instance resources
 where
 (definedTags.namespace = 'rqs' && definedTags.key = 'costcenter' && definedTags.value = '1234')

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

POST /20180409/resources
Host: query.us-phoenix-1.oraclecloud.com
<authorization and other headers>
{
  "type": "Structured",
  "query": "query instance resources where (definedTags.namespace = 'rqs' && definedTags.key = 'costcenter' && definedTags.value = '1234')",
  "matchingContextType": "HIGHLIGHTS"
}

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

{
  "items" : [ {
    "resourceType" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.exampleawcbfhncvbh3siw2svbpgr3bopovy6hgnywfauxqo37ckdmr6hjya",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7cvbl63ctajep4bh6lv4vaifauxz6ec7jzg4q",
    "timeCreated" : "2018-10-31T22:48:47.855Z",
    "displayName" : "service-pkgs",
    "availabilityDomain" : "ABCd:PHX-AD-1",
    "lifecycleState" : "RUNNING",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.exampleanb3poce6z4omcvbzw66epp3pvbbww6hq7e2jfaux2lxvi3daxhra",
    "compartmentId" : "ocid1.compartment.oc1..examplea43m3udlwrzwmbcvbk5hm3umk2khgfhjcgdttawjlfauxuqwsjiya",
    "timeCreated" : "2018-10-09T23:35:30.167Z",
    "displayName" : "prod-test",
    "availabilityDomain" : "ABCd:PHX-AD-2",
    "lifecycleState" : "RUNNING",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.examples7cz4z6b5hpdly2cvb56obhaiy4gvh2hdpz4akq4fauxpakvlqgya",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7cvbl63ctajep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-06-12T19:45:24.945Z",
    "displayName" : "BackupTest",
    "availabilityDomain" : "ABCd:PHX-AD-3",
    "lifecycleState" : "STOPPED",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.compartment.oc1..exampleaexfjsiad7gbi6r4hvmcvbk3a5hgkvutlswf54ulfauxks4p2jasq",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5cvb5qa7gg5l63ctajep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-06-12T19:25:16.942Z",
    "displayName" : "personal_abc",
    "availabilityDomain" : "ABCd:PHX-AD-2",
    "lifecycleState" : "TERMINATED",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.compartment.oc1..examplealrskzczjqmrb3cvbj4yxdvqxahhffauxtu24tk5dhikoff4uliha",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7gg5l63cvbjep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-11-29T23:40:29.005Z",
    "displayName" : "test_unused",
    "availabilityDomain" : null,
    "lifecycleState" : "AVAILABLE",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  } ]
}

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

Oracle Cloud Infrastructureドキュメント

自由形式のカスタム問合せの実行

例: 特定の定義済タグを持つインスタンス・リソースの検索