Search accounts

Searches users, groups, and invitations in Trend Micro.

Options

Field Definition Type Required
Result Set

Choose one of the following options to display your results:

  • First Matching Record: Returns only the first record that matches the search criteria.

  • First 200 Matching Records: Returns the first 200 records that match the search criteria.

  • Stream Matching Records: Passes all records that match the search criteria from your parent flow to a helper flow.

Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.

Dropdown TRUE

To learn how to use the Stream Records option and set up a helper flow to return a large number of records, see Stream matching records with a helper flow.

Input

Field Definition Type Required
Search By
Email

The email address of the account.

Text FALSE
Status

The status of the account values.

  • Enabled

  • Disabled

  • Invited

Dropdown FALSE
Account Type

The type of the account values.

  • Local Account

  • SAML Account

  • SAML Group

Dropdown FALSE
Streaming
Flow

Click Choose Flow to browse and select a helper flow as the destination for the records. Click Choose to confirm.

Each record triggers one execution of the flow. User data is referenced through the Record input object in the helper flow.

Optionally, you can click the empty field under Click or drop here to create to add custom extensible fields that pass data to the helper flow. These fields are added as key and value pairs under the State input object in the helper flow.

This field appears when you select Stream Matching Records from the Result Set option.

Flow

TRUE
Record Limit

Specify the number of records to stream.

  • The Record Limit field can't be set to 0. When it's set to greater than 1, the stream returns up to the maximum number specified.

  • When the Record Limit field is empty, null, or not selected, the stream returns all records.

  • The default value is 1000000 (1 million).

  • The valid range is from 1 to 1000000.

This field appears when you select Stream Matching Records from the Result Set option.

Number FALSE

Output

Field Definition Type
Result
ID

The unique identifier of the account.

Text
Email

The email address of the account.

Text
Name

The name of the account.

Text
Status

The status of the account.

  • Enabled

  • Disabled

  • Invited

Text
Role

The role assigned to the account.

Text
Account Type

The type of the account.

  • Root

  • Local

  • SAML

  • SAML Group

Text
Description

A brief note or identifier for the account.

Text
Raw Output

The raw response object of an account returned by the API.

Object
Accounts

The search returns a list of up to 200 accounts that match the search criteria. This list contains the output fields for each account as individual objects.

This field appears when you select the First 200 Matching Records from the Result Set option.

List of Objects
Records Streamed

The number of records streamed in a streaming flow.

This field appears when you select Stream Matching Records from the Result Set option.

Number