# @serverless/aws-iam-role

> Easily provision AWS IAM roles using [Serverless Components](https://github.com/serverless/components).

Latest version **1.0.0** (published 2019-07-17) · Apache license · 0 weekly downloads

## Install

```sh
npm install @serverless/aws-iam-role
pnpm add @serverless/aws-iam-role
yarn add @serverless/aws-iam-role
bun add @serverless/aws-iam-role
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2019-07-17 |
| First published | 2019-03-20 |
| Weekly downloads | 0 |
| License | Apache |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 24.5 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | Serverless, Inc. |
| Maintainers | ac360, aj.stuyvenberg, dschep, eahefnawy, pmuens |

## Links

- npm: https://www.npmjs.com/package/@serverless/aws-iam-role
- npm.io page: https://npm.io/package/@serverless/aws-iam-role

## Dependencies (3)

- [ramda](https://npm.io/package/ramda.md) ^0.26.0
- [aws-sdk](https://npm.io/package/aws-sdk.md) ^2.488.0
- [@serverless/core](https://npm.io/package/@serverless/core.md) ^1.0.0

## Recent versions

- 1.0.0 (latest) — 2019-07-17
- 0.3.4 — 2019-07-05
- 0.3.3 — 2019-07-04
- 0.3.2 — 2019-07-04
- 0.3.1 — 2019-06-13
- 0.3.0 — 2019-06-13
- 0.2.1 — 2019-06-05
- 0.2.0 — 2019-06-05
- 0.1.5 — 2019-04-18
- 0.1.4 — 2019-03-30
- 0.1.3 — 2019-03-29
- 0.1.2 — 2019-03-27
- 0.1.1 — 2019-03-21
- 0.1.0 — 2019-03-20

## README

# aws-iam-role

Easily provision AWS IAM roles using [Serverless Components](https://github.com/serverless/components).

 

1. [Install](#1-install)
2. [Create](#2-create)
3. [Configure](#3-configure)
4. [Deploy](#4-deploy)

 


### 1. Install

```shell
$ npm install -g @serverless/components
```

### 2. Create

Just create a `serverless.yml` file

```shell
$ touch serverless.yml
$ touch .env      # your development AWS api keys
$ touch .env.prod # your production AWS api keys
```

the `.env` files are not required if you have the aws keys set globally and you want to use a single stage, but they should look like this.

```
AWS_ACCESS_KEY_ID=XXX
AWS_SECRET_ACCESS_KEY=XXX
```

### 3. Configure

```yml
# serverless.yml

name: my-app

myRole:
  component: "@serverless/aws-iam-role"
  inputs:
    name: my-role
    service: lambda.amazonaws.com
    policy:
      arn: arn:aws:iam::aws:policy/AdministratorAccess
    regoin: us-east-1
```

### 4. Deploy

```shell
role (master)$ components

  myRole › outputs:
  name:  'my-role'
  arn:  'arn:aws:iam::552760238299:role/my-test-role'
  service:  'lambda.amazonaws.com'
  policy: 
    arn:  'arn:aws:iam::aws:policy/AdministratorAccess'


  37s › dev › my-app › done

role (master)$
```

 

### New to Components?

Checkout the [Serverless Components](https://github.com/serverless/components) repo for more information.

---
_Source: https://npm.io/package/@serverless/aws-iam-role · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._