AWS Fundamentals Logo
AWS Fundamentals
AWS::IAM::InstanceProfile

IAM InstanceProfile

Creates a new instance profile. For information about instance profiles, see [Using instance profiles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html). For information about the number of instance profiles you can create, see [object quotas](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html) in the *User Guide*.

Properties

3 configurable properties. 1 required. Click a row to see details.

Filter:
PropertyTypeFlags
Roles
Array<string>
Required
InstanceProfileName
string
Create-only
Path
string
Create-only

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

AttributeTypeDescription
Arnstring-

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::IAM::InstanceProfile

Resources:
  MyResource:
    Type: AWS::IAM::InstanceProfile
    Properties:
      Roles: []

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

iam:CreateInstanceProfileiam:PassRoleiam:AddRoleToInstanceProfileiam:GetInstanceProfile

read

iam:GetInstanceProfile

update

iam:PassRoleiam:RemoveRoleFromInstanceProfileiam:AddRoleToInstanceProfileiam:GetInstanceProfile

delete

iam:GetInstanceProfileiam:RemoveRoleFromInstanceProfileiam:DeleteInstanceProfile

list

iam:ListInstanceProfiles

Get the IAM Cheat Sheet

Everything you need to know about IAM on one page. HD quality, print-friendly.

Download Free Infographic

Quick Facts

ServiceIAM
Properties4
Required1
TaggingNot supported
Primary IDInstanceProfileName

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

InstanceProfileNamePath

Related Resources

External Links