# List resources using selectors

List resources for a workspace using selectors.

Endpoint: POST /iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/resources/search
Version: 1.0
Security: x-api-key

## Path parameters:

  - `org` (string, required)
    Org is the organisation identifier.
    Example: "y"

  - `project` (string, required)
    Project is the project identifier.
    Example: "0p9"

  - `identifier` (string, required)
    Workspace identifier
    Example: "Quo autem hic fuga."

## Header parameters:

  - `Harness-Account` (string, required)
    Account is the internal customer account ID.
    Example: "sn"

## Request fields (application/json):

  - `limit` (integer)
    Limit is the number of records to return for a page.
    Example: 30

  - `page` (integer)
    Page is the page number to return relative to the page 'limit'.
    Example: 1

  - `selectors` (array)
    Example: [{"include_conditions":[{"attribute":"tag.environment","operator":"equals","value":"prod"}],"path_id":"qa","provider":"aws","resource_type":"aws_instance","search_text":"some text"},{"include_conditions":[{"attribute":"tag.environment","operator":"equals","value":"prod"}],"path_id":"qa","provider":"aws","resource_type":"aws_instance","search_text":"some text"},{"include_conditions":[{"attribute":"tag.environment","operator":"equals","value":"prod"}],"path_id":"qa","provider":"aws","resource_type":"aws_instance","search_text":"some text"}]

  - `selectors.include_conditions` (array)
    The conditions to include the resource.
    Example: [{"attribute":"tag.environment","operator":"equals","value":"prod"}]

  - `selectors.include_conditions.attribute` (string, required)
    Attribute is the attribute to select on.
    Example: "region"

  - `selectors.include_conditions.operator` (string, required)
    Operator is the operator to use for the selector.
    Enum: "equals", "not_equals", "contains", "not_contains", "starts_with", "ends_with"

  - `selectors.include_conditions.value` (string, required)
    Value is the value to check.
    Example: "europe"

  - `selectors.path_id` (string)
    Path identifier to filter resources by
    Example: "qa"

  - `selectors.provider` (string)
    Provider Type to filter resources by
    Example: "aws"

  - `selectors.resource_type` (string)
    Type is the type of resource to select.
    Example: "aws_instance"

  - `selectors.search_text` (string)
    Search resources by text string
    Example: "some text"

## Response 200 fields (application/json):

  - `data_sources` (array, required)
    Example: [{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"},{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"}]

  - `data_sources.attributes` (object, required)
    A map of values related to the resource
    Example: {"ami":"ami-830c94ec","instance_type":"t2.micro"}

  - `data_sources.drift_attributes` (object, required)
    A map of values related to the resource
    Example: {"instance_type":"t2.nano"}

  - `data_sources.drift_status` (string, required)
    Indicates if this resource is experiencing drift.
    Enum: "changed", "deleted", "unchanged"

  - `data_sources.mode` (string, required)
    Mode associated with the resource.
    Enum: "resource", "data", "output"

  - `data_sources.module` (string, required)
    Module associated with the resource.
    Example: "full_stack"

  - `data_sources.name` (string, required)
    Name associated with the resource.
    Example: "app_server"

  - `data_sources.provider` (string, required)
    Cloud provider associated with the resource.
    Example: "AWS"

  - `data_sources.sensitive_attributes` (array, required)
    A list of the sensitive attribute keys
    Example: ["instance_type"]

  - `data_sources.type` (string, required)
    Type of the provisioned resource.
    Example: "S3 Bucket"

  - `outputs` (array, required)
    Example: [{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."},{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."},{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."}]

  - `outputs.name` (string, required)
    Name associated with the output.
    Example: "instance_public_ip"

  - `outputs.sensitive` (boolean, required)
    Indicates whether this value is sensitive
    Example: true

  - `outputs.value` (string, required)
    Value associated with the output.
    Example: "Qui porro dicta in eum."

  - `resources` (array, required)
    Example: [{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"},{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"}]

## Response 400 fields (application/vnd.goa.error):

  - `data_sources` (array, required)
    Example: [{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"},{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"}]

  - `data_sources.attributes` (object, required)
    A map of values related to the resource
    Example: {"ami":"ami-830c94ec","instance_type":"t2.micro"}

  - `data_sources.drift_attributes` (object, required)
    A map of values related to the resource
    Example: {"instance_type":"t2.nano"}

  - `data_sources.drift_status` (string, required)
    Indicates if this resource is experiencing drift.
    Enum: "changed", "deleted", "unchanged"

  - `data_sources.mode` (string, required)
    Mode associated with the resource.
    Enum: "resource", "data", "output"

  - `data_sources.module` (string, required)
    Module associated with the resource.
    Example: "full_stack"

  - `data_sources.name` (string, required)
    Name associated with the resource.
    Example: "app_server"

  - `data_sources.provider` (string, required)
    Cloud provider associated with the resource.
    Example: "AWS"

  - `data_sources.sensitive_attributes` (array, required)
    A list of the sensitive attribute keys
    Example: ["instance_type"]

  - `data_sources.type` (string, required)
    Type of the provisioned resource.
    Example: "S3 Bucket"

  - `outputs` (array, required)
    Example: [{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."},{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."},{"name":"instance_public_ip","sensitive":true,"value":"Officia magnam voluptates."}]

  - `outputs.name` (string, required)
    Name associated with the output.
    Example: "instance_public_ip"

  - `outputs.sensitive` (boolean, required)
    Indicates whether this value is sensitive
    Example: true

  - `outputs.value` (string, required)
    Value associated with the output.
    Example: "Qui porro dicta in eum."

  - `resources` (array, required)
    Example: [{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"},{"attributes":{"ami":"ami-830c94ec","instance_type":"t2.micro"},"drift_attributes":{"instance_type":"t2.nano"},"drift_status":"changed","mode":"resource","module":"full_stack","name":"app_server","provider":"AWS","sensitive_attributes":["instance_type"],"type":"S3 Bucket"}]

## Response 401 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 403 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 404 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 408 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 409 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 423 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 499 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 500 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 502 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true