nd_interface_subinterface_unmanaged

[allenrobel]

Related Issue(s)

References #295 (the 207-status:failed silent-success bug in response_handler_nd.py is worked around in this module via _raise_on_multi_status_failures; remove the workaround when #295 lands).

Note: This PR is stacked on #296 (nd_interface_subinterface_managed). Please review #296 first; this PR will be retargeted to develop and rebased once #296 merges.

Proposed Changes

• Add the nd_interface_subinterface_unmanaged module to manage L3 subinterfaces in monitor mode (unmanaged variant, policyType: monitorSubinterface) on Cisco Nexus Dashboard 4.2.
• Add SubinterfaceUnmanagedInterfaceModel and SubinterfaceUnmanagedInterfaceOrchestrator, mirroring the managed variant's structure but with the policy body reduced to its policyType discriminator only.
• All scaffolding fields (interface_type, mode, network_os_type, policy_type) are hardcoded via Literal[...] + Field(frozen=True) and hidden from the user-facing argument spec. The user supplies only switch_ip and interface_name per item.
• query_all filters on policyType in {monitorSubinterface} via a dedicated SubinterfaceUnmanagedPolicyTypeEnum, so managed and unmanaged subinterfaces are cleanly partitioned across the two modules.
• Defensive extra="ignore" on the policy model absorbs any read-only fields ND echoes under policy on GET (e.g. the schema's userDefined discriminator branch siblings).
• Orchestrator unit tests at 98% coverage (23 tests, including the _raise_on_multi_status_failures matrix and a positive assertion that query_all filters out the managed subinterface policyType).
• Integration test target with sub-id range .20-.29 to coexist with the managed target's .2-.5 range. Phases: merged (single, multi, Port-channel parent, idempotency), replaced (no-op on existing + fall-back-to-create on missing), overridden (fabric-wide reduce), deleted.

Test Notes

• Integration tests pass on ND 4.2.1 lab SITE1 against routed-mode parents (Ethernet1/3 and Port-channel10 on S1_TOR1). Both managed and unmanaged targets were run successfully back-to-back to confirm the sub-id ranges do not collide.
• 23 unit tests pass (python -m pytest tests/unit/module_utils/orchestrators/test_subinterface_unmanaged_interface.py).
• ansible-test sanity --docker clean on the touched files.
• Two carried-over ND 4.2.1 wire workarounds:
  • Parent must be in routed (L3) mode — same as managed; surfaced via _raise_on_multi_status_failures and documented in notes:.
  • interface_name echoed lowercased on GET — same normalize_interface_name field validator pattern as the managed variant.
• The routing_tag int→str workaround does NOT apply here (no policy fields with that name in the unmanaged body).

Cisco Nexus Dashboard Version

4.2.1

Related ND API Resource Category

• analyze
• infra
• manage
• onemanage
• other

Checklist

• Latest commit is rebased from develop with merge conflicts resolved
• New or updates to documentation has been made accordingly
• Assigned the proper reviewers

🤖 Generated with Claude Code