• ブール値: ブール値で検索します。
• 選択: 有効な値の定義セットを持つ検索フィールド
• ID: 一意のIDを検索
• Null: null値の検索
• Numeric: 数値で検索
• String: 文字列値で検索
• 日付範囲: 日付値で検索

• 検索するフィールド (リソースのプロパティ) の名前。フィールド名では大文字と小文字が区別されることに注意してください。
• 検索する値 (日付値の場合は日付の範囲)。
• フィールド値に対してテストする演算子です (日付値の検索には適用されません)。
• 返される項目の最大数 (初期設定は5000)。

# Set search criteria
search_criteria = api.SearchCriteria()
search_criteria.field_name = "name"
search_criteria.string_test = "equal"
search_criteria.string_value = name

# Create a search filter
search_filter = api.SearchFilter(None, [search_criteria])
search_filter.max_items = 1

# Perform the search
policies_api = api.PoliciesApi(api.ApiClient(configuration))
policies_api.search_policies(api_version, search_filter=search_filter)

# Set search criteria for platform
policy_criteria = api.SearchCriteria()
policy_criteria.field_name = "policyID"
policy_criteria.numeric_test = "equal"
policy_criteria.numeric_value = policy_id

# Set search criteria for relay
relay_criteria = api.SearchCriteria()
relay_criteria.field_name = "relayListID"
relay_criteria.numeric_test = "equal"
relay_criteria.numeric_value = relay_list_id

# Create the search filter
search_filter = api.SearchFilter(None, [policy_criteria, relay_criteria])

検索可能なフィールド

1. 検索しているリソースの種類を返す操作をクリックします。例えば、Describe a Computer操作はコンピュータリソースを返します。
2. 応答セクションで200 successful operationをクリックします。
3. フィールドの説明を読んでください。検索可能なフィールドの説明にはdatatypeとして検索可能と記載されており、datatypeにはString、Numeric、ID、Date、Boolean、Choiceが含まれます。

• 任意オブジェクトのlocaleフィールド
• オブジェクトを値として持つほとんどのフィールド (例: PolicyオブジェクトのpolicySettingsフィールド)(例外についてはコンピュータのサブオブジェクトを検索を参照)。

コンピュータサブオブジェクトの検索

{
    "hostName": "gui2-336",
    "displayName": "",
    "description": "",
    ...
    "interfaces": {
      "name": "ethernet",
      ...
    },
    "ec2VirtualMachineSummary": {
      "accountID": "123456789012",
      "availabilityZone": "ap-northeast-1",
      ...
    },
    ...
    "ID": 201
}

# Search criteria
computer_criteria = api.SearchCriteria()
computer_criteria.field_name = "ec2VirtualMachineSummary/accountID"
computer_criteria.string_test = "equal"
computer_criteria.string_value = account_id

# Search filter
max_items = None
search_filter = api.SearchFilter(max_items, computer_criteria)

# Include only the EC2 virtual machine summary in the returned computers
expand = api.Expand(api.Expand.ec2_virtual_machine_summary)

# Perform the search
computers_api = api.ComputersApi(api.ApiClient(configuration))

return computers_api.search_computers(api_version, search_filter=search_filter, expand=expand.list(), overrides=False)

Pythonコード内のフィールド名

1. 各アンダースコアの直後にある文字を大文字にします。
2. アンダースコア（_）を1つずつ削除します。

文字列検索でのワイルドカードの使用

• %: 文字以上と一致
• _; 1文字に一致

# Create the search criteria
search_criteria = api.SearchCriteria()
search_criteria.field_name = "name"
search_criteria.string_test = "equal"
search_criteria.string_value = "Base%"

ヒント ワイルドカード検索を無効にするには、SearchCriteriaオブジェクトのstringWildcardsプロパティをfalseに設定します。 search_criteria.string_wildcards = "false"

日付範囲の検索を実行する

• FirstDate: 範囲内の最も早い日付。デフォルト値は可能な限り最も早い日付です。
• FirstDateInclusive: 範囲にFirstDateを含むかどうかを示すブール値です。含む場合はtrue、含まない場合はfalseです。デフォルト値はfalseです。
• LastDate: 範囲内の後の日付。デフォルト値は可能な限り最新の日付です。
• LastDateInclusive: 範囲にLastDateを含むかどうかを示すブール値です (trueの場合は含む、falseの場合は含まない)。デフォルト値はfalseです。

# Time that rules were last updated
current_time_in_ms = int(round(time.time() * 1000))
last_updated_in_ms = current_time_in_ms - (num_days * 24 * 60 * 60 * 1000)

# Set search criteria for the date range
search_criteria = api.SearchCriteria()
search_criteria.field_name = "lastUpdated"
search_criteria.first_date_value = last_updated_in_ms
search_criteria.last_date_value = current_time_in_ms
search_criteria.first_date_inclusive = True
search_criteria.last_date_inclusive = True

# Create a search filter
search_filter = api.SearchFilter(None, [search_criteria])

# Perform the search
intrusion_prevention_rules_api = api.IntrusionPreventionRulesApi(api.ApiClient(configuration))
return intrusion_prevention_rules_api.search_intrusion_prevention_rules(api_version, search_filter=search_filter)

ヌル値を検索する

# Search criteria
computer_criteria = api.SearchCriteria()
computer_criteria.field_name = "lastSendPolicySuccess"
computer_criteria.null_test = True

# Search filter
max_items = None
search_filter = api.SearchFilter(max_items, computer_criteria)

# Include minimal information in the returned computers
expand = api.Expand(api.Expand.none)

# Perform the search
computers_api = api.ComputersApi(api.ApiClient(configuration))

return computers_api.search_computers(api_version, search_filter=search_filter, expand=expand.list(), overrides=False)

並べ替え順序

• ブール値、選択、Null、および文字列検索: 返されたオブジェクトのIDで昇順に並べ替えられます。
• ID検索: IDで並べ替え。順序が昇順か降順かはオペレーターが決定します。
  • 小なりおよび小なり: 降順
  • その他すべての演算子：昇順
• 数値検索: 検索されたフィールドで並べ替えられます。オペレーターは、順序が昇順か降順かを決定します。
  • 小なりおよび小なり: 降順
  • その他すべての演算子：昇順
  複数の検索結果が検索されたフィールドで同じ値を持つ場合、それらのオブジェクトは2次的にIDでソートされます。
• 日付検索: 検索されたフィールドで並べ替えられます。検索のために提供された日付範囲パラメータが並べ替え順序を決定します。
  • 提供されるのはLastDateのみです：降順
  • 他の組み合わせ：昇順
  複数の検索結果が検索された日付フィールドの値が同じ場合、これらのオブジェクトは2次的にIDでソートされます。
• 複数の検索条件: 複数の検索条件を使用する検索は、個々の条件のデフォルトの並べ替え順序に関係なく、ID (昇順) で並べ替えられます。

検索結果とページングを制限する

• 大なり演算子を使用したIDによる検索
• maxItemsを使用してページサイズを設定する
• 結果の前のページで最も高いIDに基づいて検索するIDの値を計算します。

# Set search criteria
search_criteria = api.SearchCriteria()
search_criteria.id_value = 0
search_criteria.id_test = "greater-than"

# Create a search filter with maximum returned items
page_size = 10
search_filter = api.SearchFilter()
search_filter.max_items = page_size
search_filter.search_criteria = [search_criteria]

# Include the minimum information in the returned Computer objects
expand = api.Expand(api.Expand.none)

# Perform the search and do work on the results
computers_api = api.ComputersApi(api.ApiClient(configuration))
paged_computers = []


while True:
    computers = computers_api.search_computers(api_version, search_filter=search_filter, expand=expand.list(), overrides=False)
    num_found = len(computers.computers)
    current_paged_computers = []
    if num_found == 0:
        print("No computers found.")
        break

    for computer in computers.computers:
        current_paged_computers.append(computer)

    paged_computers.append(current_paged_computers)

    # Get the ID of the last computer in the page and return it with the number of computers on the page
    last_id = computers.computers[-1].id
    search_criteria.id_value = last_id
    print("Last ID: " + str(last_id), "Computers found: " + str(num_found))

return paged_computers