VPC Pair 4.x Implementation

plugins/module_utils/endpoints/mixins.py

@@ -84,3 +84,48 @@ class VrfNameMixin(BaseModel):
     """Mixin for endpoints that require vrf_name parameter."""
 
     vrf_name: Optional[str] = Field(default=None, min_length=1, max_length=64, description="VRF name")
+
+
+class SwitchIdMixin(BaseModel):
+    """Mixin for endpoints that require switch_id parameter."""
+
+    switch_id: Optional[str] = Field(default=None, min_length=1, description="Switch serial number")
+
+
+class PeerSwitchIdMixin(BaseModel):
+    """Mixin for endpoints that require peer_switch_id parameter."""
+
+    peer_switch_id: Optional[str] = Field(default=None, min_length=1, description="Peer switch serial number")
+
+
+class UseVirtualPeerLinkMixin(BaseModel):
+    """Mixin for endpoints that require use_virtual_peer_link parameter."""
+
+    use_virtual_peer_link: Optional[bool] = Field(
+        default=False,
+        description="Indicates whether a virtual peer link is present",
+    )
+
+
+class FromClusterMixin(BaseModel):
+    """Mixin for endpoints that support fromCluster query parameter."""
+
+    from_cluster: Optional[str] = Field(default=None, description="Optional cluster name")
+
+
+class TicketIdMixin(BaseModel):
+    """Mixin for endpoints that support ticketId query parameter."""
+
+    ticket_id: Optional[str] = Field(default=None, description="Change ticket ID")
+
+
+class ComponentTypeMixin(BaseModel):
+    """Mixin for endpoints that require componentType query parameter."""
+
+    component_type: Optional[str] = Field(default=None, description="Component type for filtering response")
+
+
+class ViewMixin(BaseModel):
+    """Mixin for endpoints that support view parameter."""
+
+    view: Optional[str] = Field(default=None, description="Optional view type for filtering results")

plugins/module_utils/endpoints/v1/manage/manage_fabrics_actions_config_save.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright: (c) 2026, Sivakami Sivaraman sivakasi@cisco.com
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from typing import Literal
+
+from ansible_collections.cisco.nd.plugins.module_utils.common.pydantic_compat import (
+    ConfigDict,
+    Field,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.base import (
+    NDEndpointBaseModel,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.mixins import (
+    FabricNameMixin,
+    FromClusterMixin,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.v1.manage.base_path import (
+    BasePath,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.enums import HttpVerbEnum
+
+# API path covered by this file:
+# /api/v1/manage/fabrics/{fabricName}/actions/configSave
+COMMON_CONFIG = ConfigDict(validate_assignment=True)
+
+
+class EpFabricConfigSavePost(
+    FabricNameMixin,
+    FromClusterMixin,
+    NDEndpointBaseModel,
+):
+    """
+    POST /api/v1/manage/fabrics/{fabricName}/actions/configSave
+    """
+
+    model_config = COMMON_CONFIG
+    api_version: Literal["v1"] = Field(default="v1")
+    min_controller_version: str = Field(default="3.0.0")
+    class_name: Literal["EpFabricConfigSavePost"] = Field(default="EpFabricConfigSavePost")
+
+    @property
+    def path(self) -> str:
+        if self.fabric_name is None:
+            raise ValueError("fabric_name is required")
+        return BasePath.path("fabrics", self.fabric_name, "actions", "configSave")
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.POST

plugins/module_utils/endpoints/v1/manage/manage_fabrics_actions_deploy.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright: (c) 2026, Sivakami Sivaraman sivakasi@cisco.com
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from typing import Literal
+
+from ansible_collections.cisco.nd.plugins.module_utils.common.pydantic_compat import (
+    ConfigDict,
+    Field,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.base import (
+    NDEndpointBaseModel,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.mixins import (
+    FabricNameMixin,
+    FromClusterMixin,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.v1.manage.base_path import (
+    BasePath,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.enums import HttpVerbEnum
+
+# API path covered by this file:
+# /api/v1/manage/fabrics/{fabricName}/actions/deploy
+COMMON_CONFIG = ConfigDict(validate_assignment=True)
+
+
+class EpFabricDeployPost(
+    FabricNameMixin,
+    FromClusterMixin,
+    NDEndpointBaseModel,
+):
+    """
+    POST /api/v1/manage/fabrics/{fabricName}/actions/deploy
+    """
+
+    model_config = COMMON_CONFIG
+    api_version: Literal["v1"] = Field(default="v1")
+    min_controller_version: str = Field(default="3.0.0")
+    class_name: Literal["EpFabricDeployPost"] = Field(default="EpFabricDeployPost")
+
+    @property
+    def path(self) -> str:
+        if self.fabric_name is None:
+            raise ValueError("fabric_name is required")
+        return BasePath.path("fabrics", self.fabric_name, "actions", "deploy")
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.POST

plugins/module_utils/endpoints/v1/manage/manage_fabrics_switches.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright: (c) 2026, Sivakami Sivaraman sivakasi@cisco.com
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from typing import Literal
+
+from ansible_collections.cisco.nd.plugins.module_utils.common.pydantic_compat import (
+    ConfigDict,
+    Field,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.base import (
+    NDEndpointBaseModel,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.mixins import (
+    FabricNameMixin,
+    FromClusterMixin,
+    ViewMixin,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.query_params import (
+    CompositeQueryParams,
+    EndpointQueryParams,
+    LuceneQueryParams,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.v1.manage.base_path import (
+    BasePath,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.enums import HttpVerbEnum
+
+# API path covered by this file:
+# /api/v1/manage/fabrics/{fabricName}/switches
+COMMON_CONFIG = ConfigDict(validate_assignment=True)
+
+
+class FabricSwitchesEndpointParams(FromClusterMixin, ViewMixin, EndpointQueryParams):
+    """Endpoint-specific query parameters for fabric switches endpoint."""
+
+
+class EpFabricSwitchesGet(
+    FabricNameMixin,
+    NDEndpointBaseModel,
+):
+    """
+    GET /api/v1/manage/fabrics/{fabricName}/switches
+    """
+
+    model_config = COMMON_CONFIG
+    api_version: Literal["v1"] = Field(default="v1")
+    min_controller_version: str = Field(default="3.0.0")
+    class_name: Literal["EpFabricSwitchesGet"] = Field(default="EpFabricSwitchesGet")
+    endpoint_params: FabricSwitchesEndpointParams = Field(default_factory=FabricSwitchesEndpointParams, description="Endpoint-specific query parameters")
+    lucene_params: LuceneQueryParams = Field(default_factory=LuceneQueryParams, description="Lucene query parameters")
+
+    @property
+    def path(self) -> str:
+        if self.fabric_name is None:
+            raise ValueError("fabric_name is required")
+        base_path = BasePath.path("fabrics", self.fabric_name, "switches")
+        query_params = CompositeQueryParams().add(self.endpoint_params).add(self.lucene_params)
+        query_string = query_params.to_query_string()
+        if query_string:
+            return f"{base_path}?{query_string}"
+        return base_path
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.GET

plugins/module_utils/endpoints/v1/manage/manage_fabrics_switches_vpc_pair.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright: (c) 2026, Sivakami Sivaraman sivakasi@cisco.com
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from typing import Literal
+
+from ansible_collections.cisco.nd.plugins.module_utils.common.pydantic_compat import (
+    Field,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.base import (
+    NDEndpointBaseModel,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.mixins import (
+    FabricNameMixin,
+    FromClusterMixin,
+    SwitchIdMixin,
+    TicketIdMixin,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.query_params import (
+    EndpointQueryParams,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.v1.manage.base_path import (
+    BasePath,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.enums import HttpVerbEnum
+
+# API path covered by this file:
+# /api/v1/manage/fabrics/{fabricName}/switches/{switchId}/vpcPair
+
+
+class _EpVpcPairBase(
+    FabricNameMixin,
+    SwitchIdMixin,
+    NDEndpointBaseModel,
+):
+    @property
+    def path(self) -> str:
+        if self.fabric_name is None or self.switch_id is None:
+            raise ValueError("fabric_name and switch_id are required")
+        base_path = BasePath.path(
+            "fabrics",
+            self.fabric_name,
+            "switches",
+            self.switch_id,
+            "vpcPair",
+        )
+        query_string = self.endpoint_params.to_query_string()
+        if query_string:
+            return f"{base_path}?{query_string}"
+        return base_path
+
+
+class VpcPairGetEndpointParams(FromClusterMixin, EndpointQueryParams):
+    """Endpoint-specific query parameters for vPC pair GET endpoint."""
+
+
+class VpcPairPutEndpointParams(VpcPairGetEndpointParams, TicketIdMixin):
+    """Endpoint-specific query parameters for vPC pair PUT endpoint."""
+
+
+class EpVpcPairGet(_EpVpcPairBase):
+    """
+    GET /api/v1/manage/fabrics/{fabricName}/switches/{switchId}/vpcPair
+    """
+
+    class_name: Literal["EpVpcPairGet"] = Field(default="EpVpcPairGet", frozen=True, description="Class name for backward compatibility")
+    endpoint_params: VpcPairGetEndpointParams = Field(default_factory=VpcPairGetEndpointParams, description="Endpoint-specific query parameters")
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.GET
+
+
+class EpVpcPairPut(_EpVpcPairBase):
+    """
+    PUT /api/v1/manage/fabrics/{fabricName}/switches/{switchId}/vpcPair
+    """
+
+    class_name: Literal["EpVpcPairPut"] = Field(default="EpVpcPairPut", frozen=True, description="Class name for backward compatibility")
+    endpoint_params: VpcPairPutEndpointParams = Field(default_factory=VpcPairPutEndpointParams, description="Endpoint-specific query parameters")
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.PUT

plugins/module_utils/endpoints/v1/manage/manage_fabrics_switches_vpc_pair_consistency.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright: (c) 2026, Sivakami Sivaraman sivakasi@cisco.com
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from typing import Literal
+
+from ansible_collections.cisco.nd.plugins.module_utils.common.pydantic_compat import (
+    Field,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.base import (
+    NDEndpointBaseModel,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.mixins import (
+    FabricNameMixin,
+    FromClusterMixin,
+    SwitchIdMixin,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.query_params import (
+    EndpointQueryParams,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.endpoints.v1.manage.base_path import (
+    BasePath,
+)
+from ansible_collections.cisco.nd.plugins.module_utils.enums import HttpVerbEnum
+
+# API path covered by this file:
+# /api/v1/manage/fabrics/{fabricName}/switches/{switchId}/vpcPairConsistency
+
+
+class VpcPairConsistencyEndpointParams(FromClusterMixin, EndpointQueryParams):
+    """Endpoint-specific query parameters for vPC pair consistency endpoint."""
+
+
+class EpVpcPairConsistencyGet(
+    FabricNameMixin,
+    SwitchIdMixin,
+    NDEndpointBaseModel,
+):
+    """
+    GET /api/v1/manage/fabrics/{fabricName}/switches/{switchId}/vpcPairConsistency
+    """
+
+    class_name: Literal["EpVpcPairConsistencyGet"] = Field(default="EpVpcPairConsistencyGet", frozen=True, description="Class name for backward compatibility")
+    endpoint_params: VpcPairConsistencyEndpointParams = Field(
+        default_factory=VpcPairConsistencyEndpointParams, description="Endpoint-specific query parameters"
+    )
+
+    @property
+    def path(self) -> str:
+        if self.fabric_name is None or self.switch_id is None:
+            raise ValueError("fabric_name and switch_id are required")
+        base_path = BasePath.path(
+            "fabrics",
+            self.fabric_name,
+            "switches",
+            self.switch_id,
+            "vpcPairConsistency",
+        )
+        query_string = self.endpoint_params.to_query_string()
+        if query_string:
+            return f"{base_path}?{query_string}"
+        return base_path
+
+    @property
+    def verb(self) -> HttpVerbEnum:
+        return HttpVerbEnum.GET