.. Document meta :orphan: .. |antsibull-internal-nbsp| unicode:: 0xA0 :trim: .. role:: ansible-attribute-support-label .. role:: ansible-attribute-support-property .. role:: ansible-attribute-support-full .. role:: ansible-attribute-support-partial .. role:: ansible-attribute-support-none .. role:: ansible-attribute-support-na .. role:: ansible-option-type .. role:: ansible-option-elements .. role:: ansible-option-required .. role:: ansible-option-versionadded .. role:: ansible-option-aliases .. role:: ansible-option-choices .. role:: ansible-option-choices-default-mark .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.dnac.nfv_profile_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.dnac.nfv_profile module -- Resource module for Nfv Profile ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.dnac collection `_ (version 6.14.0). To install it, use: :code:`ansible-galaxy collection install cisco.dnac`. You need further requirements to be able to use this module, see :ref:`Requirements ` for details. To use it in a playbook, specify: :code:`cisco.dnac.nfv_profile`. .. version_added .. rst-class:: ansible-version-added New in cisco.dnac 3.1.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operations create, update and delete of the resource Nfv Profile. - API to create network profile for different NFV topologies. - API to delete nfv network profile. - API to update a NFV Network profile. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements .. _ansible_collections.cisco.dnac.nfv_profile_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - dnacentersdk \>= 2.7.1 - python \>= 3.9 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device: .. rst-class:: ansible-option-title **device** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's device. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks: .. rst-class:: ansible-option-title **customNetworks** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's customNetworks. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/connectiontype: .. rst-class:: ansible-option-title **connectionType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network connection from custom network (eg lan). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/networkname: .. rst-class:: ansible-option-title **networkName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of custom network (eg cust-1). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/servicestoconnect: .. rst-class:: ansible-option-title **servicesToConnect** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's servicesToConnect. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/servicestoconnect/servicename: .. rst-class:: ansible-option-title **serviceName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of service to be connected to the custom network (eg router-1). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Vlan id for the custom network(eg 4000). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customnetworks/vlanmode: .. rst-class:: ansible-option-title **vlanMode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Network mode (eg Access or Trunk). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customtemplate: .. rst-class:: ansible-option-title **customTemplate** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's customTemplate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customtemplate/devicetype: .. rst-class:: ansible-option-title **deviceType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of the device(eg Cisco 5400 Enterprise Network Compute System). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customtemplate/template: .. rst-class:: ansible-option-title **template** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the template(eg NFVIS template). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/customtemplate/templatetype: .. rst-class:: ansible-option-title **templateType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the template type to which template is associated (eg Cloud DayN Templates). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/devicetag: .. rst-class:: ansible-option-title **deviceTag** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Device Tag name(eg dev1). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/devicetype: .. rst-class:: ansible-option-title **deviceType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the device used in creating nfv profile. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/directinternetaccessforfirewall: .. rst-class:: ansible-option-title **directInternetAccessForFirewall** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Direct internet access value should be boolean (eg false or true). .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/serviceproviderprofile: .. rst-class:: ansible-option-title **serviceProviderProfile** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's serviceProviderProfile. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/serviceproviderprofile/connect: .. rst-class:: ansible-option-title **connect** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Connection of service provider and device value should be boolean (eg true). .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/serviceproviderprofile/connectdefaultgatewayonwan: .. rst-class:: ansible-option-title **connectDefaultGatewayOnWan** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Connect default gateway connect value as boolean (eg true). .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/serviceproviderprofile/linktype: .. rst-class:: ansible-option-title **linkType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of connection type(eg GigabitEthernet). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/serviceproviderprofile/serviceprovider: .. rst-class:: ansible-option-title **serviceProvider** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the service provider(eg Airtel). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services: .. rst-class:: ansible-option-title **services** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's services. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/firewallmode: .. rst-class:: ansible-option-title **firewallMode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Firewall mode details example (routed, transparent). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/imagename: .. rst-class:: ansible-option-title **imageName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Service image name (eg isrv-universalk9.16.12.01a.tar.gz). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/profiletype: .. rst-class:: ansible-option-title **profileType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Profile type of service (eg ISRv-mini). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/servicename: .. rst-class:: ansible-option-title **serviceName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the service (eg Router-1). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/servicetype: .. rst-class:: ansible-option-title **serviceType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Service type (eg ISRV). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/vnicmapping: .. rst-class:: ansible-option-title **vNicMapping** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's vNicMapping. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/vnicmapping/assignipaddresstonetwork: .. rst-class:: ansible-option-title **assignIpAddressToNetwork** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Assign ip address to network (eg true or false). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/services/vnicmapping/networktype: .. rst-class:: ansible-option-title **networkType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of connection (eg wan, lan or internal). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/vlanforl2: .. rst-class:: ansible-option-title **vlanForL2** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Nfv Profile's vlanForL2. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/vlanforl2/vlandescription: .. rst-class:: ansible-option-title **vlanDescription** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Vlan description(eg Access 4018). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/vlanforl2/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Vlan id (eg 4018). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-device/vlanforl2/vlantype: .. rst-class:: ansible-option-title **vlanType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Vlan type(eg Access or Trunk). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **dnac_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable debugging. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_host: .. rst-class:: ansible-option-title **dnac_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The Cisco DNA Center hostname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_password: .. rst-class:: ansible-option-title **dnac_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center password to authenticate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_port: .. rst-class:: ansible-option-title **dnac_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
The Cisco DNA Center port. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`443` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_username: .. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-user: .. rst-class:: ansible-option-title **dnac_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center username to authenticate. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"admin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **dnac_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable or disable SSL certificate verification. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-dnac_version: .. rst-class:: ansible-option-title **dnac_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Informs the SDK which version of Cisco DNA Center to use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"2.3.7.6"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-id: .. rst-class:: ansible-option-title **id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Id path parameter. Id of the NFV profile to be updated. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name query parameter. Name of the profile to be updated. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-profilename: .. rst-class:: ansible-option-title **profileName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the profile to create NFV profile. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__parameter-validate_response_schema: .. rst-class:: ansible-option-title **validate_response_schema** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are site\_design.SiteDesign.create\_nfv\_profile, site\_design.SiteDesign.delete\_nfv\_profile, site\_design.SiteDesign.update\_nfv\_profile, - Paths used are post /dna/intent/api/v1/nfv/network-profile, delete /dna/intent/api/v1/nfv/network-profile/{id}, put /dna/intent/api/v1/nfv/network-profile/{id}, - Does not support \ :literal:`check\_mode`\ - The plugin runs on the control node and does not use any ansible connection plugins, but instead the embedded connection manager from Cisco DNAC SDK - The parameters starting with dnac\_ are used by the Cisco DNAC Python SDK to establish the connection .. Seealso See Also -------- .. seealso:: `Cisco DNA Center documentation for Site Design CreateNFVProfile `_ Complete reference of the CreateNFVProfile API. `Cisco DNA Center documentation for Site Design DeleteNFVProfile `_ Complete reference of the DeleteNFVProfile API. `Cisco DNA Center documentation for Site Design UpdateNFVProfile `_ Complete reference of the UpdateNFVProfile API. .. Examples Examples -------- .. code-block:: yaml+jinja - name: Create cisco.dnac.nfv_profile: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" state: present device: - customNetworks: - connectionType: string networkName: string servicesToConnect: - serviceName: string vlanId: 0 vlanMode: string customTemplate: - deviceType: string template: string templateType: string deviceTag: string deviceType: string directInternetAccessForFirewall: true serviceProviderProfile: - connect: true connectDefaultGatewayOnWan: true linkType: string serviceProvider: string services: - firewallMode: string imageName: string profileType: string serviceName: string serviceType: string vNicMapping: - assignIpAddressToNetwork: string networkType: string vlanForL2: - vlanDescription: string vlanId: 0 vlanType: string profileName: string - name: Update by id cisco.dnac.nfv_profile: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" state: present device: - currentDeviceTag: string customNetworks: - connectionType: string networkName: string servicesToConnect: - serviceName: string vlanId: 0 vlanMode: string customTemplate: - deviceType: string template: string templateType: string deviceTag: string directInternetAccessForFirewall: true services: - firewallMode: string imageName: string profileType: string serviceName: string serviceType: string vNicMapping: - assignIpAddressToNetwork: string networkType: string vlanForL2: - vlanDescription: string vlanId: 0 vlanType: string id: string name: string - name: Delete by id cisco.dnac.nfv_profile: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" state: absent id: string name: string .. Facts .. Return values Return Values ------------- Common return values are documented :ref:`here `, the following are the fields unique to this module: .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Key - Description * - .. raw:: html
.. _ansible_collections.cisco.dnac.nfv_profile_module__return-dnac_response: .. rst-class:: ansible-option-title **dnac_response** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary or list with the response returned by the Cisco DNAC Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`{"executionId": "string", "executionStatusUrl": "string", "message": "string"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Rafael Campos (@racampos) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors