aws

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 11, 2026 License: Apache-2.0 Imports: 64 Imported by: 135

Documentation

Overview

Package aws allows to interact with resources on Amazon Web Services.

Index

Constants

View Source
const (
	// CanonicalAccountID is the AWS account ID for Canonical (Ubuntu).
	CanonicalAccountID = "099720109477"
	// CentOsAccountID is the AWS account ID for CentOS.
	CentOsAccountID = "679593333241"
	// AmazonAccountID is the AWS account ID (or alias) for Amazon.
	AmazonAccountID = "amazon"

	// Deprecated: Use [CanonicalAccountID] instead.
	CanonicalAccountId = CanonicalAccountID //nolint:staticcheck,revive // preserving deprecated constant name
	// Deprecated: Use [CentOsAccountID] instead.
	CentOsAccountId = CentOsAccountID //nolint:staticcheck,revive // preserving deprecated constant name
	// Deprecated: Use [AmazonAccountID] instead.
	AmazonAccountId = AmazonAccountID //nolint:staticcheck,revive // preserving deprecated constant name
)

These are commonly used AMI account IDs.

View Source
const (
	// AuthAssumeRoleEnvVar is the OS environment variable name through which an
	// Assume Role ARN may be passed for authentication.
	AuthAssumeRoleEnvVar = "TERRATEST_IAM_ROLE"
)

Variables

This section is empty.

Functions

func AddTagsToResource deprecated added in v0.9.11

func AddTagsToResource(t testing.TestingT, region string, resource string, tags map[string]string)

AddTagsToResource adds the tags to the given taggable AWS resource such as EC2, AMI or VPC.

Deprecated: Use AddTagsToResourceContext instead.

func AddTagsToResourceContext added in v1.0.0

func AddTagsToResourceContext(t testing.TestingT, ctx context.Context, region string, resource string, tags map[string]string)

AddTagsToResourceContext adds the tags to the given taggable AWS resource such as EC2, AMI or VPC. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func AddTagsToResourceContextE added in v1.0.0

func AddTagsToResourceContextE(t testing.TestingT, ctx context.Context, region string, resource string, tags map[string]string) error

AddTagsToResourceContextE adds the tags to the given taggable AWS resource such as EC2, AMI or VPC. The ctx parameter supports cancellation and timeouts.

func AddTagsToResourceE deprecated added in v0.9.11

func AddTagsToResourceE(t testing.TestingT, region string, resource string, tags map[string]string) error

AddTagsToResourceE adds the tags to the given taggable AWS resource such as EC2, AMI or VPC.

Deprecated: Use AddTagsToResourceContextE instead.

func AssertS3BucketExists deprecated

func AssertS3BucketExists(t testing.TestingT, region string, name string)

AssertS3BucketExists checks if the given S3 bucket exists in the given region and fail the test if it does not.

Deprecated: Use AssertS3BucketExistsContext instead.

func AssertS3BucketExistsContext added in v1.0.0

func AssertS3BucketExistsContext(t testing.TestingT, ctx context.Context, region string, name string)

AssertS3BucketExistsContext checks if the given S3 bucket exists in the given region and fail the test if it does not. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketExistsContextE added in v1.0.0

func AssertS3BucketExistsContextE(t testing.TestingT, ctx context.Context, region string, name string) error

AssertS3BucketExistsContextE checks if the given S3 bucket exists in the given region and return an error if it does not. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketExistsE deprecated

func AssertS3BucketExistsE(t testing.TestingT, region string, name string) error

AssertS3BucketExistsE checks if the given S3 bucket exists in the given region and return an error if it does not.

Deprecated: Use AssertS3BucketExistsContextE instead.

func AssertS3BucketPolicyExists deprecated added in v0.15.5

func AssertS3BucketPolicyExists(t testing.TestingT, region string, bucketName string)

AssertS3BucketPolicyExists checks if the given S3 bucket has a resource policy attached and returns an error if it does not

Deprecated: Use AssertS3BucketPolicyExistsContext instead.

func AssertS3BucketPolicyExistsContext added in v1.0.0

func AssertS3BucketPolicyExistsContext(t testing.TestingT, ctx context.Context, region string, bucketName string)

AssertS3BucketPolicyExistsContext checks if the given S3 bucket has a resource policy attached and fails the test if it does not. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketPolicyExistsContextE added in v1.0.0

func AssertS3BucketPolicyExistsContextE(t testing.TestingT, ctx context.Context, region string, bucketName string) error

AssertS3BucketPolicyExistsContextE checks if the given S3 bucket has a resource policy attached and returns an error if it does not. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketPolicyExistsE deprecated added in v0.15.5

func AssertS3BucketPolicyExistsE(t testing.TestingT, region string, bucketName string) error

AssertS3BucketPolicyExistsE checks if the given S3 bucket has a resource policy attached and returns an error if it does not

Deprecated: Use AssertS3BucketPolicyExistsContextE instead.

func AssertS3BucketServerSideEncryption deprecated added in v1.0.0

func AssertS3BucketServerSideEncryption(t testing.TestingT, region string, bucketName string, algorithm types.ServerSideEncryption)

AssertS3BucketServerSideEncryption checks if the given S3 bucket has server-side encryption configured with the given algorithm and fails the test if it does not.

Deprecated: Use AssertS3BucketServerSideEncryptionContext instead.

func AssertS3BucketServerSideEncryptionContext added in v1.0.0

func AssertS3BucketServerSideEncryptionContext(t testing.TestingT, ctx context.Context, region string, bucketName string, algorithm types.ServerSideEncryption)

AssertS3BucketServerSideEncryptionContext checks if the given S3 bucket has server-side encryption configured with the given algorithm, and fails the test if it does not. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketServerSideEncryptionContextE added in v1.0.0

func AssertS3BucketServerSideEncryptionContextE(t testing.TestingT, ctx context.Context, region string, bucketName string, algorithm types.ServerSideEncryption) error

AssertS3BucketServerSideEncryptionContextE checks if the given S3 bucket has server-side encryption configured with the given algorithm, and returns an error if it does not. The ctx parameter supports cancellation and timeouts.

The algorithm is matched exactly: an expectation of `aws:kms` will not match a bucket configured with `aws:kms:dsse`, and vice versa.

func AssertS3BucketServerSideEncryptionE deprecated added in v1.0.0

func AssertS3BucketServerSideEncryptionE(t testing.TestingT, region string, bucketName string, algorithm types.ServerSideEncryption) error

AssertS3BucketServerSideEncryptionE checks if the given S3 bucket has server-side encryption configured with the given algorithm and returns an error if it does not.

Deprecated: Use AssertS3BucketServerSideEncryptionContextE instead.

func AssertS3BucketVersioningExists deprecated added in v0.15.4

func AssertS3BucketVersioningExists(t testing.TestingT, region string, bucketName string)

AssertS3BucketVersioningExists checks if the given S3 bucket has a versioning configuration enabled and returns an error if it does not.

Deprecated: Use AssertS3BucketVersioningExistsContext instead.

func AssertS3BucketVersioningExistsContext added in v1.0.0

func AssertS3BucketVersioningExistsContext(t testing.TestingT, ctx context.Context, region string, bucketName string)

AssertS3BucketVersioningExistsContext checks if the given S3 bucket has a versioning configuration enabled and fails the test if it does not. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketVersioningExistsContextE added in v1.0.0

func AssertS3BucketVersioningExistsContextE(t testing.TestingT, ctx context.Context, region string, bucketName string) error

AssertS3BucketVersioningExistsContextE checks if the given S3 bucket has a versioning configuration enabled and returns an error if it does not. The ctx parameter supports cancellation and timeouts.

func AssertS3BucketVersioningExistsE deprecated added in v0.15.4

func AssertS3BucketVersioningExistsE(t testing.TestingT, region string, bucketName string) error

AssertS3BucketVersioningExistsE checks if the given S3 bucket has a versioning configuration enabled and returns an error if it does not.

Deprecated: Use AssertS3BucketVersioningExistsContextE instead.

func CreateAwsSessionWithCreds deprecated

func CreateAwsSessionWithCreds(region string, accessKeyID string, secretAccessKey string) (*aws.Config, error)

CreateAwsSessionWithCreds creates a new AWS Config using explicit credentials. This is useful if you want to create an IAM User dynamically and create an AWS Config authenticated as the new IAM User.

Deprecated: Use CreateAwsSessionWithCredsContext instead.

func CreateAwsSessionWithCredsContext added in v1.0.0

func CreateAwsSessionWithCredsContext(ctx context.Context, region string, accessKeyID string, secretAccessKey string) (*aws.Config, error)

CreateAwsSessionWithCredsContext creates a new AWS Config using explicit credentials. This is useful if you want to create an IAM User dynamically and create an AWS Config authenticated as the new IAM User. The ctx parameter is accepted for API consistency but not currently used.

func CreateAwsSessionWithMfa deprecated

func CreateAwsSessionWithMfa(region string, stsClient *sts.Client, mfaDevice *types.VirtualMFADevice) (*aws.Config, error)

CreateAwsSessionWithMfa creates a new AWS Config authenticated using an MFA token retrieved using the given STS client and MFA Device.

Deprecated: Use CreateAwsSessionWithMfaContext instead.

func CreateAwsSessionWithMfaContext added in v1.0.0

func CreateAwsSessionWithMfaContext(ctx context.Context, region string, stsClient *sts.Client, mfaDevice *types.VirtualMFADevice) (*aws.Config, error)

CreateAwsSessionWithMfaContext creates a new AWS Config authenticated using an MFA token retrieved using the given STS client and MFA Device. The ctx parameter supports cancellation and timeouts.

func CreateECRRepo deprecated added in v0.30.5

func CreateECRRepo(t testing.TestingT, region string, name string) *types.Repository

CreateECRRepo creates a new ECR Repository. This will fail the test and stop execution if there is an error.

Deprecated: Use CreateECRRepoContext instead.

func CreateECRRepoContext added in v1.0.0

func CreateECRRepoContext(t testing.TestingT, ctx context.Context, region string, name string) *types.Repository

CreateECRRepoContext creates a new ECR Repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateECRRepoContextE added in v1.0.0

func CreateECRRepoContextE(t testing.TestingT, ctx context.Context, region string, name string) (*types.Repository, error)

CreateECRRepoContextE creates a new ECR Repository. The ctx parameter supports cancellation and timeouts.

func CreateECRRepoE deprecated added in v0.30.5

func CreateECRRepoE(t testing.TestingT, region string, name string) (*types.Repository, error)

CreateECRRepoE creates a new ECR Repository.

Deprecated: Use CreateECRRepoContextE instead.

func CreateEcsCluster deprecated added in v0.14.3

func CreateEcsCluster(t testing.TestingT, region string, name string) *types.Cluster

CreateEcsCluster creates ECS cluster in the given region under the given name.

Deprecated: Use CreateEcsClusterContext instead.

func CreateEcsClusterContext added in v1.0.0

func CreateEcsClusterContext(t testing.TestingT, ctx context.Context, region string, name string) *types.Cluster

CreateEcsClusterContext creates ECS cluster in the given region under the given name. The ctx parameter supports cancellation and timeouts.

func CreateEcsClusterContextE added in v1.0.0

func CreateEcsClusterContextE(t testing.TestingT, ctx context.Context, region string, name string) (*types.Cluster, error)

CreateEcsClusterContextE creates ECS cluster in the given region under the given name. The ctx parameter supports cancellation and timeouts.

func CreateEcsClusterE deprecated added in v0.14.3

func CreateEcsClusterE(t testing.TestingT, region string, name string) (*types.Cluster, error)

CreateEcsClusterE creates ECS cluster in the given region under the given name.

Deprecated: Use CreateEcsClusterContextE instead.

func CreateMfaDevice deprecated

func CreateMfaDevice(t testing.TestingT, iamClient *iam.Client, deviceName string) *types.VirtualMFADevice

CreateMfaDevice creates an MFA device using the given IAM client.

Deprecated: Use CreateMfaDeviceContext instead.

func CreateMfaDeviceContext added in v1.0.0

func CreateMfaDeviceContext(t testing.TestingT, ctx context.Context, iamClient *iam.Client, deviceName string) *types.VirtualMFADevice

CreateMfaDeviceContext creates an MFA device using the given IAM client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateMfaDeviceContextE added in v1.0.0

func CreateMfaDeviceContextE(t testing.TestingT, ctx context.Context, iamClient *iam.Client, deviceName string) (*types.VirtualMFADevice, error)

CreateMfaDeviceContextE creates an MFA device using the given IAM client. The ctx parameter supports cancellation and timeouts.

func CreateMfaDeviceE deprecated

func CreateMfaDeviceE(t testing.TestingT, iamClient *iam.Client, deviceName string) (*types.VirtualMFADevice, error)

CreateMfaDeviceE creates an MFA device using the given IAM client.

Deprecated: Use CreateMfaDeviceContextE instead.

func CreateRandomFifoQueue deprecated added in v0.18.3

func CreateRandomFifoQueue(t testing.TestingT, awsRegion string, prefix string) string

CreateRandomFifoQueue creates a new FIFO SQS queue with a random name that starts with the given prefix and return the queue URL.

Deprecated: Use CreateRandomFifoQueueContext instead.

func CreateRandomFifoQueueContext added in v1.0.0

func CreateRandomFifoQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, prefix string) string

CreateRandomFifoQueueContext creates a new FIFO SQS queue with a random name that starts with the given prefix and return the queue URL. The ctx parameter supports cancellation and timeouts.

func CreateRandomFifoQueueContextE added in v1.0.0

func CreateRandomFifoQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, prefix string) (string, error)

CreateRandomFifoQueueContextE creates a new FIFO SQS queue with a random name that starts with the given prefix and return the queue URL. The ctx parameter supports cancellation and timeouts.

func CreateRandomFifoQueueE deprecated added in v0.18.3

func CreateRandomFifoQueueE(t testing.TestingT, awsRegion string, prefix string) (string, error)

CreateRandomFifoQueueE creates a new FIFO SQS queue with a random name that starts with the given prefix and return the queue URL.

Deprecated: Use CreateRandomFifoQueueContextE instead.

func CreateRandomQueue deprecated

func CreateRandomQueue(t testing.TestingT, awsRegion string, prefix string) string

CreateRandomQueue creates a new SQS queue with a random name that starts with the given prefix and return the queue URL.

Deprecated: Use CreateRandomQueueContext instead.

func CreateRandomQueueContext added in v1.0.0

func CreateRandomQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, prefix string) string

CreateRandomQueueContext creates a new SQS queue with a random name that starts with the given prefix and return the queue URL. The ctx parameter supports cancellation and timeouts.

func CreateRandomQueueContextE added in v1.0.0

func CreateRandomQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, prefix string) (string, error)

CreateRandomQueueContextE creates a new SQS queue with a random name that starts with the given prefix and return the queue URL. The ctx parameter supports cancellation and timeouts.

func CreateRandomQueueE deprecated

func CreateRandomQueueE(t testing.TestingT, awsRegion string, prefix string) (string, error)

CreateRandomQueueE creates a new SQS queue with a random name that starts with the given prefix and return the queue URL.

Deprecated: Use CreateRandomQueueContextE instead.

func CreateS3Bucket deprecated

func CreateS3Bucket(t testing.TestingT, region string, name string)

CreateS3Bucket creates an S3 bucket in the given region with the given name. Note that S3 bucket names must be globally unique.

Deprecated: Use CreateS3BucketContext instead.

func CreateS3BucketContext added in v1.0.0

func CreateS3BucketContext(t testing.TestingT, ctx context.Context, region string, name string)

CreateS3BucketContext creates an S3 bucket in the given region with the given name. Note that S3 bucket names must be globally unique. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateS3BucketContextE added in v1.0.0

func CreateS3BucketContextE(t testing.TestingT, ctx context.Context, region string, name string) error

CreateS3BucketContextE creates an S3 bucket in the given region with the given name. Note that S3 bucket names must be globally unique. The ctx parameter supports cancellation and timeouts.

func CreateS3BucketE deprecated

func CreateS3BucketE(t testing.TestingT, region string, name string) error

CreateS3BucketE creates an S3 bucket in the given region with the given name. Note that S3 bucket names must be globally unique.

Deprecated: Use CreateS3BucketContextE instead.

func CreateSecretStringWithDefaultKey deprecated added in v0.28.12

func CreateSecretStringWithDefaultKey(t testing.TestingT, awsRegion, description, name, secretString string) string

CreateSecretStringWithDefaultKey creates a new secret in Secrets Manager using the default "aws/secretsmanager" KMS key and returns the secret ARN

Deprecated: Use CreateSecretStringWithDefaultKeyContext instead.

func CreateSecretStringWithDefaultKeyContext added in v1.0.0

func CreateSecretStringWithDefaultKeyContext(t testing.TestingT, ctx context.Context, awsRegion, description, name, secretString string) string

CreateSecretStringWithDefaultKeyContext creates a new secret in Secrets Manager using the default "aws/secretsmanager" KMS key and returns the secret ARN. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateSecretStringWithDefaultKeyContextE added in v1.0.0

func CreateSecretStringWithDefaultKeyContextE(t testing.TestingT, ctx context.Context, awsRegion, description, name, secretString string) (string, error)

CreateSecretStringWithDefaultKeyContextE creates a new secret in Secrets Manager using the default "aws/secretsmanager" KMS key and returns the secret ARN. The ctx parameter supports cancellation and timeouts.

func CreateSecretStringWithDefaultKeyE deprecated added in v0.28.12

func CreateSecretStringWithDefaultKeyE(t testing.TestingT, awsRegion, description, name, secretString string) (string, error)

CreateSecretStringWithDefaultKeyE creates a new secret in Secrets Manager using the default "aws/secretsmanager" KMS key and returns the secret ARN

Deprecated: Use CreateSecretStringWithDefaultKeyContextE instead.

func CreateSnsTopic deprecated

func CreateSnsTopic(t testing.TestingT, region string, snsTopicName string) string

CreateSnsTopic creates an SNS Topic and return the ARN.

Deprecated: Use CreateSnsTopicContext instead.

func CreateSnsTopicContext added in v1.0.0

func CreateSnsTopicContext(t testing.TestingT, ctx context.Context, region string, snsTopicName string) string

CreateSnsTopicContext creates an SNS Topic and return the ARN. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateSnsTopicContextE added in v1.0.0

func CreateSnsTopicContextE(t testing.TestingT, ctx context.Context, region string, snsTopicName string) (string, error)

CreateSnsTopicContextE creates an SNS Topic and return the ARN. The ctx parameter supports cancellation and timeouts.

func CreateSnsTopicE deprecated

func CreateSnsTopicE(t testing.TestingT, region string, snsTopicName string) (string, error)

CreateSnsTopicE creates an SNS Topic and return the ARN.

Deprecated: Use CreateSnsTopicContextE instead.

func DeleteAmi deprecated

func DeleteAmi(t testing.TestingT, region string, imageID string)

DeleteAmi deletes the given AMI in the given region.

Deprecated: Use DeleteAmiContext instead.

func DeleteAmiAndAllSnapshots deprecated added in v0.9.9

func DeleteAmiAndAllSnapshots(t testing.TestingT, region string, ami string)

DeleteAmiAndAllSnapshots will delete the given AMI along with all EBS snapshots that backed that AMI.

Deprecated: Use DeleteAmiAndAllSnapshotsContext instead.

func DeleteAmiAndAllSnapshotsContext added in v1.0.0

func DeleteAmiAndAllSnapshotsContext(t testing.TestingT, ctx context.Context, region string, ami string)

DeleteAmiAndAllSnapshotsContext will delete the given AMI along with all EBS snapshots that backed that AMI. The ctx parameter supports cancellation and timeouts.

func DeleteAmiAndAllSnapshotsContextE added in v1.0.0

func DeleteAmiAndAllSnapshotsContextE(t testing.TestingT, ctx context.Context, region string, ami string) error

DeleteAmiAndAllSnapshotsContextE will delete the given AMI along with all EBS snapshots that backed that AMI. The ctx parameter supports cancellation and timeouts.

func DeleteAmiAndAllSnapshotsE deprecated added in v0.9.9

func DeleteAmiAndAllSnapshotsE(t testing.TestingT, region string, ami string) error

DeleteAmiAndAllSnapshotsE will delete the given AMI along with all EBS snapshots that backed that AMI.

Deprecated: Use DeleteAmiAndAllSnapshotsContextE instead.

func DeleteAmiContext added in v1.0.0

func DeleteAmiContext(t testing.TestingT, ctx context.Context, region string, imageID string)

DeleteAmiContext deletes the given AMI in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteAmiContextE added in v1.0.0

func DeleteAmiContextE(t testing.TestingT, ctx context.Context, region string, imageID string) error

DeleteAmiContextE deletes the given AMI in the given region. The ctx parameter supports cancellation and timeouts.

func DeleteAmiE deprecated

func DeleteAmiE(t testing.TestingT, region string, imageID string) error

DeleteAmiE deletes the given AMI in the given region.

Deprecated: Use DeleteAmiContextE instead.

func DeleteEC2KeyPair deprecated

func DeleteEC2KeyPair(t testing.TestingT, keyPair *Ec2Keypair)

DeleteEC2KeyPair deletes an EC2 key pair.

Deprecated: Use DeleteEC2KeyPairContext instead.

func DeleteEC2KeyPairContext added in v1.0.0

func DeleteEC2KeyPairContext(t testing.TestingT, ctx context.Context, keyPair *Ec2Keypair)

DeleteEC2KeyPairContext deletes an EC2 key pair. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteEC2KeyPairContextE added in v1.0.0

func DeleteEC2KeyPairContextE(t testing.TestingT, ctx context.Context, keyPair *Ec2Keypair) error

DeleteEC2KeyPairContextE deletes an EC2 key pair. The ctx parameter supports cancellation and timeouts.

func DeleteEC2KeyPairE deprecated

func DeleteEC2KeyPairE(t testing.TestingT, keyPair *Ec2Keypair) error

DeleteEC2KeyPairE deletes an EC2 key pair.

Deprecated: Use DeleteEC2KeyPairContextE instead.

func DeleteECRRepo deprecated added in v0.30.5

func DeleteECRRepo(t testing.TestingT, region string, repo *types.Repository)

DeleteECRRepo will force delete the ECR repo by deleting all images prior to deleting the ECR repository. This will fail the test and stop execution if there is an error.

Deprecated: Use DeleteECRRepoContext instead.

func DeleteECRRepoContext added in v1.0.0

func DeleteECRRepoContext(t testing.TestingT, ctx context.Context, region string, repo *types.Repository)

DeleteECRRepoContext will force delete the ECR repo by deleting all images prior to deleting the ECR repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteECRRepoContextE added in v1.0.0

func DeleteECRRepoContextE(t testing.TestingT, ctx context.Context, region string, repo *types.Repository) error

DeleteECRRepoContextE will force delete the ECR repo by deleting all images prior to deleting the ECR repository. The ctx parameter supports cancellation and timeouts.

func DeleteECRRepoE deprecated added in v0.30.5

func DeleteECRRepoE(t testing.TestingT, region string, repo *types.Repository) error

DeleteECRRepoE will force delete the ECR repo by deleting all images prior to deleting the ECR repository.

Deprecated: Use DeleteECRRepoContextE instead.

func DeleteEbsSnapshot deprecated added in v0.9.9

func DeleteEbsSnapshot(t testing.TestingT, region string, snapshot string)

DeleteEbsSnapshot deletes the given EBS snapshot.

Deprecated: Use DeleteEbsSnapshotContext instead.

func DeleteEbsSnapshotContext added in v1.0.0

func DeleteEbsSnapshotContext(t testing.TestingT, ctx context.Context, region string, snapshot string)

DeleteEbsSnapshotContext deletes the given EBS snapshot. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteEbsSnapshotContextE added in v1.0.0

func DeleteEbsSnapshotContextE(t testing.TestingT, ctx context.Context, region string, snapshot string) error

DeleteEbsSnapshotContextE deletes the given EBS snapshot. The ctx parameter supports cancellation and timeouts.

func DeleteEbsSnapshotE deprecated added in v0.9.9

func DeleteEbsSnapshotE(t testing.TestingT, region string, snapshot string) error

DeleteEbsSnapshotE deletes the given EBS snapshot.

Deprecated: Use DeleteEbsSnapshotContextE instead.

func DeleteEbsSnapshotWithClientContextE added in v1.0.0

func DeleteEbsSnapshotWithClientContextE(t testing.TestingT, ctx context.Context, client EbsAPI, snapshot string) error

DeleteEbsSnapshotWithClientContextE deletes the given EBS snapshot using the provided EC2 client. The ctx parameter supports cancellation and timeouts.

func DeleteEcsCluster deprecated added in v0.14.3

func DeleteEcsCluster(t testing.TestingT, region string, cluster *types.Cluster)

DeleteEcsCluster deletes existing ECS cluster in the given region.

Deprecated: Use DeleteEcsClusterContext instead.

func DeleteEcsClusterContext added in v1.0.0

func DeleteEcsClusterContext(t testing.TestingT, ctx context.Context, region string, cluster *types.Cluster)

DeleteEcsClusterContext deletes existing ECS cluster in the given region. The ctx parameter supports cancellation and timeouts.

func DeleteEcsClusterContextE added in v1.0.0

func DeleteEcsClusterContextE(t testing.TestingT, ctx context.Context, region string, cluster *types.Cluster) error

DeleteEcsClusterContextE deletes existing ECS cluster in the given region. The ctx parameter supports cancellation and timeouts.

func DeleteEcsClusterE deprecated added in v0.14.3

func DeleteEcsClusterE(t testing.TestingT, region string, cluster *types.Cluster) error

DeleteEcsClusterE deletes existing ECS cluster in the given region.

Deprecated: Use DeleteEcsClusterContextE instead.

func DeleteMessageFromQueue deprecated

func DeleteMessageFromQueue(t testing.TestingT, awsRegion string, queueURL string, receipt string)

DeleteMessageFromQueue deletes the message with the given receipt from the SQS queue with the given URL.

Deprecated: Use DeleteMessageFromQueueContext instead.

func DeleteMessageFromQueueContext added in v1.0.0

func DeleteMessageFromQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, receipt string)

DeleteMessageFromQueueContext deletes the message with the given receipt from the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func DeleteMessageFromQueueContextE added in v1.0.0

func DeleteMessageFromQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, receipt string) error

DeleteMessageFromQueueContextE deletes the message with the given receipt from the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func DeleteMessageFromQueueE deprecated

func DeleteMessageFromQueueE(t testing.TestingT, awsRegion string, queueURL string, receipt string) error

DeleteMessageFromQueueE deletes the message with the given receipt from the SQS queue with the given URL.

Deprecated: Use DeleteMessageFromQueueContextE instead.

func DeleteParameter deprecated added in v0.30.24

func DeleteParameter(t testing.TestingT, awsRegion string, keyName string)

DeleteParameter deletes all versions of SSM Parameter at keyName.

Deprecated: Use DeleteParameterContext instead.

func DeleteParameterContext added in v1.0.0

func DeleteParameterContext(t testing.TestingT, ctx context.Context, awsRegion string, keyName string)

DeleteParameterContext deletes all versions of SSM Parameter at keyName. The ctx parameter supports cancellation and timeouts.

func DeleteParameterContextE added in v1.0.0

func DeleteParameterContextE(t testing.TestingT, ctx context.Context, awsRegion string, keyName string) error

DeleteParameterContextE deletes all versions of SSM Parameter at keyName. The ctx parameter supports cancellation and timeouts.

func DeleteParameterE deprecated added in v0.30.24

func DeleteParameterE(t testing.TestingT, awsRegion string, keyName string) error

DeleteParameterE deletes all versions of SSM Parameter at keyName.

Deprecated: Use DeleteParameterContextE instead.

func DeleteParameterWithClientContextE added in v1.0.0

func DeleteParameterWithClientContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, keyName string) error

DeleteParameterWithClientContextE deletes all versions of SSM Parameter at keyName with the ability to provide the SSM client. The ctx parameter supports cancellation and timeouts.

func DeleteParameterWithClientE deprecated added in v0.36.3

func DeleteParameterWithClientE(t testing.TestingT, client *ssm.Client, keyName string) error

DeleteParameterWithClientE deletes all versions of SSM Parameter at keyName with the ability to provide the SSM client.

Deprecated: Use DeleteParameterWithClientContextE instead.

func DeleteQueue deprecated

func DeleteQueue(t testing.TestingT, awsRegion string, queueURL string)

DeleteQueue deletes the SQS queue with the given URL.

Deprecated: Use DeleteQueueContext instead.

func DeleteQueueContext added in v1.0.0

func DeleteQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string)

DeleteQueueContext deletes the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func DeleteQueueContextE added in v1.0.0

func DeleteQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string) error

DeleteQueueContextE deletes the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func DeleteQueueE deprecated

func DeleteQueueE(t testing.TestingT, awsRegion string, queueURL string) error

DeleteQueueE deletes the SQS queue with the given URL.

Deprecated: Use DeleteQueueContextE instead.

func DeleteS3Bucket deprecated

func DeleteS3Bucket(t testing.TestingT, region string, name string)

DeleteS3Bucket destroys the S3 bucket in the given region with the given name.

Deprecated: Use DeleteS3BucketContext instead.

func DeleteS3BucketContext added in v1.0.0

func DeleteS3BucketContext(t testing.TestingT, ctx context.Context, region string, name string)

DeleteS3BucketContext destroys the S3 bucket in the given region with the given name. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteS3BucketContextE added in v1.0.0

func DeleteS3BucketContextE(t testing.TestingT, ctx context.Context, region string, name string) error

DeleteS3BucketContextE destroys the S3 bucket in the given region with the given name. The ctx parameter supports cancellation and timeouts.

func DeleteS3BucketE deprecated

func DeleteS3BucketE(t testing.TestingT, region string, name string) error

DeleteS3BucketE destroys the S3 bucket in the given region with the given name.

Deprecated: Use DeleteS3BucketContextE instead.

func DeleteSNSTopic deprecated

func DeleteSNSTopic(t testing.TestingT, region string, snsTopicArn string)

DeleteSNSTopic deletes an SNS Topic.

Deprecated: Use DeleteSNSTopicContext instead.

func DeleteSNSTopicContext added in v1.0.0

func DeleteSNSTopicContext(t testing.TestingT, ctx context.Context, region string, snsTopicArn string)

DeleteSNSTopicContext deletes an SNS Topic. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteSNSTopicContextE added in v1.0.0

func DeleteSNSTopicContextE(t testing.TestingT, ctx context.Context, region string, snsTopicArn string) error

DeleteSNSTopicContextE deletes an SNS Topic. The ctx parameter supports cancellation and timeouts.

func DeleteSNSTopicE deprecated

func DeleteSNSTopicE(t testing.TestingT, region string, snsTopicArn string) error

DeleteSNSTopicE deletes an SNS Topic.

Deprecated: Use DeleteSNSTopicContextE instead.

func DeleteSecret deprecated added in v0.28.12

func DeleteSecret(t testing.TestingT, awsRegion, id string, forceDelete bool)

DeleteSecret deletes a secret. If forceDelete is true, the secret will be deleted after a short delay. If forceDelete is false, the secret will be deleted after a 30-day recovery window.

Deprecated: Use DeleteSecretContext instead.

func DeleteSecretContext added in v1.0.0

func DeleteSecretContext(t testing.TestingT, ctx context.Context, awsRegion, id string, forceDelete bool)

DeleteSecretContext deletes a secret. If forceDelete is true, the secret will be deleted after a short delay. If forceDelete is false, the secret will be deleted after a 30-day recovery window. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func DeleteSecretContextE added in v1.0.0

func DeleteSecretContextE(t testing.TestingT, ctx context.Context, awsRegion, id string, forceDelete bool) error

DeleteSecretContextE deletes a secret. If forceDelete is true, the secret will be deleted after a short delay. If forceDelete is false, the secret will be deleted after a 30-day recovery window. The ctx parameter supports cancellation and timeouts.

func DeleteSecretE deprecated added in v0.28.12

func DeleteSecretE(t testing.TestingT, awsRegion, id string, forceDelete bool) error

DeleteSecretE deletes a secret. If forceDelete is true, the secret will be deleted after a short delay. If forceDelete is false, the secret will be deleted after a 30-day recovery window.

Deprecated: Use DeleteSecretContextE instead.

func EmptyS3Bucket deprecated added in v0.9.15

func EmptyS3Bucket(t testing.TestingT, region string, name string)

EmptyS3Bucket removes the contents of an S3 bucket in the given region with the given name.

Deprecated: Use EmptyS3BucketContext instead.

func EmptyS3BucketContext added in v1.0.0

func EmptyS3BucketContext(t testing.TestingT, ctx context.Context, region string, name string)

EmptyS3BucketContext removes the contents of an S3 bucket in the given region with the given name. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func EmptyS3BucketContextE added in v1.0.0

func EmptyS3BucketContextE(t testing.TestingT, ctx context.Context, region string, name string) error

EmptyS3BucketContextE removes the contents of an S3 bucket in the given region with the given name. The ctx parameter supports cancellation and timeouts.

func EmptyS3BucketE deprecated added in v0.9.15

func EmptyS3BucketE(t testing.TestingT, region string, name string) error

EmptyS3BucketE removes the contents of an S3 bucket in the given region with the given name.

Deprecated: Use EmptyS3BucketContextE instead.

func EnableMfaDevice deprecated

func EnableMfaDevice(t testing.TestingT, iamClient *iam.Client, mfaDevice *types.VirtualMFADevice)

EnableMfaDevice enables a newly created MFA Device by supplying the first two one-time passwords, so that it can be used for future logins by the given IAM User.

Deprecated: Use EnableMfaDeviceContext instead.

func EnableMfaDeviceContext added in v1.0.0

func EnableMfaDeviceContext(t testing.TestingT, ctx context.Context, iamClient *iam.Client, mfaDevice *types.VirtualMFADevice)

EnableMfaDeviceContext enables a newly created MFA Device by supplying the first two one-time passwords, so that it can be used for future logins by the given IAM User. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func EnableMfaDeviceContextE added in v1.0.0

func EnableMfaDeviceContextE(t testing.TestingT, ctx context.Context, iamClient *iam.Client, mfaDevice *types.VirtualMFADevice) error

EnableMfaDeviceContextE enables a newly created MFA Device by supplying the first two one-time passwords, so that it can be used for future logins by the given IAM User. The ctx parameter supports cancellation and timeouts.

func EnableMfaDeviceE deprecated

func EnableMfaDeviceE(t testing.TestingT, iamClient *iam.Client, mfaDevice *types.VirtualMFADevice) error

EnableMfaDeviceE enables a newly created MFA Device by supplying the first two one-time passwords, so that it can be used for future logins by the given IAM User.

Deprecated: Use EnableMfaDeviceContextE instead.

func ExtractAccountIDFromARN added in v1.0.0

func ExtractAccountIDFromARN(arn string) (string, error)

ExtractAccountIDFromARN extracts the AWS account ID from an IAM ARN. An IAM ARN is of the format arn:aws:iam::123456789012:user/test. The account ID is the number after arn:aws:iam::, so we split on a colon and return the 5th item.

func FetchContentsOfFileFromAsg deprecated added in v0.9.17

func FetchContentsOfFileFromAsg(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePath string) map[string]string

FetchContentsOfFileFromAsg looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns a map from Instance ID to the contents of that file as a string.

Deprecated: Use FetchContentsOfFileFromAsgContext instead.

func FetchContentsOfFileFromAsgContext added in v1.0.0

func FetchContentsOfFileFromAsgContext(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePath string) map[string]string

FetchContentsOfFileFromAsgContext looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns a map from Instance ID to the contents of that file as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFileFromAsgContextE added in v1.0.0

func FetchContentsOfFileFromAsgContextE(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePath string) (map[string]string, error)

FetchContentsOfFileFromAsgContextE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns a map from Instance ID to the contents of that file as a string. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFileFromAsgE deprecated added in v0.9.17

func FetchContentsOfFileFromAsgE(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePath string) (map[string]string, error)

FetchContentsOfFileFromAsgE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns a map from Instance ID to the contents of that file as a string.

Deprecated: Use FetchContentsOfFileFromAsgContextE instead.

func FetchContentsOfFileFromInstance deprecated added in v0.9.17

func FetchContentsOfFileFromInstance(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePath string) string

FetchContentsOfFileFromInstance looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns the contents of that file as a string.

Deprecated: Use FetchContentsOfFileFromInstanceContext instead.

func FetchContentsOfFileFromInstanceContext added in v1.0.0

func FetchContentsOfFileFromInstanceContext(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePath string) string

FetchContentsOfFileFromInstanceContext looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns the contents of that file as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFileFromInstanceContextE added in v1.0.0

func FetchContentsOfFileFromInstanceContextE(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePath string) (string, error)

FetchContentsOfFileFromInstanceContextE looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns the contents of that file as a string. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFileFromInstanceE deprecated added in v0.9.17

func FetchContentsOfFileFromInstanceE(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePath string) (string, error)

FetchContentsOfFileFromInstanceE looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the file at the given path (using sudo if useSudo is true), and returns the contents of that file as a string.

Deprecated: Use FetchContentsOfFileFromInstanceContextE instead.

func FetchContentsOfFilesFromAsg deprecated added in v0.9.17

func FetchContentsOfFilesFromAsg(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePaths ...string) map[string]map[string]string

FetchContentsOfFilesFromAsg looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from Instance ID to a map of file path to the contents of that file as a string.

Deprecated: Use FetchContentsOfFilesFromAsgContext instead.

func FetchContentsOfFilesFromAsgContext added in v1.0.0

func FetchContentsOfFilesFromAsgContext(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePaths ...string) map[string]map[string]string

FetchContentsOfFilesFromAsgContext looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from Instance ID to a map of file path to the contents of that file as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFilesFromAsgContextE added in v1.0.0

func FetchContentsOfFilesFromAsgContextE(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePaths ...string) (map[string]map[string]string, error)

FetchContentsOfFilesFromAsgContextE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from Instance ID to a map of file path to the contents of that file as a string. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFilesFromAsgE deprecated added in v0.9.17

func FetchContentsOfFilesFromAsgE(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, asgName string, useSudo bool, filePaths ...string) (map[string]map[string]string, error)

FetchContentsOfFilesFromAsgE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from Instance ID to a map of file path to the contents of that file as a string.

Deprecated: Use FetchContentsOfFilesFromAsgContextE instead.

func FetchContentsOfFilesFromInstance deprecated added in v0.9.17

func FetchContentsOfFilesFromInstance(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePaths ...string) map[string]string

FetchContentsOfFilesFromInstance looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from file path to the contents of that file as a string.

Deprecated: Use FetchContentsOfFilesFromInstanceContext instead.

func FetchContentsOfFilesFromInstanceContext added in v1.0.0

func FetchContentsOfFilesFromInstanceContext(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePaths ...string) map[string]string

FetchContentsOfFilesFromInstanceContext looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from file path to the contents of that file as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFilesFromInstanceContextE added in v1.0.0

func FetchContentsOfFilesFromInstanceContextE(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePaths ...string) (map[string]string, error)

FetchContentsOfFilesFromInstanceContextE looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from file path to the contents of that file as a string. The ctx parameter supports cancellation and timeouts.

func FetchContentsOfFilesFromInstanceE deprecated added in v0.9.17

func FetchContentsOfFilesFromInstanceE(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, filePaths ...string) (map[string]string, error)

FetchContentsOfFilesFromInstanceE looks up the public IP address of the EC2 Instance with the given ID, connects to the Instance via SSH using the given username and Key Pair, fetches the contents of the files at the given paths (using sudo if useSudo is true), and returns a map from file path to the contents of that file as a string.

Deprecated: Use FetchContentsOfFilesFromInstanceContextE instead.

func FetchFilesFromAsgs deprecated added in v0.13.0

func FetchFilesFromAsgs(t testing.TestingT, awsRegion string, spec RemoteFileSpecification)

FetchFilesFromAsgs looks up the EC2 Instances in all the ASGs given in the RemoteFileSpecification, downloads the matching files from each instance, and stores them locally as described in FetchFilesFromAsgsPContext.

Deprecated: Use FetchFilesFromAsgsPContext instead.

func FetchFilesFromAsgsE deprecated added in v0.13.0

func FetchFilesFromAsgsE(t testing.TestingT, awsRegion string, spec RemoteFileSpecification) error

FetchFilesFromAsgsE is the error-returning equivalent of FetchFilesFromAsgs.

Deprecated: Use FetchFilesFromAsgsPContextE instead.

func FetchFilesFromAsgsP deprecated added in v1.0.0

func FetchFilesFromAsgsP(t testing.TestingT, awsRegion string, spec *RemoteFileSpecification)

FetchFilesFromAsgsP looks up the EC2 Instances in all the ASGs given in the RemoteFileSpecification, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. This variant accepts a pointer to RemoteFileSpecification to avoid copying the large struct.

Deprecated: Use FetchFilesFromAsgsPContext instead.

func FetchFilesFromAsgsPContext added in v1.0.0

func FetchFilesFromAsgsPContext(t testing.TestingT, ctx context.Context, awsRegion string, spec *RemoteFileSpecification)

FetchFilesFromAsgsPContext looks up the EC2 Instances in all the ASGs given in the RemoteFileSpecification, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. This variant accepts a pointer to RemoteFileSpecification to avoid copying the large struct. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchFilesFromAsgsPContextE added in v1.0.0

func FetchFilesFromAsgsPContextE(t testing.TestingT, ctx context.Context, awsRegion string, spec *RemoteFileSpecification) error

FetchFilesFromAsgsPContextE looks up the EC2 Instances in all the ASGs given in the RemoteFileSpecification, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. This variant accepts a pointer to RemoteFileSpecification to avoid copying the large struct. The ctx parameter supports cancellation and timeouts.

func FetchFilesFromAsgsPE deprecated added in v1.0.0

func FetchFilesFromAsgsPE(t testing.TestingT, awsRegion string, spec *RemoteFileSpecification) error

FetchFilesFromAsgsPE looks up the EC2 Instances in all the ASGs given in the RemoteFileSpecification, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. This variant accepts a pointer to RemoteFileSpecification to avoid copying the large struct.

Deprecated: Use FetchFilesFromAsgsPContextE instead.

func FetchFilesFromInstance deprecated added in v0.13.0

func FetchFilesFromInstance(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, remoteDirectory string, localDirectory string, filenameFilters []string)

FetchFilesFromInstance looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>

Deprecated: Use FetchFilesFromInstanceContext instead.

func FetchFilesFromInstanceContext added in v1.0.0

func FetchFilesFromInstanceContext(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, remoteDirectory string, localDirectory string, filenameFilters []string)

FetchFilesFromInstanceContext looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FetchFilesFromInstanceContextE added in v1.0.0

func FetchFilesFromInstanceContextE(t testing.TestingT, ctx context.Context, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, remoteDirectory string, localDirectory string, filenameFilters []string) error

FetchFilesFromInstanceContextE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>. The ctx parameter supports cancellation and timeouts.

func FetchFilesFromInstanceE deprecated added in v0.13.0

func FetchFilesFromInstanceE(t testing.TestingT, awsRegion string, sshUserName string, keyPair *Ec2Keypair, instanceID string, useSudo bool, remoteDirectory string, localDirectory string, filenameFilters []string) error

FetchFilesFromInstanceE looks up the EC2 Instances in the given ASG, looks up the public IPs of those EC2 Instances, connects to each Instance via SSH using the given username and Key Pair, downloads the files matching filenameFilters at the given remoteDirectory (using sudo if useSudo is true), and stores the files locally at localDirectory/<publicip>/<remoteFolderName>

Deprecated: Use FetchFilesFromInstanceContextE instead.

func FindS3BucketWithTag deprecated

func FindS3BucketWithTag(t testing.TestingT, awsRegion string, key string, value string) string

FindS3BucketWithTag finds the name of the S3 bucket in the given region with the given tag key=value.

Deprecated: Use FindS3BucketWithTagContext instead.

func FindS3BucketWithTagContext added in v1.0.0

func FindS3BucketWithTagContext(t testing.TestingT, ctx context.Context, awsRegion string, key string, value string) string

FindS3BucketWithTagContext finds the name of the S3 bucket in the given region with the given tag key=value. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func FindS3BucketWithTagContextE added in v1.0.0

func FindS3BucketWithTagContextE(t testing.TestingT, ctx context.Context, awsRegion string, key string, value string) (string, error)

FindS3BucketWithTagContextE finds the name of the S3 bucket in the given region with the given tag key=value. The ctx parameter supports cancellation and timeouts.

func FindS3BucketWithTagE deprecated

func FindS3BucketWithTagE(t testing.TestingT, awsRegion string, key string, value string) (string, error)

FindS3BucketWithTagE finds the name of the S3 bucket in the given region with the given tag key=value.

Deprecated: Use FindS3BucketWithTagContextE instead.

func FindVPCName added in v1.0.0

func FindVPCName(vpc *types.Vpc) string

FindVPCName extracts the VPC name from its tags (if any). Falls back to "Default" if it's the default VPC or empty string otherwise.

func FindVpcName deprecated

func FindVpcName(vpc types.Vpc) string

FindVpcName extracts the VPC name from its tags (if any). Fall back to "Default" if it's the default VPC or empty string otherwise.

Deprecated: Use FindVPCName instead.

func GetAccountID deprecated added in v1.0.0

func GetAccountID(t testing.TestingT) string

GetAccountID gets the Account ID for the currently logged in IAM User.

Deprecated: Use GetAccountIDContext instead.

func GetAccountIDContext added in v1.0.0

func GetAccountIDContext(t testing.TestingT, ctx context.Context) string

GetAccountIDContext gets the Account ID for the currently logged in IAM User. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetAccountIDContextE added in v1.0.0

func GetAccountIDContextE(t testing.TestingT, ctx context.Context) (string, error)

GetAccountIDContextE gets the Account ID for the currently logged in IAM User. The ctx parameter supports cancellation and timeouts.

func GetAccountIDE deprecated added in v1.0.0

func GetAccountIDE(t testing.TestingT) (string, error)

GetAccountIDE gets the Account ID for the currently logged in IAM User.

Deprecated: Use GetAccountIDContextE instead.

func GetAccountId deprecated

func GetAccountId(t testing.TestingT) string

GetAccountId gets the Account ID for the currently logged in IAM User.

Deprecated: Use GetAccountID instead.

func GetAccountIdE deprecated

func GetAccountIdE(t testing.TestingT) (string, error)

GetAccountIdE gets the Account ID for the currently logged in IAM User.

Deprecated: Use GetAccountIDE instead.

func GetAccountsWithLaunchPermissionsForAmi deprecated added in v0.13.2

func GetAccountsWithLaunchPermissionsForAmi(t testing.TestingT, awsRegion string, amiID string) []string

GetAccountsWithLaunchPermissionsForAmi returns list of accounts that the AMI is shared with

Deprecated: Use GetAccountsWithLaunchPermissionsForAmiContext instead.

func GetAccountsWithLaunchPermissionsForAmiContext added in v1.0.0

func GetAccountsWithLaunchPermissionsForAmiContext(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) []string

GetAccountsWithLaunchPermissionsForAmiContext returns list of accounts that the AMI is shared with This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetAccountsWithLaunchPermissionsForAmiContextE added in v1.0.0

func GetAccountsWithLaunchPermissionsForAmiContextE(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) ([]string, error)

GetAccountsWithLaunchPermissionsForAmiContextE returns list of accounts that the AMI is shared with The ctx parameter supports cancellation and timeouts.

func GetAccountsWithLaunchPermissionsForAmiE deprecated added in v0.13.2

func GetAccountsWithLaunchPermissionsForAmiE(t testing.TestingT, awsRegion string, amiID string) ([]string, error)

GetAccountsWithLaunchPermissionsForAmiE returns list of accounts that the AMI is shared with

Deprecated: Use GetAccountsWithLaunchPermissionsForAmiContextE instead.

func GetAcmCertificateArn deprecated

func GetAcmCertificateArn(t testing.TestingT, awsRegion string, certDomainName string) string

GetAcmCertificateArn gets the ACM certificate for the given domain name in the given region.

Deprecated: Use GetAcmCertificateArnContext instead.

func GetAcmCertificateArnContext added in v1.0.0

func GetAcmCertificateArnContext(t testing.TestingT, ctx context.Context, awsRegion string, certDomainName string) string

GetAcmCertificateArnContext gets the ACM certificate for the given domain name in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetAcmCertificateArnContextE added in v1.0.0

func GetAcmCertificateArnContextE(t testing.TestingT, ctx context.Context, awsRegion string, certDomainName string) (string, error)

GetAcmCertificateArnContextE gets the ACM certificate for the given domain name in the given region. The ctx parameter supports cancellation and timeouts.

func GetAcmCertificateArnE deprecated added in v0.9.0

func GetAcmCertificateArnE(t testing.TestingT, awsRegion string, certDomainName string) (string, error)

GetAcmCertificateArnE gets the ACM certificate for the given domain name in the given region.

Deprecated: Use GetAcmCertificateArnContextE instead.

func GetAcmCertificateArnWithClientContextE added in v1.0.0

func GetAcmCertificateArnWithClientContextE(t testing.TestingT, ctx context.Context, client AcmAPI, certDomainName string) (string, error)

GetAcmCertificateArnWithClientContextE gets the ACM certificate for the given domain name using the provided ACM client. Useful when a pre-configured client is available or in unit tests with a mock. The ctx parameter supports cancellation and timeouts.

func GetAddressOfRdsInstance deprecated added in v0.10.3

func GetAddressOfRdsInstance(t testing.TestingT, dbInstanceID string, awsRegion string) string

GetAddressOfRdsInstance gets the address of the given RDS Instance in the given region.

Deprecated: Use GetAddressOfRdsInstanceContext instead.

func GetAddressOfRdsInstanceContext added in v1.0.0

func GetAddressOfRdsInstanceContext(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) string

GetAddressOfRdsInstanceContext gets the address of the given RDS Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetAddressOfRdsInstanceContextE added in v1.0.0

func GetAddressOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) (string, error)

GetAddressOfRdsInstanceContextE gets the address of the given RDS Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetAddressOfRdsInstanceE deprecated added in v0.10.3

func GetAddressOfRdsInstanceE(t testing.TestingT, dbInstanceID string, awsRegion string) (string, error)

GetAddressOfRdsInstanceE gets the address of the given RDS Instance in the given region.

Deprecated: Use GetAddressOfRdsInstanceContextE instead.

func GetAllAwsRegions deprecated

func GetAllAwsRegions(t testing.TestingT) []string

GetAllAwsRegions gets the list of AWS regions available in this account.

Deprecated: Use GetAllAwsRegionsContext instead.

func GetAllAwsRegionsContext added in v1.0.0

func GetAllAwsRegionsContext(t testing.TestingT, ctx context.Context) []string

GetAllAwsRegionsContext gets the list of AWS regions available in this account. The ctx parameter supports cancellation and timeouts.

func GetAllAwsRegionsContextE added in v1.0.0

func GetAllAwsRegionsContextE(t testing.TestingT, ctx context.Context) ([]string, error)

GetAllAwsRegionsContextE gets the list of AWS regions available in this account. The ctx parameter supports cancellation and timeouts.

func GetAllAwsRegionsE deprecated

func GetAllAwsRegionsE(t testing.TestingT) ([]string, error)

GetAllAwsRegionsE gets the list of AWS regions available in this account.

Deprecated: Use GetAllAwsRegionsContextE instead.

func GetAllParametersOfRdsInstance deprecated added in v0.10.3

func GetAllParametersOfRdsInstance(t testing.TestingT, dbInstanceID string, awsRegion string) []types.Parameter

GetAllParametersOfRdsInstance gets all the parameters defined in the parameter group for the RDS instance in the given region.

Deprecated: Use GetAllParametersOfRdsInstanceContext instead.

func GetAllParametersOfRdsInstanceContext added in v1.0.0

func GetAllParametersOfRdsInstanceContext(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) []types.Parameter

GetAllParametersOfRdsInstanceContext gets all the parameters defined in the parameter group for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetAllParametersOfRdsInstanceContextE added in v1.0.0

func GetAllParametersOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) ([]types.Parameter, error)

GetAllParametersOfRdsInstanceContextE gets all the parameters defined in the parameter group for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetAllParametersOfRdsInstanceE deprecated added in v0.10.3

func GetAllParametersOfRdsInstanceE(t testing.TestingT, dbInstanceID string, awsRegion string) ([]types.Parameter, error)

GetAllParametersOfRdsInstanceE gets all the parameters defined in the parameter group for the RDS instance in the given region.

Deprecated: Use GetAllParametersOfRdsInstanceContextE instead.

func GetAmazonLinuxAmi deprecated

func GetAmazonLinuxAmi(t testing.TestingT, region string) string

GetAmazonLinuxAmi returns an Amazon Linux AMI HVM, SSD Volume Type public AMI for the given region.

Deprecated: Use GetAmazonLinuxAmiContext instead.

func GetAmazonLinuxAmiContext added in v1.0.0

func GetAmazonLinuxAmiContext(t testing.TestingT, ctx context.Context, region string) string

GetAmazonLinuxAmiContext returns an Amazon Linux AMI HVM, SSD Volume Type public AMI for the given region. The ctx parameter supports cancellation and timeouts.

func GetAmazonLinuxAmiContextE added in v1.0.0

func GetAmazonLinuxAmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetAmazonLinuxAmiContextE returns an Amazon Linux AMI HVM, SSD Volume Type public AMI for the given region. The ctx parameter supports cancellation and timeouts.

func GetAmazonLinuxAmiE deprecated

func GetAmazonLinuxAmiE(t testing.TestingT, region string) (string, error)

GetAmazonLinuxAmiE returns an Amazon Linux AMI HVM, SSD Volume Type public AMI for the given region.

Deprecated: Use GetAmazonLinuxAmiContextE instead.

func GetAmiPubliclyAccessible deprecated added in v0.13.2

func GetAmiPubliclyAccessible(t testing.TestingT, awsRegion string, amiID string) bool

GetAmiPubliclyAccessible returns whether the AMI is publicly accessible or not

Deprecated: Use GetAmiPubliclyAccessibleContext instead.

func GetAmiPubliclyAccessibleContext added in v1.0.0

func GetAmiPubliclyAccessibleContext(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) bool

GetAmiPubliclyAccessibleContext returns whether the AMI is publicly accessible or not This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetAmiPubliclyAccessibleContextE added in v1.0.0

func GetAmiPubliclyAccessibleContextE(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) (bool, error)

GetAmiPubliclyAccessibleContextE returns whether the AMI is publicly accessible or not The ctx parameter supports cancellation and timeouts.

func GetAmiPubliclyAccessibleE deprecated added in v0.13.2

func GetAmiPubliclyAccessibleE(t testing.TestingT, awsRegion string, amiID string) (bool, error)

GetAmiPubliclyAccessibleE returns whether the AMI is publicly accessible or not

Deprecated: Use GetAmiPubliclyAccessibleContextE instead.

func GetAvailabilityZones deprecated

func GetAvailabilityZones(t testing.TestingT, region string) []string

GetAvailabilityZones gets the Availability Zones for a given AWS region. Note that for certain regions (e.g. us-east-1), different AWS accounts have access to different availability zones.

Deprecated: Use GetAvailabilityZonesContext instead.

func GetAvailabilityZonesContext added in v1.0.0

func GetAvailabilityZonesContext(t testing.TestingT, ctx context.Context, region string) []string

GetAvailabilityZonesContext gets the Availability Zones for a given AWS region. Note that for certain regions (e.g. us-east-1), different AWS accounts have access to different availability zones. The ctx parameter supports cancellation and timeouts.

func GetAvailabilityZonesContextE added in v1.0.0

func GetAvailabilityZonesContextE(t testing.TestingT, ctx context.Context, region string) ([]string, error)

GetAvailabilityZonesContextE gets the Availability Zones for a given AWS region. Note that for certain regions (e.g. us-east-1), different AWS accounts have access to different availability zones. The ctx parameter supports cancellation and timeouts.

func GetAvailabilityZonesE deprecated

func GetAvailabilityZonesE(t testing.TestingT, region string) ([]string, error)

GetAvailabilityZonesE gets the Availability Zones for a given AWS region. Note that for certain regions (e.g. us-east-1), different AWS accounts have access to different availability zones.

Deprecated: Use GetAvailabilityZonesContextE instead.

func GetCentos7Ami deprecated

func GetCentos7Ami(t testing.TestingT, region string) string

GetCentos7Ami returns a CentOS 7 public AMI from the given region. WARNING: you may have to accept the terms & conditions of this AMI in AWS MarketPlace for your AWS Account before you can successfully launch the AMI.

Deprecated: Use GetCentos7AmiContext instead.

func GetCentos7AmiContext added in v1.0.0

func GetCentos7AmiContext(t testing.TestingT, ctx context.Context, region string) string

GetCentos7AmiContext returns a CentOS 7 public AMI from the given region. WARNING: you may have to accept the terms & conditions of this AMI in AWS MarketPlace for your AWS Account before you can successfully launch the AMI. The ctx parameter supports cancellation and timeouts.

func GetCentos7AmiContextE added in v1.0.0

func GetCentos7AmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetCentos7AmiContextE returns a CentOS 7 public AMI from the given region. WARNING: you may have to accept the terms & conditions of this AMI in AWS MarketPlace for your AWS Account before you can successfully launch the AMI. The ctx parameter supports cancellation and timeouts.

func GetCentos7AmiE deprecated

func GetCentos7AmiE(t testing.TestingT, region string) (string, error)

GetCentos7AmiE returns a CentOS 7 public AMI from the given region. WARNING: you may have to accept the terms & conditions of this AMI in AWS MarketPlace for your AWS Account before you can successfully launch the AMI.

Deprecated: Use GetCentos7AmiContextE instead.

func GetCloudWatchLogEntries deprecated

func GetCloudWatchLogEntries(t testing.TestingT, awsRegion string, logStreamName string, logGroupName string) []string

GetCloudWatchLogEntries returns the CloudWatch log messages in the given region for the given log stream and log group.

Deprecated: Use GetCloudWatchLogEntriesContext instead.

func GetCloudWatchLogEntriesContext added in v1.0.0

func GetCloudWatchLogEntriesContext(t testing.TestingT, ctx context.Context, awsRegion string, logStreamName string, logGroupName string) []string

GetCloudWatchLogEntriesContext returns the CloudWatch log messages in the given region for the given log stream and log group. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetCloudWatchLogEntriesContextE added in v1.0.0

func GetCloudWatchLogEntriesContextE(t testing.TestingT, ctx context.Context, awsRegion string, logStreamName string, logGroupName string) ([]string, error)

GetCloudWatchLogEntriesContextE returns the CloudWatch log messages in the given region for the given log stream and log group. The ctx parameter supports cancellation and timeouts.

func GetCloudWatchLogEntriesE deprecated

func GetCloudWatchLogEntriesE(t testing.TestingT, awsRegion string, logStreamName string, logGroupName string) ([]string, error)

GetCloudWatchLogEntriesE returns the CloudWatch log messages in the given region for the given log stream and log group.

Deprecated: Use GetCloudWatchLogEntriesContextE instead.

func GetCloudWatchLogEntriesWithClientContextE added in v1.0.0

func GetCloudWatchLogEntriesWithClientContextE(t testing.TestingT, ctx context.Context, client CloudWatchLogsAPI, logStreamName string, logGroupName string) ([]string, error)

GetCloudWatchLogEntriesWithClientContextE returns the CloudWatch log messages for the given log stream and log group using the provided CloudWatch Logs client. The ctx parameter supports cancellation and timeouts.

func GetCmkArn deprecated

func GetCmkArn(t testing.TestingT, region string, cmkID string) string

GetCmkArn gets the ARN of a KMS Customer Master Key (CMK) in the given region with the given ID. The ID can be an alias, such as "alias/my-cmk".

Deprecated: Use GetCmkArnContext instead.

func GetCmkArnContext added in v1.0.0

func GetCmkArnContext(t testing.TestingT, ctx context.Context, region string, cmkID string) string

GetCmkArnContext gets the ARN of a KMS Customer Master Key (CMK) in the given region with the given ID. The ID can be an alias, such as "alias/my-cmk". This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetCmkArnContextE added in v1.0.0

func GetCmkArnContextE(t testing.TestingT, ctx context.Context, region string, cmkID string) (string, error)

GetCmkArnContextE gets the ARN of a KMS Customer Master Key (CMK) in the given region with the given ID. The ID can be an alias, such as "alias/my-cmk". The ctx parameter supports cancellation and timeouts.

func GetCmkArnE deprecated

func GetCmkArnE(t testing.TestingT, region string, cmkID string) (string, error)

GetCmkArnE gets the ARN of a KMS Customer Master Key (CMK) in the given region with the given ID. The ID can be an alias, such as "alias/my-cmk".

Deprecated: Use GetCmkArnContextE instead.

func GetCmkArnWithClientContextE added in v1.0.0

func GetCmkArnWithClientContextE(t testing.TestingT, ctx context.Context, client KmsAPI, cmkID string) (string, error)

GetCmkArnWithClientContextE gets the ARN of a KMS Customer Master Key (CMK) with the given ID using the provided KMS client. The ID can be an alias, such as "alias/my-cmk". The ctx parameter supports cancellation and timeouts.

func GetDefaultEcsCluster deprecated added in v0.14.3

func GetDefaultEcsCluster(t testing.TestingT, region string) *types.Cluster

GetDefaultEcsCluster fetches information about default ECS cluster.

Deprecated: Use GetDefaultEcsClusterContext instead.

func GetDefaultEcsClusterContext added in v1.0.0

func GetDefaultEcsClusterContext(t testing.TestingT, ctx context.Context, region string) *types.Cluster

GetDefaultEcsClusterContext fetches information about default ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetDefaultEcsClusterContextE added in v1.0.0

func GetDefaultEcsClusterContextE(t testing.TestingT, ctx context.Context, region string) (*types.Cluster, error)

GetDefaultEcsClusterContextE fetches information about default ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetDefaultEcsClusterE deprecated added in v0.14.3

func GetDefaultEcsClusterE(t testing.TestingT, region string) (*types.Cluster, error)

GetDefaultEcsClusterE fetches information about default ECS cluster.

Deprecated: Use GetDefaultEcsClusterContextE instead.

func GetDefaultSubnetIDsForVpc deprecated added in v0.40.17

func GetDefaultSubnetIDsForVpc(t testing.TestingT, vpc Vpc) []string

GetDefaultSubnetIDsForVpc gets the ids of the subnets that are the default subnet for the AvailabilityZone.

Deprecated: Use GetDefaultSubnetIDsForVpcPContext instead.

func GetDefaultSubnetIDsForVpcE deprecated added in v0.40.17

func GetDefaultSubnetIDsForVpcE(t testing.TestingT, vpc Vpc) ([]string, error)

GetDefaultSubnetIDsForVpcE gets the ids of the subnets that are the default subnet for the AvailabilityZone.

Deprecated: Use GetDefaultSubnetIDsForVpcPContextE instead.

func GetDefaultSubnetIDsForVpcP deprecated added in v1.0.0

func GetDefaultSubnetIDsForVpcP(t testing.TestingT, vpc *Vpc) []string

GetDefaultSubnetIDsForVpcP gets the ids of the subnets that are the default subnet for the AvailabilityZone.

Deprecated: Use GetDefaultSubnetIDsForVpcPContext instead.

func GetDefaultSubnetIDsForVpcPContext added in v1.0.0

func GetDefaultSubnetIDsForVpcPContext(t testing.TestingT, ctx context.Context, vpc *Vpc) []string

GetDefaultSubnetIDsForVpcPContext gets the ids of the subnets that are the default subnet for the AvailabilityZone. This function will fail the test if there is an error. The P suffix differentiates this function (which accepts *Vpc pointer) from the deprecated GetDefaultSubnetIDsForVpc which accepts Vpc by value. The ctx parameter is accepted for API consistency with other Context functions.

func GetDefaultSubnetIDsForVpcPContextE added in v1.0.0

func GetDefaultSubnetIDsForVpcPContextE(t testing.TestingT, ctx context.Context, vpc *Vpc) ([]string, error)

GetDefaultSubnetIDsForVpcPContextE gets the ids of the subnets that are the default subnet for the AvailabilityZone. The P suffix differentiates this function (which accepts *Vpc pointer) from the deprecated GetDefaultSubnetIDsForVpcE which accepts Vpc by value. The ctx parameter is accepted for API consistency with other Context functions.

func GetDefaultSubnetIDsForVpcPE deprecated added in v1.0.0

func GetDefaultSubnetIDsForVpcPE(t testing.TestingT, vpc *Vpc) ([]string, error)

GetDefaultSubnetIDsForVpcPE gets the ids of the subnets that are the default subnet for the AvailabilityZone.

Deprecated: Use GetDefaultSubnetIDsForVpcPContextE instead.

func GetDynamoDBTable deprecated added in v0.15.11

func GetDynamoDBTable(t testing.TestingT, region string, tableName string) *types.TableDescription

GetDynamoDBTable fetches information about the specified dynamoDB table. This will fail the test if there are any errors.

Deprecated: Use GetDynamoDBTableContext instead.

func GetDynamoDBTableContext added in v1.0.0

func GetDynamoDBTableContext(t testing.TestingT, ctx context.Context, region string, tableName string) *types.TableDescription

GetDynamoDBTableContext fetches information about the specified dynamoDB table. This will fail the test if there are any errors. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableContextE added in v1.0.0

func GetDynamoDBTableContextE(t testing.TestingT, ctx context.Context, region string, tableName string) (*types.TableDescription, error)

GetDynamoDBTableContextE fetches information about the specified dynamoDB table. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableE deprecated added in v0.15.11

func GetDynamoDBTableE(t testing.TestingT, region string, tableName string) (*types.TableDescription, error)

GetDynamoDBTableE fetches information about the specified dynamoDB table.

Deprecated: Use GetDynamoDBTableContextE instead.

func GetDynamoDBTableTags deprecated added in v1.0.0

func GetDynamoDBTableTags(t testing.TestingT, region string, tableName string) []types.Tag

GetDynamoDBTableTags fetches resource tags of a specified dynamoDB table. This will fail the test if there are any errors.

Deprecated: Use GetDynamoDBTableTagsContext instead.

func GetDynamoDBTableTagsContext added in v1.0.0

func GetDynamoDBTableTagsContext(t testing.TestingT, ctx context.Context, region string, tableName string) []types.Tag

GetDynamoDBTableTagsContext fetches resource tags of a specified dynamoDB table. This will fail the test if there are any errors. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableTagsContextE added in v1.0.0

func GetDynamoDBTableTagsContextE(t testing.TestingT, ctx context.Context, region string, tableName string) ([]types.Tag, error)

GetDynamoDBTableTagsContextE fetches resource tags of a specified dynamoDB table. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableTagsE deprecated added in v1.0.0

func GetDynamoDBTableTagsE(t testing.TestingT, region string, tableName string) ([]types.Tag, error)

GetDynamoDBTableTagsE fetches resource tags of a specified dynamoDB table.

Deprecated: Use GetDynamoDBTableTagsContextE instead.

func GetDynamoDBTableTagsWithClientContextE added in v1.0.0

func GetDynamoDBTableTagsWithClientContextE(t testing.TestingT, ctx context.Context, client DynamoDBAPI, tableName string) ([]types.Tag, error)

GetDynamoDBTableTagsWithClientContextE fetches resource tags of a specified dynamoDB table using the provided DynamoDB client. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableTimeToLive deprecated added in v0.15.11

func GetDynamoDBTableTimeToLive(t testing.TestingT, region string, tableName string) *types.TimeToLiveDescription

GetDynamoDBTableTimeToLive fetches information about the TTL configuration of a specified dynamoDB table. This will fail the test if there are any errors.

Deprecated: Use GetDynamoDBTableTimeToLiveContext instead.

func GetDynamoDBTableTimeToLiveContext added in v1.0.0

func GetDynamoDBTableTimeToLiveContext(t testing.TestingT, ctx context.Context, region string, tableName string) *types.TimeToLiveDescription

GetDynamoDBTableTimeToLiveContext fetches information about the TTL configuration of a specified dynamoDB table. This will fail the test if there are any errors. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableTimeToLiveContextE added in v1.0.0

func GetDynamoDBTableTimeToLiveContextE(t testing.TestingT, ctx context.Context, region string, tableName string) (*types.TimeToLiveDescription, error)

GetDynamoDBTableTimeToLiveContextE fetches information about the TTL configuration of a specified dynamoDB table. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableTimeToLiveE deprecated added in v0.15.11

func GetDynamoDBTableTimeToLiveE(t testing.TestingT, region string, tableName string) (*types.TimeToLiveDescription, error)

GetDynamoDBTableTimeToLiveE fetches information about the TTL configuration of a specified dynamoDB table.

Deprecated: Use GetDynamoDBTableTimeToLiveContextE instead.

func GetDynamoDBTableTimeToLiveWithClientContextE added in v1.0.0

func GetDynamoDBTableTimeToLiveWithClientContextE(t testing.TestingT, ctx context.Context, client DynamoDBAPI, tableName string) (*types.TimeToLiveDescription, error)

GetDynamoDBTableTimeToLiveWithClientContextE fetches the TTL configuration of a specified dynamoDB table using the provided DynamoDB client. The ctx parameter supports cancellation and timeouts.

func GetDynamoDBTableWithClientContextE added in v1.0.0

func GetDynamoDBTableWithClientContextE(t testing.TestingT, ctx context.Context, client DynamoDBAPI, tableName string) (*types.TableDescription, error)

GetDynamoDBTableWithClientContextE fetches information about the specified dynamoDB table using the provided DynamoDB client. The ctx parameter supports cancellation and timeouts.

func GetDynamoDbTableTags deprecated added in v0.15.11

func GetDynamoDbTableTags(t testing.TestingT, region string, tableName string) []types.Tag

GetDynamoDbTableTags fetches resource tags of a specified dynamoDB table. This will fail the test if there are any errors.

Deprecated: Use GetDynamoDBTableTagsContext instead.

func GetDynamoDbTableTagsE deprecated added in v0.15.11

func GetDynamoDbTableTagsE(t testing.TestingT, region string, tableName string) ([]types.Tag, error)

GetDynamoDbTableTagsE fetches resource tags of a specified dynamoDB table.

Deprecated: Use GetDynamoDBTableTagsContextE instead.

func GetECRRepo deprecated added in v0.30.5

func GetECRRepo(t testing.TestingT, region string, name string) *types.Repository

GetECRRepo gets an ECR repository by name. This will fail the test and stop execution if there is an error. An error occurs if a repository with the given name does not exist in the given region.

Deprecated: Use GetECRRepoContext instead.

func GetECRRepoContext added in v1.0.0

func GetECRRepoContext(t testing.TestingT, ctx context.Context, region string, name string) *types.Repository

GetECRRepoContext gets an ECR repository by name. This function will fail the test if there is an error. An error occurs if a repository with the given name does not exist in the given region. The ctx parameter supports cancellation and timeouts.

func GetECRRepoContextE added in v1.0.0

func GetECRRepoContextE(t testing.TestingT, ctx context.Context, region string, name string) (*types.Repository, error)

GetECRRepoContextE gets an ECR Repository by name. An error occurs if a repository with the given name does not exist in the given region. The ctx parameter supports cancellation and timeouts.

func GetECRRepoE deprecated added in v0.30.5

func GetECRRepoE(t testing.TestingT, region string, name string) (*types.Repository, error)

GetECRRepoE gets an ECR Repository by name. An error occurs if a repository with the given name does not exist in the given region.

Deprecated: Use GetECRRepoContextE instead.

func GetECRRepoLifecyclePolicy deprecated added in v0.41.5

func GetECRRepoLifecyclePolicy(t testing.TestingT, region string, repo *types.Repository) string

GetECRRepoLifecyclePolicy gets the policies for the given ECR repository. This will fail the test and stop execution if there is an error.

Deprecated: Use GetECRRepoLifecyclePolicyContext instead.

func GetECRRepoLifecyclePolicyContext added in v1.0.0

func GetECRRepoLifecyclePolicyContext(t testing.TestingT, ctx context.Context, region string, repo *types.Repository) string

GetECRRepoLifecyclePolicyContext gets the policies for the given ECR repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetECRRepoLifecyclePolicyContextE added in v1.0.0

func GetECRRepoLifecyclePolicyContextE(t testing.TestingT, ctx context.Context, region string, repo *types.Repository) (string, error)

GetECRRepoLifecyclePolicyContextE gets the policies for the given ECR repository. The ctx parameter supports cancellation and timeouts.

func GetECRRepoLifecyclePolicyE deprecated added in v0.41.5

func GetECRRepoLifecyclePolicyE(t testing.TestingT, region string, repo *types.Repository) (string, error)

GetECRRepoLifecyclePolicyE gets the policies for the given ECR repository.

Deprecated: Use GetECRRepoLifecyclePolicyContextE instead.

func GetECRRepoPolicy deprecated added in v0.49.0

func GetECRRepoPolicy(t testing.TestingT, region string, repo *types.Repository) string

GetECRRepoPolicy gets the permissions for the given ECR repository. This will fail the test and stop execution if there is an error.

Deprecated: Use GetECRRepoPolicyContext instead.

func GetECRRepoPolicyContext added in v1.0.0

func GetECRRepoPolicyContext(t testing.TestingT, ctx context.Context, region string, repo *types.Repository) string

GetECRRepoPolicyContext gets the permissions for the given ECR repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetECRRepoPolicyContextE added in v1.0.0

func GetECRRepoPolicyContextE(t testing.TestingT, ctx context.Context, region string, repo *types.Repository) (string, error)

GetECRRepoPolicyContextE gets the policies for the given ECR repository. The ctx parameter supports cancellation and timeouts.

func GetECRRepoPolicyE deprecated added in v0.49.0

func GetECRRepoPolicyE(t testing.TestingT, region string, repo *types.Repository) (string, error)

GetECRRepoPolicyE gets the policies for the given ECR repository.

Deprecated: Use GetECRRepoPolicyContextE instead.

func GetEbsSnapshotsForAmi deprecated added in v0.9.9

func GetEbsSnapshotsForAmi(t testing.TestingT, region string, ami string) []string

GetEbsSnapshotsForAmi retrieves the EBS snapshots which back the given AMI.

Deprecated: Use GetEbsSnapshotsForAmiContext instead.

func GetEbsSnapshotsForAmiContext added in v1.0.0

func GetEbsSnapshotsForAmiContext(t testing.TestingT, ctx context.Context, region string, ami string) []string

GetEbsSnapshotsForAmiContext retrieves the EBS snapshots which back the given AMI. The ctx parameter supports cancellation and timeouts.

func GetEbsSnapshotsForAmiContextE added in v1.0.0

func GetEbsSnapshotsForAmiContextE(t testing.TestingT, ctx context.Context, region string, ami string) ([]string, error)

GetEbsSnapshotsForAmiContextE retrieves the EBS snapshots which back the given AMI. The ctx parameter supports cancellation and timeouts.

func GetEbsSnapshotsForAmiE deprecated added in v0.9.9

func GetEbsSnapshotsForAmiE(t testing.TestingT, region string, ami string) ([]string, error)

GetEbsSnapshotsForAmiE retrieves the EBS snapshots which back the given AMI.

Deprecated: Use GetEbsSnapshotsForAmiContextE instead.

func GetEc2InstanceIdsByFilters deprecated added in v0.15.11

func GetEc2InstanceIdsByFilters(t testing.TestingT, region string, ec2Filters map[string][]string) []string

GetEc2InstanceIdsByFilters returns all the IDs of EC2 instances in the given region which match to EC2 filter list as per https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeInstancesInput.

Deprecated: Use GetEc2InstanceIdsByFiltersContext instead.

func GetEc2InstanceIdsByFiltersContext added in v1.0.0

func GetEc2InstanceIdsByFiltersContext(t testing.TestingT, ctx context.Context, region string, ec2Filters map[string][]string) []string

GetEc2InstanceIdsByFiltersContext returns all the IDs of EC2 instances in the given region which match to EC2 filter list as per https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeInstancesInput. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetEc2InstanceIdsByFiltersContextE added in v1.0.0

func GetEc2InstanceIdsByFiltersContextE(t testing.TestingT, ctx context.Context, region string, ec2Filters map[string][]string) ([]string, error)

GetEc2InstanceIdsByFiltersContextE returns all the IDs of EC2 instances in the given region which match to EC2 filter list as per https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeInstancesInput. The ctx parameter supports cancellation and timeouts.

func GetEc2InstanceIdsByFiltersE deprecated added in v0.15.11

func GetEc2InstanceIdsByFiltersE(t testing.TestingT, region string, ec2Filters map[string][]string) ([]string, error)

GetEc2InstanceIdsByFiltersE returns all the IDs of EC2 instances in the given region which match to EC2 filter list as per https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeInstancesInput.

Deprecated: Use GetEc2InstanceIdsByFiltersContextE instead.

func GetEc2InstanceIdsByTag deprecated

func GetEc2InstanceIdsByTag(t testing.TestingT, region string, tagName string, tagValue string) []string

GetEc2InstanceIdsByTag returns all the IDs of EC2 instances in the given region with the given tag.

Deprecated: Use GetEc2InstanceIdsByTagContext instead.

func GetEc2InstanceIdsByTagContext added in v1.0.0

func GetEc2InstanceIdsByTagContext(t testing.TestingT, ctx context.Context, region string, tagName string, tagValue string) []string

GetEc2InstanceIdsByTagContext returns all the IDs of EC2 instances in the given region with the given tag. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetEc2InstanceIdsByTagContextE added in v1.0.0

func GetEc2InstanceIdsByTagContextE(t testing.TestingT, ctx context.Context, region string, tagName string, tagValue string) ([]string, error)

GetEc2InstanceIdsByTagContextE returns all the IDs of EC2 instances in the given region with the given tag. The ctx parameter supports cancellation and timeouts.

func GetEc2InstanceIdsByTagE deprecated

func GetEc2InstanceIdsByTagE(t testing.TestingT, region string, tagName string, tagValue string) ([]string, error)

GetEc2InstanceIdsByTagE returns all the IDs of EC2 instances in the given region with the given tag.

Deprecated: Use GetEc2InstanceIdsByTagContextE instead.

func GetEcsCluster deprecated added in v0.14.3

func GetEcsCluster(t testing.TestingT, region string, name string) *types.Cluster

GetEcsCluster fetches information about specified ECS cluster.

Deprecated: Use GetEcsClusterContext instead.

func GetEcsClusterContext added in v1.0.0

func GetEcsClusterContext(t testing.TestingT, ctx context.Context, region string, name string) *types.Cluster

GetEcsClusterContext fetches information about specified ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetEcsClusterContextE added in v1.0.0

func GetEcsClusterContextE(t testing.TestingT, ctx context.Context, region string, name string) (*types.Cluster, error)

GetEcsClusterContextE fetches information about specified ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetEcsClusterE deprecated added in v0.14.3

func GetEcsClusterE(t testing.TestingT, region string, name string) (*types.Cluster, error)

GetEcsClusterE fetches information about specified ECS cluster.

Deprecated: Use GetEcsClusterContextE instead.

func GetEcsClusterWithInclude deprecated added in v0.30.8

func GetEcsClusterWithInclude(t testing.TestingT, region string, name string, include []types.ClusterField) *types.Cluster

GetEcsClusterWithInclude fetches extended information about specified ECS cluster. The `include` parameter specifies a list of `ecs.ClusterField*` constants, such as `ecs.ClusterFieldTags`.

Deprecated: Use GetEcsClusterWithIncludeContext instead.

func GetEcsClusterWithIncludeContext added in v1.0.0

func GetEcsClusterWithIncludeContext(t testing.TestingT, ctx context.Context, region string, name string, include []types.ClusterField) *types.Cluster

GetEcsClusterWithIncludeContext fetches extended information about specified ECS cluster. The `include` parameter specifies a list of `ecs.ClusterField*` constants, such as `ecs.ClusterFieldTags`. The ctx parameter supports cancellation and timeouts.

func GetEcsClusterWithIncludeContextE added in v1.0.0

func GetEcsClusterWithIncludeContextE(t testing.TestingT, ctx context.Context, region string, name string, include []types.ClusterField) (*types.Cluster, error)

GetEcsClusterWithIncludeContextE fetches extended information about specified ECS cluster. The `include` parameter specifies a list of `ecs.ClusterField*` constants, such as `ecs.ClusterFieldTags`. The ctx parameter supports cancellation and timeouts.

func GetEcsClusterWithIncludeE deprecated added in v0.30.8

func GetEcsClusterWithIncludeE(t testing.TestingT, region string, name string, include []types.ClusterField) (*types.Cluster, error)

GetEcsClusterWithIncludeE fetches extended information about specified ECS cluster. The `include` parameter specifies a list of `ecs.ClusterField*` constants, such as `ecs.ClusterFieldTags`.

Deprecated: Use GetEcsClusterWithIncludeContextE instead.

func GetEcsOptimizedAmazonLinuxAmi deprecated

func GetEcsOptimizedAmazonLinuxAmi(t testing.TestingT, region string) string

GetEcsOptimizedAmazonLinuxAmi returns an Amazon ECS-Optimized Amazon Linux AMI for the given region. This AMI is useful for running an ECS cluster.

Deprecated: Use GetEcsOptimizedAmazonLinuxAmiContext instead.

func GetEcsOptimizedAmazonLinuxAmiContext added in v1.0.0

func GetEcsOptimizedAmazonLinuxAmiContext(t testing.TestingT, ctx context.Context, region string) string

GetEcsOptimizedAmazonLinuxAmiContext returns an Amazon ECS-Optimized Amazon Linux AMI for the given region. This AMI is useful for running an ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetEcsOptimizedAmazonLinuxAmiContextE added in v1.0.0

func GetEcsOptimizedAmazonLinuxAmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetEcsOptimizedAmazonLinuxAmiContextE returns an Amazon ECS-Optimized Amazon Linux AMI for the given region. This AMI is useful for running an ECS cluster. The ctx parameter supports cancellation and timeouts.

func GetEcsOptimizedAmazonLinuxAmiE deprecated

func GetEcsOptimizedAmazonLinuxAmiE(t testing.TestingT, region string) (string, error)

GetEcsOptimizedAmazonLinuxAmiE returns an Amazon ECS-Optimized Amazon Linux AMI for the given region. This AMI is useful for running an ECS cluster.

Deprecated: Use GetEcsOptimizedAmazonLinuxAmiContextE instead.

func GetEcsService deprecated added in v0.15.1

func GetEcsService(t testing.TestingT, region string, clusterName string, serviceName string) *types.Service

GetEcsService fetches information about specified ECS service.

Deprecated: Use GetEcsServiceContext instead.

func GetEcsServiceContext added in v1.0.0

func GetEcsServiceContext(t testing.TestingT, ctx context.Context, region string, clusterName string, serviceName string) *types.Service

GetEcsServiceContext fetches information about specified ECS service. The ctx parameter supports cancellation and timeouts.

func GetEcsServiceContextE added in v1.0.0

func GetEcsServiceContextE(t testing.TestingT, ctx context.Context, region string, clusterName string, serviceName string) (*types.Service, error)

GetEcsServiceContextE fetches information about specified ECS service. The ctx parameter supports cancellation and timeouts.

func GetEcsServiceE deprecated added in v0.15.1

func GetEcsServiceE(t testing.TestingT, region string, clusterName string, serviceName string) (*types.Service, error)

GetEcsServiceE fetches information about specified ECS service.

Deprecated: Use GetEcsServiceContextE instead.

func GetEcsTaskDefinition deprecated added in v0.15.1

func GetEcsTaskDefinition(t testing.TestingT, region string, taskDefinition string) *types.TaskDefinition

GetEcsTaskDefinition fetches information about specified ECS task definition.

Deprecated: Use GetEcsTaskDefinitionContext instead.

func GetEcsTaskDefinitionContext added in v1.0.0

func GetEcsTaskDefinitionContext(t testing.TestingT, ctx context.Context, region string, taskDefinition string) *types.TaskDefinition

GetEcsTaskDefinitionContext fetches information about specified ECS task definition. The ctx parameter supports cancellation and timeouts.

func GetEcsTaskDefinitionContextE added in v1.0.0

func GetEcsTaskDefinitionContextE(t testing.TestingT, ctx context.Context, region string, taskDefinition string) (*types.TaskDefinition, error)

GetEcsTaskDefinitionContextE fetches information about specified ECS task definition. The ctx parameter supports cancellation and timeouts.

func GetEcsTaskDefinitionE deprecated added in v0.15.1

func GetEcsTaskDefinitionE(t testing.TestingT, region string, taskDefinition string) (*types.TaskDefinition, error)

GetEcsTaskDefinitionE fetches information about specified ECS task definition.

Deprecated: Use GetEcsTaskDefinitionContextE instead.

func GetFirstTwoOctets

func GetFirstTwoOctets(cidrBlock string) string

GetFirstTwoOctets gets the first two octets from a CIDR block.

func GetIamCurrentUserArn deprecated

func GetIamCurrentUserArn(t testing.TestingT) string

GetIamCurrentUserArn gets the ARN for the current IAM user.

Deprecated: Use GetIamCurrentUserArnContext instead.

func GetIamCurrentUserArnContext added in v1.0.0

func GetIamCurrentUserArnContext(t testing.TestingT, ctx context.Context) string

GetIamCurrentUserArnContext gets the ARN for the current IAM user. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetIamCurrentUserArnContextE added in v1.0.0

func GetIamCurrentUserArnContextE(t testing.TestingT, ctx context.Context) (string, error)

GetIamCurrentUserArnContextE gets the ARN for the current IAM user. The ctx parameter supports cancellation and timeouts.

func GetIamCurrentUserArnE deprecated

func GetIamCurrentUserArnE(t testing.TestingT) (string, error)

GetIamCurrentUserArnE gets the ARN for the current IAM user.

Deprecated: Use GetIamCurrentUserArnContextE instead.

func GetIamCurrentUserName deprecated

func GetIamCurrentUserName(t testing.TestingT) string

GetIamCurrentUserName gets the username for the current IAM user.

Deprecated: Use GetIamCurrentUserNameContext instead.

func GetIamCurrentUserNameContext added in v1.0.0

func GetIamCurrentUserNameContext(t testing.TestingT, ctx context.Context) string

GetIamCurrentUserNameContext gets the username for the current IAM user. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetIamCurrentUserNameContextE added in v1.0.0

func GetIamCurrentUserNameContextE(t testing.TestingT, ctx context.Context) (string, error)

GetIamCurrentUserNameContextE gets the username for the current IAM user. The ctx parameter supports cancellation and timeouts.

func GetIamCurrentUserNameE deprecated

func GetIamCurrentUserNameE(t testing.TestingT) (string, error)

GetIamCurrentUserNameE gets the username for the current IAM user.

Deprecated: Use GetIamCurrentUserNameContextE instead.

func GetIamPolicyDocument deprecated added in v0.48.1

func GetIamPolicyDocument(t testing.TestingT, region string, policyARN string) string

GetIamPolicyDocument gets the most recent policy (JSON) document for an IAM policy.

Deprecated: Use GetIamPolicyDocumentContext instead.

func GetIamPolicyDocumentContext added in v1.0.0

func GetIamPolicyDocumentContext(t testing.TestingT, ctx context.Context, region string, policyARN string) string

GetIamPolicyDocumentContext gets the most recent policy (JSON) document for an IAM policy. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetIamPolicyDocumentContextE added in v1.0.0

func GetIamPolicyDocumentContextE(t testing.TestingT, ctx context.Context, region string, policyARN string) (string, error)

GetIamPolicyDocumentContextE gets the most recent policy (JSON) document for an IAM policy. The ctx parameter supports cancellation and timeouts.

func GetIamPolicyDocumentE deprecated added in v0.48.1

func GetIamPolicyDocumentE(t testing.TestingT, region string, policyARN string) (string, error)

GetIamPolicyDocumentE gets the most recent policy (JSON) document for an IAM policy.

Deprecated: Use GetIamPolicyDocumentContextE instead.

func GetInstanceIdsForAsg deprecated added in v0.9.0

func GetInstanceIdsForAsg(t testing.TestingT, asgName string, awsRegion string) []string

GetInstanceIdsForAsg gets the IDs of EC2 Instances in the given ASG.

Deprecated: Use GetInstanceIdsForAsgContext instead.

func GetInstanceIdsForAsgContext added in v1.0.0

func GetInstanceIdsForAsgContext(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) []string

GetInstanceIdsForAsgContext gets the IDs of EC2 Instances in the given ASG. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetInstanceIdsForAsgContextE added in v1.0.0

func GetInstanceIdsForAsgContextE(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) ([]string, error)

GetInstanceIdsForAsgContextE gets the IDs of EC2 Instances in the given ASG. The ctx parameter supports cancellation and timeouts.

func GetInstanceIdsForAsgE deprecated added in v0.9.0

func GetInstanceIdsForAsgE(t testing.TestingT, asgName string, awsRegion string) ([]string, error)

GetInstanceIdsForAsgE gets the IDs of EC2 Instances in the given ASG.

Deprecated: Use GetInstanceIdsForAsgContextE instead.

func GetLaunchPermissionsForAmi deprecated added in v1.0.0

func GetLaunchPermissionsForAmi(t testing.TestingT, awsRegion string, amiID string) []types.LaunchPermission

GetLaunchPermissionsForAmi returns launchPermissions as configured in AWS.

Deprecated: Use GetLaunchPermissionsForAmiContext instead.

func GetLaunchPermissionsForAmiContext added in v1.0.0

func GetLaunchPermissionsForAmiContext(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) []types.LaunchPermission

GetLaunchPermissionsForAmiContext returns launchPermissions as configured in AWS. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetLaunchPermissionsForAmiContextE added in v1.0.0

func GetLaunchPermissionsForAmiContextE(t testing.TestingT, ctx context.Context, awsRegion string, amiID string) ([]types.LaunchPermission, error)

GetLaunchPermissionsForAmiContextE returns launchPermissions as configured in AWS The ctx parameter supports cancellation and timeouts.

func GetLaunchPermissionsForAmiE deprecated added in v0.13.2

func GetLaunchPermissionsForAmiE(t testing.TestingT, awsRegion string, amiID string) ([]types.LaunchPermission, error)

GetLaunchPermissionsForAmiE returns launchPermissions as configured in AWS

Deprecated: Use GetLaunchPermissionsForAmiContextE instead.

func GetMostRecentAmiID deprecated added in v1.0.0

func GetMostRecentAmiID(t testing.TestingT, region string, ownerID string, filters map[string][]string) string

GetMostRecentAmiID gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters. Each filter should correspond to the name and values of a filter supported by DescribeImagesInput: https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeImagesInput

Deprecated: Use GetMostRecentAmiIDContext instead.

func GetMostRecentAmiIDContext added in v1.0.0

func GetMostRecentAmiIDContext(t testing.TestingT, ctx context.Context, region string, ownerID string, filters map[string][]string) string

GetMostRecentAmiIDContext gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters. Each filter should correspond to the name and values of a filter supported by DescribeImagesInput: https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeImagesInput The ctx parameter supports cancellation and timeouts.

func GetMostRecentAmiIDContextE added in v1.0.0

func GetMostRecentAmiIDContextE(t testing.TestingT, ctx context.Context, region string, ownerID string, filters map[string][]string) (string, error)

GetMostRecentAmiIDContextE gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters. Each filter should correspond to the name and values of a filter supported by DescribeImagesInput: https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeImagesInput The ctx parameter supports cancellation and timeouts.

func GetMostRecentAmiIDE deprecated added in v1.0.0

func GetMostRecentAmiIDE(t testing.TestingT, region string, ownerID string, filters map[string][]string) (string, error)

GetMostRecentAmiIDE gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters. Each filter should correspond to the name and values of a filter supported by DescribeImagesInput: https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#DescribeImagesInput

Deprecated: Use GetMostRecentAmiIDContextE instead.

func GetMostRecentAmiId deprecated

func GetMostRecentAmiId(t testing.TestingT, region string, ownerId string, filters map[string][]string) string

GetMostRecentAmiId gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters.

Deprecated: Use GetMostRecentAmiID instead.

func GetMostRecentAmiIdE deprecated

func GetMostRecentAmiIdE(t testing.TestingT, region string, ownerId string, filters map[string][]string) (string, error)

GetMostRecentAmiIdE gets the ID of the most recent AMI in the given region that has the given owner and matches the given filters.

Deprecated: Use GetMostRecentAmiIDE instead.

func GetOptionGroupNameOfRdsInstance deprecated added in v0.10.3

func GetOptionGroupNameOfRdsInstance(t testing.TestingT, dbInstanceID string, awsRegion string) string

GetOptionGroupNameOfRdsInstance gets the name of the option group associated with the RDS instance

Deprecated: Use GetOptionGroupNameOfRdsInstanceContext instead.

func GetOptionGroupNameOfRdsInstanceContext added in v1.0.0

func GetOptionGroupNameOfRdsInstanceContext(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) string

GetOptionGroupNameOfRdsInstanceContext gets the name of the option group associated with the RDS instance. The ctx parameter supports cancellation and timeouts.

func GetOptionGroupNameOfRdsInstanceContextE added in v1.0.0

func GetOptionGroupNameOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) (string, error)

GetOptionGroupNameOfRdsInstanceContextE gets the name of the option group associated with the RDS instance. The ctx parameter supports cancellation and timeouts.

func GetOptionGroupNameOfRdsInstanceE deprecated added in v0.10.3

func GetOptionGroupNameOfRdsInstanceE(t testing.TestingT, dbInstanceID string, awsRegion string) (string, error)

GetOptionGroupNameOfRdsInstanceE gets the name of the option group associated with the RDS instance

Deprecated: Use GetOptionGroupNameOfRdsInstanceContextE instead.

func GetOptionSettingForOfRdsInstance deprecated added in v0.10.3

func GetOptionSettingForOfRdsInstance(t testing.TestingT, optionName string, optionSettingName string, dbInstanceID, awsRegion string) string

GetOptionSettingForOfRdsInstance gets the value of the option name in the option group specified for the RDS instance in the given region.

Deprecated: Use GetOptionSettingForOfRdsInstanceContext instead.

func GetOptionSettingForOfRdsInstanceContext added in v1.0.0

func GetOptionSettingForOfRdsInstanceContext(t testing.TestingT, ctx context.Context, optionName string, optionSettingName string, dbInstanceID, awsRegion string) string

GetOptionSettingForOfRdsInstanceContext gets the value of the option name in the option group specified for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetOptionSettingForOfRdsInstanceContextE added in v1.0.0

func GetOptionSettingForOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, optionName string, optionSettingName string, dbInstanceID, awsRegion string) (string, error)

GetOptionSettingForOfRdsInstanceContextE gets the value of the option name in the option group specified for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetOptionSettingForOfRdsInstanceE deprecated added in v0.10.3

func GetOptionSettingForOfRdsInstanceE(t testing.TestingT, optionName string, optionSettingName string, dbInstanceID, awsRegion string) (string, error)

GetOptionSettingForOfRdsInstanceE gets the value of the option name in the option group specified for the RDS instance in the given region.

Deprecated: Use GetOptionSettingForOfRdsInstanceContextE instead.

func GetOptionsOfOptionGroup deprecated added in v0.10.3

func GetOptionsOfOptionGroup(t testing.TestingT, optionGroupName string, awsRegion string) []types.Option

GetOptionsOfOptionGroup gets the options of the option group specified

Deprecated: Use GetOptionsOfOptionGroupContext instead.

func GetOptionsOfOptionGroupContext added in v1.0.0

func GetOptionsOfOptionGroupContext(t testing.TestingT, ctx context.Context, optionGroupName string, awsRegion string) []types.Option

GetOptionsOfOptionGroupContext gets the options of the option group specified. The ctx parameter supports cancellation and timeouts.

func GetOptionsOfOptionGroupContextE added in v1.0.0

func GetOptionsOfOptionGroupContextE(t testing.TestingT, ctx context.Context, optionGroupName string, awsRegion string) ([]types.Option, error)

GetOptionsOfOptionGroupContextE gets the options of the option group specified. The ctx parameter supports cancellation and timeouts.

func GetOptionsOfOptionGroupE deprecated added in v0.10.3

func GetOptionsOfOptionGroupE(t testing.TestingT, optionGroupName string, awsRegion string) ([]types.Option, error)

GetOptionsOfOptionGroupE gets the options of the option group specified

Deprecated: Use GetOptionsOfOptionGroupContextE instead.

func GetParameter deprecated added in v0.15.3

func GetParameter(t testing.TestingT, awsRegion string, keyName string) string

GetParameter retrieves the latest version of SSM Parameter at keyName with decryption.

Deprecated: Use GetParameterContext instead.

func GetParameterContext added in v1.0.0

func GetParameterContext(t testing.TestingT, ctx context.Context, awsRegion string, keyName string) string

GetParameterContext retrieves the latest version of SSM Parameter at keyName with decryption. The ctx parameter supports cancellation and timeouts.

func GetParameterContextE added in v1.0.0

func GetParameterContextE(t testing.TestingT, ctx context.Context, awsRegion string, keyName string) (string, error)

GetParameterContextE retrieves the latest version of SSM Parameter at keyName with decryption. The ctx parameter supports cancellation and timeouts.

func GetParameterE deprecated added in v0.15.3

func GetParameterE(t testing.TestingT, awsRegion string, keyName string) (string, error)

GetParameterE retrieves the latest version of SSM Parameter at keyName with decryption.

Deprecated: Use GetParameterContextE instead.

func GetParameterValueForParameterOfRdsInstance deprecated added in v0.10.3

func GetParameterValueForParameterOfRdsInstance(t testing.TestingT, parameterName string, dbInstanceID string, awsRegion string) string

GetParameterValueForParameterOfRdsInstance gets the value of the parameter name specified for the RDS instance in the given region.

Deprecated: Use GetParameterValueForParameterOfRdsInstanceContext instead.

func GetParameterValueForParameterOfRdsInstanceContext added in v1.0.0

func GetParameterValueForParameterOfRdsInstanceContext(t testing.TestingT, ctx context.Context, parameterName string, dbInstanceID string, awsRegion string) string

GetParameterValueForParameterOfRdsInstanceContext gets the value of the parameter name specified for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetParameterValueForParameterOfRdsInstanceContextE added in v1.0.0

func GetParameterValueForParameterOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, parameterName string, dbInstanceID string, awsRegion string) (string, error)

GetParameterValueForParameterOfRdsInstanceContextE gets the value of the parameter name specified for the RDS instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetParameterValueForParameterOfRdsInstanceE deprecated added in v0.10.3

func GetParameterValueForParameterOfRdsInstanceE(t testing.TestingT, parameterName string, dbInstanceID string, awsRegion string) (string, error)

GetParameterValueForParameterOfRdsInstanceE gets the value of the parameter name specified for the RDS instance in the given region.

Deprecated: Use GetParameterValueForParameterOfRdsInstanceContextE instead.

func GetParameterWithClientContextE added in v1.0.0

func GetParameterWithClientContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, keyName string) (string, error)

GetParameterWithClientContextE retrieves the latest version of SSM Parameter at keyName with decryption with the ability to provide the SSM client. The ctx parameter supports cancellation and timeouts.

func GetParameterWithClientE deprecated added in v0.36.3

func GetParameterWithClientE(t testing.TestingT, client *ssm.Client, keyName string) (string, error)

GetParameterWithClientE retrieves the latest version of SSM Parameter at keyName with decryption with the ability to provide the SSM client.

Deprecated: Use GetParameterWithClientContextE instead.

func GetPortOfRdsInstance deprecated added in v0.10.3

func GetPortOfRdsInstance(t testing.TestingT, dbInstanceID string, awsRegion string) int32

GetPortOfRdsInstance gets the port of the given RDS Instance in the given region.

Deprecated: Use GetPortOfRdsInstanceContext instead.

func GetPortOfRdsInstanceContext added in v1.0.0

func GetPortOfRdsInstanceContext(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) int32

GetPortOfRdsInstanceContext gets the port of the given RDS Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetPortOfRdsInstanceContextE added in v1.0.0

func GetPortOfRdsInstanceContextE(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) (int32, error)

GetPortOfRdsInstanceContextE gets the port of the given RDS Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetPortOfRdsInstanceE deprecated added in v0.10.3

func GetPortOfRdsInstanceE(t testing.TestingT, dbInstanceID string, awsRegion string) (int32, error)

GetPortOfRdsInstanceE gets the port of the given RDS Instance in the given region.

Deprecated: Use GetPortOfRdsInstanceContextE instead.

func GetPrivateHostnameOfEc2Instance deprecated added in v0.13.20

func GetPrivateHostnameOfEc2Instance(t testing.TestingT, instanceID string, awsRegion string) string

GetPrivateHostnameOfEc2Instance gets the private IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPrivateHostnameOfEc2InstanceContext instead.

func GetPrivateHostnameOfEc2InstanceContext added in v1.0.0

func GetPrivateHostnameOfEc2InstanceContext(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) string

GetPrivateHostnameOfEc2InstanceContext gets the private IP address of the given EC2 Instance in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPrivateHostnameOfEc2InstanceContextE added in v1.0.0

func GetPrivateHostnameOfEc2InstanceContextE(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) (string, error)

GetPrivateHostnameOfEc2InstanceContextE gets the private IP address of the given EC2 Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetPrivateHostnameOfEc2InstanceE deprecated added in v0.13.20

func GetPrivateHostnameOfEc2InstanceE(t testing.TestingT, instanceID string, awsRegion string) (string, error)

GetPrivateHostnameOfEc2InstanceE gets the private IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPrivateHostnameOfEc2InstanceContextE instead.

func GetPrivateHostnamesOfEc2Instances deprecated added in v0.13.20

func GetPrivateHostnamesOfEc2Instances(t testing.TestingT, instanceIDs []string, awsRegion string) map[string]string

GetPrivateHostnamesOfEc2Instances gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPrivateHostnamesOfEc2InstancesContext instead.

func GetPrivateHostnamesOfEc2InstancesContext added in v1.0.0

func GetPrivateHostnamesOfEc2InstancesContext(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) map[string]string

GetPrivateHostnamesOfEc2InstancesContext gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPrivateHostnamesOfEc2InstancesContextE added in v1.0.0

func GetPrivateHostnamesOfEc2InstancesContextE(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPrivateHostnamesOfEc2InstancesContextE gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. The ctx parameter supports cancellation and timeouts.

func GetPrivateHostnamesOfEc2InstancesE deprecated added in v0.13.20

func GetPrivateHostnamesOfEc2InstancesE(t testing.TestingT, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPrivateHostnamesOfEc2InstancesE gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPrivateHostnamesOfEc2InstancesContextE instead.

func GetPrivateIPOfEc2Instance deprecated added in v1.0.0

func GetPrivateIPOfEc2Instance(t testing.TestingT, instanceID string, awsRegion string) string

GetPrivateIPOfEc2Instance gets the private IP address of the given EC2 Instance in the given region. This function will fail the test if there is an error.

Deprecated: Use GetPrivateIPOfEc2InstanceContext instead.

func GetPrivateIPOfEc2InstanceContext added in v1.0.0

func GetPrivateIPOfEc2InstanceContext(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) string

GetPrivateIPOfEc2InstanceContext gets the private IP address of the given EC2 Instance in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPrivateIPOfEc2InstanceContextE added in v1.0.0

func GetPrivateIPOfEc2InstanceContextE(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) (string, error)

GetPrivateIPOfEc2InstanceContextE gets the private IP address of the given EC2 Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetPrivateIPOfEc2InstanceE deprecated added in v1.0.0

func GetPrivateIPOfEc2InstanceE(t testing.TestingT, instanceID string, awsRegion string) (string, error)

GetPrivateIPOfEc2InstanceE gets the private IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPrivateIPOfEc2InstanceContextE instead.

func GetPrivateIpOfEc2Instance deprecated added in v0.13.18

func GetPrivateIpOfEc2Instance(t testing.TestingT, instanceID string, awsRegion string) string

GetPrivateIpOfEc2Instance gets the private IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPrivateIPOfEc2Instance instead.

func GetPrivateIpOfEc2InstanceE deprecated added in v0.13.18

func GetPrivateIpOfEc2InstanceE(t testing.TestingT, instanceID string, awsRegion string) (string, error)

GetPrivateIpOfEc2InstanceE gets the private IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPrivateIPOfEc2InstanceE instead.

func GetPrivateIpsOfEc2Instances deprecated added in v0.13.18

func GetPrivateIpsOfEc2Instances(t testing.TestingT, instanceIDs []string, awsRegion string) map[string]string

GetPrivateIpsOfEc2Instances gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPrivateIpsOfEc2InstancesContext instead.

func GetPrivateIpsOfEc2InstancesContext added in v1.0.0

func GetPrivateIpsOfEc2InstancesContext(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) map[string]string

GetPrivateIpsOfEc2InstancesContext gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPrivateIpsOfEc2InstancesContextE added in v1.0.0

func GetPrivateIpsOfEc2InstancesContextE(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPrivateIpsOfEc2InstancesContextE gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. The ctx parameter supports cancellation and timeouts.

func GetPrivateIpsOfEc2InstancesE deprecated added in v0.13.18

func GetPrivateIpsOfEc2InstancesE(t testing.TestingT, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPrivateIpsOfEc2InstancesE gets the private IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPrivateIpsOfEc2InstancesContextE instead.

func GetPublicIPOfEc2Instance deprecated added in v1.0.0

func GetPublicIPOfEc2Instance(t testing.TestingT, instanceID string, awsRegion string) string

GetPublicIPOfEc2Instance gets the public IP address of the given EC2 Instance in the given region. This function will fail the test if there is an error.

Deprecated: Use GetPublicIPOfEc2InstanceContext instead.

func GetPublicIPOfEc2InstanceContext added in v1.0.0

func GetPublicIPOfEc2InstanceContext(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) string

GetPublicIPOfEc2InstanceContext gets the public IP address of the given EC2 Instance in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPublicIPOfEc2InstanceContextE added in v1.0.0

func GetPublicIPOfEc2InstanceContextE(t testing.TestingT, ctx context.Context, instanceID string, awsRegion string) (string, error)

GetPublicIPOfEc2InstanceContextE gets the public IP address of the given EC2 Instance in the given region. The ctx parameter supports cancellation and timeouts.

func GetPublicIPOfEc2InstanceE deprecated added in v1.0.0

func GetPublicIPOfEc2InstanceE(t testing.TestingT, instanceID string, awsRegion string) (string, error)

GetPublicIPOfEc2InstanceE gets the public IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPublicIPOfEc2InstanceContextE instead.

func GetPublicIpOfEc2Instance deprecated added in v0.9.0

func GetPublicIpOfEc2Instance(t testing.TestingT, instanceID string, awsRegion string) string

GetPublicIpOfEc2Instance gets the public IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPublicIPOfEc2Instance instead.

func GetPublicIpOfEc2InstanceE deprecated added in v0.9.0

func GetPublicIpOfEc2InstanceE(t testing.TestingT, instanceID string, awsRegion string) (string, error)

GetPublicIpOfEc2InstanceE gets the public IP address of the given EC2 Instance in the given region.

Deprecated: Use GetPublicIPOfEc2InstanceE instead.

func GetPublicIpsOfEc2Instances deprecated added in v0.9.1

func GetPublicIpsOfEc2Instances(t testing.TestingT, instanceIDs []string, awsRegion string) map[string]string

GetPublicIpsOfEc2Instances gets the public IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPublicIpsOfEc2InstancesContext instead.

func GetPublicIpsOfEc2InstancesContext added in v1.0.0

func GetPublicIpsOfEc2InstancesContext(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) map[string]string

GetPublicIpsOfEc2InstancesContext gets the public IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetPublicIpsOfEc2InstancesContextE added in v1.0.0

func GetPublicIpsOfEc2InstancesContextE(t testing.TestingT, ctx context.Context, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPublicIpsOfEc2InstancesContextE gets the public IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address. The ctx parameter supports cancellation and timeouts.

func GetPublicIpsOfEc2InstancesE deprecated added in v0.9.1

func GetPublicIpsOfEc2InstancesE(t testing.TestingT, instanceIDs []string, awsRegion string) (map[string]string, error)

GetPublicIpsOfEc2InstancesE gets the public IP address of the given EC2 Instance in the given region. Returns a map of instance ID to IP address.

Deprecated: Use GetPublicIpsOfEc2InstancesContextE instead.

func GetRandomPrivateCidrBlock

func GetRandomPrivateCidrBlock(routingPrefix int) string

GetRandomPrivateCidrBlock gets a random CIDR block from the range of acceptable private IP addresses per RFC 1918 (https://tools.ietf.org/html/rfc1918#section-3) The routingPrefix refers to the "/28" in 1.2.3.4/28. Note that, as written, this function will return a subset of all valid ranges. Since we will probably use this function mostly for generating random CIDR ranges for VPCs and Subnets, having comprehensive set coverage is not essential.

func GetRandomRegion deprecated

func GetRandomRegion(t testing.TestingT, approvedRegions []string, forbiddenRegions []string) string

GetRandomRegion gets a randomly chosen AWS region. If approvedRegions is not empty, this will be a region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the AWS APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned region is not in the forbiddenRegions list.

Deprecated: Use GetRandomRegionContext instead.

func GetRandomRegionContext added in v1.0.0

func GetRandomRegionContext(t testing.TestingT, ctx context.Context, approvedRegions []string, forbiddenRegions []string) string

GetRandomRegionContext gets a randomly chosen AWS region. If approvedRegions is not empty, this will be a region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the AWS APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned region is not in the forbiddenRegions list. The ctx parameter supports cancellation and timeouts.

func GetRandomRegionContextE added in v1.0.0

func GetRandomRegionContextE(t testing.TestingT, ctx context.Context, approvedRegions []string, forbiddenRegions []string) (string, error)

GetRandomRegionContextE gets a randomly chosen AWS region. If approvedRegions is not empty, this will be a region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the AWS APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned region is not in the forbiddenRegions list. The ctx parameter supports cancellation and timeouts.

func GetRandomRegionE deprecated

func GetRandomRegionE(t testing.TestingT, approvedRegions []string, forbiddenRegions []string) (string, error)

GetRandomRegionE gets a randomly chosen AWS region. If approvedRegions is not empty, this will be a region from the approvedRegions list; otherwise, this method will fetch the latest list of regions from the AWS APIs and pick one of those. If forbiddenRegions is not empty, this method will make sure the returned region is not in the forbiddenRegions list.

Deprecated: Use GetRandomRegionContextE instead.

func GetRandomRegionForService deprecated added in v0.41.18

func GetRandomRegionForService(t testing.TestingT, serviceName string) string

GetRandomRegionForService retrieves a list of AWS regions in which a service is available Then returns one region randomly from the list

Deprecated: Use GetRandomRegionForServiceContext instead.

func GetRandomRegionForServiceContext added in v1.0.0

func GetRandomRegionForServiceContext(t testing.TestingT, ctx context.Context, serviceName string) string

GetRandomRegionForServiceContext retrieves a list of AWS regions in which a service is available Then returns one region randomly from the list. The ctx parameter supports cancellation and timeouts.

func GetRandomRegionForServiceContextE added in v1.0.0

func GetRandomRegionForServiceContextE(t testing.TestingT, ctx context.Context, serviceName string) (string, error)

GetRandomRegionForServiceContextE retrieves a list of AWS regions in which a service is available Then returns one region randomly from the list. The ctx parameter supports cancellation and timeouts.

func GetRandomRegionForServiceE deprecated added in v1.0.0

func GetRandomRegionForServiceE(t testing.TestingT, serviceName string) (string, error)

GetRandomRegionForServiceE retrieves a list of AWS regions in which a service is available Then returns one region randomly from the list and returns errors.

Deprecated: Use GetRandomRegionForServiceContextE instead.

func GetRandomStableRegion deprecated added in v0.13.16

func GetRandomStableRegion(t testing.TestingT, approvedRegions []string, forbiddenRegions []string) string

GetRandomStableRegion gets a randomly chosen AWS region that is considered stable. Like GetRandomRegion, you can further restrict the stable region list using approvedRegions and forbiddenRegions. We consider stable regions to be those that have been around for at least 1 year. Note that regions in the approvedRegions list that are not considered stable are ignored.

Deprecated: Use GetRandomStableRegionContext instead.

func GetRandomStableRegionContext added in v1.0.0

func GetRandomStableRegionContext(t testing.TestingT, ctx context.Context, approvedRegions []string, forbiddenRegions []string) string

GetRandomStableRegionContext gets a randomly chosen AWS region that is considered stable. Like GetRandomRegion, you can further restrict the stable region list using approvedRegions and forbiddenRegions. We consider stable regions to be those that have been around for at least 1 year. Note that regions in the approvedRegions list that are not considered stable are ignored. The ctx parameter supports cancellation and timeouts.

func GetRandomStableRegionContextE added in v1.0.0

func GetRandomStableRegionContextE(t testing.TestingT, ctx context.Context, approvedRegions []string, forbiddenRegions []string) (string, error)

GetRandomStableRegionContextE gets a randomly chosen AWS region that is considered stable. Like GetRandomRegion, you can further restrict the stable region list using approvedRegions and forbiddenRegions. We consider stable regions to be those that have been around for at least 1 year. Note that regions in the approvedRegions list that are not considered stable are ignored. The ctx parameter supports cancellation and timeouts.

func GetRandomStableRegionE deprecated added in v1.0.0

func GetRandomStableRegionE(t testing.TestingT, approvedRegions []string, forbiddenRegions []string) (string, error)

GetRandomStableRegionE gets a randomly chosen AWS region that is considered stable. Like GetRandomRegion, you can further restrict the stable region list using approvedRegions and forbiddenRegions. We consider stable regions to be those that have been around for at least 1 year. Note that regions in the approvedRegions list that are not considered stable are ignored.

Deprecated: Use GetRandomStableRegionContextE instead.

func GetRdsInstanceDetailsContextE added in v1.0.0

func GetRdsInstanceDetailsContextE(t testing.TestingT, ctx context.Context, dbInstanceID string, awsRegion string) (*types.DBInstance, error)

GetRdsInstanceDetailsContextE gets the details of a single DB instance whose identifier is passed. The ctx parameter supports cancellation and timeouts.

func GetRdsInstanceDetailsE deprecated added in v0.10.3

func GetRdsInstanceDetailsE(t testing.TestingT, dbInstanceID string, awsRegion string) (*types.DBInstance, error)

GetRdsInstanceDetailsE gets the details of a single DB instance whose identifier is passed.

Deprecated: Use GetRdsInstanceDetailsContextE instead.

func GetRecommendedInstanceType deprecated added in v0.28.11

func GetRecommendedInstanceType(t testing.TestingT, region string, instanceTypeOptions []string) string

GetRecommendedInstanceType takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs, and if you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function will fail the test if there is an error.

Deprecated: Use GetRecommendedInstanceTypeContext instead.

func GetRecommendedInstanceTypeContext added in v1.0.0

func GetRecommendedInstanceTypeContext(t testing.TestingT, ctx context.Context, region string, instanceTypeOptions []string) string

GetRecommendedInstanceTypeContext takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs, and if you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetRecommendedInstanceTypeContextE added in v1.0.0

func GetRecommendedInstanceTypeContextE(t testing.TestingT, ctx context.Context, region string, instanceTypeOptions []string) (string, error)

GetRecommendedInstanceTypeContextE takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. The ctx parameter supports cancellation and timeouts.

func GetRecommendedInstanceTypeE deprecated added in v0.28.11

func GetRecommendedInstanceTypeE(t testing.TestingT, region string, instanceTypeOptions []string) (string, error)

GetRecommendedInstanceTypeE takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use.

Deprecated: Use GetRecommendedInstanceTypeContextE instead.

func GetRecommendedInstanceTypeWithClient deprecated added in v1.0.0

func GetRecommendedInstanceTypeWithClient(t testing.TestingT, ec2Client *ec2.Client, instanceTypeOptions []string) string

GetRecommendedInstanceTypeWithClient takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function expects an authenticated EC2 client from the AWS SDK Go library. This function will fail the test if there is an error.

Deprecated: Use GetRecommendedInstanceTypeWithClientContext instead.

func GetRecommendedInstanceTypeWithClientContext added in v1.0.0

func GetRecommendedInstanceTypeWithClientContext(t testing.TestingT, ctx context.Context, ec2Client *ec2.Client, instanceTypeOptions []string) string

GetRecommendedInstanceTypeWithClientContext takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function expects an authenticated EC2 client from the AWS SDK Go library. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetRecommendedInstanceTypeWithClientContextE added in v1.0.0

func GetRecommendedInstanceTypeWithClientContextE(t testing.TestingT, ctx context.Context, ec2Client *ec2.Client, instanceTypeOptions []string) (string, error)

GetRecommendedInstanceTypeWithClientContextE takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function expects an authenticated EC2 client from the AWS SDK Go library. The ctx parameter supports cancellation and timeouts.

func GetRecommendedInstanceTypeWithClientE deprecated added in v0.28.15

func GetRecommendedInstanceTypeWithClientE(t testing.TestingT, ec2Client *ec2.Client, instanceTypeOptions []string) (string, error)

GetRecommendedInstanceTypeWithClientE takes in a list of EC2 instance types (e.g., "t2.micro", "t3.micro") and returns the first instance type in the list that is available in all Availability Zones (AZs) in the given region. If there's no instance available in all AZs, this function exits with an error. This is useful because certain instance types, such as t2.micro, are not available in some of the newer AZs, while t3.micro is not available in some of the older AZs. If you have code that needs to run on a "small" instance across all AZs in many different regions, you can use this function to automatically figure out which instance type you should use. This function expects an authenticated EC2 client from the AWS SDK Go library.

Deprecated: Use GetRecommendedInstanceTypeWithClientContextE instead.

func GetRecommendedRdsInstanceType deprecated added in v0.32.11

func GetRecommendedRdsInstanceType(t testing.TestingT, region string, engine string, engineVersion string, instanceTypeOptions []string) string

GetRecommendedRdsInstanceType takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will exit with an error.

Deprecated: Use GetRecommendedRdsInstanceTypeContext instead.

func GetRecommendedRdsInstanceTypeContext added in v1.0.0

func GetRecommendedRdsInstanceTypeContext(t testing.TestingT, ctx context.Context, region string, engine string, engineVersion string, instanceTypeOptions []string) string

GetRecommendedRdsInstanceTypeContext takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will exit with an error. The ctx parameter supports cancellation and timeouts.

func GetRecommendedRdsInstanceTypeContextE added in v1.0.0

func GetRecommendedRdsInstanceTypeContextE(t testing.TestingT, ctx context.Context, region string, engine string, engineVersion string, instanceTypeOptions []string) (string, error)

GetRecommendedRdsInstanceTypeContextE takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will return an error. The ctx parameter supports cancellation and timeouts.

func GetRecommendedRdsInstanceTypeE deprecated added in v0.32.11

func GetRecommendedRdsInstanceTypeE(t testing.TestingT, region string, engine string, engineVersion string, instanceTypeOptions []string) (string, error)

GetRecommendedRdsInstanceTypeE takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will return an error.

Deprecated: Use GetRecommendedRdsInstanceTypeContextE instead.

func GetRecommendedRdsInstanceTypeWithClientContextE added in v1.0.0

func GetRecommendedRdsInstanceTypeWithClientContextE(t testing.TestingT, ctx context.Context, rdsClient *rds.Client, engine string, engineVersion string, instanceTypeOptions []string) (string, error)

GetRecommendedRdsInstanceTypeWithClientContextE takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will return an error. This function expects an authenticated RDS client from the AWS SDK Go library. The ctx parameter supports cancellation and timeouts.

func GetRecommendedRdsInstanceTypeWithClientE deprecated added in v0.32.11

func GetRecommendedRdsInstanceTypeWithClientE(t testing.TestingT, rdsClient *rds.Client, engine string, engineVersion string, instanceTypeOptions []string) (string, error)

GetRecommendedRdsInstanceTypeWithClientE takes in a list of RDS instance types (e.g., "db.t2.micro", "db.t3.micro") and returns the first instance type in the list that is available in the given region and for the given database engine type. If none of the instances provided are available for your combination of region and database engine, this function will return an error. This function expects an authenticated RDS client from the AWS SDK Go library.

Deprecated: Use GetRecommendedRdsInstanceTypeWithClientContextE instead.

func GetRegionsForService deprecated added in v0.41.18

func GetRegionsForService(t testing.TestingT, serviceName string) []string

GetRegionsForService gets all AWS regions in which a service is available.

Deprecated: Use GetRegionsForServiceContext instead.

func GetRegionsForServiceContext added in v1.0.0

func GetRegionsForServiceContext(t testing.TestingT, ctx context.Context, serviceName string) []string

GetRegionsForServiceContext gets all AWS regions in which a service is available. The ctx parameter supports cancellation and timeouts.

func GetRegionsForServiceContextE added in v1.0.0

func GetRegionsForServiceContextE(t testing.TestingT, ctx context.Context, serviceName string) ([]string, error)

GetRegionsForServiceContextE gets all AWS regions in which a service is available and returns errors. See https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-global-infrastructure.html The ctx parameter supports cancellation and timeouts.

func GetRegionsForServiceE deprecated added in v0.41.18

func GetRegionsForServiceE(t testing.TestingT, serviceName string) ([]string, error)

GetRegionsForServiceE gets all AWS regions in which a service is available and returns errors. See https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-global-infrastructure.html

Deprecated: Use GetRegionsForServiceContextE instead.

func GetRoute53Record deprecated added in v0.47.1

func GetRoute53Record(t ttesting.TestingT, hostedZoneID, recordName, recordType, awsRegion string) *types.ResourceRecordSet

GetRoute53Record returns a Route 53 Record.

Deprecated: Use GetRoute53RecordContext instead.

func GetRoute53RecordContext added in v1.0.0

func GetRoute53RecordContext(t ttesting.TestingT, ctx context.Context, hostedZoneID, recordName, recordType, awsRegion string) *types.ResourceRecordSet

GetRoute53RecordContext returns a Route 53 Record. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetRoute53RecordContextE added in v1.0.0

func GetRoute53RecordContextE(t ttesting.TestingT, ctx context.Context, hostedZoneID, recordName, recordType, awsRegion string) (*types.ResourceRecordSet, error)

GetRoute53RecordContextE returns a Route 53 Record. The ctx parameter supports cancellation and timeouts.

func GetRoute53RecordE deprecated added in v0.47.1

func GetRoute53RecordE(t ttesting.TestingT, hostedZoneID, recordName, recordType, awsRegion string) (*types.ResourceRecordSet, error)

GetRoute53RecordE returns a Route 53 Record.

Deprecated: Use GetRoute53RecordContextE instead.

func GetS3BucketLoggingTarget deprecated added in v0.30.22

func GetS3BucketLoggingTarget(t testing.TestingT, awsRegion string, bucket string) string

GetS3BucketLoggingTarget fetches the given bucket's logging target bucket and returns it as a string

Deprecated: Use GetS3BucketLoggingTargetContext instead.

func GetS3BucketLoggingTargetContext added in v1.0.0

func GetS3BucketLoggingTargetContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) string

GetS3BucketLoggingTargetContext fetches the given bucket's logging target bucket and returns it as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketLoggingTargetContextE added in v1.0.0

func GetS3BucketLoggingTargetContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) (string, error)

GetS3BucketLoggingTargetContextE fetches the given bucket's logging target bucket and returns it as the following string: `TargetBucket` of the `LoggingEnabled` property for an S3 bucket. The ctx parameter supports cancellation and timeouts.

func GetS3BucketLoggingTargetE deprecated added in v0.30.22

func GetS3BucketLoggingTargetE(t testing.TestingT, awsRegion string, bucket string) (string, error)

GetS3BucketLoggingTargetE fetches the given bucket's logging target bucket and returns it as the following string: `TargetBucket` of the `LoggingEnabled` property for an S3 bucket

Deprecated: Use GetS3BucketLoggingTargetContextE instead.

func GetS3BucketLoggingTargetPrefix deprecated added in v0.32.4

func GetS3BucketLoggingTargetPrefix(t testing.TestingT, awsRegion string, bucket string) string

GetS3BucketLoggingTargetPrefix fetches the given bucket's logging object prefix and returns it as a string

Deprecated: Use GetS3BucketLoggingTargetPrefixContext instead.

func GetS3BucketLoggingTargetPrefixContext added in v1.0.0

func GetS3BucketLoggingTargetPrefixContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) string

GetS3BucketLoggingTargetPrefixContext fetches the given bucket's logging object prefix and returns it as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketLoggingTargetPrefixContextE added in v1.0.0

func GetS3BucketLoggingTargetPrefixContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) (string, error)

GetS3BucketLoggingTargetPrefixContextE fetches the given bucket's logging object prefix and returns it as the following string: `TargetPrefix` of the `LoggingEnabled` property for an S3 bucket. The ctx parameter supports cancellation and timeouts.

func GetS3BucketLoggingTargetPrefixE deprecated added in v0.32.4

func GetS3BucketLoggingTargetPrefixE(t testing.TestingT, awsRegion string, bucket string) (string, error)

GetS3BucketLoggingTargetPrefixE fetches the given bucket's logging object prefix and returns it as the following string: `TargetPrefix` of the `LoggingEnabled` property for an S3 bucket

Deprecated: Use GetS3BucketLoggingTargetPrefixContextE instead.

func GetS3BucketOwnershipControls deprecated added in v0.48.2

func GetS3BucketOwnershipControls(t testing.TestingT, awsRegion, bucket string) []string

GetS3BucketOwnershipControls fetches the given bucket's ownership controls and returns them as a slice of strings.

Deprecated: Use GetS3BucketOwnershipControlsContext instead.

func GetS3BucketOwnershipControlsContext added in v1.0.0

func GetS3BucketOwnershipControlsContext(t testing.TestingT, ctx context.Context, awsRegion, bucket string) []string

GetS3BucketOwnershipControlsContext fetches the given bucket's ownership controls and returns them as a slice of strings. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketOwnershipControlsContextE added in v1.0.0

func GetS3BucketOwnershipControlsContextE(t testing.TestingT, ctx context.Context, awsRegion, bucket string) ([]string, error)

GetS3BucketOwnershipControlsContextE fetches the given bucket's ownership controls and returns them as a slice of strings. The ctx parameter supports cancellation and timeouts.

func GetS3BucketOwnershipControlsE deprecated added in v0.48.2

func GetS3BucketOwnershipControlsE(t testing.TestingT, awsRegion, bucket string) ([]string, error)

GetS3BucketOwnershipControlsE fetches the given bucket's ownership controls and returns them as a slice of strings.

Deprecated: Use GetS3BucketOwnershipControlsContextE instead.

func GetS3BucketPolicy deprecated added in v0.15.5

func GetS3BucketPolicy(t testing.TestingT, awsRegion string, bucket string) string

GetS3BucketPolicy fetches the given bucket's resource policy and returns it as a string

Deprecated: Use GetS3BucketPolicyContext instead.

func GetS3BucketPolicyContext added in v1.0.0

func GetS3BucketPolicyContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) string

GetS3BucketPolicyContext fetches the given bucket's resource policy and returns it as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketPolicyContextE added in v1.0.0

func GetS3BucketPolicyContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) (string, error)

GetS3BucketPolicyContextE fetches the given bucket's resource policy and returns it as a string. The ctx parameter supports cancellation and timeouts.

func GetS3BucketPolicyE deprecated added in v0.15.5

func GetS3BucketPolicyE(t testing.TestingT, awsRegion string, bucket string) (string, error)

GetS3BucketPolicyE fetches the given bucket's resource policy and returns it as a string

Deprecated: Use GetS3BucketPolicyContextE instead.

func GetS3BucketTags deprecated added in v0.37.13

func GetS3BucketTags(t testing.TestingT, awsRegion string, bucket string) map[string]string

GetS3BucketTags fetches the given bucket's tags and returns them as a string map of strings.

Deprecated: Use GetS3BucketTagsContext instead.

func GetS3BucketTagsContext added in v1.0.0

func GetS3BucketTagsContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) map[string]string

GetS3BucketTagsContext fetches the given bucket's tags and returns them as a string map of strings. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketTagsContextE added in v1.0.0

func GetS3BucketTagsContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) (map[string]string, error)

GetS3BucketTagsContextE fetches the given bucket's tags and returns them as a string map of strings. The ctx parameter supports cancellation and timeouts.

func GetS3BucketTagsE deprecated added in v0.37.13

func GetS3BucketTagsE(t testing.TestingT, awsRegion string, bucket string) (map[string]string, error)

GetS3BucketTagsE fetches the given bucket's tags and returns them as a string map of strings.

Deprecated: Use GetS3BucketTagsContextE instead.

func GetS3BucketVersioning deprecated added in v0.15.4

func GetS3BucketVersioning(t testing.TestingT, awsRegion string, bucket string) string

GetS3BucketVersioning fetches the given bucket's versioning configuration status and returns it as a string

Deprecated: Use GetS3BucketVersioningContext instead.

func GetS3BucketVersioningContext added in v1.0.0

func GetS3BucketVersioningContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) string

GetS3BucketVersioningContext fetches the given bucket's versioning configuration status and returns it as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3BucketVersioningContextE added in v1.0.0

func GetS3BucketVersioningContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string) (string, error)

GetS3BucketVersioningContextE fetches the given bucket's versioning configuration status and returns it as a string. The ctx parameter supports cancellation and timeouts.

func GetS3BucketVersioningE deprecated added in v0.15.4

func GetS3BucketVersioningE(t testing.TestingT, awsRegion string, bucket string) (string, error)

GetS3BucketVersioningE fetches the given bucket's versioning configuration status and returns it as a string

Deprecated: Use GetS3BucketVersioningContextE instead.

func GetS3ObjectContents deprecated

func GetS3ObjectContents(t testing.TestingT, awsRegion string, bucket string, key string) string

GetS3ObjectContents fetches the contents of the object in the given bucket with the given key and return it as a string.

Deprecated: Use GetS3ObjectContentsContext instead.

func GetS3ObjectContentsContext added in v1.0.0

func GetS3ObjectContentsContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string, key string) string

GetS3ObjectContentsContext fetches the contents of the object in the given bucket with the given key and return it as a string. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetS3ObjectContentsContextE added in v1.0.0

func GetS3ObjectContentsContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string, key string) (string, error)

GetS3ObjectContentsContextE fetches the contents of the object in the given bucket with the given key and return it as a string. The ctx parameter supports cancellation and timeouts.

func GetS3ObjectContentsE deprecated

func GetS3ObjectContentsE(t testing.TestingT, awsRegion string, bucket string, key string) (string, error)

GetS3ObjectContentsE fetches the contents of the object in the given bucket with the given key and return it as a string.

Deprecated: Use GetS3ObjectContentsContextE instead.

func GetSecretValue deprecated added in v0.28.12

func GetSecretValue(t testing.TestingT, awsRegion, id string) string

GetSecretValue takes the friendly name or ARN of a secret and returns the plaintext value

Deprecated: Use GetSecretValueContext instead.

func GetSecretValueContext added in v1.0.0

func GetSecretValueContext(t testing.TestingT, ctx context.Context, awsRegion, id string) string

GetSecretValueContext takes the friendly name or ARN of a secret and returns the plaintext value. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetSecretValueContextE added in v1.0.0

func GetSecretValueContextE(t testing.TestingT, ctx context.Context, awsRegion, id string) (string, error)

GetSecretValueContextE takes the friendly name or ARN of a secret and returns the plaintext value. The ctx parameter supports cancellation and timeouts.

func GetSecretValueE deprecated added in v0.28.12

func GetSecretValueE(t testing.TestingT, awsRegion, id string) (string, error)

GetSecretValueE takes the friendly name or ARN of a secret and returns the plaintext value

Deprecated: Use GetSecretValueContextE instead.

func GetSyslogForInstance deprecated

func GetSyslogForInstance(t testing.TestingT, instanceID string, awsRegion string) string

GetSyslogForInstance (Deprecated) See the FetchContentsOfFileFromInstance method for a more powerful solution.

GetSyslogForInstance gets the syslog for the Instance with the given ID in the given region. This should be available ~1 minute after an Instance boots and is very useful for debugging boot-time issues, such as an error in User Data.

Deprecated: Use GetSyslogForInstanceContext instead.

func GetSyslogForInstanceContext added in v1.0.0

func GetSyslogForInstanceContext(t testing.TestingT, ctx context.Context, instanceID string, region string) string

GetSyslogForInstanceContext gets the syslog for the Instance with the given ID in the given region. This should be available ~1 minute after an Instance boots and is very useful for debugging boot-time issues, such as an error in User Data. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetSyslogForInstanceContextE added in v1.0.0

func GetSyslogForInstanceContextE(t testing.TestingT, ctx context.Context, instanceID string, region string) (string, error)

GetSyslogForInstanceContextE gets the syslog for the Instance with the given ID in the given region. This should be available ~1 minute after an Instance boots and is very useful for debugging boot-time issues, such as an error in User Data. The ctx parameter supports cancellation and timeouts.

func GetSyslogForInstanceE deprecated

func GetSyslogForInstanceE(t testing.TestingT, instanceID string, region string) (string, error)

GetSyslogForInstanceE (Deprecated) See the FetchContentsOfFileFromInstanceE method for a more powerful solution.

GetSyslogForInstanceE gets the syslog for the Instance with the given ID in the given region. This should be available ~1 minute after an Instance boots and is very useful for debugging boot-time issues, such as an error in User Data.

Deprecated: Use GetSyslogForInstanceContextE instead.

func GetSyslogForInstanceWithClientContextE added in v1.0.0

func GetSyslogForInstanceWithClientContextE(t testing.TestingT, ctx context.Context, client Ec2SyslogAPI, instanceID string) (string, error)

GetSyslogForInstanceWithClientContextE fetches the base64-decoded console output for the given instance using the provided EC2 client. Returns an empty string without error when the syslog is not yet available — callers that want retry-until-available semantics should wrap this call in retry logic (see GetSyslogForInstanceContextE for the canonical usage). The ctx parameter supports cancellation and timeouts.

func GetSyslogForInstancesInAsg deprecated

func GetSyslogForInstancesInAsg(t testing.TestingT, asgName string, awsRegion string) map[string]string

GetSyslogForInstancesInAsg (Deprecated) See the FetchContentsOfFilesFromAsg method for a more powerful solution.

GetSyslogForInstancesInAsg gets the syslog for each of the Instances in the given ASG in the given region. These logs should be available ~1 minute after the Instance boots and are very useful for debugging boot-time issues, such as an error in User Data. Returns a map of Instance ID -> Syslog for that Instance.

Deprecated: Use GetSyslogForInstancesInAsgContext instead.

func GetSyslogForInstancesInAsgContext added in v1.0.0

func GetSyslogForInstancesInAsgContext(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) map[string]string

GetSyslogForInstancesInAsgContext gets the syslog for each of the Instances in the given ASG in the given region. These logs should be available ~1 minute after the Instance boots and are very useful for debugging boot-time issues, such as an error in User Data. Returns a map of Instance ID -> Syslog for that Instance. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetSyslogForInstancesInAsgContextE added in v1.0.0

func GetSyslogForInstancesInAsgContextE(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) (map[string]string, error)

GetSyslogForInstancesInAsgContextE gets the syslog for each of the Instances in the given ASG in the given region. These logs should be available ~1 minute after the Instance boots and are very useful for debugging boot-time issues, such as an error in User Data. Returns a map of Instance ID -> Syslog for that Instance. The ctx parameter supports cancellation and timeouts.

func GetSyslogForInstancesInAsgE deprecated

func GetSyslogForInstancesInAsgE(t testing.TestingT, asgName string, awsRegion string) (map[string]string, error)

GetSyslogForInstancesInAsgE (Deprecated) See the FetchContentsOfFilesFromAsgE method for a more powerful solution.

GetSyslogForInstancesInAsgE gets the syslog for each of the Instances in the given ASG in the given region. These logs should be available ~1 minute after the Instance boots and are very useful for debugging boot-time issues, such as an error in User Data. Returns a map of Instance ID -> Syslog for that Instance.

Deprecated: Use GetSyslogForInstancesInAsgContextE instead.

func GetTagsForEc2Instance deprecated

func GetTagsForEc2Instance(t testing.TestingT, region string, instanceID string) map[string]string

GetTagsForEc2Instance returns all the tags for the given EC2 Instance.

Deprecated: Use GetTagsForEc2InstanceContext instead.

func GetTagsForEc2InstanceContext added in v1.0.0

func GetTagsForEc2InstanceContext(t testing.TestingT, ctx context.Context, region string, instanceID string) map[string]string

GetTagsForEc2InstanceContext returns all the tags for the given EC2 Instance. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetTagsForEc2InstanceContextE added in v1.0.0

func GetTagsForEc2InstanceContextE(t testing.TestingT, ctx context.Context, region string, instanceID string) (map[string]string, error)

GetTagsForEc2InstanceContextE returns all the tags for the given EC2 Instance. The ctx parameter supports cancellation and timeouts.

func GetTagsForEc2InstanceE deprecated

func GetTagsForEc2InstanceE(t testing.TestingT, region string, instanceID string) (map[string]string, error)

GetTagsForEc2InstanceE returns all the tags for the given EC2 Instance.

Deprecated: Use GetTagsForEc2InstanceContextE instead.

func GetTagsForSubnet deprecated added in v0.38.3

func GetTagsForSubnet(t testing.TestingT, subnetID string, region string) map[string]string

GetTagsForSubnet gets the tags for the specified subnet.

Deprecated: Use GetTagsForSubnetContext instead.

func GetTagsForSubnetContext added in v1.0.0

func GetTagsForSubnetContext(t testing.TestingT, ctx context.Context, subnetID string, region string) map[string]string

GetTagsForSubnetContext gets the tags for the specified subnet. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetTagsForSubnetContextE added in v1.0.0

func GetTagsForSubnetContextE(t testing.TestingT, ctx context.Context, subnetID string, region string) (map[string]string, error)

GetTagsForSubnetContextE gets the tags for the specified subnet. The ctx parameter supports cancellation and timeouts.

func GetTagsForSubnetE deprecated added in v0.38.3

func GetTagsForSubnetE(t testing.TestingT, subnetID string, region string) (map[string]string, error)

GetTagsForSubnetE gets the tags for the specified subnet.

Deprecated: Use GetTagsForSubnetContextE instead.

func GetTagsForVpc deprecated added in v0.37.12

func GetTagsForVpc(t testing.TestingT, vpcID string, region string) map[string]string

GetTagsForVpc gets the tags for the specified VPC.

Deprecated: Use GetTagsForVpcContext instead.

func GetTagsForVpcContext added in v1.0.0

func GetTagsForVpcContext(t testing.TestingT, ctx context.Context, vpcID string, region string) map[string]string

GetTagsForVpcContext gets the tags for the specified VPC. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetTagsForVpcContextE added in v1.0.0

func GetTagsForVpcContextE(t testing.TestingT, ctx context.Context, vpcID string, region string) (map[string]string, error)

GetTagsForVpcContextE gets the tags for the specified VPC. The ctx parameter supports cancellation and timeouts.

func GetTagsForVpcE deprecated added in v0.37.12

func GetTagsForVpcE(t testing.TestingT, vpcID string, region string) (map[string]string, error)

GetTagsForVpcE gets the tags for the specified VPC.

Deprecated: Use GetTagsForVpcContextE instead.

func GetTimeBasedOneTimePassword

func GetTimeBasedOneTimePassword(mfaDevice *types.VirtualMFADevice) (string, error)

GetTimeBasedOneTimePassword gets a One-Time Password from the given mfaDevice. Per the RFC 6238 standard, this value will be different every 30 seconds.

func GetUbuntu1404Ami deprecated

func GetUbuntu1404Ami(t testing.TestingT, region string) string

GetUbuntu1404Ami gets the ID of the most recent Ubuntu 14.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu1404AmiContext instead.

func GetUbuntu1404AmiContext added in v1.0.0

func GetUbuntu1404AmiContext(t testing.TestingT, ctx context.Context, region string) string

GetUbuntu1404AmiContext gets the ID of the most recent Ubuntu 14.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu1404AmiContextE added in v1.0.0

func GetUbuntu1404AmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetUbuntu1404AmiContextE gets the ID of the most recent Ubuntu 14.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu1404AmiE deprecated

func GetUbuntu1404AmiE(t testing.TestingT, region string) (string, error)

GetUbuntu1404AmiE gets the ID of the most recent Ubuntu 14.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu1404AmiContextE instead.

func GetUbuntu1604Ami deprecated

func GetUbuntu1604Ami(t testing.TestingT, region string) string

GetUbuntu1604Ami gets the ID of the most recent Ubuntu 16.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu1604AmiContext instead.

func GetUbuntu1604AmiContext added in v1.0.0

func GetUbuntu1604AmiContext(t testing.TestingT, ctx context.Context, region string) string

GetUbuntu1604AmiContext gets the ID of the most recent Ubuntu 16.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu1604AmiContextE added in v1.0.0

func GetUbuntu1604AmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetUbuntu1604AmiContextE gets the ID of the most recent Ubuntu 16.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu1604AmiE deprecated

func GetUbuntu1604AmiE(t testing.TestingT, region string) (string, error)

GetUbuntu1604AmiE gets the ID of the most recent Ubuntu 16.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu1604AmiContextE instead.

func GetUbuntu2004Ami deprecated added in v0.44.1

func GetUbuntu2004Ami(t testing.TestingT, region string) string

GetUbuntu2004Ami gets the ID of the most recent Ubuntu 20.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu2004AmiContext instead.

func GetUbuntu2004AmiContext added in v1.0.0

func GetUbuntu2004AmiContext(t testing.TestingT, ctx context.Context, region string) string

GetUbuntu2004AmiContext gets the ID of the most recent Ubuntu 20.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu2004AmiContextE added in v1.0.0

func GetUbuntu2004AmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetUbuntu2004AmiContextE gets the ID of the most recent Ubuntu 20.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu2004AmiE deprecated added in v0.44.1

func GetUbuntu2004AmiE(t testing.TestingT, region string) (string, error)

GetUbuntu2004AmiE gets the ID of the most recent Ubuntu 20.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu2004AmiContextE instead.

func GetUbuntu2204Ami deprecated added in v0.44.1

func GetUbuntu2204Ami(t testing.TestingT, region string) string

GetUbuntu2204Ami gets the ID of the most recent Ubuntu 22.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu2204AmiContext instead.

func GetUbuntu2204AmiContext added in v1.0.0

func GetUbuntu2204AmiContext(t testing.TestingT, ctx context.Context, region string) string

GetUbuntu2204AmiContext gets the ID of the most recent Ubuntu 22.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu2204AmiContextE added in v1.0.0

func GetUbuntu2204AmiContextE(t testing.TestingT, ctx context.Context, region string) (string, error)

GetUbuntu2204AmiContextE gets the ID of the most recent Ubuntu 22.04 HVM x86_64 EBS GP2 AMI in the given region. The ctx parameter supports cancellation and timeouts.

func GetUbuntu2204AmiE deprecated added in v0.44.1

func GetUbuntu2204AmiE(t testing.TestingT, region string) (string, error)

GetUbuntu2204AmiE gets the ID of the most recent Ubuntu 22.04 HVM x86_64 EBS GP2 AMI in the given region.

Deprecated: Use GetUbuntu2204AmiContextE instead.

func GetValidEngineVersion deprecated added in v0.41.20

func GetValidEngineVersion(t testing.TestingT, region string, engine string, majorVersion string) string

GetValidEngineVersion returns a string containing a valid RDS engine version for the provided region and engine type. This function will fail the test if no valid engine is found.

Deprecated: Use GetValidEngineVersionContext instead.

func GetValidEngineVersionContext added in v1.0.0

func GetValidEngineVersionContext(t testing.TestingT, ctx context.Context, region string, engine string, majorVersion string) string

GetValidEngineVersionContext returns a string containing a valid RDS engine version for the provided region and engine type. This function will fail the test if no valid engine is found. The ctx parameter supports cancellation and timeouts.

func GetValidEngineVersionContextE added in v1.0.0

func GetValidEngineVersionContextE(t testing.TestingT, ctx context.Context, region string, engine string, majorVersion string) (string, error)

GetValidEngineVersionContextE returns a string containing a valid RDS engine version or an error if no valid version is found. The ctx parameter supports cancellation and timeouts.

func GetValidEngineVersionE deprecated added in v0.41.20

func GetValidEngineVersionE(t testing.TestingT, region string, engine string, majorVersion string) (string, error)

GetValidEngineVersionE returns a string containing a valid RDS engine version or an error if no valid version is found.

Deprecated: Use GetValidEngineVersionContextE instead.

func GetWhetherSchemaExistsInRdsMySQLInstance deprecated added in v1.0.0

func GetWhetherSchemaExistsInRdsMySQLInstance(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) bool

GetWhetherSchemaExistsInRdsMySQLInstance checks whether the specified schema/table name exists in the RDS MySQL instance.

Deprecated: Use GetWhetherSchemaExistsInRdsMySQLInstanceContext instead.

func GetWhetherSchemaExistsInRdsMySQLInstanceContext added in v1.0.0

func GetWhetherSchemaExistsInRdsMySQLInstanceContext(t testing.TestingT, ctx context.Context, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) bool

GetWhetherSchemaExistsInRdsMySQLInstanceContext checks whether the specified schema/table name exists in the RDS MySQL instance. The ctx parameter supports cancellation and timeouts.

func GetWhetherSchemaExistsInRdsMySQLInstanceContextE added in v1.0.0

func GetWhetherSchemaExistsInRdsMySQLInstanceContextE(t testing.TestingT, ctx context.Context, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) (bool, error)

GetWhetherSchemaExistsInRdsMySQLInstanceContextE checks whether the specified schema/table name exists in the RDS MySQL instance. The ctx parameter supports cancellation and timeouts.

func GetWhetherSchemaExistsInRdsMySQLInstanceE deprecated added in v1.0.0

func GetWhetherSchemaExistsInRdsMySQLInstanceE(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) (bool, error)

GetWhetherSchemaExistsInRdsMySQLInstanceE checks whether the specified schema/table name exists in the RDS MySQL instance.

Deprecated: Use GetWhetherSchemaExistsInRdsMySQLInstanceContextE instead.

func GetWhetherSchemaExistsInRdsMySqlInstance deprecated added in v0.10.3

func GetWhetherSchemaExistsInRdsMySqlInstance(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) bool

GetWhetherSchemaExistsInRdsMySqlInstance checks whether the specified schema/table name exists in the RDS MySQL instance.

Deprecated: Use GetWhetherSchemaExistsInRdsMySQLInstanceContext instead.

func GetWhetherSchemaExistsInRdsMySqlInstanceE deprecated added in v0.10.3

func GetWhetherSchemaExistsInRdsMySqlInstanceE(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) (bool, error)

GetWhetherSchemaExistsInRdsMySqlInstanceE checks whether the specified schema/table name exists in the RDS MySQL instance.

Deprecated: Use GetWhetherSchemaExistsInRdsMySQLInstanceContextE instead.

func GetWhetherSchemaExistsInRdsPostgresInstance deprecated added in v0.48.0

func GetWhetherSchemaExistsInRdsPostgresInstance(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) bool

GetWhetherSchemaExistsInRdsPostgresInstance checks whether the specified schema/table name exists in the RDS Postgres instance.

Deprecated: Use GetWhetherSchemaExistsInRdsPostgresInstanceContext instead.

func GetWhetherSchemaExistsInRdsPostgresInstanceContext added in v1.0.0

func GetWhetherSchemaExistsInRdsPostgresInstanceContext(t testing.TestingT, ctx context.Context, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) bool

GetWhetherSchemaExistsInRdsPostgresInstanceContext checks whether the specified schema/table name exists in the RDS Postgres instance. The ctx parameter supports cancellation and timeouts.

func GetWhetherSchemaExistsInRdsPostgresInstanceContextE added in v1.0.0

func GetWhetherSchemaExistsInRdsPostgresInstanceContextE(t testing.TestingT, ctx context.Context, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) (bool, error)

GetWhetherSchemaExistsInRdsPostgresInstanceContextE checks whether the specified schema/table name exists in the RDS Postgres instance. The ctx parameter supports cancellation and timeouts.

func GetWhetherSchemaExistsInRdsPostgresInstanceE deprecated added in v0.48.0

func GetWhetherSchemaExistsInRdsPostgresInstanceE(t testing.TestingT, dbURL string, dbPort int32, dbUsername string, dbPassword string, expectedSchemaName string) (bool, error)

GetWhetherSchemaExistsInRdsPostgresInstanceE checks whether the specified schema/table name exists in the RDS Postgres instance.

Deprecated: Use GetWhetherSchemaExistsInRdsPostgresInstanceContextE instead.

func InvokeFunction deprecated added in v0.24.1

func InvokeFunction(t testing.TestingT, region, functionName string, payload any) []byte

InvokeFunction invokes a lambda function.

Deprecated: Use InvokeFunctionContext instead.

func InvokeFunctionContext added in v1.0.0

func InvokeFunctionContext(t testing.TestingT, ctx context.Context, region, functionName string, payload any) []byte

InvokeFunctionContext invokes a lambda function. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func InvokeFunctionContextE added in v1.0.0

func InvokeFunctionContextE(t testing.TestingT, ctx context.Context, region, functionName string, payload any) ([]byte, error)

InvokeFunctionContextE invokes a lambda function. The ctx parameter supports cancellation and timeouts.

func InvokeFunctionE deprecated added in v0.24.1

func InvokeFunctionE(t testing.TestingT, region, functionName string, payload any) ([]byte, error)

InvokeFunctionE invokes a lambda function.

Deprecated: Use InvokeFunctionContextE instead.

func IsPublicSubnet deprecated added in v0.19.3

func IsPublicSubnet(t testing.TestingT, subnetID string, region string) bool

IsPublicSubnet returns True if the subnet identified by the given id in the provided region is public.

Deprecated: Use IsPublicSubnetContext instead.

func IsPublicSubnetContext added in v1.0.0

func IsPublicSubnetContext(t testing.TestingT, ctx context.Context, subnetID string, region string) bool

IsPublicSubnetContext returns True if the subnet identified by the given id in the provided region is public. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func IsPublicSubnetContextE added in v1.0.0

func IsPublicSubnetContextE(t testing.TestingT, ctx context.Context, subnetID string, region string) (bool, error)

IsPublicSubnetContextE returns True if the subnet identified by the given id in the provided region is public. The ctx parameter supports cancellation and timeouts.

func IsPublicSubnetE deprecated added in v0.19.3

func IsPublicSubnetE(t testing.TestingT, subnetID string, region string) (bool, error)

IsPublicSubnetE returns True if the subnet identified by the given id in the provided region is public.

Deprecated: Use IsPublicSubnetContextE instead.

func NewAcmClient deprecated

func NewAcmClient(t testing.TestingT, region string) *acm.Client

NewAcmClient creates a new ACM client.

Deprecated: Use NewAcmClientContext instead.

func NewAcmClientContext added in v1.0.0

func NewAcmClientContext(t testing.TestingT, ctx context.Context, region string) *acm.Client

NewAcmClientContext creates a new ACM client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewAcmClientContextE added in v1.0.0

func NewAcmClientContextE(t testing.TestingT, ctx context.Context, region string) (*acm.Client, error)

NewAcmClientContextE creates a new ACM client. The ctx parameter supports cancellation and timeouts.

func NewAcmClientE deprecated added in v0.9.0

func NewAcmClientE(t testing.TestingT, awsRegion string) (*acm.Client, error)

NewAcmClientE creates a new ACM client.

Deprecated: Use NewAcmClientContextE instead.

func NewAsgClient deprecated added in v0.9.0

func NewAsgClient(t testing.TestingT, region string) *autoscaling.Client

NewAsgClient creates an Auto Scaling Group client.

Deprecated: Use NewAsgClientContext instead.

func NewAsgClientContext added in v1.0.0

func NewAsgClientContext(t testing.TestingT, ctx context.Context, region string) *autoscaling.Client

NewAsgClientContext creates an Auto Scaling Group client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewAsgClientContextE added in v1.0.0

func NewAsgClientContextE(t testing.TestingT, ctx context.Context, region string) (*autoscaling.Client, error)

NewAsgClientContextE creates an Auto Scaling Group client. The ctx parameter supports cancellation and timeouts.

func NewAsgClientE deprecated added in v0.9.0

func NewAsgClientE(t testing.TestingT, region string) (*autoscaling.Client, error)

NewAsgClientE creates an Auto Scaling Group client.

Deprecated: Use NewAsgClientContextE instead.

func NewAuthenticatedSession deprecated

func NewAuthenticatedSession(region string) (*aws.Config, error)

NewAuthenticatedSession creates an AWS Config following to standard AWS authentication workflow. If AuthAssumeIamRoleEnvVar environment variable is set, assumes IAM role specified in it.

Deprecated: Use NewAuthenticatedSessionContext instead.

func NewAuthenticatedSessionContext added in v1.0.0

func NewAuthenticatedSessionContext(ctx context.Context, region string) (*aws.Config, error)

NewAuthenticatedSessionContext creates an AWS Config following to standard AWS authentication workflow. If AuthAssumeIamRoleEnvVar environment variable is set, assumes IAM role specified in it. The ctx parameter supports cancellation and timeouts.

func NewAuthenticatedSessionFromDefaultCredentials deprecated added in v0.16.1

func NewAuthenticatedSessionFromDefaultCredentials(region string) (*aws.Config, error)

NewAuthenticatedSessionFromDefaultCredentials gets an AWS Config, checking that the user has credentials properly configured in their environment.

Deprecated: Use NewAuthenticatedSessionFromDefaultCredentialsContext instead.

func NewAuthenticatedSessionFromDefaultCredentialsContext added in v1.0.0

func NewAuthenticatedSessionFromDefaultCredentialsContext(ctx context.Context, region string) (*aws.Config, error)

NewAuthenticatedSessionFromDefaultCredentialsContext gets an AWS Config, checking that the user has credentials properly configured in their environment. The ctx parameter supports cancellation and timeouts.

func NewAuthenticatedSessionFromRole deprecated added in v0.9.3

func NewAuthenticatedSessionFromRole(region string, roleARN string) (*aws.Config, error)

NewAuthenticatedSessionFromRole returns a new AWS Config after assuming the role whose ARN is provided in roleARN. If the credentials are not properly configured in the underlying environment, an error is returned.

Deprecated: Use NewAuthenticatedSessionFromRoleContext instead.

func NewAuthenticatedSessionFromRoleContext added in v1.0.0

func NewAuthenticatedSessionFromRoleContext(ctx context.Context, region string, roleARN string) (*aws.Config, error)

NewAuthenticatedSessionFromRoleContext returns a new AWS Config after assuming the role whose ARN is provided in roleARN. If the credentials are not properly configured in the underlying environment, an error is returned. The ctx parameter supports cancellation and timeouts.

func NewCloudWatchLogsClient deprecated

func NewCloudWatchLogsClient(t testing.TestingT, region string) *cloudwatchlogs.Client

NewCloudWatchLogsClient creates a new CloudWatch Logs client.

Deprecated: Use NewCloudWatchLogsClientContext instead.

func NewCloudWatchLogsClientContext added in v1.0.0

func NewCloudWatchLogsClientContext(t testing.TestingT, ctx context.Context, region string) *cloudwatchlogs.Client

NewCloudWatchLogsClientContext creates a new CloudWatch Logs client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewCloudWatchLogsClientContextE added in v1.0.0

func NewCloudWatchLogsClientContextE(t testing.TestingT, ctx context.Context, region string) (*cloudwatchlogs.Client, error)

NewCloudWatchLogsClientContextE creates a new CloudWatch Logs client. The ctx parameter supports cancellation and timeouts.

func NewCloudWatchLogsClientE deprecated added in v0.9.0

func NewCloudWatchLogsClientE(t testing.TestingT, region string) (*cloudwatchlogs.Client, error)

NewCloudWatchLogsClientE creates a new CloudWatch Logs client.

Deprecated: Use NewCloudWatchLogsClientContextE instead.

func NewDynamoDBClient deprecated added in v0.15.11

func NewDynamoDBClient(t testing.TestingT, region string) *dynamodb.Client

NewDynamoDBClient creates a DynamoDB client.

Deprecated: Use NewDynamoDBClientContext instead.

func NewDynamoDBClientContext added in v1.0.0

func NewDynamoDBClientContext(t testing.TestingT, ctx context.Context, region string) *dynamodb.Client

NewDynamoDBClientContext creates a DynamoDB client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewDynamoDBClientContextE added in v1.0.0

func NewDynamoDBClientContextE(t testing.TestingT, ctx context.Context, region string) (*dynamodb.Client, error)

NewDynamoDBClientContextE creates a DynamoDB client. The ctx parameter supports cancellation and timeouts.

func NewDynamoDBClientE deprecated added in v0.15.11

func NewDynamoDBClientE(t testing.TestingT, region string) (*dynamodb.Client, error)

NewDynamoDBClientE creates a DynamoDB client.

Deprecated: Use NewDynamoDBClientContextE instead.

func NewECRClient deprecated added in v0.30.5

func NewECRClient(t testing.TestingT, region string) *ecr.Client

NewECRClient returns a client for the Elastic Container Registry. This will fail the test and stop execution if there is an error.

Deprecated: Use NewECRClientContext instead.

func NewECRClientContext added in v1.0.0

func NewECRClientContext(t testing.TestingT, ctx context.Context, region string) *ecr.Client

NewECRClientContext returns a client for the Elastic Container Registry. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewECRClientContextE added in v1.0.0

func NewECRClientContextE(t testing.TestingT, ctx context.Context, region string) (*ecr.Client, error)

NewECRClientContextE returns a client for the Elastic Container Registry. The ctx parameter supports cancellation and timeouts.

func NewECRClientE deprecated added in v0.30.5

func NewECRClientE(t testing.TestingT, region string) (*ecr.Client, error)

NewECRClientE returns a client for the Elastic Container Registry.

Deprecated: Use NewECRClientContextE instead.

func NewEc2Client deprecated

func NewEc2Client(t testing.TestingT, region string) *ec2.Client

NewEc2Client creates an EC2 client.

Deprecated: Use NewEc2ClientContext instead.

func NewEc2ClientContext added in v1.0.0

func NewEc2ClientContext(t testing.TestingT, ctx context.Context, region string) *ec2.Client

NewEc2ClientContext creates an EC2 client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewEc2ClientContextE added in v1.0.0

func NewEc2ClientContextE(t testing.TestingT, ctx context.Context, region string) (*ec2.Client, error)

NewEc2ClientContextE creates an EC2 client. The ctx parameter supports cancellation and timeouts.

func NewEc2ClientE deprecated added in v0.9.0

func NewEc2ClientE(t testing.TestingT, region string) (*ec2.Client, error)

NewEc2ClientE creates an EC2 client.

Deprecated: Use NewEc2ClientContextE instead.

func NewEcsClient deprecated added in v0.14.3

func NewEcsClient(t testing.TestingT, region string) *ecs.Client

NewEcsClient creates en ECS client.

Deprecated: Use NewEcsClientContext instead.

func NewEcsClientContext added in v1.0.0

func NewEcsClientContext(t testing.TestingT, ctx context.Context, region string) *ecs.Client

NewEcsClientContext creates an ECS client. The ctx parameter supports cancellation and timeouts.

func NewEcsClientContextE added in v1.0.0

func NewEcsClientContextE(t testing.TestingT, ctx context.Context, region string) (*ecs.Client, error)

NewEcsClientContextE creates an ECS client. The ctx parameter supports cancellation and timeouts.

func NewEcsClientE deprecated added in v0.14.3

func NewEcsClientE(t testing.TestingT, region string) (*ecs.Client, error)

NewEcsClientE creates an ECS client.

Deprecated: Use NewEcsClientContextE instead.

func NewIamClient deprecated

func NewIamClient(t testing.TestingT, region string) *iam.Client

NewIamClient creates a new IAM client.

Deprecated: Use NewIamClientContext instead.

func NewIamClientContext added in v1.0.0

func NewIamClientContext(t testing.TestingT, ctx context.Context, region string) *iam.Client

NewIamClientContext creates a new IAM client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewIamClientContextE added in v1.0.0

func NewIamClientContextE(t testing.TestingT, ctx context.Context, region string) (*iam.Client, error)

NewIamClientContextE creates a new IAM client. The ctx parameter supports cancellation and timeouts.

func NewIamClientE deprecated added in v0.9.0

func NewIamClientE(t testing.TestingT, region string) (*iam.Client, error)

NewIamClientE creates a new IAM client.

Deprecated: Use NewIamClientContextE instead.

func NewKmsClient deprecated

func NewKmsClient(t testing.TestingT, region string) *kms.Client

NewKmsClient creates a KMS client.

Deprecated: Use NewKmsClientContext instead.

func NewKmsClientContext added in v1.0.0

func NewKmsClientContext(t testing.TestingT, ctx context.Context, region string) *kms.Client

NewKmsClientContext creates a KMS client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewKmsClientContextE added in v1.0.0

func NewKmsClientContextE(t testing.TestingT, ctx context.Context, region string) (*kms.Client, error)

NewKmsClientContextE creates a KMS client. The ctx parameter supports cancellation and timeouts.

func NewKmsClientE deprecated added in v0.9.0

func NewKmsClientE(t testing.TestingT, region string) (*kms.Client, error)

NewKmsClientE creates a KMS client.

Deprecated: Use NewKmsClientContextE instead.

func NewLambdaClient deprecated added in v0.24.1

func NewLambdaClient(t testing.TestingT, region string) *lambda.Client

NewLambdaClient creates a new Lambda client.

Deprecated: Use NewLambdaClientContext instead.

func NewLambdaClientContext added in v1.0.0

func NewLambdaClientContext(t testing.TestingT, ctx context.Context, region string) *lambda.Client

NewLambdaClientContext creates a new Lambda client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewLambdaClientContextE added in v1.0.0

func NewLambdaClientContextE(t testing.TestingT, ctx context.Context, region string) (*lambda.Client, error)

NewLambdaClientContextE creates a new Lambda client. The ctx parameter supports cancellation and timeouts.

func NewLambdaClientE deprecated added in v0.24.1

func NewLambdaClientE(t testing.TestingT, region string) (*lambda.Client, error)

NewLambdaClientE creates a new Lambda client.

Deprecated: Use NewLambdaClientContextE instead.

func NewRdsClient deprecated added in v0.10.3

func NewRdsClient(t testing.TestingT, region string) *rds.Client

NewRdsClient creates an RDS client.

Deprecated: Use NewRdsClientContext instead.

func NewRdsClientContext added in v1.0.0

func NewRdsClientContext(t testing.TestingT, ctx context.Context, region string) *rds.Client

NewRdsClientContext creates an RDS client. The ctx parameter supports cancellation and timeouts.

func NewRdsClientContextE added in v1.0.0

func NewRdsClientContextE(t testing.TestingT, ctx context.Context, region string) (*rds.Client, error)

NewRdsClientContextE creates an RDS client. The ctx parameter supports cancellation and timeouts.

func NewRdsClientE deprecated added in v0.10.3

func NewRdsClientE(t testing.TestingT, region string) (*rds.Client, error)

NewRdsClientE creates an RDS client.

Deprecated: Use NewRdsClientContextE instead.

func NewRoute53Client deprecated added in v0.47.1

func NewRoute53Client(t ttesting.TestingT, region string) *route53.Client

NewRoute53Client creates a Route 53 client.

Deprecated: Use NewRoute53ClientContext instead.

func NewRoute53ClientContext added in v1.0.0

func NewRoute53ClientContext(t ttesting.TestingT, ctx context.Context, region string) *route53.Client

NewRoute53ClientContext creates a Route 53 client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewRoute53ClientContextE added in v1.0.0

func NewRoute53ClientContextE(t ttesting.TestingT, ctx context.Context, region string) (*route53.Client, error)

NewRoute53ClientContextE creates a Route 53 client. The ctx parameter supports cancellation and timeouts.

func NewRoute53ClientE deprecated added in v0.47.1

func NewRoute53ClientE(t ttesting.TestingT, region string) (*route53.Client, error)

NewRoute53ClientE creates a Route 53 client.

Deprecated: Use NewRoute53ClientContextE instead.

func NewS3Client deprecated

func NewS3Client(t testing.TestingT, region string) *s3.Client

NewS3Client creates an S3 client.

Deprecated: Use NewS3ClientContext instead.

func NewS3ClientContext added in v1.0.0

func NewS3ClientContext(t testing.TestingT, ctx context.Context, region string) *s3.Client

NewS3ClientContext creates an S3 client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewS3ClientContextE added in v1.0.0

func NewS3ClientContextE(t testing.TestingT, ctx context.Context, region string) (*s3.Client, error)

NewS3ClientContextE creates an S3 client. The ctx parameter supports cancellation and timeouts.

func NewS3ClientE deprecated added in v0.9.0

func NewS3ClientE(t testing.TestingT, region string) (*s3.Client, error)

NewS3ClientE creates an S3 client.

Deprecated: Use NewS3ClientContextE instead.

func NewS3Uploader deprecated added in v0.9.15

func NewS3Uploader(t testing.TestingT, region string) *transfermanager.Client

NewS3Uploader creates an S3 transfer manager client for uploading objects.

Deprecated: Use NewS3UploaderContext instead.

func NewS3UploaderContext added in v1.0.0

func NewS3UploaderContext(t testing.TestingT, ctx context.Context, region string) *transfermanager.Client

NewS3UploaderContext creates an S3 transfer manager client for uploading objects. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewS3UploaderContextE added in v1.0.0

func NewS3UploaderContextE(t testing.TestingT, ctx context.Context, region string) (*transfermanager.Client, error)

NewS3UploaderContextE creates an S3 transfer manager client for uploading objects. The ctx parameter supports cancellation and timeouts.

func NewS3UploaderE deprecated added in v0.9.15

func NewS3UploaderE(t testing.TestingT, region string) (*transfermanager.Client, error)

NewS3UploaderE creates an S3 transfer manager client for uploading objects.

Deprecated: Use NewS3UploaderContextE instead.

func NewSecretsManagerClient deprecated added in v0.28.12

func NewSecretsManagerClient(t testing.TestingT, region string) *secretsmanager.Client

NewSecretsManagerClient creates a new SecretsManager client.

Deprecated: Use NewSecretsManagerClientContext instead.

func NewSecretsManagerClientContext added in v1.0.0

func NewSecretsManagerClientContext(t testing.TestingT, ctx context.Context, region string) *secretsmanager.Client

NewSecretsManagerClientContext creates a new SecretsManager client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewSecretsManagerClientContextE added in v1.0.0

func NewSecretsManagerClientContextE(t testing.TestingT, ctx context.Context, region string) (*secretsmanager.Client, error)

NewSecretsManagerClientContextE creates a new SecretsManager client. The ctx parameter supports cancellation and timeouts.

func NewSecretsManagerClientE deprecated added in v0.28.12

func NewSecretsManagerClientE(t testing.TestingT, region string) (*secretsmanager.Client, error)

NewSecretsManagerClientE creates a new SecretsManager client.

Deprecated: Use NewSecretsManagerClientContextE instead.

func NewSnsClient deprecated

func NewSnsClient(t testing.TestingT, region string) *sns.Client

NewSnsClient creates a new SNS client.

Deprecated: Use NewSnsClientContext instead.

func NewSnsClientContext added in v1.0.0

func NewSnsClientContext(t testing.TestingT, ctx context.Context, region string) *sns.Client

NewSnsClientContext creates a new SNS client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewSnsClientContextE added in v1.0.0

func NewSnsClientContextE(t testing.TestingT, ctx context.Context, region string) (*sns.Client, error)

NewSnsClientContextE creates a new SNS client. The ctx parameter supports cancellation and timeouts.

func NewSnsClientE deprecated added in v0.9.0

func NewSnsClientE(t testing.TestingT, region string) (*sns.Client, error)

NewSnsClientE creates a new SNS client.

Deprecated: Use NewSnsClientContextE instead.

func NewSqsClient deprecated

func NewSqsClient(t testing.TestingT, region string) *sqs.Client

NewSqsClient creates a new SQS client.

Deprecated: Use NewSqsClientContext instead.

func NewSqsClientContext added in v1.0.0

func NewSqsClientContext(t testing.TestingT, ctx context.Context, region string) *sqs.Client

NewSqsClientContext creates a new SQS client. The ctx parameter supports cancellation and timeouts.

func NewSqsClientContextE added in v1.0.0

func NewSqsClientContextE(t testing.TestingT, ctx context.Context, region string) (*sqs.Client, error)

NewSqsClientContextE creates a new SQS client. The ctx parameter supports cancellation and timeouts.

func NewSqsClientE deprecated added in v0.9.0

func NewSqsClientE(t testing.TestingT, region string) (*sqs.Client, error)

NewSqsClientE creates a new SQS client.

Deprecated: Use NewSqsClientContextE instead.

func NewSsmClient deprecated added in v0.15.3

func NewSsmClient(t testing.TestingT, region string) *ssm.Client

NewSsmClient creates an SSM client.

Deprecated: Use NewSsmClientContext instead.

func NewSsmClientContext added in v1.0.0

func NewSsmClientContext(t testing.TestingT, ctx context.Context, region string) *ssm.Client

NewSsmClientContext creates an SSM client. The ctx parameter supports cancellation and timeouts.

func NewSsmClientContextE added in v1.0.0

func NewSsmClientContextE(t testing.TestingT, ctx context.Context, region string) (*ssm.Client, error)

NewSsmClientContextE creates an SSM client. The ctx parameter supports cancellation and timeouts.

func NewSsmClientE deprecated added in v0.15.3

func NewSsmClientE(t testing.TestingT, region string) (*ssm.Client, error)

NewSsmClientE creates an SSM client.

Deprecated: Use NewSsmClientContextE instead.

func NewStsClient deprecated added in v1.0.0

func NewStsClient(t testing.TestingT, region string) *sts.Client

NewStsClient creates a new STS client.

Deprecated: Use NewStsClientContext instead.

func NewStsClientContext added in v1.0.0

func NewStsClientContext(t testing.TestingT, ctx context.Context, region string) *sts.Client

NewStsClientContext creates a new STS client. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func NewStsClientContextE added in v1.0.0

func NewStsClientContextE(t testing.TestingT, ctx context.Context, region string) (*sts.Client, error)

NewStsClientContextE creates a new STS client. The ctx parameter supports cancellation and timeouts.

func NewStsClientE deprecated added in v0.15.0

func NewStsClientE(t testing.TestingT, region string) (*sts.Client, error)

NewStsClientE creates a new STS client.

Deprecated: Use NewStsClientContextE instead.

func PickRecommendedInstanceTypeE added in v1.0.0

func PickRecommendedInstanceTypeE(availabilityZones []string, instanceTypeOfferings []types.InstanceTypeOffering, instanceTypeOptions []string) (string, error)

PickRecommendedInstanceTypeE picks the first instance type from instanceTypeOptions that is available in all the given availability zones based on the given instance type offerings. Returns a NoInstanceTypeError if none of the options are available in all AZs.

func PutECRRepoLifecyclePolicy deprecated added in v0.41.5

func PutECRRepoLifecyclePolicy(t testing.TestingT, region string, repo *types.Repository, policy string)

PutECRRepoLifecyclePolicy puts the given policy for the given ECR repository. This will fail the test and stop execution if there is an error.

Deprecated: Use PutECRRepoLifecyclePolicyContext instead.

func PutECRRepoLifecyclePolicyContext added in v1.0.0

func PutECRRepoLifecyclePolicyContext(t testing.TestingT, ctx context.Context, region string, repo *types.Repository, policy string)

PutECRRepoLifecyclePolicyContext puts the given policy for the given ECR repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutECRRepoLifecyclePolicyContextE added in v1.0.0

func PutECRRepoLifecyclePolicyContextE(t testing.TestingT, ctx context.Context, region string, repo *types.Repository, policy string) error

PutECRRepoLifecyclePolicyContextE puts the given policy for the given ECR repository. The ctx parameter supports cancellation and timeouts.

func PutECRRepoLifecyclePolicyE deprecated added in v0.41.5

func PutECRRepoLifecyclePolicyE(t testing.TestingT, region string, repo *types.Repository, policy string) error

PutECRRepoLifecyclePolicyE puts the given policy for the given ECR repository.

Deprecated: Use PutECRRepoLifecyclePolicyContextE instead.

func PutECRRepoPolicy deprecated added in v0.49.0

func PutECRRepoPolicy(t testing.TestingT, region string, repo *types.Repository, policy string)

PutECRRepoPolicy puts the given policy for the given ECR repository. This will fail the test and stop execution if there is an error.

Deprecated: Use PutECRRepoPolicyContext instead.

func PutECRRepoPolicyContext added in v1.0.0

func PutECRRepoPolicyContext(t testing.TestingT, ctx context.Context, region string, repo *types.Repository, policy string)

PutECRRepoPolicyContext puts the given policy for the given ECR repository. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutECRRepoPolicyContextE added in v1.0.0

func PutECRRepoPolicyContextE(t testing.TestingT, ctx context.Context, region string, repo *types.Repository, policy string) error

PutECRRepoPolicyContextE puts the given policy for the given ECR repository. The ctx parameter supports cancellation and timeouts.

func PutECRRepoPolicyE deprecated added in v0.49.0

func PutECRRepoPolicyE(t testing.TestingT, region string, repo *types.Repository, policy string) error

PutECRRepoPolicyE puts the given policy for the given ECR repository.

Deprecated: Use PutECRRepoPolicyContextE instead.

func PutParameter deprecated added in v0.15.3

func PutParameter(t testing.TestingT, awsRegion string, keyName string, keyDescription string, keyValue string) int64

PutParameter creates new version of SSM Parameter at keyName with keyValue as SecureString.

Deprecated: Use PutParameterContext instead.

func PutParameterContext added in v1.0.0

func PutParameterContext(t testing.TestingT, ctx context.Context, awsRegion string, keyName string, keyDescription string, keyValue string) int64

PutParameterContext creates new version of SSM Parameter at keyName with keyValue as SecureString. The ctx parameter supports cancellation and timeouts.

func PutParameterContextE added in v1.0.0

func PutParameterContextE(t testing.TestingT, ctx context.Context, awsRegion string, keyName string, keyDescription string, keyValue string) (int64, error)

PutParameterContextE creates new version of SSM Parameter at keyName with keyValue as SecureString. The ctx parameter supports cancellation and timeouts.

func PutParameterE deprecated added in v0.15.3

func PutParameterE(t testing.TestingT, awsRegion string, keyName string, keyDescription string, keyValue string) (int64, error)

PutParameterE creates new version of SSM Parameter at keyName with keyValue as SecureString.

Deprecated: Use PutParameterContextE instead.

func PutParameterWithClientContextE added in v1.0.0

func PutParameterWithClientContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, keyName string, keyDescription string, keyValue string) (int64, error)

PutParameterWithClientContextE creates new version of SSM Parameter at keyName with keyValue as SecureString with the ability to provide the SSM client. The ctx parameter supports cancellation and timeouts.

func PutParameterWithClientE deprecated added in v0.36.3

func PutParameterWithClientE(t testing.TestingT, client *ssm.Client, keyName string, keyDescription string, keyValue string) (int64, error)

PutParameterWithClientE creates new version of SSM Parameter at keyName with keyValue as SecureString with the ability to provide the SSM client.

Deprecated: Use PutParameterWithClientContextE instead.

func PutS3BucketPolicy deprecated added in v0.15.5

func PutS3BucketPolicy(t testing.TestingT, region string, bucketName string, policyJSONString string)

PutS3BucketPolicy applies an IAM resource policy to a given S3 bucket to create its bucket policy

Deprecated: Use PutS3BucketPolicyContext instead.

func PutS3BucketPolicyContext added in v1.0.0

func PutS3BucketPolicyContext(t testing.TestingT, ctx context.Context, region string, bucketName string, policyJSONString string)

PutS3BucketPolicyContext applies an IAM resource policy to a given S3 bucket to create its bucket policy. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutS3BucketPolicyContextE added in v1.0.0

func PutS3BucketPolicyContextE(t testing.TestingT, ctx context.Context, region string, bucketName string, policyJSONString string) error

PutS3BucketPolicyContextE applies an IAM resource policy to a given S3 bucket to create its bucket policy. The ctx parameter supports cancellation and timeouts.

func PutS3BucketPolicyE deprecated added in v0.15.5

func PutS3BucketPolicyE(t testing.TestingT, region string, bucketName string, policyJSONString string) error

PutS3BucketPolicyE applies an IAM resource policy to a given S3 bucket to create its bucket policy

Deprecated: Use PutS3BucketPolicyContextE instead.

func PutS3BucketVersioning deprecated added in v0.15.4

func PutS3BucketVersioning(t testing.TestingT, region string, bucketName string)

PutS3BucketVersioning creates an S3 bucket versioning configuration in the given region against the given bucket name, WITHOUT requiring MFA to remove versioning.

Deprecated: Use PutS3BucketVersioningContext instead.

func PutS3BucketVersioningContext added in v1.0.0

func PutS3BucketVersioningContext(t testing.TestingT, ctx context.Context, region string, bucketName string)

PutS3BucketVersioningContext creates an S3 bucket versioning configuration in the given region against the given bucket name, WITHOUT requiring MFA to remove versioning. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutS3BucketVersioningContextE added in v1.0.0

func PutS3BucketVersioningContextE(t testing.TestingT, ctx context.Context, region string, bucketName string) error

PutS3BucketVersioningContextE creates an S3 bucket versioning configuration in the given region against the given bucket name, WITHOUT requiring MFA to remove versioning. The ctx parameter supports cancellation and timeouts.

func PutS3BucketVersioningE deprecated added in v0.15.4

func PutS3BucketVersioningE(t testing.TestingT, region string, bucketName string) error

PutS3BucketVersioningE creates an S3 bucket versioning configuration in the given region against the given bucket name, WITHOUT requiring MFA to remove versioning.

Deprecated: Use PutS3BucketVersioningContextE instead.

func PutS3ObjectContents deprecated added in v0.49.0

func PutS3ObjectContents(t testing.TestingT, awsRegion string, bucket string, key string, body io.Reader)

PutS3ObjectContents puts the contents of the object in the given bucket with the given key.

Deprecated: Use PutS3ObjectContentsContext instead.

func PutS3ObjectContentsContext added in v1.0.0

func PutS3ObjectContentsContext(t testing.TestingT, ctx context.Context, awsRegion string, bucket string, key string, body io.Reader)

PutS3ObjectContentsContext puts the contents of the object in the given bucket with the given key. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutS3ObjectContentsContextE added in v1.0.0

func PutS3ObjectContentsContextE(t testing.TestingT, ctx context.Context, awsRegion string, bucket string, key string, body io.Reader) error

PutS3ObjectContentsContextE puts the contents of the object in the given bucket with the given key. The ctx parameter supports cancellation and timeouts.

func PutS3ObjectContentsE deprecated added in v0.49.0

func PutS3ObjectContentsE(t testing.TestingT, awsRegion string, bucket string, key string, body io.Reader) error

PutS3ObjectContentsE puts the contents of the object in the given bucket with the given key.

Deprecated: Use PutS3ObjectContentsContextE instead.

func PutSecretString deprecated added in v0.48.0

func PutSecretString(t testing.TestingT, awsRegion, id string, secretString string)

PutSecretString updates a secret in Secrets Manager to a new string value

Deprecated: Use PutSecretStringContext instead.

func PutSecretStringContext added in v1.0.0

func PutSecretStringContext(t testing.TestingT, ctx context.Context, awsRegion, id string, secretString string)

PutSecretStringContext updates a secret in Secrets Manager to a new string value. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func PutSecretStringContextE added in v1.0.0

func PutSecretStringContextE(t testing.TestingT, ctx context.Context, awsRegion, id string, secretString string) error

PutSecretStringContextE updates a secret in Secrets Manager to a new string value. The ctx parameter supports cancellation and timeouts.

func PutSecretStringE deprecated added in v0.48.0

func PutSecretStringE(t testing.TestingT, awsRegion, id string, secretString string) error

PutSecretStringE updates a secret in Secrets Manager to a new string value

Deprecated: Use PutSecretStringContextE instead.

func ReadPasswordPolicyMinPasswordLength deprecated

func ReadPasswordPolicyMinPasswordLength(iamClient *iam.Client) (int, error)

ReadPasswordPolicyMinPasswordLength returns the minimal password length.

Deprecated: Use ReadPasswordPolicyMinPasswordLengthContext instead.

func ReadPasswordPolicyMinPasswordLengthContext added in v1.0.0

func ReadPasswordPolicyMinPasswordLengthContext(ctx context.Context, iamClient *iam.Client) (int, error)

ReadPasswordPolicyMinPasswordLengthContext returns the minimal password length. The ctx parameter supports cancellation and timeouts.

func SendMessageFifoToQueue deprecated added in v0.18.3

func SendMessageFifoToQueue(t testing.TestingT, awsRegion string, queueURL string, message string, messageGroupID string)

SendMessageFifoToQueue sends the given message to the FIFO SQS queue with the given URL.

Deprecated: Use SendMessageFifoToQueueContext instead.

func SendMessageFifoToQueueContext added in v1.0.0

func SendMessageFifoToQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, message string, messageGroupID string)

SendMessageFifoToQueueContext sends the given message to the FIFO SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func SendMessageFifoToQueueContextE added in v1.0.0

func SendMessageFifoToQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, message string, messageGroupID string) error

SendMessageFifoToQueueContextE sends the given message to the FIFO SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func SendMessageToFifoQueueE deprecated added in v0.18.3

func SendMessageToFifoQueueE(t testing.TestingT, awsRegion string, queueURL string, message string, messageGroupID string) error

SendMessageToFifoQueueE sends the given message to the FIFO SQS queue with the given URL.

Deprecated: Use SendMessageFifoToQueueContextE instead.

func SendMessageToQueue deprecated

func SendMessageToQueue(t testing.TestingT, awsRegion string, queueURL string, message string)

SendMessageToQueue sends the given message to the SQS queue with the given URL.

Deprecated: Use SendMessageToQueueContext instead.

func SendMessageToQueueContext added in v1.0.0

func SendMessageToQueueContext(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, message string)

SendMessageToQueueContext sends the given message to the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func SendMessageToQueueContextE added in v1.0.0

func SendMessageToQueueContextE(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, message string) error

SendMessageToQueueContextE sends the given message to the SQS queue with the given URL. The ctx parameter supports cancellation and timeouts.

func SendMessageToQueueE deprecated

func SendMessageToQueueE(t testing.TestingT, awsRegion string, queueURL string, message string) error

SendMessageToQueueE sends the given message to the SQS queue with the given URL.

Deprecated: Use SendMessageToQueueContextE instead.

func TerminateInstance deprecated

func TerminateInstance(t testing.TestingT, region string, instanceID string)

TerminateInstance terminates the EC2 instance with the given ID in the given region.

Deprecated: Use TerminateInstanceContext instead.

func TerminateInstanceContext added in v1.0.0

func TerminateInstanceContext(t testing.TestingT, ctx context.Context, region string, instanceID string)

TerminateInstanceContext terminates the EC2 instance with the given ID in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func TerminateInstanceContextE added in v1.0.0

func TerminateInstanceContextE(t testing.TestingT, ctx context.Context, region string, instanceID string) error

TerminateInstanceContextE terminates the EC2 instance with the given ID in the given region. The ctx parameter supports cancellation and timeouts.

func TerminateInstanceE deprecated

func TerminateInstanceE(t testing.TestingT, region string, instanceID string) error

TerminateInstanceE terminates the EC2 instance with the given ID in the given region.

Deprecated: Use TerminateInstanceContextE instead.

func WaitForCapacity deprecated added in v0.13.20

func WaitForCapacity(
	t testing.TestingT,
	asgName string,
	region string,
	maxRetries int,
	sleepBetweenRetries time.Duration,
)

WaitForCapacity waits for the currently set desired capacity to be reached on the ASG

Deprecated: Use WaitForCapacityContext instead.

func WaitForCapacityContext added in v1.0.0

func WaitForCapacityContext(
	t testing.TestingT,
	ctx context.Context,
	asgName string,
	region string,
	maxRetries int,
	sleepBetweenRetries time.Duration,
)

WaitForCapacityContext waits for the currently set desired capacity to be reached on the ASG. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func WaitForCapacityContextE added in v1.0.0

func WaitForCapacityContextE(
	t testing.TestingT,
	ctx context.Context,
	asgName string,
	region string,
	maxRetries int,
	sleepBetweenRetries time.Duration,
) error

WaitForCapacityContextE waits for the currently set desired capacity to be reached on the ASG. The ctx parameter supports cancellation and timeouts.

func WaitForCapacityE deprecated added in v0.13.20

func WaitForCapacityE(
	t testing.TestingT,
	asgName string,
	region string,
	maxRetries int,
	sleepBetweenRetries time.Duration,
) error

WaitForCapacityE waits for the currently set desired capacity to be reached on the ASG

Deprecated: Use WaitForCapacityContextE instead.

func WaitForSsmInstance deprecated added in v0.28.1

func WaitForSsmInstance(t testing.TestingT, awsRegion, instanceID string, timeout time.Duration)

WaitForSsmInstance waits until the instance get registered to the SSM inventory.

Deprecated: Use WaitForSsmInstanceContext instead.

func WaitForSsmInstanceContext added in v1.0.0

func WaitForSsmInstanceContext(t testing.TestingT, ctx context.Context, awsRegion, instanceID string, timeout time.Duration)

WaitForSsmInstanceContext waits until the instance get registered to the SSM inventory. The ctx parameter supports cancellation and timeouts.

func WaitForSsmInstanceContextE added in v1.0.0

func WaitForSsmInstanceContextE(t testing.TestingT, ctx context.Context, awsRegion, instanceID string, timeout time.Duration) error

WaitForSsmInstanceContextE waits until the instance get registered to the SSM inventory. The ctx parameter supports cancellation and timeouts.

func WaitForSsmInstanceE deprecated added in v0.28.1

func WaitForSsmInstanceE(t testing.TestingT, awsRegion, instanceID string, timeout time.Duration) error

WaitForSsmInstanceE waits until the instance get registered to the SSM inventory.

Deprecated: Use WaitForSsmInstanceContextE instead.

func WaitForSsmInstanceWithClientContextE added in v1.0.0

func WaitForSsmInstanceWithClientContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, instanceID string, timeout time.Duration) error

WaitForSsmInstanceWithClientContextE waits until the instance get registered to the SSM inventory with the ability to provide the SSM client. The ctx parameter supports cancellation and timeouts.

func WaitForSsmInstanceWithClientE deprecated added in v0.36.3

func WaitForSsmInstanceWithClientE(t testing.TestingT, client *ssm.Client, instanceID string, timeout time.Duration) error

WaitForSsmInstanceWithClientE waits until the instance get registered to the SSM inventory with the ability to provide the SSM client.

Deprecated: Use WaitForSsmInstanceWithClientContextE instead.

Types

type AcmAPI added in v1.0.0

type AcmAPI interface {
	ListCertificates(ctx context.Context, params *acm.ListCertificatesInput, optFns ...func(*acm.Options)) (*acm.ListCertificatesOutput, error)
}

AcmAPI is the subset of *acm.Client operations used by the helpers in this file. It is declared as an interface so tests can substitute a mock without an AWS account. A real *acm.Client satisfies this interface automatically.

type AsgCapacityInfo added in v0.13.20

type AsgCapacityInfo struct {
	MinCapacity     int64
	MaxCapacity     int64
	CurrentCapacity int64
	DesiredCapacity int64
}

AsgCapacityInfo holds capacity information about an Auto Scaling Group.

func GetCapacityInfoForAsg deprecated added in v0.13.20

func GetCapacityInfoForAsg(t testing.TestingT, asgName string, awsRegion string) AsgCapacityInfo

GetCapacityInfoForAsg returns the capacity info for the queried asg as a struct, AsgCapacityInfo.

Deprecated: Use GetCapacityInfoForAsgContext instead.

func GetCapacityInfoForAsgContext added in v1.0.0

func GetCapacityInfoForAsgContext(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) AsgCapacityInfo

GetCapacityInfoForAsgContext returns the capacity info for the queried asg as a struct, AsgCapacityInfo. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetCapacityInfoForAsgContextE added in v1.0.0

func GetCapacityInfoForAsgContextE(t testing.TestingT, ctx context.Context, asgName string, awsRegion string) (AsgCapacityInfo, error)

GetCapacityInfoForAsgContextE returns the capacity info for the queried asg as a struct, AsgCapacityInfo. The ctx parameter supports cancellation and timeouts.

func GetCapacityInfoForAsgE deprecated added in v0.13.20

func GetCapacityInfoForAsgE(t testing.TestingT, asgName string, awsRegion string) (AsgCapacityInfo, error)

GetCapacityInfoForAsgE returns the capacity info for the queried asg as a struct, AsgCapacityInfo.

Deprecated: Use GetCapacityInfoForAsgContextE instead.

type AsgCapacityNotMetError added in v0.13.20

type AsgCapacityNotMetError struct {
	// contains filtered or unexported fields
}

AsgCapacityNotMetError is returned when the ASG capacity is not yet at the desired capacity.

func NewAsgCapacityNotMetError added in v0.13.20

func NewAsgCapacityNotMetError(asgName string, desiredCapacity int64, currentCapacity int64) AsgCapacityNotMetError

NewAsgCapacityNotMetError returns an AsgCapacityNotMetError describing the given ASG's desired and current capacities.

func (AsgCapacityNotMetError) Error added in v0.13.20

func (err AsgCapacityNotMetError) Error() string

type BucketServerSideEncryptionNotEnabledError added in v1.0.0

type BucketServerSideEncryptionNotEnabledError struct {
	// contains filtered or unexported fields
}

BucketServerSideEncryptionNotEnabledError is returned when an S3 bucket that should have server-side encryption with the expected algorithm is not configured to do so.

func NewBucketServerSideEncryptionNotEnabledError added in v1.0.0

func NewBucketServerSideEncryptionNotEnabledError(s3BucketName string, awsRegion string, expectedAlgorithm s3types.ServerSideEncryption) BucketServerSideEncryptionNotEnabledError

NewBucketServerSideEncryptionNotEnabledError returns a BucketServerSideEncryptionNotEnabledError for the given S3 bucket, region, and expected SSE algorithm.

func (BucketServerSideEncryptionNotEnabledError) Error added in v1.0.0

type BucketVersioningNotEnabledError added in v0.15.4

type BucketVersioningNotEnabledError struct {
	// contains filtered or unexported fields
}

BucketVersioningNotEnabledError is returned when an S3 bucket that should have versioning does not have it applied

func NewBucketVersioningNotEnabledError added in v0.15.4

func NewBucketVersioningNotEnabledError(s3BucketName string, awsRegion string, versioningStatus string) BucketVersioningNotEnabledError

NewBucketVersioningNotEnabledError returns a BucketVersioningNotEnabledError for the given S3 bucket, region, and observed versioning status.

func (BucketVersioningNotEnabledError) Error added in v0.15.4

type CloudWatchLogsAPI added in v1.0.0

type CloudWatchLogsAPI interface {
	GetLogEvents(ctx context.Context, params *cloudwatchlogs.GetLogEventsInput, optFns ...func(*cloudwatchlogs.Options)) (*cloudwatchlogs.GetLogEventsOutput, error)
}

CloudWatchLogsAPI is the subset of *cloudwatchlogs.Client operations used by the helpers in this file. Declared as an interface so tests can substitute a mock; a real *cloudwatchlogs.Client satisfies it automatically.

type CommandOutput added in v0.28.1

type CommandOutput struct {
	Stdout   string
	Stderr   string
	ExitCode int64
}

CommandOutput contains the result of the SSM command.

func CheckSSMCommandWithClientContextE added in v1.0.0

func CheckSSMCommandWithClientContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, instanceID, command string, timeout time.Duration) (*CommandOutput, error)

CheckSSMCommandWithClientContextE checks that you can run the given command on the given instance through AWS SSM with the ability to provide the SSM client. Returns the result and an error if one occurs. The ctx parameter supports cancellation and timeouts.

func CheckSSMCommandWithClientE deprecated added in v0.36.3

func CheckSSMCommandWithClientE(t testing.TestingT, client *ssm.Client, instanceID, command string, timeout time.Duration) (*CommandOutput, error)

CheckSSMCommandWithClientE checks that you can run the given command on the given instance through AWS SSM with the ability to provide the SSM client. Returns the result and an error if one occurs.

Deprecated: Use CheckSSMCommandWithClientContextE instead.

func CheckSSMCommandWithClientWithDocumentContextE added in v1.0.0

func CheckSSMCommandWithClientWithDocumentContextE(t testing.TestingT, ctx context.Context, client *ssm.Client, instanceID, command string, commandDocName string, timeout time.Duration) (*CommandOutput, error)

CheckSSMCommandWithClientWithDocumentContextE checks that you can run the given command on the given instance through AWS SSM with the ability to provide the SSM client with specified Command Doc type. Returns the result and an error if one occurs. The ctx parameter supports cancellation and timeouts.

func CheckSSMCommandWithClientWithDocumentE deprecated added in v0.37.9

func CheckSSMCommandWithClientWithDocumentE(t testing.TestingT, client *ssm.Client, instanceID, command string, commandDocName string, timeout time.Duration) (*CommandOutput, error)

CheckSSMCommandWithClientWithDocumentE checks that you can run the given command on the given instance through AWS SSM with the ability to provide the SSM client with specified Command Doc type. Returns the result and an error if one occurs.

Deprecated: Use CheckSSMCommandWithClientWithDocumentContextE instead.

func CheckSsmCommand deprecated added in v0.28.1

func CheckSsmCommand(t testing.TestingT, awsRegion, instanceID, command string, timeout time.Duration) *CommandOutput

CheckSsmCommand checks that you can run the given command on the given instance through AWS SSM.

Deprecated: Use CheckSsmCommandContext instead.

func CheckSsmCommandContext added in v1.0.0

func CheckSsmCommandContext(t testing.TestingT, ctx context.Context, awsRegion, instanceID, command string, timeout time.Duration) *CommandOutput

CheckSsmCommandContext checks that you can run the given command on the given instance through AWS SSM. The ctx parameter supports cancellation and timeouts.

func CheckSsmCommandContextE added in v1.0.0

func CheckSsmCommandContextE(t testing.TestingT, ctx context.Context, awsRegion, instanceID, command string, timeout time.Duration) (*CommandOutput, error)

CheckSsmCommandContextE checks that you can run the given command on the given instance through AWS SSM. Returns the result and an error if one occurs. The ctx parameter supports cancellation and timeouts.

func CheckSsmCommandE deprecated added in v0.28.1

func CheckSsmCommandE(t testing.TestingT, awsRegion, instanceID, command string, timeout time.Duration) (*CommandOutput, error)

CheckSsmCommandE checks that you can run the given command on the given instance through AWS SSM. Returns the result and an error if one occurs.

Deprecated: Use CheckSsmCommandContextE instead.

func CheckSsmCommandWithDocument deprecated added in v0.37.9

func CheckSsmCommandWithDocument(t testing.TestingT, awsRegion, instanceID, command string, commandDocName string, timeout time.Duration) *CommandOutput

CheckSsmCommandWithDocument checks that you can run the given command on the given instance through AWS SSM with specified Command Doc type.

Deprecated: Use CheckSsmCommandWithDocumentContext instead.

func CheckSsmCommandWithDocumentContext added in v1.0.0

func CheckSsmCommandWithDocumentContext(t testing.TestingT, ctx context.Context, awsRegion, instanceID, command string, commandDocName string, timeout time.Duration) *CommandOutput

CheckSsmCommandWithDocumentContext checks that you can run the given command on the given instance through AWS SSM with specified Command Doc type. The ctx parameter supports cancellation and timeouts.

func CheckSsmCommandWithDocumentContextE added in v1.0.0

func CheckSsmCommandWithDocumentContextE(t testing.TestingT, ctx context.Context, awsRegion, instanceID, command string, commandDocName string, timeout time.Duration) (*CommandOutput, error)

CheckSsmCommandWithDocumentContextE checks that you can run the given command on the given instance through AWS SSM with specified Command Doc type. Returns the result and an error if one occurs. The ctx parameter supports cancellation and timeouts.

func CheckSsmCommandWithDocumentE deprecated added in v0.37.9

func CheckSsmCommandWithDocumentE(t testing.TestingT, awsRegion, instanceID, command string, commandDocName string, timeout time.Duration) (*CommandOutput, error)

CheckSsmCommandWithDocumentE checks that you can run the given command on the given instance through AWS SSM with specified Command Doc type. Returns the result and an error if one occurs.

Deprecated: Use CheckSsmCommandWithDocumentContextE instead.

type CredentialsError

type CredentialsError struct {
	UnderlyingErr error
}

CredentialsError is an error that occurs because AWS credentials can't be found.

func (CredentialsError) Error

func (err CredentialsError) Error() string

type DynamoDBAPI added in v1.0.0

type DynamoDBAPI interface {
	DescribeTable(ctx context.Context, params *dynamodb.DescribeTableInput, optFns ...func(*dynamodb.Options)) (*dynamodb.DescribeTableOutput, error)
	DescribeTimeToLive(ctx context.Context, params *dynamodb.DescribeTimeToLiveInput, optFns ...func(*dynamodb.Options)) (*dynamodb.DescribeTimeToLiveOutput, error)
	ListTagsOfResource(ctx context.Context, params *dynamodb.ListTagsOfResourceInput, optFns ...func(*dynamodb.Options)) (*dynamodb.ListTagsOfResourceOutput, error)
}

DynamoDBAPI is the subset of *dynamodb.Client operations used by the helpers in this file. Declared as an interface so tests can substitute a mock; a real *dynamodb.Client satisfies it automatically.

type EbsAPI added in v1.0.0

type EbsAPI interface {
	DeleteSnapshot(ctx context.Context, params *ec2.DeleteSnapshotInput, optFns ...func(*ec2.Options)) (*ec2.DeleteSnapshotOutput, error)
}

EbsAPI is the subset of *ec2.Client operations used by the EBS helpers in this file. Declared as an interface so tests can substitute a mock; a real *ec2.Client satisfies it automatically.

type Ec2Keypair

type Ec2Keypair struct {
	*ssh.KeyPair
	Name   string // The name assigned in AWS to the EC2 Key Pair
	Region string // The AWS region where the EC2 Key Pair lives
}

Ec2Keypair is an EC2 key pair.

func CreateAndImportEC2KeyPair deprecated

func CreateAndImportEC2KeyPair(t testing.TestingT, region string, name string) *Ec2Keypair

CreateAndImportEC2KeyPair generates a public/private KeyPair and import it into EC2 in the given region under the given name.

Deprecated: Use CreateAndImportEC2KeyPairContext instead.

func CreateAndImportEC2KeyPairContext added in v1.0.0

func CreateAndImportEC2KeyPairContext(t testing.TestingT, ctx context.Context, region string, name string) *Ec2Keypair

CreateAndImportEC2KeyPairContext generates a public/private KeyPair and import it into EC2 in the given region under the given name. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func CreateAndImportEC2KeyPairContextE added in v1.0.0

func CreateAndImportEC2KeyPairContextE(t testing.TestingT, ctx context.Context, region string, name string) (*Ec2Keypair, error)

CreateAndImportEC2KeyPairContextE generates a public/private KeyPair and import it into EC2 in the given region under the given name. The ctx parameter supports cancellation and timeouts.

func CreateAndImportEC2KeyPairE deprecated

func CreateAndImportEC2KeyPairE(t testing.TestingT, region string, name string) (*Ec2Keypair, error)

CreateAndImportEC2KeyPairE generates a public/private KeyPair and import it into EC2 in the given region under the given name.

Deprecated: Use CreateAndImportEC2KeyPairContextE instead.

func ImportEC2KeyPair deprecated

func ImportEC2KeyPair(t testing.TestingT, region string, name string, keyPair *ssh.KeyPair) *Ec2Keypair

ImportEC2KeyPair creates a Key Pair in EC2 by importing an existing public key.

Deprecated: Use ImportEC2KeyPairContext instead.

func ImportEC2KeyPairContext added in v1.0.0

func ImportEC2KeyPairContext(t testing.TestingT, ctx context.Context, region string, name string, keyPair *ssh.KeyPair) *Ec2Keypair

ImportEC2KeyPairContext creates a Key Pair in EC2 by importing an existing public key. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func ImportEC2KeyPairContextE added in v1.0.0

func ImportEC2KeyPairContextE(t testing.TestingT, ctx context.Context, region string, name string, keyPair *ssh.KeyPair) (*Ec2Keypair, error)

ImportEC2KeyPairContextE creates a Key Pair in EC2 by importing an existing public key. The ctx parameter supports cancellation and timeouts.

func ImportEC2KeyPairE deprecated

func ImportEC2KeyPairE(t testing.TestingT, region string, name string, keyPair *ssh.KeyPair) (*Ec2Keypair, error)

ImportEC2KeyPairE creates a Key Pair in EC2 by importing an existing public key.

Deprecated: Use ImportEC2KeyPairContextE instead.

type Ec2SyslogAPI added in v1.0.0

type Ec2SyslogAPI interface {
	GetConsoleOutput(ctx context.Context, params *ec2.GetConsoleOutputInput, optFns ...func(*ec2.Options)) (*ec2.GetConsoleOutputOutput, error)
}

Ec2SyslogAPI is the subset of *ec2.Client operations used by the syslog helpers in this file. Declared as an interface so tests can substitute a mock; a real *ec2.Client satisfies it automatically.

type FunctionError added in v0.24.1

type FunctionError struct {
	Message    string
	Payload    []byte
	StatusCode int32
}

FunctionError is returned when an AWS Lambda invocation reports a function error in its response. It carries the error message, the HTTP status code, and the raw payload returned by the function.

func (*FunctionError) Error added in v0.24.1

func (err *FunctionError) Error() string

type HostnameForEc2InstanceNotFound added in v0.13.20

type HostnameForEc2InstanceNotFound struct {
	InstanceId string //nolint:staticcheck,revive // preserving existing field name
	AwsRegion  string
	Type       string
}

HostnameForEc2InstanceNotFound is an error that occurs when the IP for an EC2 instance is not found.

func (HostnameForEc2InstanceNotFound) Error added in v0.13.20

type IPForEc2InstanceNotFound added in v1.0.0

type IPForEc2InstanceNotFound = IpForEc2InstanceNotFound //nolint:staticcheck,revive // preserving deprecated type name

IPForEc2InstanceNotFound is an alias for IpForEc2InstanceNotFound.

type InvocationTypeOption added in v0.32.21

type InvocationTypeOption string

InvocationTypeOption identifies the invocation mode passed to AWS Lambda when calling InvokeFunctionWithParamsContextE. See the InvocationType-prefixed constants for the supported values.

const (
	// InvocationTypeRequestResponse invokes the function synchronously, keeping
	// the connection open until the function returns a response or times out.
	InvocationTypeRequestResponse InvocationTypeOption = "RequestResponse"
	// InvocationTypeDryRun validates parameter values and verifies that the user
	// or role has permission to invoke the function, without actually invoking it.
	InvocationTypeDryRun InvocationTypeOption = "DryRun"
)

Supported InvocationTypeOption values for Lambda invocation modes.

func (*InvocationTypeOption) Value added in v0.32.21

func (itype *InvocationTypeOption) Value() (string, error)

Value returns the string form of the InvocationTypeOption, defaulting to InvocationTypeRequestResponse when itype is nil. It returns an error if itype is set to a value that is not one of the supported invocation types.

type IpForEc2InstanceNotFound deprecated added in v0.9.0

type IpForEc2InstanceNotFound struct {
	InstanceId string //nolint:staticcheck,revive // preserving existing field name
	AwsRegion  string
	Type       string
}

IpForEc2InstanceNotFound is an error that occurs when the IP for an EC2 instance is not found.

Deprecated: Use IPForEc2InstanceNotFound instead.

func (IpForEc2InstanceNotFound) Error added in v0.9.0

func (err IpForEc2InstanceNotFound) Error() string

type KmsAPI added in v1.0.0

type KmsAPI interface {
	DescribeKey(ctx context.Context, params *kms.DescribeKeyInput, optFns ...func(*kms.Options)) (*kms.DescribeKeyOutput, error)
}

KmsAPI is the subset of *kms.Client operations used by the helpers in this file. Declared as an interface so tests can substitute a mock; a real *kms.Client satisfies it automatically.

type LambdaOptions added in v0.32.21

type LambdaOptions struct {
	// InvocationType can be one of InvocationTypeOption values:
	//    * InvocationTypeRequestResponse (default) - Invoke the function
	//      synchronously.  Keep the connection open until the function
	//      returns a response or times out.
	//    * InvocationTypeDryRun - Validate parameter values and verify
	//      that the user or role has permission to invoke the function.
	InvocationType *InvocationTypeOption

	// Lambda function input; will be converted to JSON.
	Payload any
}

LambdaOptions contains additional parameters for InvokeFunctionWithParams(). It contains a subset of the fields found in the lambda.InvokeInput struct.

type LambdaOutput added in v0.32.21

type LambdaOutput struct {
	// The response from the function, or an error object.
	Payload []byte

	// The HTTP status code for a successful request is in the 200 range.
	// For RequestResponse invocation type, the status code is 200.
	// For the DryRun invocation type, the status code is 204.
	StatusCode int32
}

LambdaOutput contains the output from InvokeFunctionWithParams(). The fields may or may not have a value depending on the invocation type and whether an error occurred or not.

func InvokeFunctionWithParams deprecated added in v0.32.21

func InvokeFunctionWithParams(t testing.TestingT, region, functionName string, input *LambdaOptions) *LambdaOutput

InvokeFunctionWithParams invokes a lambda function using parameters supplied in the LambdaOptions struct and returns values in a LambdaOutput struct. Checks for failure using "require".

Deprecated: Use InvokeFunctionWithParamsContext instead.

func InvokeFunctionWithParamsContext added in v1.0.0

func InvokeFunctionWithParamsContext(t testing.TestingT, ctx context.Context, region, functionName string, input *LambdaOptions) *LambdaOutput

InvokeFunctionWithParamsContext invokes a lambda function using parameters supplied in the LambdaOptions struct and returns values in a LambdaOutput struct. Checks for failure using "require". The ctx parameter supports cancellation and timeouts.

func InvokeFunctionWithParamsContextE added in v1.0.0

func InvokeFunctionWithParamsContextE(t testing.TestingT, ctx context.Context, region, functionName string, input *LambdaOptions) (*LambdaOutput, error)

InvokeFunctionWithParamsContextE invokes a lambda function using parameters supplied in the LambdaOptions struct. Returns the status code and payload in a LambdaOutput struct and the error. A non-nil error will either reflect a problem with the parameters supplied to this function or an error returned by the Lambda. The ctx parameter supports cancellation and timeouts.

func InvokeFunctionWithParamsE deprecated added in v0.32.21

func InvokeFunctionWithParamsE(t testing.TestingT, region, functionName string, input *LambdaOptions) (*LambdaOutput, error)

InvokeFunctionWithParamsE invokes a lambda function using parameters supplied in the LambdaOptions struct. Returns the status code and payload in a LambdaOutput struct and the error. A non-nil error will either reflect a problem with the parameters supplied to this function or an error returned by the Lambda.

Deprecated: Use InvokeFunctionWithParamsContextE instead.

type NoBucketPolicyError added in v0.15.5

type NoBucketPolicyError struct {
	// contains filtered or unexported fields
}

NoBucketPolicyError is returned when an S3 bucket that should have a policy applied does not

func NewNoBucketPolicyError added in v0.15.5

func NewNoBucketPolicyError(s3BucketName string, awsRegion string, bucketPolicy string) NoBucketPolicyError

NewNoBucketPolicyError returns a NoBucketPolicyError for the given S3 bucket, region, and bucket policy.

func (NoBucketPolicyError) Error added in v0.15.5

func (err NoBucketPolicyError) Error() string

type NoImagesFound

type NoImagesFound struct {
	Filters map[string][]string
	Region  string
	OwnerID string //nolint:staticcheck,revive // preserving existing field name
}

NoImagesFound is an error that occurs if no images were found.

func (NoImagesFound) Error

func (err NoImagesFound) Error() string

type NoInstanceTypeError added in v0.28.11

type NoInstanceTypeError struct {
	InstanceTypeOptions []string
	Azs                 []string
}

NoInstanceTypeError is returned when none of the given instance type options are available in all AZs in a region

func (NoInstanceTypeError) Error added in v0.28.11

func (err NoInstanceTypeError) Error() string

type NoRdsInstanceTypeError added in v0.32.11

type NoRdsInstanceTypeError struct {
	DatabaseEngine        string
	DatabaseEngineVersion string
	InstanceTypeOptions   []string
}

NoRdsInstanceTypeError is returned when none of the given instance types are available for the region, database engine, and database engine combination given

func (NoRdsInstanceTypeError) Error added in v0.32.11

func (err NoRdsInstanceTypeError) Error() string

type NotFoundError added in v0.13.20

type NotFoundError struct {
	// contains filtered or unexported fields
}

NotFoundError is returned when an expected object is not found

func NewNotFoundError added in v0.13.20

func NewNotFoundError(objectType string, objectID string, region string) NotFoundError

NewNotFoundError returns a NotFoundError for the given object type, ID, and region.

func (NotFoundError) Error added in v0.13.20

func (err NotFoundError) Error() string

type OptionGroupOptionSettingForDBInstanceNotFound added in v1.0.0

type OptionGroupOptionSettingForDBInstanceNotFound = OptionGroupOptionSettingForDbInstanceNotFound

OptionGroupOptionSettingForDBInstanceNotFound is an alias for OptionGroupOptionSettingForDbInstanceNotFound with the correct Go naming convention.

type OptionGroupOptionSettingForDbInstanceNotFound deprecated added in v0.10.3

type OptionGroupOptionSettingForDbInstanceNotFound struct {
	OptionName        string
	OptionSettingName string
	DbInstanceID      string //nolint:staticcheck,revive // preserving existing field name
	AwsRegion         string
}

OptionGroupOptionSettingForDbInstanceNotFound is an error that occurs when the option setting specified is not found in the option group of the DB instance.

Deprecated: Use OptionGroupOptionSettingForDBInstanceNotFound instead.

func (OptionGroupOptionSettingForDbInstanceNotFound) Error added in v0.10.3

type ParameterForDBInstanceNotFound added in v1.0.0

type ParameterForDBInstanceNotFound = ParameterForDbInstanceNotFound

ParameterForDBInstanceNotFound is an alias for ParameterForDbInstanceNotFound with the correct Go naming convention.

type ParameterForDbInstanceNotFound deprecated added in v0.10.3

type ParameterForDbInstanceNotFound struct {
	ParameterName string
	DbInstanceID  string //nolint:staticcheck,revive // preserving existing field name
	AwsRegion     string
}

ParameterForDbInstanceNotFound is an error that occurs when the parameter group specified is not found for the DB instance.

Deprecated: Use ParameterForDBInstanceNotFound instead.

func (ParameterForDbInstanceNotFound) Error added in v0.10.3

type QueueMessageResponse

type QueueMessageResponse struct {
	Error         error
	ReceiptHandle string
	MessageBody   string
}

QueueMessageResponse contains a queue message.

func WaitForQueueMessage deprecated

func WaitForQueueMessage(t testing.TestingT, awsRegion string, queueURL string, timeout int) QueueMessageResponse

WaitForQueueMessage waits to receive a message from on the queueURL. Since the API only allows us to wait a max 20 seconds for a new message to arrive, we must loop TIMEOUT/20 number of times to be able to wait for a total of TIMEOUT seconds

Deprecated: Use WaitForQueueMessageContext instead.

func WaitForQueueMessageContext added in v1.0.0

func WaitForQueueMessageContext(t testing.TestingT, ctx context.Context, awsRegion string, queueURL string, timeout int) QueueMessageResponse

WaitForQueueMessageContext waits to receive a message from on the queueURL. Since the API only allows us to wait a max 20 seconds for a new message to arrive, we must loop TIMEOUT/20 number of times to be able to wait for a total of TIMEOUT seconds. The ctx parameter supports cancellation and timeouts.

type ReceiveMessageTimeout

type ReceiveMessageTimeout struct {
	QueueUrl   string //nolint:staticcheck,revive // preserving existing field name
	TimeoutSec int
}

ReceiveMessageTimeout is an error that occurs if receiving a message times out.

func (ReceiveMessageTimeout) Error

func (err ReceiveMessageTimeout) Error() string

type RemoteFileSpecification added in v0.13.0

type RemoteFileSpecification struct {
	RemotePathToFileFilter map[string][]string // A map of the files to fetch, where the keys are directories on the remote host and the values are filters for what files to fetch from the directory. The filters support bash-style wildcards.
	KeyPair                *Ec2Keypair
	SshUser                string   //nolint:staticcheck,revive // preserving existing field name
	LocalDestinationDir    string   // base path where to store downloaded artifacts locally. The final path of each resource will include the ip of the host and the name of the immediate parent folder.
	AsgNames               []string // ASGs where our instances will be
	UseSudo                bool
}

RemoteFileSpecification describes which files you want to copy from your instances

type S3AccessLoggingNotEnabledErr added in v0.30.22

type S3AccessLoggingNotEnabledErr struct {
	OriginBucket string
	Region       string
}

S3AccessLoggingNotEnabledErr is a custom error that occurs when acess logging hasn't been enabled on the S3 Bucket

func (S3AccessLoggingNotEnabledErr) Error added in v0.30.22

type Subnet

type Subnet struct {
	Tags             map[string]string // The tags associated with the subnet
	Id               string            //nolint:staticcheck,revive // preserving existing field name
	AvailabilityZone string            // The Availability Zone the subnet is in
	CidrBlock        string            // The CIDR block associated with the subnet
	DefaultForAz     bool              // If the subnet is default for the Availability Zone
}

Subnet is a subnet in an availability zone.

func GetAzDefaultSubnetsForVpc deprecated added in v0.41.11

func GetAzDefaultSubnetsForVpc(t testing.TestingT, vpcID string, region string) []Subnet

GetAzDefaultSubnetsForVpc gets the default az subnets in the specified VPC.

Deprecated: Use GetAzDefaultSubnetsForVpcContext instead.

func GetAzDefaultSubnetsForVpcContext added in v1.0.0

func GetAzDefaultSubnetsForVpcContext(t testing.TestingT, ctx context.Context, vpcID string, region string) []Subnet

GetAzDefaultSubnetsForVpcContext gets the default az subnets in the specified VPC. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetAzDefaultSubnetsForVpcContextE added in v1.0.0

func GetAzDefaultSubnetsForVpcContextE(t testing.TestingT, ctx context.Context, vpcID string, region string) ([]Subnet, error)

GetAzDefaultSubnetsForVpcContextE gets the default az subnets in the specified VPC. The ctx parameter supports cancellation and timeouts.

func GetAzDefaultSubnetsForVpcE deprecated added in v1.0.0

func GetAzDefaultSubnetsForVpcE(t testing.TestingT, vpcID string, region string) ([]Subnet, error)

GetAzDefaultSubnetsForVpcE gets the default az subnets in the specified VPC.

Deprecated: Use GetAzDefaultSubnetsForVpcContextE instead.

func GetSubnetsForVpc deprecated

func GetSubnetsForVpc(t testing.TestingT, vpcID string, region string) []Subnet

GetSubnetsForVpc gets the subnets in the specified VPC.

Deprecated: Use GetSubnetsForVpcContext instead.

func GetSubnetsForVpcContext added in v1.0.0

func GetSubnetsForVpcContext(t testing.TestingT, ctx context.Context, vpcID string, region string) []Subnet

GetSubnetsForVpcContext gets the subnets in the specified VPC. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetSubnetsForVpcContextE added in v1.0.0

func GetSubnetsForVpcContextE(t testing.TestingT, ctx context.Context, region string, filters []types.Filter) ([]Subnet, error)

GetSubnetsForVpcContextE gets the subnets in the specified VPC. The ctx parameter supports cancellation and timeouts.

func GetSubnetsForVpcE deprecated

func GetSubnetsForVpcE(t testing.TestingT, region string, filters []types.Filter) ([]Subnet, error)

GetSubnetsForVpcE gets the subnets in the specified VPC.

Deprecated: Use GetSubnetsForVpcContextE instead.

type Vpc

type Vpc struct {
	Id                   string            //nolint:staticcheck,revive // preserving existing field name
	Name                 string            // The name of the VPC
	Subnets              []Subnet          // A list of subnets in the VPC
	Tags                 map[string]string // The tags associated with the VPC
	CidrBlock            *string           // The primary IPv4 CIDR block for the VPC.
	CidrAssociations     []*string         // Information about the IPv4 CIDR blocks associated with the VPC.
	Ipv6CidrAssociations []*string         // Information about the IPv6 CIDR blocks associated with the VPC.
}

Vpc is an Amazon Virtual Private Cloud.

func GetDefaultVpc deprecated

func GetDefaultVpc(t testing.TestingT, region string) *Vpc

GetDefaultVpc fetches information about the default VPC in the given region.

Deprecated: Use GetDefaultVpcContext instead.

func GetDefaultVpcContext added in v1.0.0

func GetDefaultVpcContext(t testing.TestingT, ctx context.Context, region string) *Vpc

GetDefaultVpcContext fetches information about the default VPC in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetDefaultVpcContextE added in v1.0.0

func GetDefaultVpcContextE(t testing.TestingT, ctx context.Context, region string) (*Vpc, error)

GetDefaultVpcContextE fetches information about the default VPC in the given region. The ctx parameter supports cancellation and timeouts.

func GetDefaultVpcE deprecated

func GetDefaultVpcE(t testing.TestingT, region string) (*Vpc, error)

GetDefaultVpcE fetches information about the default VPC in the given region.

Deprecated: Use GetDefaultVpcContextE instead.

func GetVpcByID deprecated added in v1.0.0

func GetVpcByID(t testing.TestingT, vpcID string, region string) *Vpc

GetVpcByID fetches information about a VPC with given ID in the given region.

Deprecated: Use GetVpcByIDContext instead.

func GetVpcByIDContext added in v1.0.0

func GetVpcByIDContext(t testing.TestingT, ctx context.Context, vpcID string, region string) *Vpc

GetVpcByIDContext fetches information about a VPC with given ID in the given region. This function will fail the test if there is an error. The ctx parameter supports cancellation and timeouts.

func GetVpcByIDContextE added in v1.0.0

func GetVpcByIDContextE(t testing.TestingT, ctx context.Context, vpcID string, region string) (*Vpc, error)

GetVpcByIDContextE fetches information about a VPC with given ID in the given region. The ctx parameter supports cancellation and timeouts.

func GetVpcByIDE deprecated added in v1.0.0

func GetVpcByIDE(t testing.TestingT, vpcID string, region string) (*Vpc, error)

GetVpcByIDE fetches information about a VPC with given ID in the given region.

Deprecated: Use GetVpcByIDContextE instead.

func GetVpcById deprecated added in v0.18.6

func GetVpcById(t testing.TestingT, vpcID string, region string) *Vpc

GetVpcById fetches information about a VPC with given ID in the given region.

Deprecated: Use GetVpcByID instead.

func GetVpcByIdE deprecated added in v0.18.6

func GetVpcByIdE(t testing.TestingT, vpcID string, region string) (*Vpc, error)

GetVpcByIdE fetches information about a VPC with given ID in the given region.

Deprecated: Use GetVpcByIDE instead.

func GetVpcsContextE added in v1.0.0

func GetVpcsContextE(t testing.TestingT, ctx context.Context, filters []types.Filter, region string) ([]*Vpc, error)

GetVpcsContextE fetches information about VPCs from given regions limited by filters The ctx parameter supports cancellation and timeouts.

func GetVpcsE deprecated added in v0.18.6

func GetVpcsE(t testing.TestingT, filters []types.Filter, region string) ([]*Vpc, error)

GetVpcsE fetches information about VPCs from given regions limited by filters

Deprecated: Use GetVpcsContextE instead.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL