---
id: aws-cdk-aws-globalaccelerator
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-globalaccelerator — The CDK Construct Library for AWS::GlobalAccelerator

License: permissive · Maintenance: active · Downloads: 132.5K/mo

## What it is and what it does

This package provides AWS CDK constructs for defining Global Accelerator infrastructure as code in Python. Global Accelerator is an AWS service that improves application availability and performance by intercepting user connections at edge locations and routing them to redundant backends across AWS's global network. The construct library abstracts the underlying CloudFormation resources, allowing you to define accelerators, listeners, endpoint groups, and various endpoint types (Application Load Balancers, Network Load Balancers, EC2 instances, Elastic IPs) through Python code.

The package depends on core CDK libraries (aws-cdk.core, aws-cdk.aws-ec2, aws-cdk.custom-resources) and related utilities (constructs, jsii, typeguard, publication). It supports Python 3.7 through 3.11. However, AWS CDK v1 reached end-of-support on 2023-06-01, meaning this package is no longer receiving updates; users should migrate to AWS CDK v2 for ongoing support and new features.

Use it for:

- Define multi-region traffic routing infrastructure using Global Accelerator with Application or Network Load Balancers in different AWS regions.
- Route user traffic to geographically distributed EC2 instances or Elastic IP addresses with automatic failover and performance optimization.
- Set up endpoint groups with custom weights and client IP preservation for advanced traffic management across regions.
- Reference and configure security groups created by Global Accelerator for fine-grained access control to backend resources.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides AWS CDK constructs to define and manage AWS Global Accelerator resources, including accelerators, listeners, and endpoint groups for routing traffic across regions.

Yes, if you are actively maintaining an AWS CDK v1 codebase that requires Global Accelerator constructs. However, plan a migration to AWS CDK v2 soon—this package is no longer updated as of 2023-06-01 and v1 has reached end-of-support. For new projects, use the v2 equivalent instead. Install friction is low and the license is permissive.

## Install

pip install aws-cdk-aws-globalaccelerator
uv add aws-cdk-aws-globalaccelerator
poetry add aws-cdk-aws-globalaccelerator

## Installing aws-cdk.aws-globalaccelerator

Before you install: Low install friction with a wheel distribution. The package is in active maintenance status but reached end-of-support on 2023-06-01; AWS CDK v1 users should plan migration to v2, as this package is no longer being updated.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install aws-cdk.aws-globalaccelerator

from aws_cdk import aws_globalaccelerator as globalaccelerator
from aws_cdk import core

class MyStack(core.Stack):
    def __init__(self, scope: core.Construct, id: str, **kwargs):
        super().__init__(scope, id, **kwargs)
        accelerator = globalaccelerator.Accelerator(self, "Accelerator")
        listener = accelerator.add_listener("Listener",
            port_ranges=[globalaccelerator.PortRange(from_port=80)]
        )

AWS CDK v1 reached end-of-support on 2023-06-01; this package is no longer updated and migration to AWS CDK v2 is recommended.

Verify before relying:

- Whether existing v1 deployments remain functional despite end-of-support status
- Specific migration path complexity from v1 to v2 for Global Accelerator constructs

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 132.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws global accelerator cdk, cdk global accelerator constructs, aws traffic routing infrastructure, multi-region load balancing cdk, global accelerator endpoints, cdk edge location routing, aws accelerator listener groups, aws-cdk, infrastructure-as-code, deprecated-v1

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-globalaccelerator) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-globalaccelerator/)