IoT / Client / list_security_profiles

list_security_profiles

IoT.Client.list_security_profiles(**kwargs)

Note

The IoT Device Defender detect feature will no longer be available to new customers starting August 31, 2026. If you would like to use the detect feature, sign up prior to August 31, 2026. To learn about alternatives to IoT Device Defender detect, see IoT Device Defender detect feature availability change in the IoT Device Defender Developer Guide. There is no change to IoT Device Defender audit availability.

Lists the Device Defender security profiles you’ve created. You can filter security profiles by dimension or custom metric.

Requires permission to access the ListSecurityProfiles action.

Note

dimensionName and metricName cannot be used in the same request.

See also: AWS API Documentation

Request Syntax

response = client.list_security_profiles(
    nextToken='string',
    maxResults=123,
    dimensionName='string',
    metricName='string'
)
Parameters:

  • nextToken (string) – The token for the next set of results.

  • maxResults (integer) – The maximum number of results to return at one time.

  • dimensionName (string) – A filter to limit results to the security profiles that use the defined dimension. Cannot be used with metricName

  • metricName (string) – The name of the custom metric. Cannot be used with dimensionName.

Return type:

dict

Returns:

Response Syntax

{
    'securityProfileIdentifiers': [
        {
            'name': 'string',
            'arn': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • securityProfileIdentifiers (list) –

      A list of security profile identifiers (names and ARNs).

      • (dict) –

        Identifying information for a Device Defender security profile.

        • name (string) –

          The name you’ve given to the security profile.

        • arn (string) –

          The ARN of the security profile.

    • nextToken (string) –

      A token that can be used to retrieve the next set of results, or null if there are no additional results.

Exceptions