AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.


For .NET Core this operation is only available in asynchronous form. Please refer to AssociateIamInstanceProfileAsync.

Namespace: Amazon.EC2
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z


public virtual AssociateIamInstanceProfileResponse AssociateIamInstanceProfile(
         AssociateIamInstanceProfileRequest request


Type: Amazon.EC2.Model.AssociateIamInstanceProfileRequest

Container for the necessary parameters to execute the AssociateIamInstanceProfile service method.

Return Value

The response from the AssociateIamInstanceProfile service method, as returned by EC2.


This example associates an IAM instance profile named admin-role with the specified instance.

To associate an IAM instance profile with an instance

var client = new AmazonEC2Client();
var response = client.AssociateIamInstanceProfile(new AssociateIamInstanceProfileRequest 
    IamInstanceProfile = new IamInstanceProfileSpecification { Name = "admin-role" },
    InstanceId = "i-123456789abcde123"

IamInstanceProfileAssociation iamInstanceProfileAssociation = response.IamInstanceProfileAssociation;


Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also