mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-03-12 07:01:03 -04:00
* 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
1.9 KiB
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 withname.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 toCannot 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