> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloudability

> An overview of how Cloudability can be integrated with OpenOps

OpenOps integrates with [Cloudability](https://www.apptio.com/products/cloudability/) to automate the retrieval and management of cloud resource usage recommendations.

## Actions

OpenOps provides four [actions](https://docs.openops.com/workflow-management/actions.md) for interacting with Cloudability:

![Cloudability actions](https://docs.openops.com/images/cloudability-actions.png)

All Cloudability actions are based on the [Cloudability API](https://www.ibm.com/docs/en/cloudability-commercial/cloudability-standard/saas?topic=api-getting-started-cloudability-v3) and require configuring a Cloudability [connection](https://docs.openops.com/cloud-access/access-levels-permissions.md) with your API key and API URL.

![Configuring a Cloudability connection](https://docs.openops.com/images/cloudability-connection.png)

The following sections describe the four actions available in the Cloudability block.

### Get Recommendations

Retrieves cost optimization recommendations from Cloudability with extensive filtering options:

* **Vendor Type**: AWS, Azure, GCP, or Containers
* **Recommendation Type**: Dynamic dropdown based on the selected vendor
* **Look-Back Period**: Last 10 or 30 days
* **Cost Basis**: On-Demand or Effective pricing
* **Recommendations Status**: Show only active, show all (including snoozed), or show only snoozed
* **Limit**: Optional maximum number of recommendations to return
* **Additional Filters**: Custom filters per [Cloudability's rightsizing API documentation](https://www.ibm.com/docs/en/cloudability-commercial/cloudability-standard/saas?topic=api-rightsizing-end-points)

Below is a sample output returned by this step when it is configured to request active AWS EC2 recommendations with a 10-day look-back period:

**Cloudability recommendations**

```json theme={null}
{
  "meta": {
    "info": [],
    "aggregates": [
      {
        "cost": 6.1,
        "basis": "On-Demand",
        "idleSavings": 0,
        "optimizedSavings": 4.97,
        "rightsizeSavings": 1.13
      }
    ],
    "totalCount": 1
  },
  "result": [
    {
      "os": "Linux",
      "idle": 23,
      "name": "LDN-APP03",
      "cpuMax": 22,
      "gpuMax": "N/A",
      "region": "eu-west-2",
      "service": "ec2-recs",
      "snoozed": false,
      "tenancy": "default",
      "lastSeen": "2025-07-20T23:00:00Z",
      "nodeType": "t2.small",
      "provider": "NATIVE",
      "memoryMax": "N/A",
      "unitPrice": 0.03,
      "totalSpend": 6.1,
      "accountName": "Training Account - AL",
      "cpuCapacity": 0.2,
      "gpuCapacity": 0,
      "localDrives": -1,
      "tagMappings": [
        {
          "tag": "tag2",
          "tagName": "Department",
          "vendorTagValue": "shared services"
        },
        {
          "tag": "tag3",
          "tagName": "Business Unit",
          "vendorTagValue": "shared services"
        },
        {
          "tag": "tag5",
          "tagName": "Resource Name",
          "vendorTagValue": "ldn-app03"
        },
        {
          "tag": "tag12",
          "tagName": "Department Mispelling",
          "vendorTagValue": "shared services"
        },
        {
          "tag": "tag21",
          "tagName": "Scaleup",
          "vendorTagValue": "shared services"
        }
      ],
      "commentCount": 4,
      "currencyCode": "USD",
      "daysInactive": 0,
      "gpuMemoryMax": "N/A",
      "hoursRunning": 234.51,
      "localCapacity": -1,
      "instanceFamily": "t2",
      "memoryCapacity": 2,
      "networkCapacity": 100,
      "recommendations": [
        {
          "risk": 0,
          "action": "Rightsize",
          "cpuRisk": 0,
          "savings": 1.13,
          "cpuRatio": 2,
          "diskRisk": 0,
          "gpuRatio": 0,
          "nodeType": "t3a.small",
          "memoryFit": true,
          "unitPrice": 0.02,
          "currentGen": true,
          "inDefaults": true,
          "memoryRisk": 0,
          "sameFamily": false,
          "sameMemory": true,
          "savingsPct": 18,
          "cpuCapacity": 0.4,
          "gpuCapacity": 0,
          "localDrives": -1,
          "memoryRatio": 1,
          "networkRisk": 0,
          "maxInstances": 1,
          "minInstances": 1,
          "networkRatio": 50,
          "defaultsOrder": 1,
          "localCapacity": -1,
          "gpuMemoryRatio": 0,
          "instanceFamily": "t3a",
          "memoryCapacity": 2,
          "networkCapacity": 5000,
          "preferenceOrder": 1,
          "diskXPutCapacity": 160,
          "gpuMemoryCapacity": 0,
          "previousGenTarget": false,
          "persistentStorageAdded": false
        },
        {
          "risk": 0,
          "action": "Rightsize",
          "cpuRisk": 0,
          "savings": 0.56,
          "cpuRatio": 2,
          "diskRisk": 0,
          "gpuRatio": 0,
          "nodeType": "t3.small",
          "memoryFit": true,
          "unitPrice": 0.02,
          "currentGen": true,
          "inDefaults": true,
          "memoryRisk": 0,
          "sameFamily": false,
          "sameMemory": true,
          "savingsPct": 9,
          "cpuCapacity": 0.4,
          "gpuCapacity": 0,
          "localDrives": -1,
          "memoryRatio": 1,
          "networkRisk": 0,
          "maxInstances": 1,
          "minInstances": 1,
          "networkRatio": 50,
          "defaultsOrder": 2,
          "localCapacity": -1,
          "gpuMemoryRatio": 0,
          "instanceFamily": "t3",
          "memoryCapacity": 2,
          "networkCapacity": 5000,
          "preferenceOrder": 2,
          "diskXPutCapacity": 160,
          "gpuMemoryCapacity": 0,
          "previousGenTarget": false,
          "persistentStorageAdded": false
        }
      ],
      "snoozeExpiresOn": "",
      "vendorAccountId": "366445176032",
      "availabilityZone": "eu-west-2c",
      "defaultMemoryFit": true,
      "maxInstanceCount": 1,
      "minInstanceCount": 1,
      "defaultCurrentGen": true,
      "defaultSameFamily": false,
      "gpuMemoryCapacity": 0,
      "resourceIdentifier": "i-0d380eee1c3bc4fed",
      "defaultCrossArchitecture": false
    }
  ]
}
```

### Snooze Recommendations

Temporarily dismisses specific recommendations:

* **Vendor Type**: AWS, Azure, GCP, or Containers
* **Recommendation Type**: Dynamic dropdown based on the selected vendor
* **Account ID**: The cloud account ID
* **Resource IDs**: Array of resource IDs to snooze
* **Snooze Until**: Date in `yyyy-MM-dd` format, or "never" for indefinite snoozing

### Unsnooze Recommendations

Reactivates previously snoozed recommendations:

* **Vendor Type**: AWS, Azure, GCP, or Containers
* **Recommendation Type**: Dynamic dropdown based on the selected vendor
* **Account ID**: The cloud account ID
* **Resource IDs**: Array of resource IDs to unsnooze

### Custom API Call

Allows making arbitrary calls to any [Cloudability API](https://www.ibm.com/docs/en/cloudability-commercial/cloudability-standard/saas?topic=api-getting-started-cloudability-v3) endpoint:

* **URL**: Dynamic endpoint selection
* **Method**: `GET`, `POST`, `PATCH`, `PUT`, `DELETE`, or `HEAD`
* **Headers**: Optional (authorization auto-injected)
* **Query Parameters**: Optional
* **Body**: Optional JSON payload

## Designing a workflow

A typical Cloudability workflow starts by collecting active recommendations using the *Get Recommendations* action and iterating through them. For each recommendation, the workflow determines the owner of the affected resource from the `tagMappings` array returned with it, and asks the owner for a decision in Slack. If the owner approves, the workflow remediates the resource using the actions available for the [cloud platforms OpenOps supports](https://docs.openops.com/cloud-access/supported-cloud-providers.md). If the owner snoozes it, the workflow delays the recommendation with *Snooze Recommendations* and can reactivate it later with *Unsnooze Recommendations*.

For the patterns behind owner mapping, approval requests, and decision tracking, see [Designing Workflows with FinOps Platforms](https://docs.openops.com/cookbook/designing-workflows-with-finops-platforms.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.