Skip to content

Retrieves information about a version of the specified role template

Description

Retrieves information about a version of the specified role template. Role templates define a reusable configuration—including role name and path patterns, trust policy, inline and managed policies, permissions boundary, tags, and maximum session duration—that you use to create IAM roles with acquire_role.

If you do not specify a minor version, the service returns the template's default minor version.

Usage

iam_get_role_template_version(TemplateArn, MinorVersion)

Arguments

  • TemplateArn

[required] The Amazon Resource Name (ARN) of the role template whose version you want to retrieve.

For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

  • MinorVersion

The minor version of the role template to retrieve. If you do not specify a minor version, the service returns the template's default minor version.

Value

A list with the following syntax:

list(
  RoleTemplateVersion = list(
    TemplateArn = "string",
    TemplateName = "string",
    TemplateVersionId = "string",
    Description = "string",
    MajorVersion = 123,
    DefaultMinorVersion = 123,
    ManagedByType = "Service",
    ManagedByValue = "string",
    Enabled = TRUE|FALSE,
    MinorVersion = 123,
    RoleNamePattern = "string",
    RolePathPattern = "string",
    RoleDescriptionPattern = "string",
    AssumeRolePolicyDocumentTemplate = "string",
    InlinePolicyTemplates = list(
      list(
        PolicyName = "string",
        PolicyDocument = "string"
      )
    ),
    ManagedPolicyArns = list(
      "string"
    ),
    PermissionBoundaryArn = "string",
    ParametersDefinition = list(
      list(
        Name = "string",
        Type = "String"|"StringList"|"Number"|"NumberList"|"Arn"|"ArnList",
        SubType = "string",
        Description = "string",
        IsRequired = TRUE|FALSE,
        DefaultValue = "string",
        Immutable = TRUE|FALSE
      )
    ),
    RoleTagsTemplate = list(
      list(
        Key = "string",
        Value = "string"
      )
    ),
    MaxSessionDuration = 123,
    VersionEnabled = TRUE|FALSE,
    CreateTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    UpdateTimestamp = as.POSIXct(
      "2015-01-01"
    )
  )
)

Request syntax

svc$get_role_template_version(
  TemplateArn = "string",
  MinorVersion = 123
)