> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/crossplane/api/application-load-balancer/targetgroup.md). # TargetGroup ## Overview * Resource Name: `TargetGroup` * Resource Group: `alb.ionoscloud.crossplane.io` * Resource Version: `v1alpha1` * Resource Scope: `Cluster` ## Usage In order to manage resources on IONOS Cloud using Crossplane Provider, you need to have Crossplane Provider for IONOS Cloud installed into a Kubernetes Cluster, as a prerequisite. For a step-by-step guide, check the following [link](https://github.com/ionos-cloud/crossplane-provider-ionoscloud/tree/master/examples/example.md). It is recommended to clone the repository for easier access to the example files. ### Create Use the following command to create a resource instance. Before applying the file, check the properties defined in the `spec.forProvider` fields: ```bash kubectl apply -f examples/ionoscloud/alb/targetgroup.yaml ``` *Note*: The command should be run from the root of the `crossplane-provider-ionoscloud` directory. ### Update Use the following command to update an instance. Before applying the file, update the properties defined in the `spec.forProvider` fields: ```bash kubectl apply -f examples/ionoscloud/alb/targetgroup.yaml ``` *Note*: The command should be run from the root of the `crossplane-provider-ionoscloud` directory. ### Wait Use the following commands to wait for resources to be ready and synced. Update the `` accordingly: ```bash kubectl wait --for=condition=ready targetgroups.alb.ionoscloud.crossplane.io/ ``` ```bash kubectl wait --for=condition=synced targetgroups.alb.ionoscloud.crossplane.io/ ``` ### Get Use the following command to get a list of the existing instances: ```bash kubectl get -f targetgroups.alb.ionoscloud.crossplane.io ``` *Note*: Use options `--output wide`, `--output json` to get more information about the resource instances. ### Delete Use the following command to destroy the resources created by applying the file: ```bash kubectl delete -f examples/ionoscloud/alb/targetgroup.yaml ``` *Note*: The command should be run from the root of the `crossplane-provider-ionoscloud` directory. ## Properties In order to configure the IONOS Cloud Resource, the user can set the `spec.forProvider` fields into the specification file for the resource instance. The required fields that need to be set can be found [here](#required-properties). Following, there is a list of all the properties: * `algorithm` (string) * description: Balancing algorithm. * possible values: "ROUND\_ROBIN";"LEAST\_CONNECTION";"RANDOM";"SOURCE\_IP" * `healthCheck` (object) * description: Health check properties for target group. * properties: * `checkInterval` (integer) * description: The interval in milliseconds between consecutive health checks; default is 2000. * format: int32 * `checkTimeout` (integer) * description: The maximum time in milliseconds to wait for a target to respond to a check. For target VMs with 'Check Interval' set, the lesser of the two values is used once the TCP connection is established. * format: int32 * `retries` (integer) * description: The maximum number of attempts to reconnect to a target after a connection failure. Valid range is 0 to 65535, and default is three reconnection attempts. * format: int32 * `httpHealthCheck` (object) * description: HTTP health check properties for target group. * properties: * `matchType` (string) * description: The match type for the HTTP health check. * possible values: "";"STATUS\_CODE";"RESPONSE\_BODY" * `method` (string) * description: The method for the HTTP health check. * possible values: "HEAD";"PUT";"POST";"GET";"TRACE";"PATCH";"OPTIONS" * `negate` (boolean) * `path` (string) * description: The path (destination URL) for the HTTP health check request; the default is `/`. * `regex` (boolean) * `response` (string) * description: The response returned by the request, depending on the match type. * required properties: * `matchType` * `response` * `name` (string) * description: The name of the target group. * `protocol` (string) * description: Balancing protocol. * possible values: "HTTP" * `targets` (array) * description: Array of items in the collection. * properties: * `healthCheckEnabled` (boolean) * description: Makes the target available only if it accepts periodic health check TCP connection attempts; when turned off, the target is considered always available. The health check only consists of a connection attempt to the address and port of the target. * `ip` (string) * description: The IP of the balanced target VM. * `maintenanceEnabled` (boolean) * description: Maintenance mode prevents the target from receiving balanced traffic. * `port` (integer) * description: The port of the balanced target service; valid range is 1 to 65535. * format: int32 * `weight` (integer) * description: Traffic is distributed in proportion to target weight, relative to the combined weight of all targets. A target with higher weight receives a greater share of traffic. Valid range is 0 to 256 and default is 1; targets with weight of 0 do not participate in load balancing but still accept persistent connections. It is best use values in the middle of the range to leave room for later adjustments. * format: int32 * required properties: * `ip` * `port` * `weight` ### Required Properties The user needs to set the following properties in order to configure the IONOS Cloud Resource: * `algorithm` * `name` * `protocol` ## Resource Definition The corresponding resource definition can be found [here](https://github.com/ionos-cloud/crossplane-provider-ionoscloud/tree/master/package/crds/alb.ionoscloud.crossplane.io_targetgroups.yaml). ## Resource Instance Example An example of a resource instance can be found [here](https://github.com/ionos-cloud/crossplane-provider-ionoscloud/tree/master/examples/ionoscloud/alb/targetgroup.yaml). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ionos.com/cloud/crossplane/api/application-load-balancer/targetgroup.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.