IoT / Paginator / ListRelatedResourcesForAuditFinding

ListRelatedResourcesForAuditFinding#

class IoT.Paginator.ListRelatedResourcesForAuditFinding#
paginator = client.get_paginator('list_related_resources_for_audit_finding')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from IoT.Client.list_related_resources_for_audit_finding().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    findingId='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • findingId (string) –

    [REQUIRED]

    The finding Id.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'relatedResources': [
        {
            'resourceType': 'DEVICE_CERTIFICATE'|'CA_CERTIFICATE'|'IOT_POLICY'|'COGNITO_IDENTITY_POOL'|'CLIENT_ID'|'ACCOUNT_SETTINGS'|'ROLE_ALIAS'|'IAM_ROLE'|'ISSUER_CERTIFICATE',
            'resourceIdentifier': {
                'deviceCertificateId': 'string',
                'caCertificateId': 'string',
                'cognitoIdentityPoolId': 'string',
                'clientId': 'string',
                'policyVersionIdentifier': {
                    'policyName': 'string',
                    'policyVersionId': 'string'
                },
                'account': 'string',
                'iamRoleArn': 'string',
                'roleAliasArn': 'string',
                'issuerCertificateIdentifier': {
                    'issuerCertificateSubject': 'string',
                    'issuerId': 'string',
                    'issuerCertificateSerialNumber': 'string'
                },
                'deviceCertificateArn': 'string'
            },
            'additionalInfo': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • relatedResources (list) –

      The related resources.

      • (dict) –

        Information about a related resource.

        • resourceType (string) –

          The type of resource.

        • resourceIdentifier (dict) –

          Information that identifies the resource.

          • deviceCertificateId (string) –

            The ID of the certificate attached to the resource.

          • caCertificateId (string) –

            The ID of the CA certificate used to authorize the certificate.

          • cognitoIdentityPoolId (string) –

            The ID of the Amazon Cognito identity pool.

          • clientId (string) –

            The client ID.

          • policyVersionIdentifier (dict) –

            The version of the policy associated with the resource.

            • policyName (string) –

              The name of the policy.

            • policyVersionId (string) –

              The ID of the version of the policy associated with the resource.

          • account (string) –

            The account with which the resource is associated.

          • iamRoleArn (string) –

            The ARN of the IAM role that has overly permissive actions.

          • roleAliasArn (string) –

            The ARN of the role alias that has overly permissive actions.

          • issuerCertificateIdentifier (dict) –

            The issuer certificate identifier.

            • issuerCertificateSubject (string) –

              The subject of the issuer certificate.

            • issuerId (string) –

              The issuer ID.

            • issuerCertificateSerialNumber (string) –

              The issuer certificate serial number.

          • deviceCertificateArn (string) –

            The ARN of the identified device certificate.

        • additionalInfo (dict) –

          Other information about the resource.

          • (string) –

            • (string) –

    • NextToken (string) –

      A token to resume pagination.