cisco.dnac.task (2.0.7) — module

Manage Task objects of Task

| "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 Task(s) based on filter criteria.

Returns a Task by specified id.

Returns Task count.

Returns root Tasks associated with an Operationid.

Returns a Task with its children Tasks by based on their id.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_tasks
  cisco.dnac.task:
    state: query  # required
    data: SomeValue  # string
    end_time: SomeValue  # string
    error_code: SomeValue  # string
    failure_reason: SomeValue  # string
    is_error: SomeValue  # string
    limit: SomeValue  # string
    offset: SomeValue  # string
    order: SomeValue  # string
    parent_id: SomeValue  # string
    progress: SomeValue  # string
    service_type: SomeValue  # string
    sort_by: SomeValue  # string
    start_time: SomeValue  # string
    username: SomeValue  # string
  register: nm_get_tasks
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_task_by_id
  cisco.dnac.task:
    state: query  # required
    task_id: SomeValue  # string, required
  register: nm_get_task_by_id
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_task_count
  cisco.dnac.task:
    state: query  # required
    count: True  # boolean, required
    data: SomeValue  # string
    end_time: SomeValue  # string
    error_code: SomeValue  # string
    failure_reason: SomeValue  # string
    is_error: SomeValue  # string
    parent_id: SomeValue  # string
    progress: SomeValue  # string
    service_type: SomeValue  # string
    start_time: SomeValue  # string
    username: SomeValue  # string
  register: nm_get_task_count
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_task_by_operationid
  cisco.dnac.task:
    state: query  # required
    limit: 1  #  integer, required
    offset: 1  #  integer, required
    operation_id: SomeValue  # string, required
  register: nm_get_task_by_operationid
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_task_tree
  cisco.dnac.task:
    state: query  # required
    task_id: SomeValue  # string, required
    tree: True  # boolean, required
  register: nm_get_task_tree

Inputs

    
data:
    description:
    - Fetch Tasks that contains this data.
    type: str

tree:
    description:
    - If true retrieves the Task tree.
    required: true
    type: bool

count:
    description:
    - If true gets the number of objects.
    required: true
    type: bool

limit:
    description:
    - Limit query parameter.
    - The maximum value of {limit} supported is 500. Base 1 indexing for {limit}, minimum
      value is 1.
    - Type str for state query.
    - Type int for state query.
    type: raw

order:
    description:
    - Sort order - asc or dsc.
    type: str

offset:
    description:
    - Offset query parameter.
    - Index, minimum value is 0.
    - Type str for state query.
    - Type int for state query.
    type: raw

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

task_id:
    description:
    - UUID of the Task.
    required: true
    type: str

end_time:
    description:
    - This is the epoch end time upto which audit records need to be fetched.
    type: str

is_error:
    description:
    - Fetch Tasks ended as success or failure. Valid values true, false.
    type: str

progress:
    description:
    - Fetch Tasks that contains this progress.
    type: str

username:
    description:
    - Fetch Tasks with this username.
    type: str

parent_id:
    description:
    - Fetch Tasks that have this parent Id.
    type: str

error_code:
    description:
    - Fetch Tasks that have this error code.
    type: str

start_time:
    description:
    - This is the epoch start time from which Tasks need to be fetched.
    type: str

operation_id:
    description:
    - OperationId path parameter.
    required: true
    type: str

service_type:
    description:
    - Fetch Tasks with this service type.
    type: str

failure_reason:
    description:
    - Fetch Tasks that contains this failure reason.
    type: str

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: task.get_task_by_id
  type: str

See also