tessl/golang-github-com-pulumi-pulumi-aws-sdk-v7

A Pulumi provider SDK for creating and managing Amazon Web Services (AWS) cloud resources in Go, providing strongly-typed resource classes and data sources for all major AWS services.

Overview

Eval results

Files

Pulumi AWS Provider - Go SDK

Name: tessl/golang-github-com-pulumi-pulumi-aws-sdk-v7
Author: tessl

The Pulumi AWS Provider (github.com/pulumi/pulumi-aws/sdk/v7) is a Go SDK for creating and managing Amazon Web Services (AWS) cloud resources using Pulumi's infrastructure-as-code framework. It provides strongly-typed resource classes and data sources for all major AWS services.

Package Information

Module: github.com/pulumi/pulumi-aws/sdk/v7
Package Type: golang
Language: Go
Installation: go get github.com/pulumi/pulumi-aws/sdk/v7
Version: 7.16.0

Quick Start

import (
    "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    "github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        bucket, err := s3.NewBucketV2(ctx, "my-bucket", &s3.BucketV2Args{
            Bucket: pulumi.String("my-unique-bucket-name"),
        })
        if err != nil {
            return err
        }

        ctx.Export("bucketName", bucket.Bucket)
        return nil
    })
}

→ Complete Quick Start Guide

Core Concepts

Resource Pattern

// Create a resource
func New<ResourceName>(ctx *pulumi.Context, name string, args *<ResourceName>Args, opts ...pulumi.ResourceOption) (*<ResourceName>, error)

// Import existing resource
func Get<ResourceName>(ctx *pulumi.Context, name string, id pulumi.IDInput, state *<ResourceName>State, opts ...pulumi.ResourceOption) (*<ResourceName>, error)

Data Source Pattern

// Synchronous lookup
func Lookup<Name>(ctx *pulumi.Context, args *Lookup<Name>Args, opts ...pulumi.InvokeOption) (*Lookup<Name>Result, error)

// Output variant (for dependencies)
func Lookup<Name>Output(ctx *pulumi.Context, args Lookup<Name>OutputArgs, opts ...pulumi.InvokeOption) Lookup<Name>ResultOutput

Type System

// Input/Output types
pulumi.String("value")        // pulumi.StringInput / pulumi.StringOutput
pulumi.StringPtr("value")     // pulumi.StringPtrInput / pulumi.StringPtrOutput
pulumi.StringArray{...}       // pulumi.StringArrayInput / pulumi.StringArrayOutput
pulumi.StringMap{...}         // pulumi.StringMapInput / pulumi.StringMapOutput

// Special types
pulumi.ID("id")               // Resource identifiers
pulumi.NewFileArchive("path") // Lambda deployments
pulumi.NewFileAsset("path")   // File uploads

Resource Options

pulumi.DependsOn([]pulumi.Resource{other})  // Explicit dependency
pulumi.Parent(parent)                        // Parent-child relationship
pulumi.Provider(customProvider)              // Custom provider
pulumi.Import(pulumi.ID("existing-id"))      // Import existing resource
pulumi.IgnoreChanges([]string{"tags"})       // Ignore field changes
pulumi.Protect(true)                         // Prevent deletion

Service Categories

Compute

EC2: Instances, VPCs, Security Groups, Networking → Reference
Lambda: Functions, Layers, Event Source Mappings → Reference
ECS: Clusters, Task Definitions, Services → Reference
EKS: Kubernetes Clusters, Node Groups → Reference
Auto Scaling: Auto Scaling Groups, Policies → Reference

Storage

S3: Buckets, Objects, Policies → Reference
EBS: Volumes, Snapshots → Reference
EFS: File Systems, Mount Targets → Reference

Database

RDS: Relational Databases, Aurora Clusters → Reference
DynamoDB: NoSQL Tables, Global Tables → Reference
ElastiCache: Redis/Memcached Clusters → Reference

Networking

Load Balancers: ALB, NLB, Classic ELB → Reference
Route 53: DNS Zones, Records → Reference

Security

IAM: Roles, Policies, Users, Groups → Reference
KMS: Encryption Keys, Grants → Reference
Secrets Manager: Secrets, Rotation → Reference

Messaging

SNS: Topics, Subscriptions → Reference
SQS: Queues, Policies → Reference
Kinesis: Streams, Analytics → Reference

Monitoring

CloudWatch: Metrics, Alarms, Logs → Reference
CloudTrail: Audit Trails → Reference

Application Services

API Gateway: REST APIs (v1), HTTP APIs (v2) → Reference
CloudFormation: Stacks, StackSets → Reference
SSM: Parameter Store, Documents → Reference

All Services

200+ AWS services available → Complete Service List

Quick Reference

Common Resource Constructors

Service	Resource	Constructor
S3	Bucket	`s3.NewBucketV2(ctx, name, args, opts)`
Lambda	Function	`lambda.NewFunction(ctx, name, args, opts)`
EC2	Instance	`ec2.NewInstance(ctx, name, args, opts)`
EC2	VPC	`ec2.NewVpc(ctx, name, args, opts)`
RDS	Database	`rds.NewInstance(ctx, name, args, opts)`
DynamoDB	Table	`dynamodb.NewTable(ctx, name, args, opts)`
IAM	Role	`iam.NewRole(ctx, name, args, opts)`
ECS	Cluster	`ecs.NewCluster(ctx, name, args, opts)`
EKS	Cluster	`eks.NewCluster(ctx, name, args, opts)`

Common Data Sources

Purpose	Function
Current account ID	`aws.GetCallerIdentity(ctx, args, opts)`
Current region	`aws.GetRegion(ctx, args, opts)`
Available AZs	`aws.GetAvailabilityZones(ctx, args, opts)`
Latest AMI	`ec2.LookupAmi(ctx, args, opts)`
Existing VPC	`ec2.LookupVpc(ctx, args, opts)`

Provider Configuration

// Default provider (uses environment variables)
bucket, err := s3.NewBucketV2(ctx, "bucket", &s3.BucketV2Args{...})

// Custom provider
provider, err := aws.NewProvider(ctx, "custom", &aws.ProviderArgs{
    Region:  pulumi.StringPtr("us-east-1"),
    Profile: pulumi.StringPtr("production"),
})
bucket, err := s3.NewBucketV2(ctx, "bucket", &s3.BucketV2Args{...}, 
    pulumi.Provider(provider))

→ Provider Configuration Reference

Common Patterns

Error Handling

resource, err := service.NewResource(ctx, "name", &service.ResourceArgs{})
if err != nil {
    return err
}

Dependencies

// Implicit (automatic)
bucket, err := s3.NewBucketV2(ctx, "bucket", &s3.BucketV2Args{})
policy, err := s3.NewBucketPolicy(ctx, "policy", &s3.BucketPolicyArgs{
    Bucket: bucket.ID(),  // Implicit dependency
})

// Explicit (manual)
resource, err := service.NewResource(ctx, "resource", &service.ResourceArgs{},
    pulumi.DependsOn([]pulumi.Resource{other}))

Output Transformations

transformedOutput := resource.Field.ApplyT(func(value string) (string, error) {
    return fmt.Sprintf("transformed-%s", value), nil
}).(pulumi.StringOutput)

Documentation Structure

Guides - Step-by-step instructions

Quick Start Guide - Get started in minutes
More guides for common workflows

Examples - Real-world scenarios

Real-World Scenarios - Production patterns
Edge Cases - Advanced scenarios and pitfalls

Reference - Detailed specifications

Provider Configuration - Authentication, regions, settings
Core Data Sources - Account, region, AZ queries

Compute

EC2 - Instances, VPCs, networking (100+ resources)
Lambda - Serverless functions, layers, triggers
ECS - Container services, task definitions
EKS - Kubernetes clusters, node groups
Auto Scaling - Auto Scaling groups, policies

Storage

S3 - Object storage, buckets, policies
EBS and EFS - Block storage, file systems

Database

RDS - Relational databases, Aurora
DynamoDB - NoSQL tables, streams
ElastiCache - Redis, Memcached, MemoryDB

Networking

Load Balancers - ALB, NLB, Classic ELB
Route 53 - DNS, hosted zones, records

Security

IAM - Roles, policies, users
KMS and Secrets Manager - Encryption, secrets

Messaging

SNS, SQS, Kinesis - Pub/sub, queues, streams

Monitoring

CloudWatch and CloudTrail - Metrics, logs, alarms

Application Services

API Gateway - REST and HTTP APIs
CloudFormation and SSM - Stacks, parameters
All AWS Services - Complete service catalog

Available Service Packages

Over 200 AWS service packages are available under github.com/pulumi/pulumi-aws/sdk/v7/go/aws/:

Category	Services
Compute	ec2, lambda, ecs, eks, autoscaling, batch, lightsail
Storage	s3, ebs, efs, glacier, storagegateway, backup
Database	rds, dynamodb, elasticache, neptune, memorydb, dax
Networking	vpc, lb, route53, cloudfront, apigateway, directconnect
Security	iam, kms, secretsmanager, guardduty, securityhub, waf
Messaging	sns, sqs, kinesis, eventbridge (cloudwatch), mq, msk
Analytics	athena, emr, glue, quicksight, opensearch, redshift
ML/AI	sagemaker, bedrock, comprehend, rekognition, transcribe
Developer Tools	codebuild, codedeploy, codecommit, codepipeline
Management	cloudformation, cloudwatch, cloudtrail, ssm, config

→ Complete Service Package List

Error Handling

All resource constructors return (resource, error):

resource, err := service.NewResource(ctx, "name", &service.ResourceArgs{})
if err != nil {
    return err  // Return from pulumi.Run callback
}

Getting Help

Documentation Navigation

New to Pulumi AWS? → Start with Quick Start Guide
Need examples? → See Real-World Scenarios
Hitting edge cases? → Check Edge Cases & Troubleshooting
Need API details? → Browse Reference Documentation

Common Tasks Quick Links

Task	Documentation
Configure AWS credentials	Provider Reference
Create VPC with subnets	EC2 Reference
Deploy Lambda function	Lambda Reference
Set up S3 bucket	S3 Reference
Create RDS database	RDS Reference
Configure IAM roles	IAM Reference
Deploy container service	ECS Reference
Set up Kubernetes cluster	EKS Reference
Create API Gateway	API Gateway Reference
Query account/region info	Core Data Sources

Architecture Overview

┌─────────────────────────────────────────────────────────┐
│ Pulumi AWS Provider                                     │
│                                                         │
│  Provider Config ──→ Resources ──→ AWS Cloud           │
│       ↓                   ↓                             │
│  Authentication      Dependencies                       │
│  Region              Outputs                            │
│  Tags                                                   │
└─────────────────────────────────────────────────────────┘

Provider: Configures authentication, region, and defaults
Resources: Managed AWS infrastructure (create, update, delete)
Data Sources: Read-only queries of existing resources
Outputs: Async values enabling cross-resource dependencies

Integration Patterns

Lambda + API Gateway

Deploy serverless API → Example

S3 + CloudFront + Route53

Deploy static website with CDN → Example

ECS + ALB

Deploy containerized application → Example

VPC + Subnets + NAT

Create network infrastructure → Example

Next Steps

Start Building: Quick Start Guide
Learn Patterns: Real-World Scenarios
Handle Edge Cases: Edge Cases Guide
Explore APIs: Browse Reference Documentation

Key Features

200+ AWS Services: Comprehensive coverage of AWS
Strongly Typed: Go type safety for all resources
Automatic Dependencies: Output-based dependency tracking
Multi-Region: Deploy across multiple AWS regions
Cross-Account: Manage resources in multiple accounts
State Management: Automatic state tracking and drift detection
Preview Mode: See changes before applying
Rollback Support: Automatic rollback on errors

Additional Resources

Pulumi Docs: https://www.pulumi.com/docs/
AWS Provider Registry: https://www.pulumi.com/registry/packages/aws/
GitHub Repository: https://github.com/pulumi/pulumi-aws
API Documentation: https://pkg.go.dev/github.com/pulumi/pulumi-aws/sdk/v7

For detailed API specifications, comprehensive examples, and advanced patterns, explore the Reference Documentation.

Install with Tessl CLI

npx tessl i tessl/golang-github-com-pulumi-pulumi-aws-sdk-v7

Workspace: tessl
Visibility: Public
Created: about 2 hours ago
Last updated: about 2 hours ago
Describes: pkg:golang/github.com/pulumi/pulumi-aws/sdk/v7@v7.16.0