add import documentation, regenerate test config

Author: subham-ibmhc

internal/service/sfn/testdata/StateMachine/basic/main_gen.tf

@@ -1,6 +1,35 @@
 # Copyright (c) HashiCorp, Inc.
 # SPDX-License-Identifier: MPL-2.0
 
+resource "aws_sfn_state_machine" "test" {
+  name     = var.rName
+  role_arn = aws_iam_role.for_sfn.arn
+
+  definition = <<EOF
+{
+  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
+  "StartAt": "HelloWorld",
+  "States": {
+    "HelloWorld": {
+      "Type": "Task",
+      "Resource": "${aws_lambda_function.test.arn}",
+      "Retry": [
+        {
+          "ErrorEquals": [
+            "States.ALL"
+          ],
+          "IntervalSeconds": 5,
+          "MaxAttempts": 5,
+          "BackoffRate": 8
+        }
+      ],
+      "End": true
+    }
+  }
+}
+EOF
+}
+
 resource "aws_iam_role_policy" "for_lambda" {
   name = "${var.rName}-lambda"
   role = aws_iam_role.for_lambda.id
@@ -98,35 +127,6 @@ resource "aws_iam_role" "for_sfn" {
 }
 EOF
 }
-
-resource "aws_sfn_state_machine" "test" {
-  name     = var.rName
-  role_arn = aws_iam_role.for_sfn.arn
-
-  definition = <<EOF
-{
-  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
-  "StartAt": "HelloWorld",
-  "States": {
-    "HelloWorld": {
-      "Type": "Task",
-      "Resource": "${aws_lambda_function.test.arn}",
-      "Retry": [
-        {
-          "ErrorEquals": [
-            "States.ALL"
-          ],
-          "IntervalSeconds": 5,
-          "MaxAttempts": 5,
-          "BackoffRate": 8
-        }
-      ],
-      "End": true
-    }
-  }
-}
-EOF
-}
 variable "rName" {
   description = "Name for resource"
   type        = string

internal/service/sfn/testdata/StateMachine/basic_v6.13.0/main_gen.tf

@@ -1,6 +1,35 @@
 # Copyright (c) HashiCorp, Inc.
 # SPDX-License-Identifier: MPL-2.0
 
+resource "aws_sfn_state_machine" "test" {
+  name     = var.rName
+  role_arn = aws_iam_role.for_sfn.arn
+
+  definition = <<EOF
+{
+  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
+  "StartAt": "HelloWorld",
+  "States": {
+    "HelloWorld": {
+      "Type": "Task",
+      "Resource": "${aws_lambda_function.test.arn}",
+      "Retry": [
+        {
+          "ErrorEquals": [
+            "States.ALL"
+          ],
+          "IntervalSeconds": 5,
+          "MaxAttempts": 5,
+          "BackoffRate": 8
+        }
+      ],
+      "End": true
+    }
+  }
+}
+EOF
+}
+
 resource "aws_iam_role_policy" "for_lambda" {
   name = "${var.rName}-lambda"
   role = aws_iam_role.for_lambda.id
@@ -98,35 +127,6 @@ resource "aws_iam_role" "for_sfn" {
 }
 EOF
 }
-
-resource "aws_sfn_state_machine" "test" {
-  name     = var.rName
-  role_arn = aws_iam_role.for_sfn.arn
-
-  definition = <<EOF
-{
-  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
-  "StartAt": "HelloWorld",
-  "States": {
-    "HelloWorld": {
-      "Type": "Task",
-      "Resource": "${aws_lambda_function.test.arn}",
-      "Retry": [
-        {
-          "ErrorEquals": [
-            "States.ALL"
-          ],
-          "IntervalSeconds": 5,
-          "MaxAttempts": 5,
-          "BackoffRate": 8
-        }
-      ],
-      "End": true
-    }
-  }
-}
-EOF
-}
 variable "rName" {
   description = "Name for resource"
   type        = string

internal/service/sfn/testdata/StateMachine/region_override/main_gen.tf

@@ -1,6 +1,37 @@
 # Copyright (c) HashiCorp, Inc.
 # SPDX-License-Identifier: MPL-2.0
 
+resource "aws_sfn_state_machine" "test" {
+  region = var.region
+
+  name     = var.rName
+  role_arn = aws_iam_role.for_sfn.arn
+
+  definition = <<EOF
+{
+  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
+  "StartAt": "HelloWorld",
+  "States": {
+    "HelloWorld": {
+      "Type": "Task",
+      "Resource": "${aws_lambda_function.test.arn}",
+      "Retry": [
+        {
+          "ErrorEquals": [
+            "States.ALL"
+          ],
+          "IntervalSeconds": 5,
+          "MaxAttempts": 5,
+          "BackoffRate": 8
+        }
+      ],
+      "End": true
+    }
+  }
+}
+EOF
+}
+
 resource "aws_iam_role_policy" "for_lambda" {
   name = "${var.rName}-lambda"
   role = aws_iam_role.for_lambda.id
@@ -102,37 +133,6 @@ resource "aws_iam_role" "for_sfn" {
 }
 EOF
 }
-
-resource "aws_sfn_state_machine" "test" {
-  region = var.region
-
-  name     = var.rName
-  role_arn = aws_iam_role.for_sfn.arn
-
-  definition = <<EOF
-{
-  "Comment": "A Hello World example of the Amazon States Language using an AWS Lambda Function",
-  "StartAt": "HelloWorld",
-  "States": {
-    "HelloWorld": {
-      "Type": "Task",
-      "Resource": "${aws_lambda_function.test.arn}",
-      "Retry": [
-        {
-          "ErrorEquals": [
-            "States.ALL"
-          ],
-          "IntervalSeconds": 5,
-          "MaxAttempts": 5,
-          "BackoffRate": 8
-        }
-      ],
-      "End": true
-    }
-  }
-}
-EOF
-}
 variable "rName" {
   description = "Name for resource"
   type        = string

website/docs/r/sfn_state_machine.html.markdown

@@ -209,6 +209,27 @@ This resource exports the following attributes in addition to the arguments abov
 
 ## Import
 
+In Terraform v1.12.0 and later, the [`import` block](https://developer.hashicorp.com/terraform/language/import) can be used with the `identity` attribute. For example:
+
+```terraform
+import {
+  to = aws_sfn_state_machine.example
+  identity = {
+    "arn" = "arn:aws:states:us-east-1:123456789012:stateMachine:MyWorkflow-2024-09-17-a7b3c8f1"
+  }
+}
+
+resource "aws_sfn_state_machine" "example" {
+  ### Configuration omitted for brevity ###
+}
+```
+
+### Identity Schema
+
+#### Required
+
+- `arn` (String) ARN of the certificate.
+
 In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import State Machines using the `arn`. For example:
 
 ```terraform