added option to create a random port for a tcp route

cloudfoundry/cfapi/route_manager.go

@@ -127,16 +127,23 @@ func (rm *RouteManager) ReadRoute(routeID string) (route CCRoute, err error) {
 }
 
 // CreateRoute -
-func (rm *RouteManager) CreateRoute(r CCRoute) (route CCRoute, err error) {
+func (rm *RouteManager) CreateRoute(r CCRoute, randomPort bool) (route CCRoute, err error) {
 
 	body, err := json.Marshal(r)
 	if err != nil {
 		return
 	}
 
+	var path string
+	if randomPort {
+		path = "/v2/routes?generate_port=true"
+	} else {
+		path = "/v2/routes"
+	}
+
 	resource := CCRouteResource{}
 	if err = rm.ccGateway.CreateResource(rm.apiEndpoint,
-		"/v2/routes", bytes.NewReader(body), &resource); err != nil {
+		path, bytes.NewReader(body), &resource); err != nil {
 		return
 	}
 	route = resource.Entity

cloudfoundry/cfapi/service_manager.go

@@ -632,7 +632,6 @@ func (sm *ServiceManager) DeleteServiceKey(serviceKeyID string) (err error) {
 
 // FindServiceKey -
 func (sm *ServiceManager) FindServiceKey(name string, serviceInstanceID string) (serviceKey CCServiceKey, err error) {
-
 	path := fmt.Sprintf("/v2/service_keys?q=%s", url.QueryEscape("name:"+name))
 
 	var found bool

cloudfoundry/resource_cf_route.go

@@ -35,8 +35,13 @@ func resourceRoute() *schema.Resource {
 			"port": &schema.Schema{
 				Type:          schema.TypeInt,
 				Optional:      true,
+				ConflictsWith: []string{"path", "random_port"},
+			},
+			"random_port": &schema.Schema{
+				Type:          schema.TypeBool,
+				Optional:      true,
 				ForceNew:      true,
-				ConflictsWith: []string{"path"},
+				ConflictsWith: []string{"path", "port"},
 			},
 			"path": &schema.Schema{
 				Type:          schema.TypeString,
@@ -111,10 +116,15 @@ func resourceRouteCreate(d *schema.ResourceData, meta interface{}) (err error) {
 		route.Path = &vv
 	}
 
+	randomPort := false
+	if v, ok := d.GetOk("random_port"); ok {
+		randomPort = v.(bool)
+	}
+
 	rm := session.RouteManager()
 
 	// Create route
-	if route, err = rm.CreateRoute(route); err != nil {
+	if route, err = rm.CreateRoute(route, randomPort); err != nil {
 		return err
 	}
 	// Delete route if an error occurs

website/docs/r/route.html.markdown

@@ -32,7 +32,8 @@ The following arguments are supported:
 
 The following argument applies only to TCP routes.
 
-- `port` - (Optional) The port to associate with the route for a TCP route. 
+- `port` - (Optional, Int) The port to associate with the route for a TCP route. 
+- `random_port` - (Optional, Bool) Set to 'true' to create a random port.
 
 The following argument applies only to HTTP routes.
 
@@ -43,7 +44,7 @@ The following maps the route to an application.
 - `target` - (Optional) A route mapping that will map this route to an application
 
   - `app` - (Required, String) The ID of the [application](/docs/providers/cf/r/app.html) to map this route to.
-  - `port` - (Optional, int) A port that the application will be listening on. If this argument is not provided then the route will be associated with the application's default port.
+  - `port` - (Optional, Int) A port that the application will be listening on. If this argument is not provided then the route will be associated with the application's default port.
 
 ## Attributes Reference