Skip to content
GitHubXDiscord

RoleAlias

The RoleAlias resource lets you manage AWS IoT RoleAliases and their configurations. RoleAliases are used to simplify the management of AWS IoT policies and permissions for devices.

Create a basic RoleAlias with required properties and a common optional property:

import AWS from "alchemy/aws/control";
const basicRoleAlias = await AWS.IoT.RoleAlias("basicRoleAlias", {
RoleAlias: "MyDeviceRoleAlias",
RoleArn: "arn:aws:iam::123456789012:role/MyIoTRole",
CredentialDurationSeconds: 3600 // Optional: Duration in seconds
});

Configure a RoleAlias with tags for better organization and management:

const advancedRoleAlias = await AWS.IoT.RoleAlias("advancedRoleAlias", {
RoleAlias: "MyAdvancedDeviceRoleAlias",
RoleArn: "arn:aws:iam::123456789012:role/MyAdvancedIoTRole",
CredentialDurationSeconds: 7200, // Optional: Extended duration
Tags: [
{ Key: "Environment", Value: "Production" },
{ Key: "Team", Value: "IoT Development" }
]
});

Handle the case where you want to adopt an existing RoleAlias instead of failing:

const adoptedRoleAlias = await AWS.IoT.RoleAlias("adoptedRoleAlias", {
RoleAlias: "ExistingDeviceRoleAlias",
RoleArn: "arn:aws:iam::123456789012:role/ExistingIoTRole",
adopt: true // Enables adoption of existing RoleAlias
});