amazonka-gamelift-2.0: Amazon GameLift SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.GameLift.CreateVpcPeeringConnection

Description

Establishes a VPC peering connection between a virtual private cloud (VPC) in an Amazon Web Services account with the VPC for your Amazon GameLift fleet. VPC peering enables the game servers on your fleet to communicate directly with other Amazon Web Services resources. You can peer with VPCs in any Amazon Web Services account that you have access to, including the account that you use to manage your Amazon GameLift fleets. You cannot peer with VPCs that are in different Regions. For more information, see VPC Peering with Amazon GameLift Fleets.

Before calling this operation to establish the peering connection, you first need to use CreateVpcPeeringAuthorization and identify the VPC you want to peer with. Once the authorization for the specified VPC is issued, you have 24 hours to establish the connection. These two operations handle all tasks necessary to peer the two VPCs, including acceptance, updating routing tables, etc.

To establish the connection, call this operation from the Amazon Web Services account that is used to manage the Amazon GameLift fleets. Identify the following values: (1) The ID of the fleet you want to be enable a VPC peering connection for; (2) The Amazon Web Services account with the VPC that you want to peer with; and (3) The ID of the VPC you want to peer with. This operation is asynchronous. If successful, a connection request is created. You can use continuous polling to track the request's status using DescribeVpcPeeringConnections , or by monitoring fleet events for success or failure using DescribeFleetEvents .

Related actions

All APIs by task

Synopsis

Creating a Request

data CreateVpcPeeringConnection Source #

See: newCreateVpcPeeringConnection smart constructor.

Constructors

CreateVpcPeeringConnection' 

Fields

  • fleetId :: Text

    A unique identifier for the fleet. You can use either the fleet ID or ARN value. This tells Amazon GameLift which GameLift VPC to peer with.

  • peerVpcAwsAccountId :: Text

    A unique identifier for the Amazon Web Services account with the VPC that you want to peer your Amazon GameLift fleet with. You can find your Account ID in the Amazon Web Services Management Console under account settings.

  • peerVpcId :: Text

    A unique identifier for a VPC with resources to be accessed by your 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 GameLift Fleets.

Instances

Instances details
ToJSON CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

ToHeaders CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

ToPath CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

ToQuery CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

AWSRequest CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Generic CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Associated Types

type Rep CreateVpcPeeringConnection :: Type -> Type #

Read CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Show CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

NFData CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Eq CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Hashable CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

type AWSResponse CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

type Rep CreateVpcPeeringConnection Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

type Rep CreateVpcPeeringConnection = D1 ('MetaData "CreateVpcPeeringConnection" "Amazonka.GameLift.CreateVpcPeeringConnection" "amazonka-gamelift-2.0-IjhNQby9jLV6gj30IrgsyK" 'False) (C1 ('MetaCons "CreateVpcPeeringConnection'" 'PrefixI 'True) (S1 ('MetaSel ('Just "fleetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "peerVpcAwsAccountId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "peerVpcId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newCreateVpcPeeringConnection Source #

Create a value of CreateVpcPeeringConnection with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

CreateVpcPeeringConnection, createVpcPeeringConnection_fleetId - A unique identifier for the fleet. You can use either the fleet ID or ARN value. This tells Amazon GameLift which GameLift VPC to peer with.

CreateVpcPeeringConnection, createVpcPeeringConnection_peerVpcAwsAccountId - A unique identifier for the Amazon Web Services account with the VPC that you want to peer your Amazon GameLift fleet with. You can find your Account ID in the Amazon Web Services Management Console under account settings.

CreateVpcPeeringConnection, createVpcPeeringConnection_peerVpcId - A unique identifier for a VPC with resources to be accessed by your 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 GameLift Fleets.

Request Lenses

createVpcPeeringConnection_fleetId :: Lens' CreateVpcPeeringConnection Text Source #

A unique identifier for the fleet. You can use either the fleet ID or ARN value. This tells Amazon GameLift which GameLift VPC to peer with.

createVpcPeeringConnection_peerVpcAwsAccountId :: Lens' CreateVpcPeeringConnection Text Source #

A unique identifier for the Amazon Web Services account with the VPC that you want to peer your Amazon GameLift fleet with. You can find your Account ID in the Amazon Web Services Management Console under account settings.

createVpcPeeringConnection_peerVpcId :: Lens' CreateVpcPeeringConnection Text Source #

A unique identifier for a VPC with resources to be accessed by your 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 GameLift Fleets.

Destructuring the Response

data CreateVpcPeeringConnectionResponse Source #

Constructors

CreateVpcPeeringConnectionResponse' 

Fields

Instances

Instances details
Generic CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Associated Types

type Rep CreateVpcPeeringConnectionResponse :: Type -> Type #

Read CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Show CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

NFData CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

Eq CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

type Rep CreateVpcPeeringConnectionResponse Source # 
Instance details

Defined in Amazonka.GameLift.CreateVpcPeeringConnection

type Rep CreateVpcPeeringConnectionResponse = D1 ('MetaData "CreateVpcPeeringConnectionResponse" "Amazonka.GameLift.CreateVpcPeeringConnection" "amazonka-gamelift-2.0-IjhNQby9jLV6gj30IrgsyK" 'False) (C1 ('MetaCons "CreateVpcPeeringConnectionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateVpcPeeringConnectionResponse Source #

Create a value of CreateVpcPeeringConnectionResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:httpStatus:CreateVpcPeeringConnectionResponse', createVpcPeeringConnectionResponse_httpStatus - The response's http status code.

Response Lenses