Skip to content

IAM  >  Operations  >  get_role_template_version

get_role_template_version

Operation

get_role_template_version async 

get_role_template_version(input: GetRoleTemplateVersionInput, plugins: list[Plugin] | None = None) -> GetRoleTemplateVersionOutput

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 AcquireRole.

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

Parameters:

Name Type Description Default
input GetRoleTemplateVersionInput

An instance of GetRoleTemplateVersionInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
GetRoleTemplateVersionOutput

An instance of GetRoleTemplateVersionOutput.

Input

GetRoleTemplateVersionInput dataclass

Bases: _SerdeShape

Dataclass for GetRoleTemplateVersionInput structure.

Attributes

minor_version class-attribute instance-attribute 
minor_version: int | None = ...

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.

template_arn class-attribute instance-attribute 
template_arn: str | None = ...

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.

Output

GetRoleTemplateVersionOutput dataclass

Bases: _SerdeShape

Dataclass for GetRoleTemplateVersionOutput structure.

Attributes

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

role_template_version instance-attribute 
role_template_version: RoleTemplateVersion

A structure that contains details about the requested role template version.