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.

Minimal Example

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
});

Advanced Configuration

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" }
  ]
});

Adoption of Existing RoleAlias

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
});