oci_load_balancer_path_route_set

This resource provides the Path Route Set resource in Oracle Cloud Infrastructure Load Balancer service. Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/loadbalancer/latest/PathRouteSet

Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/load_balancer

Adds a path route set to a load balancer. For more information, see Managing Request Routing.

Example Usage

resource "oci_load_balancer_path_route_set" "test_path_route_set" {
	#Required
	load_balancer_id = oci_load_balancer_load_balancer.test_load_balancer.id
	name = var.path_route_set_name
	path_routes {
		#Required
		backend_set_name = oci_load_balancer_backend_set.test_backend_set.name
		path = var.path_route_set_path_routes_path
		path_match_type {
			#Required
			match_type = var.path_route_set_path_routes_path_match_type_match_type
		}
	}
}

Argument Reference

The following arguments are supported:

• load_balancer_id - (Required) The OCID of the load balancer to add the path route set to.

• name - (Required) The name for this set of path route rules. It must be unique and it cannot be changed. Avoid entering confidential information. Example: example_path_route_set

• path_routes - (Required) (Updatable) The set of path route rules.

  • backend_set_name - (Required) (Updatable) The name of the target backend set for requests where the incoming URI matches the specified path. Example: example_backend_set

  • path - (Required) (Updatable) The path string to match against the incoming URI path.

    • Path strings are case-insensitive.
    • Asterisk (*) wildcards are not supported.
    • Regular expressions are not supported.

    Example: /example/video/123

  • path_match_type - (Required) (Updatable) The type of matching to apply to incoming URIs.

    • match_type - (Required) (Updatable) Specifies how the load balancing service compares a PathRoute object’s path string against the incoming URI.

      • EXACT_MATCH - Looks for a path string that exactly matches the incoming URI path.
      • FORCE_LONGEST_PREFIX_MATCH - Looks for the path string with the best, longest match of the beginning portion of the incoming URI path.
      • PREFIX_MATCH - Looks for a path string that matches the beginning portion of the incoming URI path.
      • SUFFIX_MATCH - Looks for a path string that matches the ending portion of the incoming URI path.

      For a full description of how the system handles matchType in a path route set containing multiple rules, see Managing Request Routing.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Attributes Reference

The following attributes are exported:

• name - The unique name for this set of path route rules. Avoid entering confidential information. Example: example_path_route_set

• path_routes - The set of path route rules.

  • backend_set_name - The name of the target backend set for requests where the incoming URI matches the specified path. Example: example_backend_set

  • path - The path string to match against the incoming URI path.

    • Path strings are case-insensitive.
    • Asterisk (*) wildcards are not supported.
    • Regular expressions are not supported.

    Example: /example/video/123

  • path_match_type - The type of matching to apply to incoming URIs.

    • match_type - Specifies how the load balancing service compares a PathRoute object’s path string against the incoming URI.

      • EXACT_MATCH - Looks for a path string that exactly matches the incoming URI path.
      • FORCE_LONGEST_PREFIX_MATCH - Looks for the path string with the best, longest match of the beginning portion of the incoming URI path.
      • PREFIX_MATCH - Looks for a path string that matches the beginning portion of the incoming URI path.
      • SUFFIX_MATCH - Looks for a path string that matches the ending portion of the incoming URI path.

      For a full description of how the system handles matchType in a path route set containing multiple rules, see Managing Request Routing.

Timeouts

The timeouts block allows you to specify timeouts for certain operations: * create - (Defaults to 20 minutes), when creating the Path Route Set * update - (Defaults to 20 minutes), when updating the Path Route Set * delete - (Defaults to 20 minutes), when destroying the Path Route Set

Import

PathRouteSets can be imported using the id, e.g.

$ terraform import oci_load_balancer_path_route_set.test_path_route_set "loadBalancers/{loadBalancerId}/pathRouteSets/{pathRouteSetName}"