list-aws-recommendations

dci list-aws-recommendations managementAccountId

Returns commitment purchase recommendations for the organization. Multiple recommendations may exist per organization (one per service).

Output

List of recommendations.

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

Field	Type	Description
`compute`	object	Recommended commitments for compute
`compute.policy`	string	Actual configured policy
`compute.currentCommitment`	number (double)	Active commitments currently applied to this account, measured in hourly spend.
`compute.recommendedCommitment`	number (double)	Recommended hourly commitment level based on usage patterns and your commitment policy, designed to increase savings while managing underutilization risk.
`compute.potentialAdditionalSavings`	number (double)	Estimated additional monthly savings from applying the recommended commitment policy.
`compute.estimatedAverageCoverage`	number (double)	Estimated average coverage.
`compute.estimatedEquivalentRecommendedCommitment`	number (double)	Estimated shelf-price hourly equivalent of the recommended commitment, derived from the median hourly eligible usage over the last 60 days multiplied by the estimated average coverage.
`database`	object	Recommended commitments for database
`database.policy`	string	Actual configured policy
`database.currentCommitment`	number (double)	Active commitments currently applied to this account, measured in hourly spend.
`database.recommendedCommitment`	number (double)	Recommended hourly commitment level based on usage patterns and your commitment policy, designed to increase savings while managing underutilization risk.
`database.potentialAdditionalSavings`	number (double)	Estimated additional monthly savings from applying the recommended commitment policy.
`database.estimatedAverageCoverage`	number (double)	Estimated average coverage.
`database.estimatedEquivalentRecommendedCommitment`	number (double)	Estimated shelf-price hourly equivalent of the recommended commitment, derived from the median hourly eligible usage over the last 60 days multiplied by the estimated average coverage.

Raw JSON schema

{
  "type": "object",
  "description": "Recommended commitments for onboarded services",
  "properties": {
    "compute": {
      "allOf": [
        {
          "type": "object",
          "description": "Recommended commitments",
          "properties": {
            "policy": {
              "type": "string",
              "description": "Actual configured policy"
            },
            "currentCommitment": {
              "type": "number",
              "format": "double",
              "description": "Active commitments currently applied to this account, measured in hourly spend."
            },
            "recommendedCommitment": {
              "type": "number",
              "format": "double",
              "description": "Recommended hourly commitment level based on usage patterns and your commitment policy, designed to increase savings while managing underutilization risk."
            },
            "potentialAdditionalSavings": {
              "type": "number",
              "format": "double",
              "description": "Estimated additional monthly savings from applying the recommended commitment policy."
            },
            "estimatedAverageCoverage": {
              "type": "number",
              "format": "double",
              "description": "Estimated average coverage."
            },
            "estimatedEquivalentRecommendedCommitment": {
              "type": "number",
              "format": "double",
              "description": "Estimated shelf-price hourly equivalent of the recommended commitment, derived from the median hourly eligible usage over the last 60 days multiplied by the estimated average coverage."
            }
          }
        }
      ],
      "description": "Recommended commitments for compute"
    },
    "database": {
      "allOf": [
        {
          "type": "object",
          "description": "Recommended commitments",
          "properties": {
            "policy": {
              "type": "string",
              "description": "Actual configured policy"
            },
            "currentCommitment": {
              "type": "number",
              "format": "double",
              "description": "Active commitments currently applied to this account, measured in hourly spend."
            },
            "recommendedCommitment": {
              "type": "number",
              "format": "double",
              "description": "Recommended hourly commitment level based on usage patterns and your commitment policy, designed to increase savings while managing underutilization risk."
            },
            "potentialAdditionalSavings": {
              "type": "number",
              "format": "double",
              "description": "Estimated additional monthly savings from applying the recommended commitment policy."
            },
            "estimatedAverageCoverage": {
              "type": "number",
              "format": "double",
              "description": "Estimated average coverage."
            },
            "estimatedEquivalentRecommendedCommitment": {
              "type": "number",
              "format": "double",
              "description": "Estimated shelf-price hourly equivalent of the recommended commitment, derived from the median hourly eligible usage over the last 60 days multiplied by the estimated average coverage."
            }
          }
        }
      ],
      "description": "Recommended commitments for database"
    }
  }
}

Errors

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP status	Exit code	Error code	Meaning
400	30	`VALIDATION_ERROR`	The arguments or request body were rejected. Review the command's flags and payload.
401	10	`AUTHENTICATION_FAILED`	Not signed in, or the API token is invalid. Run `dci login` or check `DCI_API_KEY`.
403	11	`PERMISSION_DENIED`	The DoiT user or the active customer context does not have access.
404	20	`RESOURCE_NOT_FOUND`	The requested resource does not exist. Check the identifier argument.
500, 503	40	`API_SERVER_ERROR`	The API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: listawsrecommendations

Output​

Errors​

Output

Errors