racampos.dnac.nfv_provision (0.0.1) — module

Manage NfvProvision objects of SiteDesign

| "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

Design and Provision single/multi NFV device with given site/area/building/floor .

Returns provisioning device information for the specified IP address.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: provision_nfv
  cisco.dnac.nfv_provision:
    state: create  # required
    provisioning:  # required
    - site:  # required
        siteProfileName: SomeValue  # string
        area:
          name: SomeValue  # string
          parentName: SomeValue  # string
        building:
          name: SomeValue  # string
          address: SomeValue  # string
          latitude: 1  #  number
          longitude: 1  #  number
          parentName: SomeValue  # string
        floor:
          name: SomeValue  # string
          parentName: SomeValue  # string
          rfModel: SomeValue  # string
          width: 1  #  number
          length: 1  #  number
          height: 1  #  number
      device:  # required
      - tagName: SomeValue  # string, required
        serviceProviders:  # required
        - serviceProvider: SomeValue  # string, required
          wanInterface:
            ipAddress: SomeValue  # string
            interfaceName: SomeValue  # string
            subnetmask: SomeValue  # string
            bandwidth: SomeValue  # string
            gateway: SomeValue  # string
        services:  # required
        - type: SomeValue  # string, required
          mode: SomeValue  # string
          systemIp: SomeValue  # string
          centralManagerIP: SomeValue  # string
          centralRegistrationKey: SomeValue  # string
          commonKey: SomeValue  # string
          adminPasswordHash: SomeValue  # string
          disk: SomeValue  # string
        subPools:  # required
        - type: SomeValue  # string, required
          name: SomeValue  # string, required
          ipSubnet: SomeValue  # string, required
          gateway: SomeValue  # string, required
          parentPoolName: SomeValue  # string
        ip: SomeValue  # string
        deviceSerialNumber: SomeValue  # string
        vlan:
        - type: SomeValue  # string, required
          id: SomeValue  # string, required
          interfaces: SomeValue  # string, required
          network: SomeValue  # string
        customNetworks:
        - name: SomeValue  # string, required
          port: SomeValue  # string
          ipAddressPool: SomeValue  # string
        templateParam:
          nfvis:
            var1: SomeValue  # string
          asav:
            var1: SomeValue  # string
    siteProfile:  # required
    - siteProfileName: SomeValue  # string, required
      device:  # required
      - deviceType: SomeValue  # string, required
        tagName: SomeValue  # string, required
        serviceProviders:  # required
        - serviceProvider: SomeValue  # string, required
          linkType: SomeValue  # string, required
          connect: True  # boolean, required
          defaultGateway: True  # boolean, required
        dia: True  # boolean, required
        services:  # required
        - type: SomeValue  # string, required
          profile: SomeValue  # string, required
          name: SomeValue  # string, required
          imageName: SomeValue  # string, required
          topology:  # required
            type: SomeValue  # string
            name: SomeValue  # string
            assignIp: SomeValue  # string
          mode: SomeValue  # string
        customServices:
        - name: SomeValue  # string, required
          applicationType: SomeValue  # string, required
          profile: SomeValue  # string, required
          topology:  # required
            type: SomeValue  # string
            name: SomeValue  # string
            assignIp: SomeValue  # string
          imageName: SomeValue  # string
        customNetworks:
        - name: SomeValue  # string, required
          servicesToConnect:  # required
          - service: SomeValue  # string, required
          connectionType: SomeValue  # string, required
          networkMode: SomeValue  # string, required
          vlan: SomeValue  # string
        vlan:
        - type: SomeValue  # string, required
          id: SomeValue  # string, required
        customTemplate:
        - deviceType: SomeValue  # string, required
          template: SomeValue  # string, required
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  
- name: get_device_details_by_ip
  cisco.dnac.nfv_provision:
    state: query  # required
    device_ip: SomeValue  # string, required
  register: query_result

Inputs

    
device_ip:
    description:
    - Device to which the provisioning detail has to be retrieved.
    - Required for state query.
    type: str

siteProfile:
    description:
    - Site Profile, property of the request body (list of objects).
    - Required for state create.
    elements: dict
    suboptions:
      device:
        description:
        - It is the nfv provision's device.
        elements: dict
        required: true
        suboptions:
          customNetworks:
            description:
            - It is the nfv provision's customNetworks.
            elements: dict
            suboptions:
              connectionType:
                description:
                - It is the nfv provision's connectionType.
                required: true
                type: str
              name:
                description:
                - It is the nfv provision's name.
                required: true
                type: str
              networkMode:
                description:
                - It is the nfv provision's networkMode.
                required: true
                type: str
              servicesToConnect:
                description:
                - It is the nfv provision's servicesToConnect.
                elements: dict
                required: true
                suboptions:
                  service:
                    description:
                    - It is the nfv provision's service.
                    required: true
                    type: str
                type: list
              vlan:
                description:
                - It is the nfv provision's vlan.
                type: str
            type: list
          customServices:
            description:
            - It is the nfv provision's customServices.
            elements: dict
            suboptions:
              applicationType:
                description:
                - It is the nfv provision's applicationType.
                required: true
                type: str
              imageName:
                description:
                - It is the nfv provision's imageName.
                type: str
              name:
                description:
                - It is the nfv provision's name.
                required: true
                type: str
              profile:
                description:
                - It is the nfv provision's profile.
                required: true
                type: str
              topology:
                description:
                - It is the nfv provision's topology.
                required: true
                suboptions:
                  assignIp:
                    description:
                    - It is the nfv provision's assignIp.
                    type: str
                  name:
                    description:
                    - It is the nfv provision's name.
                    type: str
                  type:
                    description:
                    - It is the nfv provision's type.
                    type: str
                type: dict
            type: list
          customTemplate:
            description:
            - It is the nfv provision's customTemplate.
            elements: dict
            suboptions:
              deviceType:
                description:
                - It is the nfv provision's deviceType.
                required: true
                type: str
              template:
                description:
                - It is the nfv provision's template.
                required: true
                type: str
            type: list
          deviceType:
            description:
            - It is the nfv provision's deviceType.
            required: true
            type: str
          dia:
            description:
            - It is the nfv provision's dia.
            required: true
            type: bool
          serviceProviders:
            description:
            - It is the nfv provision's serviceProviders.
            elements: dict
            required: true
            suboptions:
              connect:
                description:
                - It is the nfv provision's connect.
                required: true
                type: bool
              defaultGateway:
                description:
                - It is the nfv provision's defaultGateway.
                required: true
                type: bool
              linkType:
                description:
                - It is the nfv provision's linkType.
                required: true
                type: str
              serviceProvider:
                description:
                - It is the nfv provision's serviceProvider.
                required: true
                type: str
            type: list
          services:
            description:
            - It is the nfv provision's services.
            elements: dict
            required: true
            suboptions:
              imageName:
                description:
                - It is the nfv provision's imageName.
                required: true
                type: str
              mode:
                description:
                - It is the nfv provision's mode.
                type: str
              name:
                description:
                - It is the nfv provision's name.
                required: true
                type: str
              profile:
                description:
                - It is the nfv provision's profile.
                required: true
                type: str
              topology:
                description:
                - It is the nfv provision's topology.
                required: true
                suboptions:
                  assignIp:
                    description:
                    - It is the nfv provision's assignIp.
                    type: str
                  name:
                    description:
                    - It is the nfv provision's name.
                    type: str
                  type:
                    description:
                    - It is the nfv provision's type.
                    type: str
                type: dict
              type:
                description:
                - It is the nfv provision's type.
                required: true
                type: str
            type: list
          tagName:
            description:
            - It is the nfv provision's tagName.
            required: true
            type: str
          vlan:
            description:
            - It is the nfv provision's vlan.
            elements: dict
            suboptions:
              id:
                description:
                - It is the nfv provision's id.
                required: true
                type: str
              type:
                description:
                - It is the nfv provision's type.
                required: true
                type: str
            type: list
        type: list
      siteProfileName:
        description:
        - It is the nfv provision's siteProfileName.
        required: true
        type: str
    type: list

provisioning:
    description:
    - Provisioning, property of the request body (list of objects).
    - Required for state create.
    elements: dict
    suboptions:
      device:
        description:
        - It is the nfv provision's device.
        elements: dict
        required: true
        suboptions:
          customNetworks:
            description:
            - It is the nfv provision's customNetworks.
            elements: dict
            suboptions:
              ipAddressPool:
                description:
                - It is the nfv provision's ipAddressPool.
                type: str
              name:
                description:
                - It is the nfv provision's name.
                required: true
                type: str
              port:
                description:
                - It is the nfv provision's port.
                type: str
            type: list
          deviceSerialNumber:
            description:
            - It is the nfv provision's deviceSerialNumber.
            type: str
          ip:
            description:
            - It is the nfv provision's ip.
            type: str
          serviceProviders:
            description:
            - It is the nfv provision's serviceProviders.
            elements: dict
            required: true
            suboptions:
              serviceProvider:
                description:
                - It is the nfv provision's serviceProvider.
                required: true
                type: str
              wanInterface:
                description:
                - It is the nfv provision's wanInterface.
                suboptions:
                  bandwidth:
                    description:
                    - It is the nfv provision's bandwidth.
                    type: str
                  gateway:
                    description:
                    - It is the nfv provision's gateway.
                    type: str
                  interfaceName:
                    description:
                    - It is the nfv provision's interfaceName.
                    type: str
                  ipAddress:
                    description:
                    - It is the nfv provision's ipAddress.
                    type: str
                  subnetmask:
                    description:
                    - It is the nfv provision's subnetmask.
                    type: str
                type: dict
            type: list
          services:
            description:
            - It is the nfv provision's services.
            elements: dict
            required: true
            suboptions:
              adminPasswordHash:
                description:
                - It is the nfv provision's adminPasswordHash.
                type: str
              centralManagerIP:
                description:
                - It is the nfv provision's centralManagerIP.
                type: str
              centralRegistrationKey:
                description:
                - It is the nfv provision's centralRegistrationKey.
                type: str
              commonKey:
                description:
                - It is the nfv provision's commonKey.
                type: str
              disk:
                description:
                - It is the nfv provision's disk.
                type: str
              mode:
                description:
                - It is the nfv provision's mode.
                type: str
              systemIp:
                description:
                - It is the nfv provision's systemIp.
                type: str
              type:
                description:
                - It is the nfv provision's type.
                required: true
                type: str
            type: list
          subPools:
            description:
            - It is the nfv provision's subPools.
            elements: dict
            required: true
            suboptions:
              gateway:
                description:
                - It is the nfv provision's gateway.
                required: true
                type: str
              ipSubnet:
                description:
                - It is the nfv provision's ipSubnet.
                required: true
                type: str
              name:
                description:
                - It is the nfv provision's name.
                required: true
                type: str
              parentPoolName:
                description:
                - It is the nfv provision's parentPoolName.
                type: str
              type:
                description:
                - It is the nfv provision's type.
                required: true
                type: str
            type: list
          tagName:
            description:
            - It is the nfv provision's tagName.
            required: true
            type: str
          templateParam:
            description:
            - It is the nfv provision's templateParam.
            suboptions:
              asav:
                description:
                - It is the nfv provision's asav.
                suboptions:
                  var1:
                    description:
                    - It is the nfv provision's var1.
                    type: str
                type: dict
              nfvis:
                description:
                - It is the nfv provision's nfvis.
                suboptions:
                  var1:
                    description:
                    - It is the nfv provision's var1.
                    type: str
                type: dict
            type: dict
          vlan:
            description:
            - It is the nfv provision's vlan.
            elements: dict
            suboptions:
              id:
                description:
                - It is the nfv provision's id.
                required: true
                type: str
              interfaces:
                description:
                - It is the nfv provision's interfaces.
                required: true
                type: str
              network:
                description:
                - It is the nfv provision's network.
                type: str
              type:
                description:
                - It is the nfv provision's type.
                required: true
                type: str
            type: list
        type: list
      site:
        description:
        - It is the nfv provision's site.
        required: true
        suboptions:
          area:
            description:
            - It is the nfv provision's area.
            suboptions:
              name:
                description:
                - It is the nfv provision's name.
                type: str
              parentName:
                description:
                - It is the nfv provision's parentName.
                type: str
            type: dict
          building:
            description:
            - It is the nfv provision's building.
            suboptions:
              address:
                description:
                - It is the nfv provision's address.
                type: str
              latitude:
                description:
                - It is the nfv provision's latitude.
                type: int
              longitude:
                description:
                - It is the nfv provision's longitude.
                type: int
              name:
                description:
                - It is the nfv provision's name.
                type: str
              parentName:
                description:
                - It is the nfv provision's parentName.
                type: str
            type: dict
          floor:
            description:
            - It is the nfv provision's floor.
            suboptions:
              height:
                description:
                - It is the nfv provision's height.
                type: int
              length:
                description:
                - It is the nfv provision's length.
                type: int
              name:
                description:
                - It is the nfv provision's name.
                type: str
              parentName:
                description:
                - It is the nfv provision's parentName.
                type: str
              rfModel:
                description:
                - It is the nfv provision's rfModel.
                type: str
              width:
                description:
                - It is the nfv provision's width.
                type: int
            type: dict
          siteProfileName:
            description:
            - It is the nfv provision's siteProfileName.
            type: str
        type: dict
    type: list

Outputs

get_device_details_by_ip:
  contains: null
  description: Returns provisioning device information for the specified IP address.
  provisionDetails:
    contains:
      beginStep:
        description: It is the nfv provision's beginStep.
        returned: always
        sample: <beginstep>
        type: str
      duration:
        description: It is the nfv provision's duration.
        returned: always
        sample: <duration>
        type: str
      endTime:
        description: It is the nfv provision's endTime.
        returned: always
        sample: <endtime>
        type: str
      startTime:
        description: It is the nfv provision's startTime.
        returned: always
        sample: <starttime>
        type: str
      status:
        description: It is the nfv provision's status.
        returned: always
        sample: <status>
        type: str
      statusMessage:
        description: It is the nfv provision's statusMessage.
        returned: always
        sample: <statusmessage>
        type: str
      taskNodes:
        contains:
          cliTemplateUserMessageDTO:
            description: It is the nfv provision's cliTemplateUserMessageDTO.
            returned: always
            type: dict
          duration:
            description: It is the nfv provision's duration.
            returned: always
            sample: <duration>
            type: str
          endTime:
            description: It is the nfv provision's endTime.
            returned: always
            sample: <endtime>
            type: str
          errorPayload:
            description: It is the nfv provision's errorPayload.
            returned: always
            type: dict
          name:
            description: It is the nfv provision's name.
            returned: always
            sample: <name>
            type: str
          nextTask:
            description: It is the nfv provision's nextTask.
            returned: always
            sample: <nexttask>
            type: str
          parentTask:
            description: It is the nfv provision's parentTask.
            returned: always
            type: dict
          payload:
            description: It is the nfv provision's payload.
            returned: always
            sample: <payload>
            type: str
          provisionedNames:
            description: It is the nfv provision's provisionedNames.
            returned: always
            type: dict
          startTime:
            description: It is the nfv provision's startTime.
            returned: always
            sample: <starttime>
            type: str
          status:
            description: It is the nfv provision's status.
            returned: always
            sample: <status>
            type: str
          statusMessage:
            description: It is the nfv provision's statusMessage.
            returned: always
            sample: <statusmessage>
            type: str
          stepRan:
            description: It is the nfv provision's stepRan.
            returned: always
            sample: <stepran>
            type: str
          target:
            description: It is the nfv provision's target.
            returned: always
            sample: <target>
            type: str
        description: It is the nfv provision's taskNodes.
        returned: always
        type: list
      topology:
        description: It is the nfv provision's topology.
        returned: always
        sample: <topology>
        type: str
    description: Provision Details, property of the response body.
    returned: always
    type: dict
  returned: always
  type: dict
provision_nfv:
  contains: null
  description: Design and Provision single/multi NFV device with given site/area/building/floor
    .
  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

See also