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 and PCL 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 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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also