Skip to content
Docs
Modules
aws

aws

ℹ️

This module requires that Risor has been compiled with the aws Go build tag. When compiling manually, make sure you specify -tags aws (opens in a new tab).

The aws module exposes a simple interface that wraps the AWS SDK v2 for Go. Create a client by providing the name of the service you want to use. All API calls for that service are then made available on the client.

Speciying a config is optional, but can be used to configure the client.

Functions

client

Function signature
client(service string, config map | aws.config) aws.client

Creates a new AWS client for the given service. The config parameter is optional and can be used to configure the client. All service API calls are made available on the client.

Example
>>> aws.client("s3")
aws.client(service=s3, region=us-east-1)
>>> aws.client("ec2")
aws.client(service=ec2, region=us-east-1)
>>> aws.client("ec2", {region: "us-west-2"})
aws.client(service=ec2, region=us-west-2)

config

Function signature
config(config map) aws.config

Creates a new AWS config with the given configuration map.

Example
>>> aws.config({region: "us-east-2"})
aws.config(region=us-east-2)

Available configuration options:

{
  "region": "us-east-1",
  "credentials": {
    "key": "AKID",
    "secret": "SECRET",
    "session": "SESSION_TOKEN"
  },
  "profile": "custom_profile",
  "credentials_files": ["test/credentials"],
  "config_files": ["test/config"]
}

S3 Client Usage

>>> s3 := aws.client("s3")
>>> s3.list_buckets()["Buckets"]
[{"CreationDate "2023-07-26T01:16:19Z", "Name "example-12345"}]
>>> s3.create_bucket({Bucket: 'test-{rand.int()}'})
{"Location": "/test-2769212968479898940", "ResultMetadata": {}}

Services

Support for these services is built into the Risor CLI:

  • apigatewayv2
  • athena
  • backup
  • cloudformation
  • cloudfront
  • cloudtrail
  • cloudwatch
  • cloudwatchlogs
  • ddb
  • ebs
  • ec2
  • ecr
  • ecs
  • eks
  • elasticache
  • elasticsearchse
  • eventbridge
  • firehose
  • glue
  • iam
  • kinesis
  • kms
  • lambda
  • ram
  • rds
  • redshift
  • route53
  • s3
  • secretsmanager
  • sesv2
  • sfn
  • sns
  • sqs
  • sts
  • wafv2
  • xray
Builtinsbase64