cisco.dnac.nfv_profile (2.0.7) — module

Manage NfvProfile objects of SiteDesign

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

API to create network profile for different NFV topologies.

API to get NFV network profile.

API to delete nfv network profile.

API to update a NFV Network profile.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: create_nfv_profile
  cisco.dnac.nfv_profile:
    state: create  # required
    device:  # required
    - deviceType: SomeValue  # string, required
      deviceTag: SomeValue  # string, required
      serviceProviderProfile:  # required
      - serviceProvider: SomeValue  # string, required
        linkType: SomeValue  # string, required
        connect: True  # boolean, required
        connectDefaultGatewayOnWan: True  # boolean, required
      directInternetAccessForFirewall: True  # boolean, required
      services:  # required
      - serviceType: SomeValue  # string, required
        profileType: SomeValue  # string, required
        serviceName: SomeValue  # string, required
        imageName: SomeValue  # string, required
        vNicMapping:  # required
        - networkType: SomeValue  # string, required
          assignIpAddressToNetwork: SomeValue  # string
        firewallMode: SomeValue  # string
      customNetworks:
      - networkName: SomeValue  # string, required
        servicesToConnect:  # required
        - serviceName: SomeValue  # string, required
        connectionType: SomeValue  # string, required
        vlanMode: SomeValue  # string, required
        vlanId: 1  #  number, required
      vlanForL2:
      - vlanType: SomeValue  # string, required
        vlanId: 1  #  number, required
        vlanDescription: SomeValue  # string, required
      customTemplate:
      - deviceType: SomeValue  # string, required
        template: SomeValue  # string, required
        templateType: SomeValue  # string, required
    profileName: SomeValue  # string, required
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get_nfv_profile
  cisco.dnac.nfv_profile:
    state: query  # required
    id: SomeValue  # string, required
    limit: SomeValue  # string
    name: SomeValue  # string
    offset: SomeValue  # string
  register: nm_get_nfv_profile
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: delete_nfv_profile
  cisco.dnac.nfv_profile:
    state: delete  # required
    id: SomeValue  # string, required
    name: SomeValue  # string
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: update_nfv_profile
  cisco.dnac.nfv_profile:
    state: update  # required
    id: SomeValue  # string, required
    device:  # required
    - deviceTag: SomeValue  # string, required
      directInternetAccessForFirewall: True  # boolean, required
      currentDeviceTag: SomeValue  # string, required
      services:
      - serviceType: SomeValue  # string, required
        profileType: SomeValue  # string, required
        serviceName: SomeValue  # string, required
        imageName: SomeValue  # string, required
        vNicMapping:  # required
        - networkType: SomeValue  # string, required
          assignIpAddressToNetwork: SomeValue  # string
        firewallMode: SomeValue  # string
      customNetworks:
      - networkName: SomeValue  # string, required
        servicesToConnect:  # required
        - serviceName: SomeValue  # string, required
        connectionType: SomeValue  # string, required
        vlanMode: SomeValue  # string, required
        vlanId: 1  #  number, required
      vlanForL2:
      - vlanType: SomeValue  # string, required
        vlanId: 1  #  number, required
        vlanDescription: SomeValue  # string, required
      customTemplate:
      - deviceType: SomeValue  # string, required
        template: SomeValue  # string, required
        templateType: SomeValue  # string, required
    name: SomeValue  # string

Inputs

    
id:
    description:
    - ID of network profile to retrieve.
    - Id of nfv network profile to delete. .
    - Id of the NFV profile to be updated.
    required: true
    type: str

name:
    description:
    - Name of network profile to be retrieved.
    - Nameof nfv network profile to delete. .
    - Name of the profile to be updated.
    type: str

limit:
    description:
    - Number of profile to be retrieved.
    type: str

device:
    description:
    - Device, property of the request body (list of objects).
    elements: dict
    required: true
    suboptions:
      currentDeviceTag:
        description:
        - It is the nfv profile's currentDeviceTag.
        required: true
        type: str
      customNetworks:
        description:
        - It is the nfv profile's customNetworks.
        elements: dict
        suboptions:
          connectionType:
            description:
            - It is the nfv profile's connectionType.
            - Required for states update and create.
            type: str
          networkName:
            description:
            - It is the nfv profile's networkName.
            - Required for states update and create.
            type: str
          servicesToConnect:
            description:
            - It is the nfv profile's servicesToConnect.
            elements: dict
            required: true
            suboptions:
              serviceName:
                description:
                - It is the nfv profile's serviceName.
                - Required for states update and create.
                type: str
            type: list
          vlanId:
            description:
            - It is the nfv profile's vlanId.
            - Required for states update and create.
            type: int
          vlanMode:
            description:
            - It is the nfv profile's vlanMode.
            - Required for states update and create.
            type: str
        type: list
      customTemplate:
        description:
        - It is the nfv profile's customTemplate.
        elements: dict
        suboptions:
          deviceType:
            description:
            - It is the nfv profile's deviceType.
            - Required for states update and create.
            type: str
          template:
            description:
            - It is the nfv profile's template.
            - Required for states update and create.
            type: str
          templateType:
            description:
            - It is the nfv profile's templateType.
            - Required for states update and create.
            type: str
        type: list
      deviceTag:
        description:
        - It is the nfv profile's deviceTag.
        - Required for states update and create.
        type: str
      deviceType:
        description:
        - It is the nfv profile's deviceType.
        required: true
        type: str
      directInternetAccessForFirewall:
        description:
        - It is the nfv profile's directInternetAccessForFirewall.
        - Required for states update and create.
        type: bool
      serviceProviderProfile:
        description:
        - It is the nfv profile's serviceProviderProfile.
        elements: dict
        required: true
        suboptions:
          connect:
            description:
            - It is the nfv profile's connect.
            required: true
            type: bool
          connectDefaultGatewayOnWan:
            description:
            - It is the nfv profile's connectDefaultGatewayOnWan.
            required: true
            type: bool
          linkType:
            description:
            - It is the nfv profile's linkType.
            required: true
            type: str
          serviceProvider:
            description:
            - It is the nfv profile's serviceProvider.
            required: true
            type: str
        type: list
      services:
        description:
        - It is the nfv profile's services.
        elements: dict
        required: true
        suboptions:
          firewallMode:
            description:
            - It is the nfv profile's firewallMode.
            type: str
          imageName:
            description:
            - It is the nfv profile's imageName.
            - Required for states update and create.
            type: str
          profileType:
            description:
            - It is the nfv profile's profileType.
            - Required for states update and create.
            type: str
          serviceName:
            description:
            - It is the nfv profile's serviceName.
            - Required for states update and create.
            type: str
          serviceType:
            description:
            - It is the nfv profile's serviceType.
            - Required for states update and create.
            type: str
          vNicMapping:
            description:
            - It is the nfv profile's vNicMapping.
            elements: dict
            required: true
            suboptions:
              assignIpAddressToNetwork:
                description:
                - It is the nfv profile's assignIpAddressToNetwork.
                type: str
              networkType:
                description:
                - It is the nfv profile's networkType.
                - Required for states update and create.
                type: str
            type: list
        type: list
      vlanForL2:
        description:
        - It is the nfv profile's vlanForL2.
        elements: dict
        suboptions:
          vlanDescription:
            description:
            - It is the nfv profile's vlanDescription.
            - Required for states update and create.
            type: str
          vlanId:
            description:
            - It is the nfv profile's vlanId.
            - Required for states update and create.
            type: int
          vlanType:
            description:
            - It is the nfv profile's vlanType.
            - Required for states update and create.
            type: str
        type: list
    type: list

offset:
    description:
    - Offset/starting row.
    type: str

profileName:
    description:
    - Site Profile Name, property of the request body.
    - Required for state create.
    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: site_design.create_nfv_profile
  type: str

See also