racampos.dnac.network (0.0.1) — module

Manage Network objects of NetworkSettings

| "added in version" 1.0 of racampos.dnac"

Authors: first last (@GitHubID)

preview | supported by community

This plugin has a corresponding action plugin.

Install collection

Install with ansible-galaxy collection install racampos.dnac:==0.0.1


Add to requirements.yml

  collections:
    - name: racampos.dnac
      version: 0.0.1

Description

API to get DHCP and DNS center server details.

API to create a Network for DHCP and DNS center server settings.

API to update Network for DHCP and DNS center server settings.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_network
  cisco.dnac.network:
    state: query  # required
    site_id: SomeValue  # string
  register: query_result
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  
- name: create_network
  cisco.dnac.network:
    state: create  # required
    site_id: SomeValue  # string, required
    settings:  # required
      dhcpServer:
      - SomeValue  # string
      dnsServer:
        domainName: SomeValue  # string
        primaryIpAddress: SomeValue  # string
        secondaryIpAddress: SomeValue  # string
      syslogServer:
        ipAddresses:
        - SomeValue  # string
        configureDnacIP: True  # boolean
      snmpServer:
        ipAddresses:
        - SomeValue  # string
        configureDnacIP: True  # boolean
      netflowcollector:
        ipAddress: SomeValue  # string
        port: 1  #  number
      ntpServer:
      - SomeValue  # string
      timezone: SomeValue  # string
      messageOfTheday:
        bannerMessage: SomeValue  # string
        retainExistingBanner: True  # boolean
      network_aaa:
        servers: SomeValue  # string
        ipAddress: SomeValue  # string
        network: SomeValue  # string
        protocol: SomeValue  # string
        sharedSecret: SomeValue  # string
      clientAndEndpoint_aaa:
        servers: SomeValue  # string
        ipAddress: SomeValue  # string
        network: SomeValue  # string
        protocol: SomeValue  # string
        sharedSecret: SomeValue  # string
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  
- name: update_network
  cisco.dnac.network:
    state: update  # required
    site_id: SomeValue  # string, required
    settings:  # required
      dhcpServer:
      - SomeValue  # string
      dnsServer:
        domainName: SomeValue  # string
        primaryIpAddress: SomeValue  # string
        secondaryIpAddress: SomeValue  # string
      syslogServer:
        ipAddresses:
        - SomeValue  # string
        configureDnacIP: True  # boolean
      snmpServer:
        ipAddresses:
        - SomeValue  # string
        configureDnacIP: True  # boolean
      netflowcollector:
        ipAddress: SomeValue  # string
        port: 1  #  number
      ntpServer:
      - SomeValue  # string
      timezone: SomeValue  # string
      messageOfTheday:
        bannerMessage: SomeValue  # string
        retainExistingBanner: True  # boolean
      network_aaa:
        servers: SomeValue  # string
        ipAddress: SomeValue  # string
        network: SomeValue  # string
        protocol: SomeValue  # string
        sharedSecret: SomeValue  # string
      clientAndEndpoint_aaa:
        servers: SomeValue  # string
        ipAddress: SomeValue  # string
        network: SomeValue  # string
        protocol: SomeValue  # string
        sharedSecret: SomeValue  # string

Inputs

    
site_id:
    description:
    - Site id to get the Network settings associated with the site.
    - Site id to which site details to associate with the Network settings.
    - Site id to update the Network settings which is associated with the site.
    - Required for states create and update.
    type: str

settings:
    description:
    - Settings, property of the request body.
    required: true
    suboptions:
      clientAndEndpoint_aaa:
        description:
        - It is the Network's clientAndEndpoint_aaa.
        suboptions:
          ipAddress:
            description:
            - It is the Network's ipAddress.
            type: str
          network:
            description:
            - It is the Network's Network.
            type: str
          protocol:
            description:
            - It is the Network's protocol.
            type: str
          servers:
            description:
            - It is the Network's servers.
            type: str
          sharedSecret:
            description:
            - It is the Network's sharedSecret.
            type: str
        type: dict
      dhcpServer:
        description:
        - It is the Network's dhcpServer.
        type: list
      dnsServer:
        description:
        - It is the Network's dnsServer.
        suboptions:
          domainName:
            description:
            - It is the Network's domainName.
            type: str
          primaryIpAddress:
            description:
            - It is the Network's primaryIpAddress.
            type: str
          secondaryIpAddress:
            description:
            - It is the Network's secondaryIpAddress.
            type: str
        type: dict
      messageOfTheday:
        description:
        - It is the Network's messageOfTheday.
        suboptions:
          bannerMessage:
            description:
            - It is the Network's bannerMessage.
            type: str
          retainExistingBanner:
            description:
            - It is the Network's retainExistingBanner.
            type: bool
        type: dict
      netflowcollector:
        description:
        - It is the Network's netflowcollector.
        suboptions:
          ipAddress:
            description:
            - It is the Network's ipAddress.
            type: str
          port:
            description:
            - It is the Network's port.
            type: int
        type: dict
      network_aaa:
        description:
        - It is the Network's Network_aaa.
        suboptions:
          ipAddress:
            description:
            - It is the Network's ipAddress.
            type: str
          network:
            description:
            - It is the Network's Network.
            type: str
          protocol:
            description:
            - It is the Network's protocol.
            type: str
          servers:
            description:
            - It is the Network's servers.
            type: str
          sharedSecret:
            description:
            - It is the Network's sharedSecret.
            type: str
        type: dict
      ntpServer:
        description:
        - It is the Network's ntpServer.
        type: list
      snmpServer:
        description:
        - It is the Network's snmpServer.
        suboptions:
          configureDnacIP:
            description:
            - It is the Network's configureDnacIP.
            type: bool
          ipAddresses:
            description:
            - It is the Network's ipAddresses.
            type: list
        type: dict
      syslogServer:
        description:
        - It is the Network's syslogServer.
        suboptions:
          configureDnacIP:
            description:
            - It is the Network's configureDnacIP.
            type: bool
          ipAddresses:
            description:
            - It is the Network's ipAddresses.
            type: list
        type: dict
      timezone:
        description:
        - It is the Network's timezone.
        type: str
    type: dict

Outputs

create_network:
  contains: null
  description: API to create a Network for DHCP and DNS center server settings.
  executionId:
    description: Execution Id, property of the response body.
    returned: success
    sample: <executionid>
    type: str
  executionStatusUrl:
    description: Execution Status Url, property of the response body.
    returned: success
    sample: <executionstatusurl>
    type: str
  message:
    description: Message, property of the response body.
    returned: success
    sample: <message>
    type: str
  returned: success
  type: dict
get_network:
  contains: null
  description: API to get DHCP and DNS center server details.
  response:
    contains:
      groupUuid:
        description: It is the Network's groupUuid.
        returned: always
        sample: <groupuuid>
        type: str
      inheritedGroupName:
        description: It is the Network's inheritedGroupName.
        returned: always
        sample: <inheritedgroupname>
        type: str
      inheritedGroupUuid:
        description: It is the Network's inheritedGroupUuid.
        returned: always
        sample: <inheritedgroupuuid>
        type: str
      instanceType:
        description: It is the Network's instanceType.
        returned: always
        sample: <instancetype>
        type: str
      instanceUuid:
        description: It is the Network's instanceUuid.
        returned: always
        sample: <instanceuuid>
        type: str
      key:
        description: It is the Network's key.
        returned: always
        sample: <key>
        type: str
      namespace:
        description: It is the Network's namespace.
        returned: always
        sample: <namespace>
        type: str
      type:
        description: It is the Network's type.
        returned: always
        sample: <type>
        type: str
      value:
        contains:
          configureDnacIP:
            description: It is the Network's configureDnacIP.
            returned: always
            sample: false
            type: bool
          ipAddresses:
            description: It is the Network's ipAddresses.
            returned: always
            type: list
        description: It is the Network's value.
        returned: always
        type: list
      version:
        description: It is the Network's version.
        returned: always
        sample: 0
        type: int
    description: Response, property of the response body (list of objects).
    returned: always
    type: list
  returned: always
  type: dict
  version:
    description: Version, property of the response body.
    returned: always
    sample: '1.0'
    type: str
update_network:
  contains: null
  description: API to update Network for DHCP and DNS center server settings.
  executionId:
    description: Execution Id, property of the response body.
    returned: changed
    sample: <executionid>
    type: str
  executionStatusUrl:
    description: Execution Status Url, property of the response body.
    returned: changed
    sample: <executionstatusurl>
    type: str
  message:
    description: Message, property of the response body.
    returned: changed
    sample: <message>
    type: str
  returned: changed
  type: dict

See also