create_transit_gateway ¶

def create_transit_gateway(
    self,
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    description: Optional["capo_ec2.types.string.String"] = None,
    options: Optional[
        "capo_ec2.types.transit_gateway_request_options.TransitGatewayRequestOptions"
    ] = None,
    tag_specifications: Optional[
        "capo_ec2.types.tag_specification_list.TagSpecificationList"
    ] = None,
    dry_run: Optional["capo_ec2.types.boolean.Boolean"] = None,
) -> "capo_ec2.types.create_transit_gateway_result.CreateTransitGatewayResult":
    """<p>Creates a transit gateway.</p> <p>You can use a transit gateway to interconnect your virtual private clouds (VPC) and on-premises networks. After the transit gateway enters the <code>available</code> state, you can attach your VPCs and VPN connections to the transit gateway.</p> <p>To attach your VPCs, use <a>CreateTransitGatewayVpcAttachment</a>.</p> <p>To attach a VPN connection, use <a>CreateCustomerGateway</a> to create a customer gateway and specify the ID of the customer gateway and the ID of the transit gateway in a call to <a>CreateVpnConnection</a>.</p> <p>When you create a transit gateway, we create a default transit gateway route table and use it as the default association route table and the default propagation route table. You can use <a>CreateTransitGatewayRouteTable</a> to create additional transit gateway route tables. If you disable automatic route propagation, we do not create a default transit gateway route table. You can use <a>EnableTransitGatewayRouteTablePropagation</a> to propagate routes from a resource attachment to a transit gateway route table. If you disable automatic associations, you can use <a>AssociateTransitGatewayRouteTable</a> to associate a resource attachment with a transit gateway route table.</p>

    Args:
        description: <p>A description of the transit gateway.</p>
        options: <p>The transit gateway options.</p>
        tag_specifications: <p>The tags to apply to the transit gateway.</p>
        dry_run: <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>

    Raises:
        capo_ec2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_ec2.types.create_transit_gateway_request.CreateTransitGatewayRequest]",
    ) -> OperationResponse[
        "capo_ec2.types.create_transit_gateway_result.CreateTransitGatewayResult"
    ]:
        import capo_ec2._operations.amazon_ec2.create_transit_gateway

        output, http_response = (
            capo_ec2._operations.amazon_ec2.create_transit_gateway.create_transit_gateway(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateTransitGateway")
    )
    input_: capo_ec2.types.create_transit_gateway_request.CreateTransitGatewayRequest = {}
    if description is not None:
        input_["description"] = description
    if options is not None:
        input_["options"] = options
    if tag_specifications is not None:
        input_["tag_specifications"] = tag_specifications
    if dry_run is not None:
        input_["dry_run"] = dry_run

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output