---
title: "GET /targetgroups/{targetGroupIdentifier}"
method: GET
path: "/targetgroups/{targetGroupIdentifier}"
---

# GET /targetgroups/{targetGroupIdentifier}

`GET /targetgroups/{targetGroupIdentifier}`

Retrieves information about the specified target group.

## Path parameters

- `targetGroupIdentifier` string, required

## Response `200`

Success

- GetTargetGroupResponse
  - `id` string — The ID of the target group.
  - `arn` string — The Amazon Resource Name (ARN) of the target group.
  - `name` string — The name of the target group.
  - `type` 'IP' | 'LAMBDA' | 'INSTANCE' | 'ALB' — The target group type.
  - `config` object — The target group configuration.
    - `port` integer — The port on which the targets are listening. For HTTP, the default is 80. For HTTPS, the default is 443. Not supported if the target group type is <code>LAMBDA</code>.
    - `protocol` 'HTTP' | 'HTTPS' | 'TCP' — The protocol to use for routing traffic to the targets. The default is the protocol of the target group. Not supported if the target group type is <code>LAMBDA</code>.
    - `protocolVersion` 'HTTP1' | 'HTTP2' | 'GRPC' — The protocol version. The default is <code>HTTP1</code>. Not supported if the target group type is <code>LAMBDA</code>.
    - `ipAddressType` 'IPV4' | 'IPV6' — The type of IP address used for the target group. Supported only if the target group type is <code>IP</code>. The default is <code>IPV4</code>.
    - `vpcIdentifier` string — The ID of the VPC. Not supported if the target group type is <code>LAMBDA</code>.
    - `healthCheck` object — The health check configuration. Not supported if the target group type is <code>LAMBDA</code> or <code>ALB</code>.
      - `enabled` boolean — Indicates whether health checking is enabled.
      - `protocol` 'HTTP' | 'HTTPS' | 'TCP' — The protocol used when performing health checks on targets. The possible protocols are <code>HTTP</code> and <code>HTTPS</code>. The default is <code>HTTP</code>.
      - `protocolVersion` 'HTTP1' | 'HTTP2' — The protocol version used when performing health checks on targets. The possible protocol versions are <code>HTTP1</code> and <code>HTTP2</code>.
      - `port` integer — The port used when performing health checks on targets. The default setting is the port that a target receives traffic on.
      - `path` string — The destination for health checks on the targets. If the protocol version is <code>HTTP/1.1</code> or <code>HTTP/2</code>, specify a valid URI (for example, <code>/path?query</code>). The default path is <code>/</code>. Health checks are not supported if the protocol version is <code>gRPC</code>, however, you can choose <code>HTTP/1.1</code> or <code>HTTP/2</code> and specify a valid URI.
      - `healthCheckIntervalSeconds` integer — The approximate amount of time, in seconds, between health checks of an individual target. The range is 5–300 seconds. The default is 30 seconds.
      - `healthCheckTimeoutSeconds` integer — The amount of time, in seconds, to wait before reporting a target as unhealthy. The range is 1–120 seconds. The default is 5 seconds.
      - `healthyThresholdCount` integer — The number of consecutive successful health checks required before considering an unhealthy target healthy. The range is 2–10. The default is 5.
      - `unhealthyThresholdCount` integer — The number of consecutive failed health checks required before considering a target unhealthy. The range is 2–10. The default is 2.
      - `matcher` object — The codes to use when checking for a successful response from a target.
        - `httpCode` string — The HTTP code to use when checking for a successful response from a target.
    - `lambdaEventStructureVersion` 'V1' | 'V2' — The version of the event structure that your Lambda function receives. Supported only if the target group type is <code>LAMBDA</code>. The default is <code>V1</code>.
  - `createdAt` string, date-time — The date and time that the target group was created, in ISO-8601 format.
  - `lastUpdatedAt` string, date-time — The date and time that the target group was last updated, in ISO-8601 format.
  - `status` 'CREATE_IN_PROGRESS' | 'ACTIVE' | 'DELETE_IN_PROGRESS' | 'CREATE_FAILED' | 'DELETE_FAILED' — The status.
  - `serviceArns` ServiceArn[] — The Amazon Resource Names (ARNs) of the service.
  - `failureMessage` string — The failure message.
  - `failureCode` string — The failure code.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/vpc-lattice.md) · [All operations](https://skmtc.net/aws/apis/vpc-lattice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/vpc-lattice/versions/bbec5439e0f7/schema)