delete_tier1_gateway
Remove a Tier-1 gateway from VMware NSX, including all attached segments and NAT rules. Specify the gateway ID to delete.
Instructions
Delete a Tier-1 gateway. WARNING: This removes all attached segments and NAT rules.
Args: tier1_id: The Tier-1 gateway ID to delete. target: Optional NSX Manager target name from config. Uses default if omitted.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier1_id | Yes | ||
| target | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- mcp_server/server.py:510-522 (handler)The MCP tool handler for 'delete_tier1_gateway' which takes an optional target and calls the underlying operational function.
@mcp.tool() def delete_tier1_gateway(tier1_id: str, target: str | None = None) -> str: """Delete a Tier-1 gateway. WARNING: This removes all attached segments and NAT rules. Args: tier1_id: The Tier-1 gateway ID to delete. target: Optional NSX Manager target name from config. Uses default if omitted. """ from vmware_nsx.ops.gateway_mgmt import delete_tier1_gateway as _delete client = _get_connection(target) _delete(client, tier1_id) return f"Tier-1 gateway '{tier1_id}' deleted." - vmware_nsx/ops/segment_mgmt.py:270-285 (handler)The core implementation logic for deleting a Tier-1 gateway.
def delete_tier1_gateway(client: NsxClient, tier1_id: str) -> dict: """Delete a Tier-1 gateway. Args: client: Authenticated NSX API client. tier1_id: Tier-1 gateway identifier to delete. Returns: Dict with deletion status. """ _validate_id(tier1_id) path = f"/policy/api/v1/infra/tier-1s/{tier1_id}" client.delete(path) _log.info("Deleted Tier-1 gateway %s", tier1_id) return {"deleted": True, "tier1_id": tier1_id}