Create Wifi Profile Parcel For Mobility - Cisco Catalyst SD-WAN Manager API, Release 20.18

{"type":"api","title":"Create Wifi Profile Parcel For Mobility","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/a724d7a2-d5be-3cd7-8f42-0d775cdd69b7","info":{"title":"Feature Profiles - Mobility and NFV","description":"Feature profiles associated with UX 2.0 configuration\n\nIncludes API operations for the following:\n- Feature Profiles in Mobility and NFV Solutions\n- Supporting mobility features and Network Function Virtualization (NFV) configurations.\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Configuration - Feature Profile (Mobility)"],"description":"Create an Wifi Profile Parcel for Mobility feature profile","operationId":"CreateWifiProfileParcelForMobility","parameters":[{"name":"profileId","in":"path","description":"Feature Profile ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Wifi Profile Parcel","content":{"application/json":{"schema":{"discriminator":{"propertyName":"type"},"properties":{"createdBy":{"type":"string","description":"User who last created this.","readOnly":true},"createdOn":{"type":"integer","description":"Timestamp of creation","format":"int64","readOnly":true},"description":{"type":"string","description":"Description of the Profile Parcel.","example":"Wifi 7 profile Parcel"},"id":{"type":"string","description":"System generated unique identifier of the Profile Parcel in UUID format.","example":"6fa14197-c25f-4a14-b81b-299de32ed2ca"},"lastUpdatedBy":{"type":"string","description":"User who last updated this.","readOnly":true},"lastUpdatedOn":{"type":"integer","description":"Timestamp of last update","format":"int64","readOnly":true},"name":{"type":"string","description":"Name of the Profile Parcel. Must be unique.","example":"Wifi profile Parcel"},"type":{"type":"string","description":"type","example":"wifi","enum":["cellular","wifi","ethernet","globalSettings","networkProtocol","securityPolicy"]},"variables":{"type":"array","items":{"required":["jsonPath","varName"],"type":"object","properties":{"jsonPath":{"type":"string"},"varName":{"type":"string"}},"$$ref":"#/components/schemas/Variable"}},"ssidConfigList":{"maxItems":4,"minItems":1,"type":"array","items":{"type":"object","properties":{"qosSettings":{"pattern":"(WLAN_QOS_BEST_EFFORT|WLAN_QOS_VIDEO|WLAN_QOS_VOICE|WLAN_QOS_BACKGROUND|WLAN_QOS_RESERVED)","type":"string"},"securityAuthType":{"pattern":"(OPEN|WPA2-PSK_AES)","type":"string"},"ssid":{"maxLength":32,"minLength":1,"type":"string"},"visibility":{"type":"boolean"},"wpaPskKey":{"type":"string"}},"$$ref":"#/components/schemas/SSIDConfig"}},"guestWifi":{"type":"object","properties":{"securityAuthType":{"pattern":"(OPEN|WPA2-PSK_AES)","type":"string"},"ssid":{"maxLength":32,"minLength":1,"type":"string"},"visibility":{"type":"boolean"},"wpaPskKey":{"type":"string"}},"$$ref":"#/components/schemas/GuestWifi"},"corporateWifi":{"required":["securityAuthType"],"type":"object","properties":{"aaaServerInfo":{"required":["aaaServersParcelId","radiusServerName"],"type":"object","properties":{"aaaServersParcelId":{"pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}","type":"string"},"radiusServerName":{"type":"string"}},"$$ref":"#/components/schemas/AaaServerInfo"},"corporateWlan":{"type":"boolean"},"radiusServer":{"required":["host","port","secret"],"type":"object","properties":{"host":{"pattern":"(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(%[\\p{N}\\p{L}]+)?","type":"string"},"port":{"minimum":0,"type":"integer","format":"int32"},"secret":{"type":"string"}},"$$ref":"#/components/schemas/RadiusServer"},"securityAuthType":{"pattern":"(WPA2-PSK_AES|WPA2-Enterprise)","type":"string"},"ssid":{"maxLength":32,"minLength":1,"type":"string"},"visibility":{"type":"boolean"},"wpaPskKey":{"type":"string"}},"$$ref":"#/components/schemas/CorporateWifi"},"advancedRadioSetting":{"type":"object","properties":{"channelPowerSettings":{"type":"object","properties":{"radioBand2Dot4Ghz":{"type":"object","properties":{"band":{"pattern":"(RADIO_2_DOT_4_GHZ)","type":"string"},"channel":{"pattern":"(auto|1|2|3|4|5|6|7|8|9|10|11)","type":"string"},"channelWidth":{"pattern":"(RADIO_CHANNEL_WIDTH_20_MHZ)","type":"string"},"transmitPower":{"pattern":"(auto|1|2|3|4|5|6|7)","type":"string"}},"$$ref":"#/components/schemas/RadioBandSetting_2_4G"},"radioBand5Ghz":{"type":"object","properties":{"band":{"pattern":"(RADIO_5_GHZ)","type":"string"},"channel":{"pattern":"(auto|36|40|44|48|52|56|60|64|100|104|108|112|116|120|124|128|132|136|140|144|149|153|157|161|165)","type":"string"},"channelWidth":{"pattern":"(RADIO_CHANNEL_WIDTH_20_MHZ|RADIO_CHANNEL_WIDTH_40_MHZ|RADIO_CHANNEL_WIDTH_80_MHZ)","type":"string"},"transmitPower":{"pattern":"(auto|1|2|3|4|5|6|7)","type":"string"}},"$$ref":"#/components/schemas/RadioBandSetting_5G"}},"$$ref":"#/components/schemas/ChannelPowerSettings"},"countryRegionSettings":{"type":"object","properties":{"countryRegion":{"type":"string"},"regulatoryDomain":{"pattern":"(REG_DOMAIN_INVALID|REG_DOMAIN_A|REG_DOMAIN_B|REG_DOMAIN_C|REG_DOMAIN_D|REG_DOMAIN_E|REG_DOMAIN_F|REG_DOMAIN_G|REG_DOMAIN_H|REG_DOMAIN_I|REG_DOMAIN_J|REG_DOMAIN_K|REG_DOMAIN_L|REG_DOMAIN_M|REG_DOMAIN_N|REG_DOMAIN_P|REG_DOMAIN_Q|REG_DOMAIN_R|REG_DOMAIN_S|REG_DOMAIN_T|REG_DOMAIN_U|REG_DOMAIN_Z|REG_DOMAIN_NONE|REG_DOMAIN_ZZ)","type":"string"}},"$$ref":"#/components/schemas/CountryRegionSettings"}},"$$ref":"#/components/schemas/AdvancedRadioSetting"}},"required":["name","type","name","type"],"type":"object","$$ref":"#/components/schemas/Wifi"},"examples":{"Wifi Profile Parcel For Mobility Global Feature Profile":{"description":"Wifi Profile Parcel For Mobility Global Feature Profile","value":{"name":"config_grp_test","description":"config_grp_test","family":"aon","featureprofiles":[{"profileName":"config_grp_test_aon","description":"","profileType":"aon","parcels":[{"ssidConfigList":[{"ssid":"myssid1","visibility":true,"securityAuthType":"OPEN","wpaPskKey":"","qosSettings":"WLAN_QOS_VIDEO"},{"ssid":"myssid2","visibility":true,"securityAuthType":"WPA2-PSK_AES","wpaPskKey":"B1C2DE1","qosSettings":"WLAN_QOS_BEST_EFFORT"},{"ssid":"myssid3","visibility":true,"securityAuthType":"WPA2-PSK_AES","wpaPskKey":"A4B5EA1","qosSettings":"WLAN_QOS_BEST_EFFORT"},{"ssid":"myssid4","visibility":true,"securityAuthType":"WPA2-Enterprise","wpaPskKey":"","qosSettings":"WLAN_QOS_BEST_EFFORT","radiusServer":[{"host":"1.2.3.4","port":1812,"secret":"secret1"},{"host":"5.6.7.8","port":1814,"secret":"secret2"}]}],"guestWifi":{"ssid":"Guest123","visibility":false,"securityAuthType":"WPA2-PSK_AES","wpaPskKey":"A2BC3ED","encryptionType":"cipherAES","wpaEncryptionMode":"WPA2","validityPeriod":"60"},"corporateWifi":{"ssid":"Corporate123","visibility":false,"securityAuthType":"WPA2-PSK_AES","wpaPskKey":"A2BC3ED","encryptionType":"cipherAES","wpaEncryptionMode":"WPA2","validityPeriod":"60","corporateWlan":true},"advancedRadioSetting":{"countryRegionSettings":{"countryRegion":"United State","regulatoryDomain":"REG_DOMAIN_A"},"channelPowerSettings":{"radioBand2Dot4Ghz":{"band":"RADIO_2_DOT_4_GHZ","channel":"11","transmitPower":"1","channelWidth":"RADIO_CHANNEL_WIDTH_20_MHZ"},"radioBand5Ghz":{"band":"RADIO_5_GHZ","channel":"36","transmitPower":"1","channelWidth":"RADIO_CHANNEL_WIDTH_20_MHZ"}}},"parcelType":"wifi","subparcels":[]}]}]}}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"examples":{"post response example":{"description":"post response example","value":{"parcelId":"24C3EF06-c09a-DeFa-Ab26-a1cc4Ef0D51A"}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Feature Profile \u003e Teleworker \u003e Wifi-write","method":"post","path":"/v1/feature-profile/mobility/global/{profileId}/wifi"}}