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

• VPCLattice.Client.exceptions.ValidationException

• VPCLattice.Client.exceptions.AccessDeniedException

• VPCLattice.Client.exceptions.ThrottlingException

• VPCLattice.Client.exceptions.InternalServerException