Oracle Cloud Infrastructureドキュメント

リソースの問合せ

このトピックでは、フリー・テキスト検索を実行したり、問合せを実行して、テナンシ内のOracle Cloud Infrastructureリソースを検索する方法について説明します。 問合せでは、特定のフィールドや条件に従ってリソースを検索し、フリー・テキスト検索では、リソース・メタデータ内の任意のテキストを使用してリソースを検索します。

ノート

サポートされているリソースと問合せ言語の構文

検索は、サポートされているリソースの検索結果に基づいています。 Oracle Cloud Infrastructureサービスとリソース検索がサポートする内容を確認するには、「検索の概要」「サポートされるリソース」セクションを参照してください。

さらに、フリー・テキスト検索結果で必要な結果が得られない場合は、問合せ言語構文を使用して問合せを実行する必要があります。 問合せの構文の詳細については、「検索言語の構文」を参照してください。

コンソールの使用

次のいずれかの方法でリソースを見つけることができます:

  • フリー・テキスト検索のためのフリーフォーム・テキストの入力
  • 問合せを入力する(リソース問合せ言語の構文に基づいて)
  • サンプル問合せを変更

デフォルトでは、検索ボックスに入力されたテキストはフリー・テキスト検索として解釈されます。

フリー・テキスト検索を実行するには
カスタムのフリーフォームの問合せを実行するには
サンプル問合せを実行するには

APIの使用

APIおよび署名リクエストの使用については、REST APIおよび「セキュリティ資格証明」を参照してください。 SDKの詳細は、「ソフトウェア開発キットとコマンドライン・インタフェース」を参照してください。

次の操作を使用してリソースを検索するか、検索可能なリソースを見つけます:

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

この項では、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リファレンス・ガイドのその参照ページを参照してください。 「検索」用に索引が付けられたリソース・タイプの参照ページについては、「サポートされるリソース」を参照してください。