Adding a Cloud

In order to utilize Cloud Recommender, you must have at least one cloud added to your account. You may add a cloud through the Clouds screen by clicking on the “Add Cloud” button.

Cloud Recommender currently supports AWS clouds.


In order to query your AWS account for data, Cloud Recommender needs an IAM role with read permissions to various AWS services. We provide an Amazon CloudFormation template that you can use to set everything up.

To add a cloud:

  1. Launch the CloudFormation template.

    1. At the end, under Capabilities, be sure to check the box next to “I acknowledge that AWS CloudFormation might create IAM resources.”
    2. Click on “Create stack”.
  2. Wait for the stack to complete.

  3. Provide Cloud Recommender with the value of the MonitorRoleARN output.

While we tried to make the entire role permissions read-only, we did have to add write permissions around creating a Cost And Usage Report, since CloudFormation does not provide the capability to create one at this time. All of write permissions are limited to a single resource (a Cost And Usage Report with a particular name).

If “Access” is set to “Read-write” (default), a second role will be created that will be used to allow you to automate the recommendations. You may set this to “Read-only” to avoid granting this access, but Cloud Recommender will not be able to automate any recommendations.

When you follow the “Add Cloud” workflow, the only thing that you must provide is the MonitorRoleARN output. However, we do allow you to modify the External ID value. Cloud Recommender uses an External ID when assuming the IAM role to connect to your cloud as outlined in this document.

When you add a new cloud, Cloud Recommender generates a random External ID. You may change this ID if you like; note that you must change it both in Cloud Recommender and in the CloudFormation stack (you may do so in the same place where you name the new stack).

Once the new cloud has been added, its status will be set to pending. The cloud will automatically be scheduled for mining and analysis; this process can take some time, depending on the quantity of resources that your cloud has. Once analysis has completed, Cloud Recommender will provide you with a series of recommendations to reduce cost and increase performance.