cisco.catalystcenter.wireless_controllers_intended_radio_frequencies_update_create module -- Resource module for Wireless Controllers Intended Radio Frequencies Update Create

Note

This module is part of the cisco.catalystcenter collection (version 2.12.0).

To install it, use: ansible-galaxy collection install cisco.catalystcenter. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: cisco.catalystcenter.wireless_controllers_intended_radio_frequencies_update_create.

New in cisco.catalystcenter 2.11.0

Synopsis

  • Manage operation create of the resource Wireless Controllers Intended Radio Frequencies Update Create. - > This API operation creates/updates/deletes an intended feature resource, and the subsequent "deploy" API call will configure the changes on the underlying wireless controller, and this API is applicable for per-device based configuration.

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

  • catalystcentersdk >= 3.2.3.0.0

  • python >= 3.12

Parameters

Parameter

Comments

catalystcenter_debug

aliases: dnac_debug

boolean

Flag for Cisco Catalyst Center SDK to enable debugging.

Choices:

catalystcenter_host

aliases: dnac_host

string / required

The Cisco Catalyst Center hostname.

catalystcenter_password

aliases: dnac_password

string

The Cisco Catalyst Center password to authenticate.

catalystcenter_port

aliases: dnac_port, catalystcenter_api_port

integer

The Cisco Catalyst Center port.

Default: :ansible-option-default:`443`

catalystcenter_username

aliases: dnac_username, user

string

The Cisco Catalyst Center username to authenticate.

Default: :ansible-option-default:`"admin"`

catalystcenter_verify

aliases: dnac_verify

boolean

Flag to enable or disable SSL certificate verification.

Choices:

catalystcenter_version

aliases: dnac_version

string

Informs the SDK which version of Cisco Catalyst Center to use.

Default: :ansible-option-default:`"3.1.6.0"`

multiBssidProfiles

dictionary

Wireless Controllers Intended Radio Frequencies Update Create's multiBssidProfiles.

networkDeviceId

string

NetworkDeviceId path parameter. Network device ID of the wireless controller to provision. The API /dna/intent/api/v1/network-device can be used to get the network device ID.

radioProfiles

dictionary

Wireless Controllers Intended Radio Frequencies Update Create's radioProfiles.

rfProfiles

dictionary

Wireless Controllers Intended Radio Frequencies Update Create's rfProfiles.

rfTags

dictionary

Wireless Controllers Intended Radio Frequencies Update Create's rfTags.

urwbProfiles

dictionary

Wireless Controllers Intended Radio Frequencies Update Create's urwbProfiles.

validate_response_schema

boolean

Flag for Cisco Catalyst Center SDK to enable the validation of request bodies against a JSON schema.

Choices:

Notes

Note

  • SDK Method used are wireless.Wireless.update_configurations_for_an_intended_radio_frequency_feature_on_a_wireless_controller,

  • Paths used are post /dna/campus/api/v1/wirelessControllers/{networkDeviceId}/intended/radioFrequencies/update,

  • Does not support check_mode

  • The plugin runs on the control node and does not use any ansible connection plugins,

  • but instead uses the embedded connection manager from Cisco CATALYST SDK

  • Requires Python >= 3.10, matching the controller Python versions supported by the collection's minimum ansible-core version (see the collection README for the current ansible-core / Python compatibility range)

See Also

See also

Cisco Catalyst Center documentation for Wireless UpdateConfigurationsForAnIntendedRadioFrequencyFeatureOnAWirelessController

Complete reference of the UpdateConfigurationsForAnIntendedRadioFrequencyFeatureOnAWirelessController API.

Examples

---
- name: Create
  cisco.catalystcenter.wireless_controllers_intended_radio_frequencies_update_create:
    catalystcenter_host: "{{catalystcenter_host}}"
    catalystcenter_username: "{{catalystcenter_username}}"
    catalystcenter_password: "{{catalystcenter_password}}"
    catalystcenter_verify: "{{catalystcenter_verify}}"
    catalystcenter_port: "{{catalystcenter_port}}"
    catalystcenter_version: "{{catalystcenter_version}}"
    catalystcenter_debug: "{{catalystcenter_debug}}"
    networkDeviceId: dd584a8a-a7ae-4323-97f4-ab950cab52a6
    rfProfiles:
      bandSelectAgeOutDualBand: 60
      bandSelectAgeOutSuppression: 20
      bandSelectClientMidRssi: -80
      bandSelectClientRssi: -80
      bandSelectCycleCount: 2
      bandSelectCycleThreshold: 200
      bandSelectProbeResponse: true
      clientNetworkPreference: DEFAULT
      clientResetThresh6Ghz: 5
      clientResetThreshold: 5
      clientSelectThreshold: 50
      configType: RF_PROFILE
      coverageDataPacketRssiThreshold: -80
      coverageVoicePacketRssiThreshold: -80
      dcaContributionInterference: true
      deviceVersion: '17.12'
      dot11axBcastProbeRespIntvl: 20
      loadBalancingDenialCount: 3
      op: MERGE
      optRoamRssiCheckEnabled: false
      rfProfileAirtimeAllocation: 5
      rfProfileAtfOperMode: APF_ATF_MODE_DISABLE
      rfProfileAtfOptimization: APF_ATF_STEALING_POLICY_DISABLE
      rfProfileBand: DOT11_6_GHZ_BAND
      rfProfileBridgeClientAccess: false
      rfProfileChannelWidthMax: DCA_EWLC_CHAN_WIDTH_CAP_MAX
      rfProfileChannelWidthMin: DCA_EWLC_CHAN_WIDTH_CAP_20_MHZ
      rfProfileClientAwareFra: false
      rfProfileClientCountReset6Ghz: 1
      rfProfileDataRate11M: APF_TX_RATE_BASIC
      rfProfileDataRate12M: APF_TX_RATE_BASIC
      rfProfileDataRate18M: APF_TX_RATE_SUPPORTED
      rfProfileDataRate1M: APF_TX_RATE_BASIC
      rfProfileDataRate24M: APF_TX_RATE_BASIC
      rfProfileDataRate2M: APF_TX_RATE_BASIC
      rfProfileDataRate36M: APF_TX_RATE_SUPPORTED
      rfProfileDataRate48M: APF_TX_RATE_SUPPORTED
      rfProfileDataRate54M: APF_TX_RATE_UNSUPPORTED
      rfProfileDataRate55M: APF_TX_RATE_BASIC
      rfProfileDataRate6M: APF_TX_RATE_BASIC
      rfProfileDataRate9M: APF_TX_RATE_SUPPORTED
      rfProfileDot11Ax6GhzFeature: HE_6GHZ_NONE
      rfProfileDot11axNonSrgObssPdMax: -62
      rfProfileDot11axObssPdEnabled: false
      rfProfileDot11axSrgObssPdEnabled: false
      rfProfileDot11axSrgObssPdMax: -62
      rfProfileDot11axSrgObssPdMin: -62
      rfProfileExceptionLevel: 25
      rfProfileFraAction: FRA_ACTION_DEFAULT
      rfProfileGuardIntervalExt: GUARD_INTERVAL_NONE
      rfProfileHsrMode: false
      rfProfileHsrNeighborTimeout: 5
      rfProfileLoadBalancingWindow: 5
      rfProfileMaxRadioClients: 200
      rfProfileMbssidProfName: mb1
      rfProfileMinNumClients: 3
      rfProfileMulticastDataRate: MCAST_DATA_RATE_DEFAULT
      rfProfileName: testrf
      rfProfileNdpMode: NDP_MODE_OFF_CHANNEL
      rfProfileOptRoamRssiThreshold: -127
      rfProfilePscBias: false
      rfProfileRfDcaChannelWidth: RF_DCA_CHAN_WIDTH_BEST
      rfProfileStatus: false
      rfProfileTrapThresholdClients: 12
      rfProfileTxPowerMax: 30
      rfProfileTxPowerMin: -10
      rfProfileTxPowerV1Threshold: -70
      rfProfileTxPowerV2Threshold: -67
      rfProfileZerowtDfs: false
      rxSopSensitivityCustom: -85
      rxSopSensitivityThreshold: RRM_EWLC_RXSENSOP_THRESHOLD_AUTO
      trapThresholdInterference: 10
      trapThresholdNoise: -70
      trapThresholdUtilization: 80

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

catalystcenter_response

dictionary

A dictionary or list with the response returned by the Cisco Catalyst Center Python SDK

Returned: always

Sample: :ansible-rv-sample-value:`{"response": {"taskId": "string", "url": "string"}, "version": "string"}`

Authors

  • Bryan Vargas (@bvargasre)