Installation

Install

npm install --save-dev @interlace/serverless-iam-roles-per-function

pnpm add -D @interlace/serverless-iam-roles-per-function

yarn add -D @interlace/serverless-iam-roles-per-function

bun add -d @interlace/serverless-iam-roles-per-function

Wire into the project

serverless.yml

plugins:
  - '@interlace/serverless-iam-roles-per-function'

serverless.ts

const serverlessConfiguration = {
  plugins: ['@interlace/serverless-iam-roles-per-function'],
};

serverless.js

module.exports = {
  plugins: ['@interlace/serverless-iam-roles-per-function'],
};

serverless.json

{
  "plugins": ["@interlace/serverless-iam-roles-per-function"]
}

Smoke test

The status command verifies the plugin loaded and reads your function list, without touching AWS:

sls iam status

Expected output:

[interlace-iam] --- IAM Roles Per Function — Status ---
[interlace-iam]   Functions:                   3
[interlace-iam]   With per-function role:      0
[interlace-iam]   Falling back to global role: 3
[interlace-iam]   defaultInherit:              false
[interlace-iam]   suppressGlobalRole:          false
[interlace-iam]   requirePerFunctionRoles:     false

(Numbers and flags will reflect your project's state — what matters is that the plugin printed at all.)

Configuration — every option you can set under custom.interlaceIamRolesPerFunction
Migration — if you're swapping out serverless-iam-roles-per-function

Install

Wire into the project

Smoke test

Next

On this page