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.