github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/d/iam_role.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_iam_role"
     4  sidebar_current: docs-aws-datasource-iam-role
     5  description: |-
     6    Get information on a Amazon IAM role
     7  ---
     8  
     9  # aws_iam_role
    10  
    11  This data source can be used to fetch information about a specific
    12  IAM role. By using this data source, you can reference IAM role
    13  properties without having to hard code ARNs as input.
    14  
    15  ## Example Usage
    16  
    17  ```hcl
    18  data "aws_iam_role" "example" {
    19    role_name = "an_example_role_name"
    20  }
    21  ```
    22  
    23  ## Argument Reference
    24  
    25  * `role_name` - (Required) The friendly IAM role name to match.
    26  
    27  ## Attributes Reference
    28  
    29  * `arn` - The Amazon Resource Name (ARN) specifying the role.
    30  
    31  * `assume_role_policy_document` - The policy document associated with the role.
    32  
    33  * `path` - The path to the role.
    34  
    35  * `role_id` - The stable and unique string identifying the role.