netautomate.netorca.get_change_instances module

Module Documentation: get_change_instances

Table of Contents

Module: get_change_instances

short_description: Get Change Instances form NetOrca

version_added: 0.1.0

description:

  • This modules gets the change instances for a team in Netorca. Every filter option supported by the NetOrca API is supported by this module.

options:

  • url:
    • description: Base URL for NetOrca.
    • required: true
    • type: str
  • api_key:
    • description: API Key generated for team. If this is not specified, username and password need to be provided.
    • required: false
    • type: str
  • username:
    • description: Username for account in the team. Use when no API KEY is available.
    • required: false
    • type: str
  • password:
    • description: Password for account in the team. Use when no API KEY is available.
    • required: false
    • type: str
  • filters:
    • description: Filters to apply to the change instances. See NetOrca API documentation for more details.
    • required: false
    • type: dict

extends_documentation_fragment:

  • netautomate.netorca.get_change_instances

author:

requirements:

  • netorca-sdk
  • validators

Examples

# Supply API Key and get all change instances
- name: Get all change instances
  get_change_instances:
    url: https://dev.netorca.io
    api_key: <api key here>

Return Values

# These are examples of possible return values, and in general should use other names for return values.
change_instances:
    description: An array of the change instances returned by NetOrca
    type: array
    returned: always
message:
    description: A general message, useful when errors are encountered
    type: str
    returned: always
    sample: 'Returned 10 change instances'

File a bug with the netautomate.netorca collection in order to have it corrected.