terraform/website/source/docs/providers/aws/d/iam_role.html.markdown

36 lines
813 B
Markdown
Raw Normal View History

---
layout: "aws"
2017-04-07 17:44:35 +02:00
page_title: AWS: aws_iam_role
sidebar_current: docs-aws-datasource-iam-role
description: |-
Get information on a Amazon IAM role
---
2017-04-07 17:44:35 +02:00
# aws_iam_role
This data source can be used to fetch information about a specific
IAM role. By using this data source, you can reference IAM role
properties without having to hard code ARNs as input.
## Example Usage
```hcl
data "aws_iam_role" "example" {
role_name = "an_example_role_name"
}
```
## Argument Reference
* `role_name` - (Required) The friendly IAM role name to match.
## Attributes Reference
* `arn` - The Amazon Resource Name (ARN) specifying the role.
* `assume_role_policy_document` - The policy document associated with the role.
* `path` - The path to the role.
* `role_id` - The stable and unique string identifying the role.