Skip to main content
Retrieve a list of resources that match the specified criteria.
External DocumentationTo learn more, visit the AWS documentation.

​
Basic Parameters

ParameterDescription
AWS RegionsA comma-separated list of AWS regions where this action will be executed.

For example, to execute in US East and Europe, enter us-east-1,eu-west-1.

Alternatively, you can use the asterisk symbol * to run the action in all available AWS Regions.
FiltersA JSON object that represents filters used to filter the returned resources.

For more information refer to Resource Filters.

For example:
{
  “CompositeFilters”: [
    {
      “Operator”: “AND”,
      “StringFilters”: [
        {
          “FieldName”: “ResourceType”,
          “Filter”: {
            “Comparison”: “EQUALS”,
            “Value”: “AwsEc2Instance”
          }
        }
      ]
    }
  ],
  “CompositeOperator”: “AND”
}
Max ResultsThe maximum number of results to return per page. Valid values range from 1 to 100.
Next TokenA pagination token for retrieving subsequent pages of results. Can be obtained from the NextToken field in the previous response.

Notes:
* This parameter can only be used when a single region is specified.
* To use the pagination token, send the request with the exact same Filters and Sort Criteria as the original request, modifying these criteria in subsequent requests will raise an error.
Sort CriteriaA list of sort criteria objects used to sort the returned results.

For more information refer to Sort Criterion.

For example:
[
  {
    “Field”: “Region”,
    “SortOrder”: “desc”
  }
]

​
Advanced Parameters

ParameterDescription
Disable XML To JSON Auto ConvertWhen checked, XML responses are not automatically converted into JSON format.

​
Example Output

{
	"Resources": [
		{
			"AccountId": "123456789012",
			"FindingsSummary": [
				{
					"FindingType": "Software and Configuration Checks",
					"ProductName": "Security Hub",
					"Severities": {
						"Critical": 0,
						"High": 2,
						"Medium": 1,
						"Low": 0,
						"Informational": 0
					},
					"TotalFindings": 3
				}
			],
			"Region": "us-east-1",
			"ResourceCategory": "compute",
			"ResourceId": "arn:aws:ec2:us-east-1:123456789012:instance/i-0123456789abcdef0",
			"ResourceName": "my-instance",
			"ResourceType": "AwsEc2Instance"
		}
	],
	"NextToken": "string"
}

​
Workflow Library Example

Security Hub Get Resources with Aws and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop