create

{              
  "metadata": {                // [required]
    "labels": {                // [map]
                               // Labels associated with the resource.
      string: string                  
    },
    "name": string,            // Human readable name for the resource.
    "parent_id": string,       // [required]
                               // Identifier of the parent resource to which the resource belongs.
    "resource_version": int64  // Version of the resource for safe concurrent modifications and consistent reads.
                               // Positive and monotonically increases on each resource spec change (but *not* on each change of the
                               // resource's container(s) or status).
                               // Service allows zero value or current.
  },
  "spec": {                // [required]
    "description": string, // Optional description of the route.
    "destination": {  // [required] [immutable]
                      // Destination for the route.
                      // Each destination CIDR must be unique within a route table.
                      // When multiple routes match a destination IP, the route with the longest
                      // matching prefix (most specific match) is selected.
      "cidr": string  // [required] [immutable]
                      // Destination CIDR block in IPv4 format (e.g., "0.0.0.0/0" for default route, "192.168.100.0/24" for specific subnet).
                      // The CIDR notation specifies the range of IP addresses that this route will match.
                      // Must be unique within a route table.
    },
    "next_hop": {                     // [required] [immutable]
                                      // Next hop configuration specifying where to send matching traffic.
      "allocation": { // Cannot be set together with: default_egress_gateway
                      // Forward traffic to a specific IP allocation (/32 address only).
                      // The allocation must be from the same network as the route table.
                      // The allocation must be assigned to either a Compute instance or a Load Balancer.
                      // Warning: If the allocation exists but is not assigned to any resource,
                      // traffic will be forwarded to a "black hole" and dropped.
        "id": string  // [required]
                      // ID of the IP allocation to use as the next hop.
      },
      "default_egress_gateway": bool  // Cannot be set together with: allocation
                                      // Use the default egress gateway for outbound traffic.
                                      // Note: For VMs with public addresses (Floating IPs/FIPs), the FIP-specific route
                                      // takes precedence over this default egress gateway route.
    }
  }
}