SecurityAgent / Paginator / ListDiscoveredEndpoints

ListDiscoveredEndpoints¶

class SecurityAgent.Paginator.ListDiscoveredEndpoints¶

paginator = client.get_paginator('list_discovered_endpoints')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from SecurityAgent.Client.list_discovered_endpoints().

Request Syntax

response_iterator = paginator.paginate(
    pentestJobId='string',
    agentSpaceId='string',
    prefix='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

pentestJobId (string) –
[REQUIRED]

The unique identifier of the pentest job to list discovered endpoints for.
agentSpaceId (string) –
[REQUIRED]

The unique identifier of the agent space.
prefix (string) – A prefix to filter discovered endpoints by URI.
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

{
    'discoveredEndpoints': [
        {
            'uri': 'string',
            'pentestJobId': 'string',
            'taskId': 'string',
            'agentSpaceId': 'string',
            'evidence': 'string',
            'operation': 'string',
            'description': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –

Output for the ListDiscoveredEndpoints operation.
- discoveredEndpoints (list) –
  
  The list of discovered endpoints.
  - (dict) –
    
    Represents an endpoint discovered during a pentest job.
    - uri (string) –
      
      The URI of the discovered endpoint.
    - pentestJobId (string) –
      
      The unique identifier of the pentest job that discovered the endpoint.
    - taskId (string) –
      
      The unique identifier of the task that discovered the endpoint.
    - agentSpaceId (string) –
      
      The unique identifier of the agent space associated with the discovered endpoint.
    - evidence (string) –
      
      The evidence that led to the discovery of the endpoint.
    - operation (string) –
      
      The HTTP operation associated with the discovered endpoint.
    - description (string) –
      
      A description of the discovered endpoint.
- NextToken (string) –
  
  A token to resume pagination.