{"type":"api","title":"Update Host Policy","meta":{"id":"/apps/pubhub/media/nexus-dashboard-api-v1/86cc2501c92a7370499e3d537496e5c722396afb/ca19d971-84d3-3c2a-862a-c2fba289d1d4","info":{"contact":{"name":"API Support","url":"https://devnetapps.cisco.com/docs/nexus-dashboard/api-v1/developer-support/"},"title":"Nexus Dashboard Fabric Controller API - LAN","description":"Nexus Dashboard Fabric Controller API - LAN","version":"12.5.0"},"tags":[{"name":"End Point Information","description":"Endpoint Locator (EPL) APIs"},{"name":"Fabric Backup and Restore"},{"name":"Change Control"},{"name":"Dashboard"},{"name":"Config Deployer"},{"name":"Fabrics"},{"name":"Inventory"},{"name":"Credentials"},{"name":"Links"},{"name":"OAMs"},{"name":"Switches"},{"name":"Global Interface"},{"name":"Interface Service"},{"name":"Policies"},{"name":"Resource Manager Operations"},{"name":"Top Down LAN Network Operations"},{"name":"Top Down LAN VRF Operations"},{"name":"Service Network Operations"},{"name":"Top Down LAN Network Operations v2"},{"name":"Top Down LAN VRF Operations v2"},{"name":"vPC Pairs"},{"name":"Fabric Inventory"},{"name":"ToR Operations"},{"name":"Templates"},{"name":"Flow Policy Management","description":"IPFM Flow Policy Management"},{"name":"Discovered Hosts","description":"IPFM Discovered Hosts"},{"name":"Host Policy Management","description":"IPFM Host Policy Management"},{"name":"Multicast NAT Modes","description":"Multicast NAT Modes"},{"name":"IPFM Events","description":"IPFM Events"},{"name":"Multicast NAT Recirc Mappings","description":"Multicast NAT Recirc Mappings"},{"name":"Host Alias Management","description":"IPFM Host Aliases listing/create/update/delete"},{"name":"Flow Group Management","description":"IPFM Flow Group"},{"name":"Flow Status","description":"IPFM Flow Status/Chart listings"},{"name":"Topology Management","description":"IPFM Topology listing"},{"name":"Global Settings","description":"IPFM Global Settings"},{"name":"Static Receiver Management","description":"IPFM static receiver listing/create/delete"},{"name":"Host Group Management","description":"IPFM Host Group"},{"name":"RTP Service","description":"RTP Service"},{"name":"Flow Alias Management","description":"IPFM Flow Alias Management"},{"name":"Multicast NAT Rules","description":"Multicast NAT Rules"},{"name":"Telemetry Sync Status","description":"IPFM Telemetry Sync Status"},{"name":"Service Cluster","description":"The first step of L4-L7 services flow, i.e. service node attributes and its physical attachment to VXLAN EVPN fabric"},{"name":"Service Addon","description":"Addon service for L4-L7 services, including route, probe, ACL"},{"name":"Service Chain","description":"The third (optional) step of L4-L7 services flow, i.e. define service chain that consists of multiple service functions in specified order"},{"name":"Audit Log","description":"The audit logs of L4-L7 services"},{"name":"Service Function","description":"The second step of L4-L7 services flow, i.e. service cluster's logical attachments to VXLAN EVPN fabric"},{"name":"Service Insertion","description":"The fourth step of L4-L7 services flow, i.e. service chain for traffic redirect"}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview-legacy-lan.md"},"labelConfig":{"endpoint":{"field":"operationId","format":"startCase"}}},"openapi":"3.0.1","servers":[{"url":"/appcenter/cisco/ndfc/api/v1/","description":"Test server"}]},"spec":{"tags":["Host Policy Management"],"summary":"Update a Host Policy in the given fabric and the VRF","description":"Update/edit an existing Host Policy in the given fabric and the VRF. \n\nOnly the 'permit' value can be updated for a host policy.","operationId":"updateHostPolicy","parameters":[{"name":"fabricName","in":"path","description":"Name of the fabric that the Host Policy belongs to","required":true,"schema":{"type":"string"}},{"name":"vrfName","in":"path","description":"Name of the VRF that the Host Policy belongs to","required":true,"schema":{"type":"string"}},{"name":"policyName","in":"path","description":"Name of the Host Policy to edit","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"string","description":"Example Request Body for Updation: {\"permit\":true|false}"}}},"required":true},"responses":{"200":{"description":"Host policy update successful. Example Response Body: \n\r{\"hostPolicyId\": POLICY_ID, \n\"host\": \"HOST_NAME\", \n\"receiverHost\": \"RECEIVER_HOST_NAME\", \n\"senderHost\": \"SENDER_HOST_NAME\", \n\"receiverIp\":\"RECEIVER_IP\", \n\"senderIp\":\"SENDER_IP\", \n\"multicast\": \"MULTICAST_IP\", \n\"mask\":MASK, \n\"hostRole\": \"Sender|Receiver-External|Receiver-Local\", \n\"permit\": true|false, \n\"sequenceNumber\":SEQUENCE_NUMBER, \n\"createdBy\": \"USER_NAME\", \n\"lastUpdated\": LAST_UPDATED_TIMESTAMP, \n\"policyName\": \"POLICY_NAME\", \n\"fabric\": \"FABRIC\", \n\"vrf\": \"VRF\", \n\"lastUpdatedAsString\": \"LAST_UPDATED_TIME_AS_STRING\"}","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized access to API","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Operation is not allowed in read-only mode","content":{"application/json":{"schema":{"type":"object"}}}},"500":{"description":"Message varies depending on the condition","content":{"application/json":{"schema":{"type":"object"}}}}},"__originalOperationId":"updateHostPolicy","method":"put","path":"/appcenter/cisco/ndfc/api/v1/pmn/fabrics/{fabricName}/vrfs/{vrfName}/hostpolicies/{policyName}"}}