Skip to content

IAM  >  Operations  >  get_role_template_version

get_role_template_version

Operation

get_role_template_version async

get_role_template_version(request: GetRoleTemplateVersionInput | GetRoleTemplateVersionInputDict, /, *, plugins: list[Plugin] | None = None) -> GetRoleTemplateVersionOutput
get_role_template_version(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetRoleTemplateVersionInputDict]) -> 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
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

Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.

Model

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.

Dictionaries

GetRoleTemplateVersionInputDict

Bases: TypedDict

Dictionary form of GetRoleTemplateVersionInput.

Attributes
minor_version 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 instance-attribute
template_arn: Required[str]

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.