---
title: "GET /role-aliases/{roleAlias}"
method: GET
path: "/role-aliases/{roleAlias}"
---

# GET /role-aliases/{roleAlias}

`GET /role-aliases/{roleAlias}`

Describes a role alias.

Requires permission to access the [DescribeRoleAlias](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `roleAlias` string, required

## Response `200`

Success

- DescribeRoleAliasResponse
  - `roleAliasDescription` object — The role alias description.
    - `roleAlias` string — The role alias.
    - `roleAliasArn` string — The ARN of the role alias.
    - `roleArn` string — The role ARN.
    - `owner` string — The role alias owner.
    - `credentialDurationSeconds` integer — The number of seconds for which the credential is valid.
    - `creationDate` string, date-time — The UNIX timestamp of when the role alias was created.
    - `lastModifiedDate` string, date-time — The UNIX timestamp of when the role alias was last modified.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — UnauthorizedException
- `483` — ServiceUnavailableException
- `484` — InternalFailureException
- `485` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/versions/deef5c4b09f0/schema)