# 

# exoscale_nlb_service_list (Data Source)

Fetch Exoscale [Network Load Balancers (NLB)](https://community.exoscale.com/product/networking/nlb/) Services.

Corresponding resource: [exoscale_nlb]({{< ref "../resources/nlb.md" >}}).

## Example Usage

```terraform
data "exoscale_nlb_service_list" "example_nlb_services" {
  name = "my-nlb"
}

# Outputs
output "nlb_services_output" {
  value = data.exoscale_nlb_service_list.example_nlb_services.services
}
```

Please refer to the [examples](https://github.com/exoscale/terraform-provider-exoscale/tree/master/examples/)
directory for complete configuration examples.

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `zone` (String) The Exoscale [Zone](https://www.exoscale.com/datacenters/) name.

### Optional

- `nlb_id` (String) The NLB ID to match (conflicts with `name`).
- `nlb_name` (String) The NLB name to match (conflicts with `id`).
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))

### Read-Only

- `id` (String) The ID of this resource.
- `services` (Attributes List) The list of [exoscale_nlb_service]({{< ref "./nlb_service_list.md" >}}). (see [below for nested schema](#nestedatt--services))

<a id="nestedblock--timeouts"></a>
### Nested Schema for `timeouts`

Optional:

- `read` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.


<a id="nestedatt--services"></a>
### Nested Schema for `services`

Read-Only:

- `description` (String) NLB service description.
- `healthcheck` (Object) (see [below for nested schema](#nestedatt--services--healthcheck))
- `id` (String) NLB service ID.
- `instance_pool_id` (String) The [exoscale_instance_pool]({{< ref "./instance_pool.md" >}}) (ID) to forward traffic to.
- `name` (String) NLB Service name.
- `port` (Number) Port exposed on the NLB's public IP.
- `protocol` (String) Network traffic protocol.
- `state` (String) NLB Service State.
- `strategy` (String) The strategy (`round-robin`|`source-hash`).
- `target_port` (Number) Port on which the network traffic will be forwarded to on the receiving instance.

<a id="nestedatt--services--healthcheck"></a>
### Nested Schema for `services.healthcheck`

Read-Only:

- `interval` (Number)
- `mode` (String)
- `port` (Number)
- `retries` (Number)
- `timeout` (Number)
- `tls_sni` (String)
- `uri` (String)