GameLift / Client / describe_vpc_peering_connections



Retrieves information on VPC peering connections. Use this operation to get peering information for all fleets or for one specific fleet ID.

To retrieve connection information, call this operation from the Amazon Web Services account that is used to manage the Amazon GameLift fleets. Specify a fleet ID or leave the parameter empty to retrieve all connection records. If successful, the retrieved information includes both active and pending connections. Active connections identify the IpV4 CIDR block that the VPC uses to connect.

Related actions

All APIs by task

See also: AWS API Documentation

Request Syntax

response = client.describe_vpc_peering_connections(

FleetId (string) – A unique identifier for the fleet. You can use either the fleet ID or ARN value.

Return type:



Response Syntax

    'VpcPeeringConnections': [
            'FleetId': 'string',
            'FleetArn': 'string',
            'IpV4CidrBlock': 'string',
            'VpcPeeringConnectionId': 'string',
            'Status': {
                'Code': 'string',
                'Message': 'string'
            'PeerVpcId': 'string',
            'GameLiftVpcId': 'string'

Response Structure

  • (dict) –

    • VpcPeeringConnections (list) –

      A collection of VPC peering connection records that match the request.

      • (dict) –

        Represents a peering connection between a VPC on one of your Amazon Web Services accounts and the VPC for your Amazon GameLift fleets. This record may be for an active peering connection or a pending connection that has not yet been established.

        Related actions

        All APIs by task

        • FleetId (string) –

          A unique identifier for the fleet. This ID determines the ID of the Amazon GameLift VPC for your fleet.

        • FleetArn (string) –

          The Amazon Resource Name ( ARN) associated with the GameLift fleet resource for this connection.

        • IpV4CidrBlock (string) –

          CIDR block of IPv4 addresses assigned to the VPC peering connection for the GameLift VPC. The peered VPC also has an IPv4 CIDR block associated with it; these blocks cannot overlap or the peering connection cannot be created.

        • VpcPeeringConnectionId (string) –

          A unique identifier that is automatically assigned to the connection record. This ID is referenced in VPC peering connection events, and is used when deleting a connection.

        • Status (dict) –

          The status information about the connection. Status indicates if a connection is pending, successful, or failed.

          • Code (string) –

            Code indicating the status of a VPC peering connection.

          • Message (string) –

            Additional messaging associated with the connection status.

        • PeerVpcId (string) –

          A unique identifier for a VPC with resources to be accessed by your Amazon GameLift fleet. The VPC must be in the same Region as your fleet. To look up a VPC ID, use the VPC Dashboard in the Amazon Web Services Management Console. Learn more about VPC peering in VPC Peering with Amazon GameLift Fleets.

        • GameLiftVpcId (string) –

          A unique identifier for the VPC that contains the Amazon GameLift fleet for this connection. This VPC is managed by Amazon GameLift and does not appear in your Amazon Web Services account.


  • GameLift.Client.exceptions.UnauthorizedException

  • GameLift.Client.exceptions.InvalidRequestException

  • GameLift.Client.exceptions.NotFoundException

  • GameLift.Client.exceptions.InternalServiceException