cisco.dnac.flow_analysis (2.0.7) — module

Manage FlowAnalysis objects of PathTrace

| "added in version" 1.0.0 of cisco.dnac"

Authors: Rafael Campos (@racampos)

This plugin has a corresponding action plugin.

Install collection

Install with ansible-galaxy collection install cisco.dnac:==2.0.7


Add to requirements.yml

  collections:
    - name: cisco.dnac
      version: 2.0.7

Description

Returns a summary of all flow analyses stored. Results can be filtered by specified parameters.

Initiates a new flow analysis with periodic refresh and stat collection options. Returns a request id and a task id to get results and follow progress.

Returns result of a previously requested flow analysis by its Flow Analysis id.

Deletes a flow analysis request by its id.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: retrives_all_previous_pathtraces_summary
  cisco.dnac.flow_analysis:
    state: query  # required
    dest_ip: SomeValue  # string
    dest_port: SomeValue  # string
    gt_create_time: SomeValue  # string
    last_update_time: SomeValue  # string
    limit: SomeValue  # string
    lt_create_time: SomeValue  # string
    offset: SomeValue  # string
    order: SomeValue  # string
    periodic_refresh: True  # boolean
    protocol: SomeValue  # string
    sort_by: SomeValue  # string
    source_ip: SomeValue  # string
    source_port: SomeValue  # string
    status: SomeValue  # string
    task_id: SomeValue  # string
  register: nm_retrives_all_previous_pathtraces_summary
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: initiate_a_new_pathtrace
  cisco.dnac.flow_analysis:
    state: create  # required
    destIP: SomeValue  # string, required
    sourceIP: SomeValue  # string, required
    controlPath: True  # boolean
    destPort: SomeValue  # string
    inclusions:
    - SomeValue  # string
    periodicRefresh: True  # boolean
    protocol: SomeValue  # string
    sourcePort: SomeValue  # string
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: retrieves_previous_pathtrace
  cisco.dnac.flow_analysis:
    state: query  # required
    flow_analysis_id: SomeValue  # string, required
  register: nm_retrieves_previous_pathtrace
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: deletes_pathtrace_by_id
  cisco.dnac.flow_analysis:
    state: delete  # required
    flow_analysis_id: SomeValue  # string, required

Inputs

    
limit:
    description:
    - Number of resources returned.
    type: str

order:
    description:
    - Order by this field.
    type: str

destIP:
    description:
    - FlowAnalysisRequest's destIP.
    - Required for state create.
    type: str

offset:
    description:
    - Start index of resources returned (1-based).
    type: str

status:
    description:
    - Status query parameter.
    type: str

dest_ip:
    description:
    - Destination IP address.
    type: str

sort_by:
    description:
    - Sort by this field.
    type: str

task_id:
    description:
    - Task ID.
    type: str

destPort:
    description:
    - FlowAnalysisRequest's destPort.
    type: str

protocol:
    description:
    - Protocol query parameter.
    - FlowAnalysisRequest's protocol.
    type: str

sourceIP:
    description:
    - FlowAnalysisRequest's sourceIP.
    - Required for state create.
    type: str

dest_port:
    description:
    - Destination port.
    type: str

source_ip:
    description:
    - Source IP address.
    type: str

inclusions:
    description:
    - FlowAnalysisRequest's inclusions (list of strings).
    type: list

sourcePort:
    description:
    - FlowAnalysisRequest's sourcePort.
    type: str

controlPath:
    description:
    - FlowAnalysisRequest's controlPath.
    type: bool

source_port:
    description:
    - Source port.
    type: str

gt_create_time:
    description:
    - Analyses requested after this time.
    type: str

lt_create_time:
    description:
    - Analyses requested before this time.
    type: str

periodicRefresh:
    description:
    - FlowAnalysisRequest's periodicRefresh.
    type: bool

flow_analysis_id:
    description:
    - Flow analysis request id.
    required: true
    type: str

last_update_time:
    description:
    - Last update time.
    type: str

periodic_refresh:
    description:
    - Is analysis periodically refreshed?.
    type: bool

Outputs

dnac_response:
  description: A dictionary with the response returned by the DNA Center Python SDK
  returned: always
  sample:
    response: 29
    version: '1.0'
  type: dict
missing_params:
  description: Provided arguments do not comply with the schema of the DNA Center
    Python SDK function
  returned: when the function request schema is not satisfied
  sample: null
  type: list
sdk_function:
  description: The DNA Center SDK function used to execute the task
  returned: always
  sample: path_trace.deletes_pathtrace_by_id
  type: str

See also