VPCLattice / Client / list_target_groups

list_target_groups#

VPCLattice.Client.list_target_groups(**kwargs)#

Lists your target groups. You can narrow your search by using the filters below in your request.

See also: AWS API Documentation

Request Syntax

response = client.list_target_groups(
    maxResults=123,
    nextToken='string',
    targetGroupType='IP'|'LAMBDA'|'INSTANCE'|'ALB',
    vpcIdentifier='string'
)
Parameters:

  • maxResults (integer) – The maximum number of results to return.

  • nextToken (string) – A pagination token for the next page of results.

  • targetGroupType (string) – The target group type.

  • vpcIdentifier (string) – The ID or Amazon Resource Name (ARN) of the VPC.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'id': 'string',
            'ipAddressType': 'IPV4'|'IPV6',
            'lambdaEventStructureVersion': 'V1'|'V2',
            'lastUpdatedAt': datetime(2015, 1, 1),
            'name': 'string',
            'port': 123,
            'protocol': 'HTTP'|'HTTPS'|'TCP',
            'serviceArns': [
                'string',
            ],
            'status': 'CREATE_IN_PROGRESS'|'ACTIVE'|'DELETE_IN_PROGRESS'|'CREATE_FAILED'|'DELETE_FAILED',
            'type': 'IP'|'LAMBDA'|'INSTANCE'|'ALB',
            'vpcIdentifier': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • items (list) –

      Information about the target groups.

      • (dict) –

        Summary information about a target group.

        For more information, see Target groups in the Amazon VPC Lattice User Guide.

        • arn (string) –

          The ARN (Amazon Resource Name) of the target group.

        • createdAt (datetime) –

          The date and time that the target group was created, specified in ISO-8601 format.

        • id (string) –

          The ID of the target group.

        • ipAddressType (string) –

          The type of IP address used for the target group. The possible values are IPV4 and IPV6. This is an optional parameter. If not specified, the default is IPV4.

        • lambdaEventStructureVersion (string) –

          The version of the event structure that your Lambda function receives. Supported only if the target group type is LAMBDA.

        • lastUpdatedAt (datetime) –

          The date and time that the target group was last updated, specified in ISO-8601 format.

        • name (string) –

          The name of the target group.

        • port (integer) –

          The port of the target group.

        • protocol (string) –

          The protocol of the target group.

        • serviceArns (list) –

          The Amazon Resource Names (ARNs) of the service.

          • (string) –

        • status (string) –

          The status.

        • type (string) –

          The target group type.

        • vpcIdentifier (string) –

          The ID of the VPC of the target group.

    • nextToken (string) –

      If there are additional results, a pagination token for the next page of results.

Exceptions