2026/07/31 - AWS Billing - 3 new api methods
Changes Adds GetEnterpriseSupportChargeSummary, GetEnterpriseSupportContractDetails, and ListEnterpriseSupportLinkedAccountCharges. These APIs provide first-time programmatic access to billing data for Enterprise Support usage previously only available upon request through AWS Concierge or Support.
Returns a summary of Enterprise Support data aggregated across all accounts in the Enterprise Support profile.
See also: AWS API Documentation
Request Syntax
client.get_enterprise_support_charge_summary(
billingMonth='string'
)
string
[REQUIRED]
The billing month in YYYY-MM format. This must be a month in the past.
dict
Response Syntax
{
'payerAccountId': 'string',
'billingMonth': 'string',
'billingPeriodStartDate': datetime(2015, 1, 1),
'billingPeriodEndDate': datetime(2015, 1, 1),
'isEstimated': True|False,
'billDate': datetime(2015, 1, 1),
'supportCharge': 'string',
'totalSupportCharge': 'string',
'supportDiscount': 'string',
'totalSupportEligibleSpend': 'string',
'totalSupportEligibleUsageSpend': 'string',
'totalSupportEligibleReservedInstanceSpend': 'string',
'totalSupportEligibleSavingsPlanSpend': 'string',
'supportChargePercentage': 'string',
'supportEffectivePricingPlan': {
'pricingPlanId': 'string',
'name': 'string',
'description': 'string',
'startDate': datetime(2015, 1, 1),
'endDate': datetime(2015, 1, 1),
'planDiscountPercent': 'string',
'discountAppliesToMinimumCharge': True|False,
'minimumCharge': 'string',
'tiered': 'string',
'tiers': [
{
'tierMinimum': 'string',
'tierMaximum': 'string',
'baseCharge': 'string',
'additionalPercentageOfAggregateCharges': 'string',
'aggregateChargesAdjustment': 'string',
'incremental': True|False,
'increment': 'string',
'incrementCharge': 'string'
},
]
}
}
Response Structure
(dict) --
The response structure for GetEnterpriseSupportChargeSummary.
payerAccountId (string) --
The payer account ID that is authorized to view Enterprise Support data for all accounts in its Support profile.
billingMonth (string) --
The billing month in YYYY-MM format. This must be a month in the past.
billingPeriodStartDate (datetime) --
The start date of the billing period.
billingPeriodEndDate (datetime) --
The end date of the billing period.
isEstimated (boolean) --
When true, the Support charge amount is estimated. When false, the Support charge amount is finalized.
billDate (datetime) --
The date the bill was generated.
supportCharge (string) --
The Support charge amount for the account.
totalSupportCharge (string) --
The total Support charge amount for all accounts in the Support profile.
supportDiscount (string) --
The support discount amount.
totalSupportEligibleSpend (string) --
The total Support-eligible Spend from all accounts in the Support profile. This includes eligible spend from usage of Amazon Web Services, Reserved Instances, and Savings Plans.
totalSupportEligibleUsageSpend (string) --
The total Support-eligible spend from usage of Amazon Web Services from all accounts in the Support profile.
totalSupportEligibleReservedInstanceSpend (string) --
The total Support-eligible Reserved Instance spend from all accounts in the Support profile.
totalSupportEligibleSavingsPlanSpend (string) --
The total Support-eligible Savings Plan spend from all accounts in the Support profile.
supportChargePercentage (string) --
The percentage applied to the total Support-eligible spend to calculate the total Support charge across all accounts in the Support profile.
supportEffectivePricingPlan (dict) --
The effective pricing plan used for the support charge calculation.
pricingPlanId (string) --
The unique identifier for the pricing plan.
name (string) --
The name of the pricing plan.
description (string) --
A description of the pricing plan.
startDate (datetime) --
The start date of the pricing plan.
endDate (datetime) --
The end date of the pricing plan.
planDiscountPercent (string) --
The discount percentage applied by this pricing plan.
discountAppliesToMinimumCharge (boolean) --
Whether the discount applies to the minimum Support charge.
minimumCharge (string) --
The minimum Support charge amount for this pricing plan.
tiered (string) --
Whether the pricing plan uses tiered pricing.
tiers (list) --
The pricing tiers within this plan.
(dict) --
A tier within an Enterprise Support pricing plan.
tierMinimum (string) --
The minimum spend threshold for this tier.
tierMaximum (string) --
The maximum spend threshold for this tier.
baseCharge (string) --
The base charge for this tier.
additionalPercentageOfAggregateCharges (string) --
The additional percentage applied to aggregate charges in this tier.
aggregateChargesAdjustment (string) --
The adjustment applied to aggregate charges.
incremental (boolean) --
Whether the tier charges are calculated incrementally.
increment (string) --
The increment amount for incremental tier calculations.
incrementCharge (string) --
The charge per increment.
Returns Enterprise Support contract details.
See also: AWS API Documentation
Request Syntax
client.get_enterprise_support_contract_details(
billingMonth='string'
)
string
[REQUIRED]
The billing month in YYYY-MM format. This must be a month in the past.
dict
Response Syntax
{
'isContractActive': True|False,
'supportAllocationMethod': 'string',
'supportReservedInstanceAmortizationStartDate': datetime(2015, 1, 1),
'supportReservedInstanceTreatmentMethod': 'string',
'supportSavingsPlansAmortizationStartDate': datetime(2015, 1, 1),
'supportSavingsPlansTreatmentMethod': 'string',
'supportProrateStartDate': datetime(2015, 1, 1),
'contractPayerAccountIds': [
{
'accountId': 'string',
'isGdn': True|False
},
],
'chargedPayerAccountIds': [
{
'accountId': 'string',
'chargePercentage': 'string'
},
],
'additionalSupportCharge': [
{
'description': 'string',
'amount': 'string',
'chargeType': 'string'
},
],
'additionalSupportEligibleUsageSpend': [
{
'description': 'string',
'amount': 'string',
'chargeType': 'string'
},
],
'pricingPlans': [
{
'pricingPlanId': 'string',
'name': 'string',
'description': 'string',
'startDate': datetime(2015, 1, 1),
'endDate': datetime(2015, 1, 1),
'planDiscountPercent': 'string',
'discountAppliesToMinimumCharge': True|False,
'minimumCharge': 'string',
'tiered': 'string',
'tiers': [
{
'tierMinimum': 'string',
'tierMaximum': 'string',
'baseCharge': 'string',
'additionalPercentageOfAggregateCharges': 'string',
'aggregateChargesAdjustment': 'string',
'incremental': True|False,
'increment': 'string',
'incrementCharge': 'string'
},
]
},
]
}
Response Structure
(dict) --
The response structure for GetEnterpriseSupportContractDetails.
isContractActive (boolean) --
When true, the Enterprise Support contract is active. When false, the Enterprise Support Contract is inactive.
supportAllocationMethod (string) --
The method used to distribute the total Support charge amount across each account in the Support profile. Valid values: Proportional, Fixed_Percentage. Proportional means support charges are distributed to each account in proportion to its eligible Spend. Fixed_Percentage means support charges are distributed across accounts according to pre-configured percentages from the contract.
supportReservedInstanceAmortizationStartDate (datetime) --
When supportReservedInstanceTreatmentMethod = AmortizedCustom, only amortized fees for Reserved Instances purchased on or after this date are included in the calculation. This field is Null for all other treatment methods.
supportReservedInstanceTreatmentMethod (string) --
The method used to include Reserved Instance (RI) fees in the Enterprise Support charge calculation. Valid values: None (RI fees excluded from Support-eligible spend), Upfront (full upfront RI fees included in month of purchase), Amortized (RI fees spread over commitment term for RIs purchased on or after Support subscription start date), AmortizedCustom (same as Amortized but only for RIs purchased on or after a specified custom start date), AmortizedAll (RI fees amortized for all active RIs including those purchased before Support subscription started).
supportSavingsPlansAmortizationStartDate (datetime) --
This is applicable when supportSavingsPlansTreatmentMethod = Amortized and is Null for all other methods. It shows the start date from which Savings Plan fees are included in Support Eligible Spend.
supportSavingsPlansTreatmentMethod (string) --
The method used to include Savings Plans fees in Enterprise Support charge calculations. Valid values: None (Savings Plan fees excluded from Support-eligible spend), Upfront (full upfront Savings Plan fees included in month of purchase), Amortized (Savings Plan fees spread over commitment term for Savings Plans purchased on or after Support subscription start date), AmortizedCustom (same as Amortized but only for Savings Plans purchased on or after a specified custom start date), AmortizedAll (Savings Plan fees amortized for all active Savings Plans including those purchased before Support subscription started).
supportProrateStartDate (datetime) --
The start date for accounts subscribed or unsubscribed to Support billing during the billing month.
contractPayerAccountIds (list) --
The list of accounts covered by the Enterprise Support contract.
(dict) --
An account that is covered by the Enterprise Support contract.
accountId (string) --
The account ID.
isGdn (boolean) --
When true, Support charges are calculated on charges before private discounts. When false, they are calculated after private discounts.
chargedPayerAccountIds (list) --
The list of payer accounts and their charge allocation percentages.
(dict) --
An account that is charged all or a portion of the total Support charge and the percentage of the charge allocated to it.
accountId (string) --
The account ID.
chargePercentage (string) --
The percentage of the total Support charge allocated to this account. This is 0.0 when supportAllocationMethod = Proportional.
additionalSupportCharge (list) --
Any Additional support charges applied to the contract.
(dict) --
An additional charge applied to an Enterprise Support contract.
description (string) --
A description of the additional charge.
amount (string) --
The charge amount.
chargeType (string) --
The type of additional charge.
additionalSupportEligibleUsageSpend (list) --
Any Additional support-eligible usage spend charges.
(dict) --
An additional charge applied to an Enterprise Support contract.
description (string) --
A description of the additional charge.
amount (string) --
The charge amount.
chargeType (string) --
The type of additional charge.
pricingPlans (list) --
The pricing plans associated with this Enterprise Support contract.
(dict) --
A pricing plan for Enterprise Support billing.
pricingPlanId (string) --
The unique identifier for the pricing plan.
name (string) --
The name of the pricing plan.
description (string) --
A description of the pricing plan.
startDate (datetime) --
The start date of the pricing plan.
endDate (datetime) --
The end date of the pricing plan.
planDiscountPercent (string) --
The discount percentage applied by this pricing plan.
discountAppliesToMinimumCharge (boolean) --
Whether the discount applies to the minimum Support charge.
minimumCharge (string) --
The minimum Support charge amount for this pricing plan.
tiered (string) --
Whether the pricing plan uses tiered pricing.
tiers (list) --
The pricing tiers within this plan.
(dict) --
A tier within an Enterprise Support pricing plan.
tierMinimum (string) --
The minimum spend threshold for this tier.
tierMaximum (string) --
The maximum spend threshold for this tier.
baseCharge (string) --
The base charge for this tier.
additionalPercentageOfAggregateCharges (string) --
The additional percentage applied to aggregate charges in this tier.
aggregateChargesAdjustment (string) --
The adjustment applied to aggregate charges.
incremental (boolean) --
Whether the tier charges are calculated incrementally.
increment (string) --
The increment amount for incremental tier calculations.
incrementCharge (string) --
The charge per increment.
Returns Support-eligible spend broken down at linked account level.
See also: AWS API Documentation
Request Syntax
client.list_enterprise_support_linked_account_charges(
billingMonth='string',
accountId='string',
maxResults=123,
nextToken='string'
)
string
[REQUIRED]
The billing month in YYYY-MM format. This must be a month in the past.
string
An optional linked account ID to filter results to a specific account.
integer
The maximum number of results to return per page.
string
The pagination token for the next page of results.
dict
Response Syntax
{
'linkedAccount': [
{
'accountId': 'string',
'payerAccountId': 'string',
'accountType': 'string',
'billableSeconds': 123,
'totalSeconds': 123,
'totalSupportEligibleSpend': 'string',
'proratedTotalSupportEligibleSpend': 'string',
'linkedTimePeriods': [
{
'beginDate': datetime(2015, 1, 1),
'endDate': datetime(2015, 1, 1)
},
],
'subscriptionTimePeriods': [
{
'beginDate': datetime(2015, 1, 1),
'endDate': datetime(2015, 1, 1)
},
],
'totalSupportEligibleReservedInstanceSpend': 'string',
'totalSupportEligibleSavingsPlanSpend': 'string',
'supportEligibleSpendByService': [
{
'serviceCode': 'string',
'totalSupportEligibleSpend': 'string'
},
]
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
The response structure for ListEnterpriseSupportLinkedAccountCharges.
linkedAccount (list) --
The list of Enterprise Support charges per linked account.
(dict) --
Enterprise Support charges for a linked account.
accountId (string) --
The linked account ID.
payerAccountId (string) --
The payer account ID that is authorized to view Enterprise Support data for all accounts in its Support profile.
accountType (string) --
The type of account.
billableSeconds (integer) --
The number of billable seconds in the billing period based on when the account was subscribed to Enterprise Support.
totalSeconds (integer) --
The total number of seconds in the billing period.
totalSupportEligibleSpend (string) --
The total support-eligible spend for this account.
proratedTotalSupportEligibleSpend (string) --
The prorated total support-eligible spend based on when the account was subscribed to Enterprise Support.
linkedTimePeriods (list) --
The time periods during which this account was linked.
(dict) --
A time period for Enterprise Support billing.
beginDate (datetime) --
The begin date of the time period.
endDate (datetime) --
The end date of the time period.
subscriptionTimePeriods (list) --
The subscription time periods for this account.
(dict) --
A time period for Enterprise Support billing.
beginDate (datetime) --
The begin date of the time period.
endDate (datetime) --
The end date of the time period.
totalSupportEligibleReservedInstanceSpend (string) --
The total support-eligible Reserved Instance spend for this account.
totalSupportEligibleSavingsPlanSpend (string) --
The total support-eligible Savings Plan spend for this account.
supportEligibleSpendByService (list) --
The support-eligible spend broken down by service.
(dict) --
Service-level usage details by account.
serviceCode (string) --
The service code for which to return Support-eligible spend data.
totalSupportEligibleSpend (string) --
The total support-eligible spend for the service.
nextToken (string) --
The pagination token for the next page of results.