Files
opentf/website/source/docs/providers/aws/r/iam_instance_profile.html.markdown
George Christou 61277c0dbd website/docs: Run terraform fmt on code examples (#12075)
* docs/vsphere: Fix code block

* docs: Convert `...` to `# ...` to allow `terraform fmt`ing

* docs: Trim trailing whitespace

* docs: First-pass run of `terraform fmt` on code examples
2017-02-19 00:48:50 +02:00

1.9 KiB

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
aws AWS: aws_iam_instance_profile docs-aws-resource-iam-instance-profile Provides an IAM instance profile.

aws_iam_instance_profile

Provides an IAM instance profile.

Example Usage

resource "aws_iam_instance_profile" "test_profile" {
  name  = "test_profile"
  roles = ["${aws_iam_role.role.name}"]
}

resource "aws_iam_role" "role" {
  name = "test_role"
  path = "/"

  assume_role_policy = <<EOF
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "sts:AssumeRole",
            "Principal": {
               "Service": "ec2.amazonaws.com"
            },
            "Effect": "Allow",
            "Sid": ""
        }
    ]
}
EOF
}

Argument Reference

The following arguments are supported:

  • name - (Optional, Forces new resource) The profile's name.
  • name_prefix - (Optional, Forces new resource) Creates a unique name beginning with the specified prefix. Conflicts with name.
  • path - (Optional, default "/") Path in which to create the profile.
  • roles - (Required) A list of role names to include in the profile. The current default is 1. If you see an error message similar to Cannot exceed quota for InstanceSessionsPerInstanceProfile: 1, then you must contact AWS support and ask for a limit increase.

Attribute Reference

  • id - The instance profile's ID.

  • arn - The ARN assigned by AWS to the instance profile.

  • create_date - The creation timestamp of the instance profile.

  • name - The instance profile's name.

  • path - The path of the instance profile in IAM.

  • roles - The list of roles assigned to the instance profile.

  • unique_id - The unique ID assigned by AWS.

Import

Instance Profiles can be imported using the name, e.g.

$ terraform import aws_iam_instance_profile.test_profile app-instance-profile-1