Terraform provider: aws

Terraform provider: aws (doc)

• profile, shared_config_files, shared_credentials_files
• Terraform region

allowed_account_ids
default_tags
assume_role

Configuration examples

 provider "aws" {
 profile = "your_profile_name"
}

provider "aws" {
 region = "us-east-1"
 profile = "your_profile_name"
}

provider "aws" {
 version = "~> 3.38.0"
 region = "us-east-1"
 profile = "your_profile_name"
}

provider "aws" {
  region     = var.region
  version    = ">= 0.13"
  assume_role {
    role_arn = "arn:aws:iam::01234567890:role/role_in_account_b"
  }
}

Including Tags:

 # Terraform 0.12 (2019) and later syntax
provider "aws" {
  # ... other configuration ...
  default_tags {
    tags = {
      Environment = "Production"
      Owner       = "Ops"
    }
  }
}

Dynamic Credentials with the AWS Provider:

provider "aws" {
  shared_config_files = [var.tfc_aws_dynamic_credentials.default.shared_config_file]
}

Installing

Installing hashicorp/aws v4.31.0
Installing hashicorp/aws v4.29.0...
Installing hashicorp/aws v4.28.0...
Installing hashicorp/aws v4.15.1...
Installing hashicorp/aws v3.63.0...

Errors

• Error: Provider produced inconsistent final plan
• Error: error configuring Terraform AWS Provider: no valid credential sources for Terraform AWS Provider found.
• Error: configuring Terraform AWS Provider: failed to get shared config profile
• AWS Error: A Profile was specified along with the environment variables "AWS ACCESS KEY ID" and "AWS SECRET ACCESS KEY". The Profile is now used instead of the environment variable credentials.
• The security token included in the request is invalid

Limitation

• aws account disable-region not implemented

Related terms

• Data sources: aws_caller_identity
• CloudFormation resource types: (Type:)
• Terraform S3 backend: backends.tf
• Terraform provider: AWS
• AWS Control Tower Account Factory for Terraform (AFT)
• Terraform AWS data sources
• AWS_DEFAULT_REGION
• Terraform modules
• Terraform provider-level tagging
• required_version
• Terraform provider: AWS Cloud Control
• terraform init, terraform providers lock
• provider =

Activities / Changelog

• Terraform AWS Provider Version 6 Upgrade Guide (announcement, Jun 2025)
• Terraform AWS Provider Version 5 Upgrade Guide (upgrade, announcement, Mar 2023)
• Terraform AWS Provider Version 4 Upgrade Guide: https://registry.terraform.io/providers/hashicorp/aws/latest/docs/guides/version-4-upgrade
• Terraform AWS provider 4.0: https://www.hashicorp.com/blog/terraform-aws-provider-4-0-refactors-s3-bucket-resource
• Multiple load_balancer configuration block support was added in Terraform AWS Provider version 2.22.0.

See also

• Terraform AWS, provider, 5.0 (Mar 2023), 6.0 (Jun 2025)
• Terraform AWS: provider, resources, modules, data sources, VPC, IAM, Net, EC2, S3, Route53, ACM, CloudWatch, SES, RDS, ECS, awscc, autoscaling, EKS