list-aws-member-accounts
dci list-aws-member-accounts managementAccountId [flags]
Returns all member AWS accounts under the specified organization that have
active or historical commitment coverage. Includes 30-day statistics and estimated
monthly potential savings (monthlyPotentialSavings) per SP type.
Flags
--page-token: (string)
--max-results: (integer default:50)
Output
List of member accounts.
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[].memberAccountId | string | 12-digit AWS member account ID. |
items[].managementAccountId | string | 12-digit AWS management (payer) account ID of the parent AWS Organization. |
items[].displayName | string | Human-readable account alias, if available. |
items[].stats30d | object | Trailing 30-day aggregate metrics per SP type. |
items[].stats30d.compute | object | Minimal 30-day aggregate. Only esr and savings are persisted at this granularity. Responses are denominated in USD. Used by both AWS organization/member-account and GCP billing-account list items. |
items[].stats30d.compute.esr | number (double) | Effective Savings Rate over the last 30 days (0–1). |
items[].stats30d.compute.savings | object | Realized savings amount over the last 30 days. Nested fields omitted — see the raw JSON schema. |
items[].stats30d.database | object | Minimal 30-day aggregate. Only esr and savings are persisted at this granularity. Responses are denominated in USD. Used by both AWS organization/member-account and GCP billing-account list items. |
items[].stats30d.database.esr | number (double) | Effective Savings Rate over the last 30 days (0–1). |
items[].stats30d.database.savings | object | Realized savings amount over the last 30 days. Nested fields omitted — see the raw JSON schema. |
items[].monthlyPotentialSavings | object | Estimated monthly additional savings per SP type for this member account, attributed from the parent organization's projection by share of trailing-60-day SP-eligible on-demand cost. |
items[].monthlyPotentialSavings.compute | object | |
items[].monthlyPotentialSavings.compute.amount | string | Decimal monetary amount at ISO 4217 minor-unit precision (string). |
items[].monthlyPotentialSavings.compute.currency | string | ISO 4217 currency code. |
items[].monthlyPotentialSavings.database | object | |
items[].monthlyPotentialSavings.database.amount | string | Decimal monetary amount at ISO 4217 minor-unit precision (string). |
items[].monthlyPotentialSavings.database.currency | string | ISO 4217 currency code. |
pageToken | string | |
rowCount | integer (int64) | Best-effort count for the filtered result set. May be null or omitted for expensive counts. |
Raw JSON schema
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"memberAccountId",
"managementAccountId"
],
"properties": {
"memberAccountId": {
"type": "string",
"description": "12-digit AWS member account ID."
},
"managementAccountId": {
"type": "string",
"description": "12-digit AWS management (payer) account ID of the parent AWS Organization."
},
"displayName": {
"type": "string",
"description": "Human-readable account alias, if available.",
"nullable": true,
"example": "prod-web"
},
"stats30d": {
"type": "object",
"description": "Trailing 30-day aggregate metrics per SP type.",
"properties": {
"compute": {
"type": "object",
"description": "Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity.\nResponses are denominated in USD. Used by both AWS organization/member-account and GCP\nbilling-account list items.\n",
"properties": {
"esr": {
"type": "number",
"format": "double",
"description": "Effective Savings Rate over the last 30 days (0–1).",
"nullable": true,
"example": 0.187
},
"savings": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Realized savings amount over the last 30 days."
}
}
},
"database": {
"type": "object",
"description": "Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity.\nResponses are denominated in USD. Used by both AWS organization/member-account and GCP\nbilling-account list items.\n",
"properties": {
"esr": {
"type": "number",
"format": "double",
"description": "Effective Savings Rate over the last 30 days (0–1).",
"nullable": true,
"example": 0.187
},
"savings": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Realized savings amount over the last 30 days."
}
}
}
}
},
"monthlyPotentialSavings": {
"allOf": [
{
"type": "object",
"description": "Estimated monthly additional savings per SP type, taken from the latest PS4C purchase\nprojection. Unlike `savingsTotals` (realized YTD/lifetime savings), this is a forward-looking\nestimate of the monthly savings achievable if the recommended commitments were purchased. For\nmember accounts, the organization figure is attributed by each member account's share of\ntrailing-60-day SP-eligible on-demand cost. A per-SP-type value of `0.00` means the latest\nprojection is missing, expired, or empty. The field is omitted entirely only for accounts that\nhave never had potential savings computed.\n",
"properties": {
"compute": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
},
"database": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
}
}
],
"description": "Estimated monthly additional savings per SP type for this member account, attributed from\nthe parent organization's projection by share of trailing-60-day SP-eligible on-demand cost.\n"
}
}
}
},
"pageToken": {
"type": "string",
"nullable": true
},
"rowCount": {
"type": "integer",
"format": "int64",
"description": "Best-effort count for the filtered result set. May be null or omitted for expensive counts.",
"nullable": true
}
}
}
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: listawsmemberaccounts