list-aws-organizations-settings

dci list-aws-organizations-settings [flags]

Returns automation and recommendation engine settings for every onboarded organization, broken down by product line (compute, database). Settings are configured at the customer level and apply uniformly across all organizations. Only product lines that are activated/onboarded for a given organization are returned. The purchaseAccountId is the member AWS account designated to execute SP purchases on behalf of that organization.

Flags

--page-token: (string)

--max-results: (integer default:50)

Output

List of per-organization per-product-line engine settings.

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
items	array of object
items[].managementAccountId	string	12-digit account number of the organization's management (payer) account.
items[].purchaseAccountId	string	Member AWS account used to execute SP purchases for this organization. Null if not configured.
items[].services	array of object	Settings for each activated product line.
items[].services[].service	string	Product line these settings apply to. One of: "compute", "database".
items[].services[].settings	object	Automation and recommendation engine settings for one product line.
items[].services[].settings.purchaseMode	string	Whether purchases execute automatically or require approval. One of: "autonomous", "requires_approval".
items[].services[].settings.minimumCommitment	number (double)	Minimum hourly commitment amount (USD) per purchase step.
items[].services[].settings.lastDayOfMonthForPurchase	integer	Latest calendar day of the month on which a purchase may be scheduled.
items[].services[].settings.maximumCommitment	number (double)	Maximum total hourly commitment (USD). 0 means no cap.
items[].services[].settings.term	string	Preferred commitment term length.
items[].services[].settings.paymentOption	string	Preferred payment structure for new commitments.
items[].services[].settings.policy	string	Coverage target policy.
items[].services[].settings.upfrontPercentage	number (double)	Fraction of the hourly commitment paid upfront (0–1). Only present when paymentOption is partial_upfront.
pageToken	string	Opaque cursor for the next page. Absent when this is the last page.
rowCount	integer (int64)	Number of items returned in this page.

Raw JSON schema

{
  "type": "object",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "managementAccountId",
          "purchaseAccountId",
          "services"
        ],
        "properties": {
          "managementAccountId": {
            "type": "string",
            "description": "12-digit account number of the organization's management (payer) account.",
            "example": "123456789012"
          },
          "purchaseAccountId": {
            "type": "string",
            "description": "Member AWS account used to execute SP purchases for this organization. Null if not configured.",
            "nullable": true,
            "example": "987654321098"
          },
          "services": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "service",
                "settings"
              ],
              "properties": {
                "service": {
                  "type": "string",
                  "enum": [
                    "compute",
                    "database"
                  ],
                  "description": "Product line these settings apply to."
                },
                "settings": {
                  "type": "object",
                  "description": "Automation and recommendation engine settings for one product line.",
                  "required": [
                    "purchaseMode",
                    "minimumCommitment",
                    "lastDayOfMonthForPurchase",
                    "maximumCommitment",
                    "term",
                    "paymentOption",
                    "policy"
                  ],
                  "properties": {
                    "purchaseMode": {
                      "type": "string",
                      "enum": [
                        "autonomous",
                        "requires_approval"
                      ],
                      "description": "Whether purchases execute automatically or require approval."
                    },
                    "minimumCommitment": {
                      "type": "number",
                      "format": "double",
                      "description": "Minimum hourly commitment amount (USD) per purchase step."
                    },
                    "lastDayOfMonthForPurchase": {
                      "type": "integer",
                      "description": "Latest calendar day of the month on which a purchase may be scheduled."
                    },
                    "maximumCommitment": {
                      "type": "number",
                      "format": "double",
                      "description": "Maximum total hourly commitment (USD). 0 means no cap."
                    },
                    "term": {
                      "allOf": [
                        {
                          "type": "string",
                          "enum": [
                            "one_year",
                            "three_year"
                          ],
                          "description": "Commitment term length."
                        }
                      ],
                      "description": "Preferred commitment term length."
                    },
                    "paymentOption": {
                      "allOf": [
                        {
                          "type": "string",
                          "enum": [
                            "no_upfront",
                            "partial_upfront",
                            "all_upfront"
                          ],
                          "description": "Payment structure for a commitment.\n- `no_upfront` — all charges paid monthly\n- `partial_upfront` — a portion paid upfront; remainder monthly\n- `all_upfront` — full commitment paid upfront\n"
                        }
                      ],
                      "description": "Preferred payment structure for new commitments."
                    },
                    "policy": {
                      "allOf": [
                        {
                          "type": "string",
                          "enum": [
                            "conservative",
                            "balanced",
                            "max_savings"
                          ],
                          "description": "Coverage target policy.\n- `conservative` — lower coverage target (~65%)\n- `balanced` — moderate coverage target (~80%)\n- `max_savings` — aggressive coverage target (~90%)\n"
                        }
                      ],
                      "description": "Coverage target policy."
                    },
                    "upfrontPercentage": {
                      "type": "number",
                      "format": "double",
                      "description": "Fraction of the hourly commitment paid upfront (0–1). Only present when paymentOption is `partial_upfront`."
                    }
                  }
                }
              }
            },
            "description": "Settings for each activated product line."
          }
        }
      }
    },
    "pageToken": {
      "type": "string",
      "description": "Opaque cursor for the next page. Absent when this is the last page.",
      "nullable": true
    },
    "rowCount": {
      "type": "integer",
      "format": "int64",
      "description": "Number of items returned in this page."
    }
  }
}

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.
500, 503	40	API_SERVER_ERROR	The API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: listawsorganizationssettings