Back to Terraform Provider Aws

AWSAT001

.ci/providerlint/passes/AWSAT001/README.md

6.44.01.9 KB
Original Source
<!-- Copyright IBM Corp. 2014, 2026 --> <!-- SPDX-License-Identifier: MPL-2.0 -->

AWSAT001

The AWSAT001 analyzer reports when a resource.TestMatchResourceAttr() call references an Amazon Resource Name (ARN) attribute. It is preferred to use resource.TestCheckResourceAttrPair() or one one of the available Terraform AWS Provider ARN testing check functions instead building full ARN regular expressions. These testing helper functions consider the value of the AWS Account ID, Partition, and Region of the acceptance test runner.

The resource.TestCheckResourceAttrPair() call can be used when the Terraform state has the ARN value already available, such as when the current resource is referencing an ARN attribute of another resource.

Otherwise, available ARN testing check functions include:

  • acctest.CheckResourceAttrGlobalARN
  • acctest.CheckResourceAttrGlobalARNNoAccount
  • acctest.CheckResourceAttrRegionalARN
  • acctest.MatchResourceAttrGlobalARN
  • acctest.MatchResourceAttrRegionalARN
  • acctest.CheckResourceAttrRegionalARNNoAccount
  • acctest.CheckResourceAttrRegionalARNAccountID
  • acctest.CheckResourceAttrGlobalARNAccountID

Flagged Code

go
resource.TestMatchResourceAttr("aws_lb_listener.test", "certificate_arn", regexache.MustCompile(`^arn:[^:]+:acm:[^:]+:[^:]+:certificate/.+$`))

Passing Code

go
resource.TestCheckResourceAttrPair("aws_lb_listener.test", "certificate_arn", "aws_acm_certificate.test", "arn")

acctest.MatchResourceAttrRegionalARN("aws_lb_listener.test", "certificate_arn", "acm", regexache.MustCompile(`certificate/.+`))

Ignoring Check

The check can be ignored for a certain line via a //lintignore:AWSAT001 comment on the previous line or at the end of the offending line, e.g.

go
//lintignore:AWSAT001
resource.TestMatchResourceAttr("aws_lb_listener.test", "certificate_arn", regexache.MustCompile(`^arn:[^:]+:acm:[^:]+:[^:]+:certificate/.+$`))