I want to use the Pulumi AWS package (aws) in my project.
## Provider details
- Package: aws
- Version: v7.30.0
- Publisher: Pulumi
- Source: pulumi
- Repository: https://github.com/pulumi/pulumi-aws
## 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/aws/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/aws/versions/latest/readme
- Installation and configuration: https://api.pulumi.com/api/registry/packages/pulumi/pulumi/aws/versions/latest/installation
- Per-resource/function docs: https://api.pulumi.com/api/registry/packages/pulumi/pulumi/aws/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.
Note: some values in this example will be different from run to run. These values are indicated
with ***.
Create a new stack:
$ pulumi stack init website-testing
Set the AWS region:
$ pulumi config set aws:region us-west-2
Restore NPM modules via npm install or yarn install.
Run pulumi up to preview and deploy changes. After the preview is shown you will be
prompted if you want to continue or not.
$ pulumi up
Previewing update of stack 'website-testing'Previewing changes:
...
Updating stack 'website-testing'Performing changes:
Type Name Status Info
+ pulumi:pulumi:Stack aws-js-s3-folder-website-testing created
+ ├─ aws:s3:Bucket s3-website-bucket created
+ ├─ aws:s3:BucketPolicy bucketPolicy created
+ ├─ aws:s3:BucketObject favicon.png created
+ └─ aws:s3:BucketObject index.html created
info: 5 changes performed:
+ 5 resources created
Update duration: ***
Permalink: https://app.pulumi.com/***
To see the resources that were created, run pulumi stack output:
$ pulumi stack output
Current stack outputs (2):
OUTPUT VALUE
bucketName s3-website-bucket-***
websiteUrl ***.s3-website-us-west-2.amazonaws.com
To see that the S3 objects exist, you can either use the AWS Console or the AWS CLI: