GetIdleRecommendationsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-compute-optimizer/json-schema/amazon-compute-optimizer-get-idle-recommendations-request-schema.json",
  "title": "GetIdleRecommendationsRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-compute-optimizer-operations-api-openapi.yml#/components/schemas/GetIdleRecommendationsRequest",
  "type": "object",
  "properties": {
    "resourceArns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The ARN that identifies the idle resource."
    },
    "nextToken": {
      "type": "string",
      "description": "The token to advance to the next page of idle resource recommendations."
    },
    "maxResults": {
      "type": "integer",
      "description": "The maximum number of idle resource recommendations to return with a single request. To retrieve the remaining results, make another request with the returned nextToken value."
    },
    "filters": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/IdleRecommendationFilter"
      },
      "description": "An array of objects to specify a filter that returns a more specific list of idle resource recommendations."
    },
    "accountIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Return the idle resource recommendations to the specified Amazon Web Services account IDs. If your account is the management account or the delegated administrator of an organization, use this parameter to return the idle resource recommendations to specific member accounts. You can only specify one account ID per request."
    },
    "orderBy": {
      "$ref": "#/$defs/OrderBy"
    }
  },
  "$defs": {
    "IdleRecommendationFilter": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "enum": [
            "Finding",
            "ResourceType"
          ],
          "description": "The name of the filter. Specify Finding to return recommendations with a specific finding classification. You can filter your idle resource recommendations by tag:key and tag-key tags. A tag:key is a key and value combination of a tag assigned to your idle resource recommendations. Use the tag key in the filter name and the tag value as the filter value. For example, to find all idle resource service recommendations that have a tag with the key of Owner and the value of TeamA, specify tag:Owner for the filter name and TeamA for the filter value. A tag-key is the key of a tag assigned to your i"
        },
        "values": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The value of the filter."
        }
      }
    },
    "OrderBy": {
      "type": "object",
      "properties": {
        "dimension": {
          "type": "string",
          "enum": [
            "SavingsValue",
            "SavingsValueAfterDiscount"
          ],
          "description": "The dimension values to sort the recommendations."
        },
        "order": {
          "type": "string",
          "enum": [
            "Asc",
            "Desc"
          ],
          "description": "The order to sort the recommendations."
        }
      }
    }
  }
}