Viewing docs for AWSx (Pulumi Crosswalk for AWS) v3.5.0
published on Tuesday, Apr 14, 2026 by Pulumi
published on Tuesday, Apr 14, 2026 by Pulumi
AWSx (Pulumi AWS Components)
I want to use the Pulumi AWSx (Pulumi Crosswalk for AWS) package (awsx) in my project.
## Provider details
- Package: awsx
- Version: v3.5.0
- Publisher: Pulumi
- Source: pulumi
- Repository: https://github.com/pulumi/pulumi-awsx
## Documentation
The Pulumi Cloud Registry API serves canonical, up-to-date docs for this package — including private packages and every published version. Send the "Accept: text/markdown" header for clean readable content, or "application/json" for structured data.
Start at the navigation tree, which cross-links to the readme, installation guide, and per-resource docs URL template:
- https://api.pulumi.com/api/registry/packages/pulumi/pulumi/awsx/versions/latest/nav
Returns a summary by default. The full tree can be hundreds of kB for large providers, so prefer targeted search: append "?q=<query>&depth=full" to filter by resource/function title or token (for example "?q=bucket&depth=full"). Only request the full nav without a query if you actually need to enumerate every resource.
Other endpoints:
- Overview and getting started: https://api.pulumi.com/api/registry/packages/pulumi/pulumi/awsx/versions/latest/readme
- Installation and configuration: https://api.pulumi.com/api/registry/packages/pulumi/pulumi/awsx/versions/latest/installation
- Per-resource/function docs: https://api.pulumi.com/api/registry/packages/pulumi/pulumi/awsx/versions/latest/docs/{token}?lang={lang}
Replace {token} with the percent-encoded token from the nav response (for example aws:s3/bucket:Bucket).
Replace {lang} with typescript, python, go, csharp, java, or yaml.
Fetch the installation endpoint above for the correct setup steps — install instructions vary between native providers, bridged Terraform providers, and component packages.
Help me get started using this provider. Show me a complete Pulumi program that provisions a common resource, including all necessary configuration and imports.
Viewing docs for AWSx (Pulumi Crosswalk for AWS) v3.5.0
published on Tuesday, Apr 14, 2026 by Pulumi
published on Tuesday, Apr 14, 2026 by Pulumi
The Amazon Web Services (AWS) AWSx library uses automatic well-architected best practices to make common infrastructure-as-code tasks in AWS easier and more secure. It uses the AWS SDK to manage and provision resources.
The AWSx provider must be configured with credentials to deploy and update resources in AWS; see Installation & Configuration for instructions.
New to Pulumi and AWS? Get started with AWS using our AWSx tutorial.
Example
import * as awsx from "@pulumi/awsx";
// Allocate a new VPC with the default settings:
const vpc = new awsx.ec2.Vpc("custom");
// Export a few resulting fields to make them easy to use:
export const vpcId = vpc.vpcId;
export const privateSubnetIds = vpc.privateSubnetIds;
export const publicSubnetIds = vpc.publicSubnetIds;
import pulumi
import pulumi_awsx as awsx
vpc = awsx.ec2.Vpc("custom")
pulumi.export("vpcId", vpc.vpc_id)
pulumi.export("publicSubnetIds", vpc.public_subnet_ids)
pulumi.export("privateSubnetIds", vpc.private_subnet_ids)
package main
import (
"github.com/pulumi/pulumi-awsx/sdk/go/awsx/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
vpc, err := ec2.NewVpc(ctx, "my-vpc", nil)
if err != nil {
return err
}
ctx.Export("vpcId", vpc.VpcId)
ctx.Export("privateSubnetIds", vpc.PrivateSubnetIds)
ctx.Export("publicSubnetIds", vpc.PublicSubnetIds)
return nil
})
}
using Pulumi;
using Ec2 = Pulumi.Awsx.Ec2;
class MyStack : Stack
{
public MyStack()
{
var vpc = new Ec2.Vpc("custom");
this.VpcId = vpc.VpcId;
}
[Output] public Output<string> VpcId { get; set; }
}
class Program
{
static Task<int> Main(string[] args) => Deployment.RunAsync<MyStack>();
}
package myproject;
import com.pulumi.Pulumi;
import com.pulumi.awsx.ec2.Vpc;
public class App {
public static void main(String[] args) {
Pulumi.run(ctx -> {
var vpc = new Vpc("custom");
ctx.export("vpcId", vpc.vpcId());
ctx.export("privateSubnetIds", vpc.privateSubnetIds());
ctx.export("publicSubnetIds", vpc.publicSubnetIds());
});
}
}
name: awsx-networking-yaml
runtime: yaml
description: A minimal AWS Pulumi YAML program
resources:
# Allocate a new VPC with the default settings:
vpc:
type: awsx:ec2:Vpc
outputs:
vpcId: ${vpc.vpcId}
privateSubnetIds: ${vpc.privateSubnetIds}
publicSubnetIds: ${vpc.publicSubnetIds}
Viewing docs for AWSx (Pulumi Crosswalk for AWS) v3.5.0
published on Tuesday, Apr 14, 2026 by Pulumi
published on Tuesday, Apr 14, 2026 by Pulumi