Table of Contents
BillingConductor.Client¶A low-level client representing AWSBillingConductor
Amazon Web Services Billing Conductor is a fully managed service that you can use to customize a pro forma version of your billing data each month, to accurately show or chargeback your end customers. Amazon Web Services Billing Conductor doesn't change the way you're billed by Amazon Web Services each month by design. Instead, it provides you with a mechanism to configure, generate, and display rates to certain customers over a given billing period. You can also analyze the difference between the rates you apply to your accounting groupings relative to your actual rates from Amazon Web Services. As a result of your Amazon Web Services Billing Conductor configuration, the payer account can also see the custom rate applied on the billing details page of the Amazon Web Services Billing console , or configure a cost and usage report per billing group.
This documentation shows how you can configure Amazon Web Services Billing Conductor using its API. For more information about using the Amazon Web Services Billing Conductor user interface, see the Amazon Web Services Enterprise Billing Console User Guide .
import boto3
client = boto3.client('billingconductor')
These are the available methods:
associate_accounts()associate_pricing_rules()batch_associate_resources_to_custom_line_item()batch_disassociate_resources_from_custom_line_item()can_paginate()close()create_billing_group()create_custom_line_item()create_pricing_plan()create_pricing_rule()delete_billing_group()delete_custom_line_item()delete_pricing_plan()delete_pricing_rule()disassociate_accounts()disassociate_pricing_rules()get_paginator()get_waiter()list_account_associations()list_billing_group_cost_reports()list_billing_groups()list_custom_line_items()list_pricing_plans()list_pricing_plans_associated_with_pricing_rule()list_pricing_rules()list_pricing_rules_associated_to_pricing_plan()list_resources_associated_to_custom_line_item()list_tags_for_resource()tag_resource()untag_resource()update_billing_group()update_custom_line_item()update_pricing_plan()update_pricing_rule()associate_accounts(**kwargs)¶Connects an array of account IDs in a consolidated billing family to a predefined billing group. The account IDs must be a part of the consolidated billing family during the current month, and not already associated with another billing group. The maximum number of accounts that can be associated in one call is 30.
See also: AWS API Documentation
Request Syntax
response = client.associate_accounts(
Arn='string',
AccountIds=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the billing group that associates the array of account IDs.
[REQUIRED]
The associating array of account IDs.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the billing group that associates the array of account IDs.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionassociate_pricing_rules(**kwargs)¶Connects an array of PricingRuleArns to a defined PricingPlan . The maximum number PricingRuleArn that can be associated in one call is 30.
See also: AWS API Documentation
Request Syntax
response = client.associate_pricing_rules(
Arn='string',
PricingRuleArns=[
'string',
]
)
[REQUIRED]
The PricingPlanArn that the PricingRuleArns are associated with.
[REQUIRED]
The PricingRuleArns that are associated with the Pricing Plan.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The PricingPlanArn that the PricingRuleArns are associated with.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionbatch_associate_resources_to_custom_line_item(**kwargs)¶Associates a batch of resources to a percentage custom line item.
See also: AWS API Documentation
Request Syntax
response = client.batch_associate_resources_to_custom_line_item(
TargetArn='string',
ResourceArns=[
'string',
],
BillingPeriodRange={
'InclusiveStartBillingPeriod': 'string',
'ExclusiveEndBillingPeriod': 'string'
}
)
[REQUIRED]
A percentage custom line item ARN to associate the resources to.
[REQUIRED]
A list containing the ARNs of the resources to be associated.
The billing period range in which the custom line item request will be applied.
The inclusive start billing period that defines a billing period range where a custom line is applied.
The inclusive end billing period that defines a billing period range where a custom line is applied.
dict
Response Syntax
{
'SuccessfullyAssociatedResources': [
{
'Arn': 'string',
'Error': {
'Message': 'string',
'Reason': 'INVALID_ARN'|'SERVICE_LIMIT_EXCEEDED'|'ILLEGAL_CUSTOMLINEITEM'|'INTERNAL_SERVER_EXCEPTION'
}
},
],
'FailedAssociatedResources': [
{
'Arn': 'string',
'Error': {
'Message': 'string',
'Reason': 'INVALID_ARN'|'SERVICE_LIMIT_EXCEEDED'|'ILLEGAL_CUSTOMLINEITEM'|'INTERNAL_SERVER_EXCEPTION'
}
},
]
}
Response Structure
(dict) --
SuccessfullyAssociatedResources (list) --
A list of AssociateResourceResponseElement for each resource that's been associated to a percentage custom line item successfully.
(dict) --
A resource association result for a percentage custom line item.
Arn (string) --
The resource ARN that was associated to the custom line item.
Error (dict) --
An AssociateResourceError that will populate if the resource association fails.
Message (string) --
The reason the resource association failed.
Reason (string) --
A static error code that used to classify the type of failure.
FailedAssociatedResources (list) --
A list of AssociateResourceResponseElement for each resource that failed association to a percentage custom line item.
(dict) --
A resource association result for a percentage custom line item.
Arn (string) --
The resource ARN that was associated to the custom line item.
Error (dict) --
An AssociateResourceError that will populate if the resource association fails.
Message (string) --
The reason the resource association failed.
Reason (string) --
A static error code that used to classify the type of failure.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionbatch_disassociate_resources_from_custom_line_item(**kwargs)¶Disassociates a batch of resources from a percentage custom line item.
See also: AWS API Documentation
Request Syntax
response = client.batch_disassociate_resources_from_custom_line_item(
TargetArn='string',
ResourceArns=[
'string',
],
BillingPeriodRange={
'InclusiveStartBillingPeriod': 'string',
'ExclusiveEndBillingPeriod': 'string'
}
)
[REQUIRED]
A percentage custom line item ARN to disassociate the resources from.
[REQUIRED]
A list containing the ARNs of resources to be disassociated.
The billing period range in which the custom line item request will be applied.
The inclusive start billing period that defines a billing period range where a custom line is applied.
The inclusive end billing period that defines a billing period range where a custom line is applied.
dict
Response Syntax
{
'SuccessfullyDisassociatedResources': [
{
'Arn': 'string',
'Error': {
'Message': 'string',
'Reason': 'INVALID_ARN'|'SERVICE_LIMIT_EXCEEDED'|'ILLEGAL_CUSTOMLINEITEM'|'INTERNAL_SERVER_EXCEPTION'
}
},
],
'FailedDisassociatedResources': [
{
'Arn': 'string',
'Error': {
'Message': 'string',
'Reason': 'INVALID_ARN'|'SERVICE_LIMIT_EXCEEDED'|'ILLEGAL_CUSTOMLINEITEM'|'INTERNAL_SERVER_EXCEPTION'
}
},
]
}
Response Structure
(dict) --
SuccessfullyDisassociatedResources (list) --
A list of DisassociateResourceResponseElement for each resource that's been disassociated from a percentage custom line item successfully.
(dict) --
A resource disassociation result for a percentage custom line item.
Arn (string) --
The resource ARN that was disassociated from the custom line item.
Error (dict) --
An AssociateResourceError shown if the resource disassociation fails.
Message (string) --
The reason the resource association failed.
Reason (string) --
A static error code that used to classify the type of failure.
FailedDisassociatedResources (list) --
A list of DisassociateResourceResponseElement for each resource that failed disassociation from a percentage custom line item.
(dict) --
A resource disassociation result for a percentage custom line item.
Arn (string) --
The resource ARN that was disassociated from the custom line item.
Error (dict) --
An AssociateResourceError shown if the resource disassociation fails.
Message (string) --
The reason the resource association failed.
Reason (string) --
A static error code that used to classify the type of failure.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptioncan_paginate(operation_name)¶Check if an operation can be paginated.
create_foo, and you'd normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").True if the operation can be paginated,
False otherwise.close()¶Closes underlying endpoint connections.
create_billing_group(**kwargs)¶Creates a billing group that resembles a consolidated billing family that Amazon Web Services charges, based off of the predefined pricing plan computation.
See also: AWS API Documentation
Request Syntax
response = client.create_billing_group(
ClientToken='string',
Name='string',
AccountGrouping={
'LinkedAccountIds': [
'string',
]
},
ComputationPreference={
'PricingPlanArn': 'string'
},
PrimaryAccountId='string',
Description='string',
Tags={
'string': 'string'
}
)
The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.
This field is autopopulated if not provided.
[REQUIRED]
The billing group name. The names must be unique.
[REQUIRED]
The set of accounts that will be under the billing group. The set of accounts resemble the linked accounts in a consolidated family.
The account IDs that make up the billing group. Account IDs must be a part of the consolidated billing family, and not associated with another billing group.
[REQUIRED]
The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
The Amazon Resource Name (ARN) of the pricing plan used to compute the Amazon Web Services charges for a billing group.
A map that contains tag keys and tag values that are attached to a billing group. This feature isn't available during the beta.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the created billing group.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptioncreate_custom_line_item(**kwargs)¶Creates a custom line item that can be used to create a one-time fixed charge that can be applied to a single billing group for the current or previous billing period. The one-time fixed charge is either a fee or discount.
See also: AWS API Documentation
Request Syntax
response = client.create_custom_line_item(
ClientToken='string',
Name='string',
Description='string',
BillingGroupArn='string',
BillingPeriodRange={
'InclusiveStartBillingPeriod': 'string',
'ExclusiveEndBillingPeriod': 'string'
},
Tags={
'string': 'string'
},
ChargeDetails={
'Flat': {
'ChargeValue': 123.0
},
'Percentage': {
'PercentageValue': 123.0,
'AssociatedValues': [
'string',
]
},
'Type': 'CREDIT'|'FEE'
}
)
The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.
This field is autopopulated if not provided.
[REQUIRED]
The name of the custom line item.
[REQUIRED]
The description of the custom line item. This is shown on the Bills page in association with the charge value.
[REQUIRED]
The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
A time range for which the custom line item is effective.
The inclusive start billing period that defines a billing period range where a custom line is applied.
The inclusive end billing period that defines a billing period range where a custom line is applied.
A map that contains tag keys and tag values that are attached to a custom line item.
[REQUIRED]
A CustomLineItemChargeDetails that describes the charge details for a custom line item.
A CustomLineItemFlatChargeDetails that describes the charge details of a flat custom line item.
The custom line item's fixed charge value in USD.
A CustomLineItemPercentageChargeDetails that describes the charge details of a percentage custom line item.
The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
A list of resource ARNs to associate to the percentage custom line item.
The type of the custom line item that indicates whether the charge is a fee or credit.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the created custom line item.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptioncreate_pricing_plan(**kwargs)¶Creates a pricing plan that is used for computing Amazon Web Services charges for billing groups.
See also: AWS API Documentation
Request Syntax
response = client.create_pricing_plan(
ClientToken='string',
Name='string',
Description='string',
PricingRuleArns=[
'string',
],
Tags={
'string': 'string'
}
)
The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.
This field is autopopulated if not provided.
[REQUIRED]
The pricing plan name. The names must be unique to each pricing plan.
A list of Amazon Resource Names (ARNs) that define the pricing plan parameters.
A map that contains tag keys and tag values that are attached to a pricing plan.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the created pricing plan.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptioncreate_pricing_rule(**kwargs)¶Creates a pricing rule can be associated to a pricing plan, or a set of pricing plans.
See also: AWS API Documentation
Request Syntax
response = client.create_pricing_rule(
ClientToken='string',
Name='string',
Description='string',
Scope='GLOBAL'|'SERVICE',
Type='MARKUP'|'DISCOUNT',
ModifierPercentage=123.0,
Service='string',
Tags={
'string': 'string'
}
)
The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.
This field is autopopulated if not provided.
[REQUIRED]
The pricing rule name. The names must be unique to each pricing rule.
[REQUIRED]
The scope of pricing rule that indicates if it is globally applicable, or is service-specific.
[REQUIRED]
The type of pricing rule.
[REQUIRED]
A percentage modifier applied on the public pricing rates.
Scope attribute is set to SERVICE , the attribute indicates which service the PricingRule is applicable for.A map that contains tag keys and tag values that are attached to a pricing rule.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the created pricing rule.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.ServiceLimitExceededExceptionBillingConductor.Client.exceptions.InternalServerExceptiondelete_billing_group(**kwargs)¶Deletes a billing group.
See also: AWS API Documentation
Request Syntax
response = client.delete_billing_group(
Arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the billing group you're deleting.
{
'Arn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the deleted billing group.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptiondelete_custom_line_item(**kwargs)¶Deletes the custom line item identified by the given ARN in the current, or previous billing period.
See also: AWS API Documentation
Request Syntax
response = client.delete_custom_line_item(
Arn='string',
BillingPeriodRange={
'InclusiveStartBillingPeriod': 'string',
'ExclusiveEndBillingPeriod': 'string'
}
)
[REQUIRED]
The ARN of the custom line item to be deleted.
The billing period range in which the custom line item request will be applied.
The inclusive start billing period that defines a billing period range where a custom line is applied.
The inclusive end billing period that defines a billing period range where a custom line is applied.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
Then ARN of the deleted custom line item.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptiondelete_pricing_plan(**kwargs)¶Deletes a pricing plan. The pricing plan must not be associated with any billing groups to delete successfully.
See also: AWS API Documentation
Request Syntax
response = client.delete_pricing_plan(
Arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing plan you're deleting.
{
'Arn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the deleted pricing plan.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptiondelete_pricing_rule(**kwargs)¶Deletes the pricing rule identified by the input Amazon Resource Name (ARN).
See also: AWS API Documentation
Request Syntax
response = client.delete_pricing_rule(
Arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing rule you are deleting.
{
'Arn': 'string'
}
Response Structure
The Amazon Resource Name (ARN) of the deleted pricing rule.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptiondisassociate_accounts(**kwargs)¶Removes the specified list of account IDs from the given billing group.
See also: AWS API Documentation
Request Syntax
response = client.disassociate_accounts(
Arn='string',
AccountIds=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the billing group that the array of account IDs will disassociate from.
[REQUIRED]
The array of account IDs to disassociate.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the billing group that the array of account IDs is disassociated from.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptiondisassociate_pricing_rules(**kwargs)¶Disassociates a list of pricing rules from a pricing plan.
See also: AWS API Documentation
Request Syntax
response = client.disassociate_pricing_rules(
Arn='string',
PricingRuleArns=[
'string',
]
)
[REQUIRED]
The pricing plan Amazon Resource Name (ARN) to disassociate pricing rules from.
[REQUIRED]
A list containing the Amazon Resource Name (ARN) of the pricing rules that will be disassociated.
dict
Response Syntax
{
'Arn': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the pricing plan that the pricing rules successfully disassociated from.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionget_paginator(operation_name)¶Create a paginator for an operation.
create_foo, and you'd normally invoke the
operation as client.create_foo(**kwargs), if the
create_foo operation can be paginated, you can use the
call client.get_paginator("create_foo").client.can_paginate method to
check if an operation is pageable.get_waiter(waiter_name)¶Returns an object that can wait for some condition.
list_account_associations(**kwargs)¶
- Amazon Web Services Billing Conductor is in beta release and is subject to change. Your use of Amazon Web Services Billing Conductor is subject to the Beta Service Participation terms of the `Amazon Web Services Service Terms <https://aws.amazon.com/service-terms/>`__ (Section 1.10). *
This is a paginated call to list linked accounts that are linked to the payer account for the specified time period. If no information is provided, the current billing period is used. The response will optionally include the billing group associated with the linked account.
See also: AWS API Documentation
Request Syntax
response = client.list_account_associations(
BillingPeriod='string',
Filters={
'Association': 'string',
'AccountId': 'string'
},
NextToken='string'
)
The filter on the account ID of the linked account, or any of the following:
MONITORED: linked accounts that are associated to billing groups.
UNMONITORED: linked accounts that are not associated to billing groups.
Billing Group Arn: linked accounts that are associated to the provided billing group Arn.
MONITORED: linked accounts that are associated to billing groups.
UNMONITORED: linked accounts that are not associated to billing groups.
Billing Group Arn: linked accounts that are associated to the provided Billing Group Arn.
The Amazon Web Services account ID to filter on.
dict
Response Syntax
{
'LinkedAccounts': [
{
'AccountId': 'string',
'BillingGroupArn': 'string',
'AccountName': 'string',
'AccountEmail': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
LinkedAccounts (list) --
The list of linked accounts in the payer account.
(dict) --
- Amazon Web Services Billing Conductor is in beta release and is subject to change. Your use of Amazon Web Services Billing Conductor is subject to the Beta Service Participation terms of the `Amazon Web Services Service Terms <https://aws.amazon.com/service-terms/>`__ (Section 1.10). *
A representation of a linked account.
AccountId (string) --
The associating array of account IDs.
BillingGroupArn (string) --
The Billing Group Arn that the linked account is associated to.
AccountName (string) --
The Amazon Web Services account name.
AccountEmail (string) --
The Amazon Web Services account email.
NextToken (string) --
The pagination token used on subsequent calls to get accounts.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_billing_group_cost_reports(**kwargs)¶A paginated call to retrieve a summary report of actual Amazon Web Services charges and the calculated Amazon Web Services charges based on the associated pricing plan of a billing group.
See also: AWS API Documentation
Request Syntax
response = client.list_billing_group_cost_reports(
BillingPeriod='string',
MaxResults=123,
NextToken='string',
Filters={
'BillingGroupArns': [
'string',
]
}
)
A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.
The list of Amazon Resource Names (ARNs) used to filter billing groups to retrieve reports.
dict
Response Syntax
{
'BillingGroupCostReports': [
{
'Arn': 'string',
'AWSCost': 'string',
'ProformaCost': 'string',
'Margin': 'string',
'MarginPercentage': 'string',
'Currency': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingGroupCostReports (list) --
A list of BillingGroupCostReportElement retrieved.
(dict) --
A summary report of actual Amazon Web Services charges and calculated Amazon Web Services charges, based on the associated pricing plan of a billing group.
Arn (string) --
The Amazon Resource Name (ARN) of a billing group.
AWSCost (string) --
The actual Amazon Web Services charges for the billing group.
ProformaCost (string) --
The hypothetical Amazon Web Services charges based on the associated pricing plan of a billing group.
Margin (string) --
The billing group margin.
MarginPercentage (string) --
The percentage of billing group margin.
Currency (string) --
The displayed currency.
NextToken (string) --
The pagination token used on subsequent calls to get reports.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_billing_groups(**kwargs)¶A paginated call to retrieve a list of billing groups for the given billing period. If you don't provide a billing group, the current billing period is used.
See also: AWS API Documentation
Request Syntax
response = client.list_billing_groups(
BillingPeriod='string',
MaxResults=123,
NextToken='string',
Filters={
'Arns': [
'string',
],
'PricingPlan': 'string'
}
)
A ListBillingGroupsFilter that specifies the billing group and pricing plan to retrieve billing group information.
The list of billing group Amazon Resource Names (ARNs) to retrieve information.
The pricing plan Amazon Resource Names (ARNs) to retrieve information.
dict
Response Syntax
{
'BillingGroups': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'PrimaryAccountId': 'string',
'ComputationPreference': {
'PricingPlanArn': 'string'
},
'Size': 123,
'CreationTime': 123,
'LastModifiedTime': 123,
'Status': 'ACTIVE'|'PRIMARY_ACCOUNT_MISSING',
'StatusReason': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingGroups (list) --
A list of BillingGroupListElement retrieved.
(dict) --
A representation of a billing group.
Name (string) --
The billing group's name.
Arn (string) --
The Amazon Resource Number (ARN) that can be used to uniquely identify the billing group.
Description (string) --
The billing group description.
PrimaryAccountId (string) --
The account ID that serves as the main account in a billing group.
ComputationPreference (dict) --
The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
PricingPlanArn (string) --
The Amazon Resource Name (ARN) of the pricing plan used to compute the Amazon Web Services charges for a billing group.
Size (integer) --
The number of accounts in the particular billing group.
CreationTime (integer) --
The time the billing group was created.
LastModifiedTime (integer) --
The most recent time the billing group was modified.
Status (string) --
The billing group status. Only one of the valid values can be used.
StatusReason (string) --
The reason why the billing group is in its current status.
NextToken (string) --
The pagination token used on subsequent calls to get billing groups.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_custom_line_items(**kwargs)¶A paginated call to get a list of all custom line items (FFLIs) for the given billing period. If you don't provide a billing period, the current billing period is used.
See also: AWS API Documentation
Request Syntax
response = client.list_custom_line_items(
BillingPeriod='string',
MaxResults=123,
NextToken='string',
Filters={
'Names': [
'string',
],
'BillingGroups': [
'string',
],
'Arns': [
'string',
]
}
)
A ListCustomLineItemsFilter that specifies the custom line item names and/or billing group Amazon Resource Names (ARNs) to retrieve FFLI information.
A list of custom line items to retrieve information.
The billing group Amazon Resource Names (ARNs) to retrieve information.
A list of custom line item ARNs to retrieve information.
dict
Response Syntax
{
'CustomLineItems': [
{
'Arn': 'string',
'Name': 'string',
'ChargeDetails': {
'Flat': {
'ChargeValue': 123.0
},
'Percentage': {
'PercentageValue': 123.0
},
'Type': 'CREDIT'|'FEE'
},
'CurrencyCode': 'USD'|'CNY',
'Description': 'string',
'ProductCode': 'string',
'BillingGroupArn': 'string',
'CreationTime': 123,
'LastModifiedTime': 123,
'AssociationSize': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
CustomLineItems (list) --
A list of FreeFormLineItemListElements received.
(dict) --
A representation of a custom line item.
Arn (string) --
The Amazon Resource Names (ARNs) for custom line items.
Name (string) --
The custom line item's name.
ChargeDetails (dict) --
A ListCustomLineItemChargeDetails that describes the charge details of a custom line item.
Flat (dict) --
A ListCustomLineItemFlatChargeDetails that describes the charge details of a flat custom line item.
ChargeValue (float) --
The custom line item's fixed charge value in USD.
Percentage (dict) --
A ListCustomLineItemPercentageChargeDetails that describes the charge details of a percentage custom line item.
PercentageValue (float) --
The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
Type (string) --
The type of the custom line item that indicates whether the charge is a fee or credit .
CurrencyCode (string) --
The custom line item's charge value currency. Only one of the valid values can be used.
Description (string) --
The custom line item's description. This is shown on the Bills page in association with the charge value.
ProductCode (string) --
The product code associated with the custom line item.
BillingGroupArn (string) --
The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
CreationTime (integer) --
The time created.
LastModifiedTime (integer) --
The most recent time the custom line item was modified.
AssociationSize (integer) --
The number of resources that are associated to the custom line item.
NextToken (string) --
The pagination token used on subsequent calls to get custom line items (FFLIs).
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_pricing_plans(**kwargs)¶A paginated call to get pricing plans for the given billing period. If you don't provide a billing period, the current billing period is used.
See also: AWS API Documentation
Request Syntax
response = client.list_pricing_plans(
BillingPeriod='string',
Filters={
'Arns': [
'string',
]
},
MaxResults=123,
NextToken='string'
)
A ListPricingPlansFilter that specifies the Amazon Resource Name (ARNs) of pricing plans to retrieve pricing plans information.
A list of pricing plan Amazon Resource Names (ARNs) to retrieve information.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingPlans': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'Size': 123,
'CreationTime': 123,
'LastModifiedTime': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the described pricing plans are applicable.
PricingPlans (list) --
A list of PricingPlanListElement retrieved.
(dict) --
A representation of a pricing plan.
Name (string) --
The name of a pricing plan.
Arn (string) --
The pricing plan Amazon Resource Names (ARN). This can be used to uniquely identify a pricing plan.
Description (string) --
The pricing plan description.
Size (integer) --
The pricing rules count currently associated with this pricing plan list element.
CreationTime (integer) --
The time the pricing plan was created.
LastModifiedTime (integer) --
The most recent time the pricing plan was modified.
NextToken (string) --
The pagination token used on subsequent calls to get pricing plans.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionlist_pricing_plans_associated_with_pricing_rule(**kwargs)¶A list of the pricing plans associated with a pricing rule.
See also: AWS API Documentation
Request Syntax
response = client.list_pricing_plans_associated_with_pricing_rule(
BillingPeriod='string',
PricingRuleArn='string',
MaxResults=123,
NextToken='string'
)
[REQUIRED]
The pricing rule Amazon Resource Name (ARN) for which associations will be listed.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingRuleArn': 'string',
'PricingPlanArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingPeriod (string) --
The pricing plan billing period for which associations will be listed.
PricingRuleArn (string) --
The pricing rule Amazon Resource Name (ARN) for which associations will be listed.
PricingPlanArns (list) --
The list containing pricing plans associated with the requested pricing rule.
NextToken (string) --
The pagination token to be used on subsequent calls.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_pricing_rules(**kwargs)¶Describes a pricing rule that can be associated to a pricing plan, or set of pricing plans.
See also: AWS API Documentation
Request Syntax
response = client.list_pricing_rules(
BillingPeriod='string',
Filters={
'Arns': [
'string',
]
},
MaxResults=123,
NextToken='string'
)
A DescribePricingRuleFilter that specifies the Amazon Resource Name (ARNs) of pricing rules to retrieve pricing rules information.
A list containing the pricing rule Amazon Resource Names (ARNs) to include in the API response.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingRules': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'Scope': 'GLOBAL'|'SERVICE',
'Type': 'MARKUP'|'DISCOUNT',
'ModifierPercentage': 123.0,
'Service': 'string',
'AssociatedPricingPlanCount': 123,
'CreationTime': 123,
'LastModifiedTime': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the described pricing rules are applicable.
PricingRules (list) --
A list containing the described pricing rules.
(dict) --
A representation of a pricing rule.
Name (string) --
The name of a pricing rule.
Arn (string) --
The Amazon Resource Name (ARN) used to uniquely identify a pricing rule.
Description (string) --
The pricing rule description.
Scope (string) --
The scope of pricing rule that indicates if it is globally applicable, or if it is service-specific.
Type (string) --
The type of pricing rule.
ModifierPercentage (float) --
A percentage modifier applied on the public pricing rates.
Service (string) --
If the Scope attribute is SERVICE , this attribute indicates which service the PricingRule is applicable for.
AssociatedPricingPlanCount (integer) --
The pricing plans count that this pricing rule is associated with.
CreationTime (integer) --
The time the pricing rule was created.
LastModifiedTime (integer) --
The most recent time the pricing rule was modified.
NextToken (string) --
The pagination token used on subsequent calls to get pricing rules.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionlist_pricing_rules_associated_to_pricing_plan(**kwargs)¶Lists the pricing rules associated with a pricing plan.
See also: AWS API Documentation
Request Syntax
response = client.list_pricing_rules_associated_to_pricing_plan(
BillingPeriod='string',
PricingPlanArn='string',
MaxResults=123,
NextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing plan for which associations are to be listed.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingPlanArn': 'string',
'PricingRuleArns': [
'string',
],
'NextToken': 'string'
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the pricing rule associations are listed.
PricingPlanArn (string) --
The Amazon Resource Name (ARN) of the pricing plan for which associations are listed.
PricingRuleArns (list) --
A list containing pricing rules associated with the requested pricing plan.
NextToken (string) --
The pagination token to be used on subsequent calls.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionlist_resources_associated_to_custom_line_item(**kwargs)¶List the resources associated to a custom line item.
See also: AWS API Documentation
Request Syntax
response = client.list_resources_associated_to_custom_line_item(
BillingPeriod='string',
Arn='string',
MaxResults=123,
NextToken='string',
Filters={
'Relationship': 'PARENT'|'CHILD'
}
)
[REQUIRED]
The ARN of the custom line item for which the resource associations will be listed.
(Optional) A ListResourcesAssociatedToCustomLineItemFilter that can specify the types of resources that should be retrieved.
The type of relationship between the custom line item and the associated resource.
dict
Response Syntax
{
'Arn': 'string',
'AssociatedResources': [
{
'Arn': 'string',
'Relationship': 'PARENT'|'CHILD'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Arn (string) --
The custom line item ARN for which the resource associations are listed.
AssociatedResources (list) --
A list of ListResourcesAssociatedToCustomLineItemResponseElement for each resource association retrieved.
(dict) --
A representation of a resource association for a custom line item.
Arn (string) --
The ARN of the associated resource.
Relationship (string) --
The type of relationship between the custom line item and the associated resource.
NextToken (string) --
The pagination token to be used in subsequent requests to retrieve additional results.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionA list the tags for a resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) that identifies the resource to list the tags.
{
'Tags': {
'string': 'string'
}
}
Response Structure
The tags for the resource.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptiontag_resource(**kwargs)¶Associates the specified tags to a resource with the specified resourceArn . If existing tags on a resource are not specified in the request parameters, they are not changed.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceArn='string',
Tags={
'string': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource to which to add tags.
[REQUIRED]
The tags to add to the resource as a list of key-value pairs.
dict
Response Syntax
{}
Response Structure
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionuntag_resource(**kwargs)¶Deletes specified tags from a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceArn='string',
TagKeys=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource to which to delete tags.
[REQUIRED]
The tags to delete from the resource as a list of key-value pairs.
dict
Response Syntax
{}
Response Structure
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionupdate_billing_group(**kwargs)¶This updates an existing billing group.
See also: AWS API Documentation
Request Syntax
response = client.update_billing_group(
Arn='string',
Name='string',
Status='ACTIVE'|'PRIMARY_ACCOUNT_MISSING',
ComputationPreference={
'PricingPlanArn': 'string'
},
Description='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the billing group being updated.
The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
The Amazon Resource Name (ARN) of the pricing plan used to compute the Amazon Web Services charges for a billing group.
dict
Response Syntax
{
'Arn': 'string',
'Name': 'string',
'Description': 'string',
'PrimaryAccountId': 'string',
'PricingPlanArn': 'string',
'Size': 123,
'LastModifiedTime': 123,
'Status': 'ACTIVE'|'PRIMARY_ACCOUNT_MISSING',
'StatusReason': 'string'
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the billing group that was updated.
Name (string) --
The name of the billing group. The names must be unique to each billing group.
Description (string) --
A description of the billing group.
PrimaryAccountId (string) --
The account ID that serves as the main account in a billing group.
PricingPlanArn (string) --
The Amazon Resource Name (ARN) of the pricing plan to compute Amazon Web Services charges for the billing group.
Size (integer) --
The number of accounts in the particular billing group.
LastModifiedTime (integer) --
The most recent time the billing group was modified.
Status (string) --
The status of the billing group. Only one of the valid values can be used.
StatusReason (string) --
The reason why the billing group is in its current status.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionupdate_custom_line_item(**kwargs)¶Update an existing custom line item in the current or previous billing period.
See also: AWS API Documentation
Request Syntax
response = client.update_custom_line_item(
Arn='string',
Name='string',
Description='string',
ChargeDetails={
'Flat': {
'ChargeValue': 123.0
},
'Percentage': {
'PercentageValue': 123.0
}
},
BillingPeriodRange={
'InclusiveStartBillingPeriod': 'string',
'ExclusiveEndBillingPeriod': 'string'
}
)
[REQUIRED]
The ARN of the custom line item to be updated.
A ListCustomLineItemChargeDetails containing the new charge details for the custom line item.
An UpdateCustomLineItemFlatChargeDetails that describes the new charge details of a flat custom line item.
The custom line item's new fixed charge value in USD.
An UpdateCustomLineItemPercentageChargeDetails that describes the new charge details of a percentage custom line item.
The custom line item's new percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
The billing period range in which the custom line item request will be applied.
The inclusive start billing period that defines a billing period range where a custom line is applied.
The inclusive end billing period that defines a billing period range where a custom line is applied.
dict
Response Syntax
{
'Arn': 'string',
'BillingGroupArn': 'string',
'Name': 'string',
'Description': 'string',
'ChargeDetails': {
'Flat': {
'ChargeValue': 123.0
},
'Percentage': {
'PercentageValue': 123.0
},
'Type': 'CREDIT'|'FEE'
},
'LastModifiedTime': 123,
'AssociationSize': 123
}
Response Structure
(dict) --
Arn (string) --
The ARN of the successfully updated custom line item.
BillingGroupArn (string) --
The ARN of the billing group that the custom line item is applied to.
Name (string) --
The name of the successfully updated custom line item.
Description (string) --
The description of the successfully updated custom line item.
ChargeDetails (dict) --
A ListCustomLineItemChargeDetails containing the charge details of the successfully updated custom line item.
Flat (dict) --
A ListCustomLineItemFlatChargeDetails that describes the charge details of a flat custom line item.
ChargeValue (float) --
The custom line item's fixed charge value in USD.
Percentage (dict) --
A ListCustomLineItemPercentageChargeDetails that describes the charge details of a percentage custom line item.
PercentageValue (float) --
The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
Type (string) --
The type of the custom line item that indicates whether the charge is a fee or credit .
LastModifiedTime (integer) --
The most recent time the custom line item was modified.
AssociationSize (integer) --
The number of resources that are associated to the custom line item.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionupdate_pricing_plan(**kwargs)¶This updates an existing pricing plan.
See also: AWS API Documentation
Request Syntax
response = client.update_pricing_plan(
Arn='string',
Name='string',
Description='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing plan you're updating.
dict
Response Syntax
{
'Arn': 'string',
'Name': 'string',
'Description': 'string',
'Size': 123,
'LastModifiedTime': 123
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the updated pricing plan.
Name (string) --
The name of the pricing plan. The name must be unique to each pricing plan.
Description (string) --
The new description for the pricing rule.
Size (integer) --
The pricing rules count currently associated with this pricing plan list.
LastModifiedTime (integer) --
The most recent time the pricing plan was modified.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionupdate_pricing_rule(**kwargs)¶Updates an existing pricing rule.
See also: AWS API Documentation
Request Syntax
response = client.update_pricing_rule(
Arn='string',
Name='string',
Description='string',
Type='MARKUP'|'DISCOUNT',
ModifierPercentage=123.0
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing rule to update.
dict
Response Syntax
{
'Arn': 'string',
'Name': 'string',
'Description': 'string',
'Scope': 'GLOBAL'|'SERVICE',
'Type': 'MARKUP'|'DISCOUNT',
'ModifierPercentage': 123.0,
'Service': 'string',
'AssociatedPricingPlanCount': 123,
'LastModifiedTime': 123
}
Response Structure
(dict) --
Arn (string) --
The Amazon Resource Name (ARN) of the successfully updated pricing rule.
Name (string) --
The new name of the pricing rule. The name must be unique to each pricing rule.
Description (string) --
The new description for the pricing rule.
Scope (string) --
The scope of pricing rule that indicates if it is globally applicable, or is service-specific.
Type (string) --
The new pricing rule type.
ModifierPercentage (float) --
The new modifier to show pricing plan rates as a percentage.
Service (string) --
If the Scope attribute is set to SERVICE , the attribute indicates which service the PricingRule is applicable for.
AssociatedPricingPlanCount (integer) --
The pricing plans count that this pricing rule is associated with.
LastModifiedTime (integer) --
The most recent time the pricing rule was modified.
Exceptions
BillingConductor.Client.exceptions.ThrottlingExceptionBillingConductor.Client.exceptions.ConflictExceptionBillingConductor.Client.exceptions.AccessDeniedExceptionBillingConductor.Client.exceptions.ValidationExceptionBillingConductor.Client.exceptions.InternalServerExceptionBillingConductor.Client.exceptions.ResourceNotFoundExceptionThe available paginators are:
BillingConductor.Paginator.ListAccountAssociationsBillingConductor.Paginator.ListBillingGroupCostReportsBillingConductor.Paginator.ListBillingGroupsBillingConductor.Paginator.ListCustomLineItemsBillingConductor.Paginator.ListPricingPlansBillingConductor.Paginator.ListPricingPlansAssociatedWithPricingRuleBillingConductor.Paginator.ListPricingRulesBillingConductor.Paginator.ListPricingRulesAssociatedToPricingPlanBillingConductor.Paginator.ListResourcesAssociatedToCustomLineItemBillingConductor.Paginator.ListAccountAssociations¶paginator = client.get_paginator('list_account_associations')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_account_associations().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'Association': 'string',
'AccountId': 'string'
},
PaginationConfig={
'MaxItems': 123,
'StartingToken': 'string'
}
)
The filter on the account ID of the linked account, or any of the following:
MONITORED: linked accounts that are associated to billing groups.
UNMONITORED: linked accounts that are not associated to billing groups.
Billing Group Arn: linked accounts that are associated to the provided billing group Arn.
MONITORED: linked accounts that are associated to billing groups.
UNMONITORED: linked accounts that are not associated to billing groups.
Billing Group Arn: linked accounts that are associated to the provided Billing Group Arn.
The Amazon Web Services account ID to filter on.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'LinkedAccounts': [
{
'AccountId': 'string',
'BillingGroupArn': 'string',
'AccountName': 'string',
'AccountEmail': 'string'
},
],
}
Response Structure
(dict) --
LinkedAccounts (list) --
The list of linked accounts in the payer account.
(dict) --
- Amazon Web Services Billing Conductor is in beta release and is subject to change. Your use of Amazon Web Services Billing Conductor is subject to the Beta Service Participation terms of the `Amazon Web Services Service Terms <https://aws.amazon.com/service-terms/>`__ (Section 1.10). *
A representation of a linked account.
AccountId (string) --
The associating array of account IDs.
BillingGroupArn (string) --
The Billing Group Arn that the linked account is associated to.
AccountName (string) --
The Amazon Web Services account name.
AccountEmail (string) --
The Amazon Web Services account email.
BillingConductor.Paginator.ListBillingGroupCostReports¶paginator = client.get_paginator('list_billing_group_cost_reports')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_billing_group_cost_reports().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'BillingGroupArns': [
'string',
]
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.
The list of Amazon Resource Names (ARNs) used to filter billing groups to retrieve reports.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingGroupCostReports': [
{
'Arn': 'string',
'AWSCost': 'string',
'ProformaCost': 'string',
'Margin': 'string',
'MarginPercentage': 'string',
'Currency': 'string'
},
],
}
Response Structure
(dict) --
BillingGroupCostReports (list) --
A list of BillingGroupCostReportElement retrieved.
(dict) --
A summary report of actual Amazon Web Services charges and calculated Amazon Web Services charges, based on the associated pricing plan of a billing group.
Arn (string) --
The Amazon Resource Name (ARN) of a billing group.
AWSCost (string) --
The actual Amazon Web Services charges for the billing group.
ProformaCost (string) --
The hypothetical Amazon Web Services charges based on the associated pricing plan of a billing group.
Margin (string) --
The billing group margin.
MarginPercentage (string) --
The percentage of billing group margin.
Currency (string) --
The displayed currency.
BillingConductor.Paginator.ListBillingGroups¶paginator = client.get_paginator('list_billing_groups')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_billing_groups().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'Arns': [
'string',
],
'PricingPlan': 'string'
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A ListBillingGroupsFilter that specifies the billing group and pricing plan to retrieve billing group information.
The list of billing group Amazon Resource Names (ARNs) to retrieve information.
The pricing plan Amazon Resource Names (ARNs) to retrieve information.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingGroups': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'PrimaryAccountId': 'string',
'ComputationPreference': {
'PricingPlanArn': 'string'
},
'Size': 123,
'CreationTime': 123,
'LastModifiedTime': 123,
'Status': 'ACTIVE'|'PRIMARY_ACCOUNT_MISSING',
'StatusReason': 'string'
},
],
}
Response Structure
(dict) --
BillingGroups (list) --
A list of BillingGroupListElement retrieved.
(dict) --
A representation of a billing group.
Name (string) --
The billing group's name.
Arn (string) --
The Amazon Resource Number (ARN) that can be used to uniquely identify the billing group.
Description (string) --
The billing group description.
PrimaryAccountId (string) --
The account ID that serves as the main account in a billing group.
ComputationPreference (dict) --
The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
PricingPlanArn (string) --
The Amazon Resource Name (ARN) of the pricing plan used to compute the Amazon Web Services charges for a billing group.
Size (integer) --
The number of accounts in the particular billing group.
CreationTime (integer) --
The time the billing group was created.
LastModifiedTime (integer) --
The most recent time the billing group was modified.
Status (string) --
The billing group status. Only one of the valid values can be used.
StatusReason (string) --
The reason why the billing group is in its current status.
BillingConductor.Paginator.ListCustomLineItems¶paginator = client.get_paginator('list_custom_line_items')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_custom_line_items().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'Names': [
'string',
],
'BillingGroups': [
'string',
],
'Arns': [
'string',
]
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A ListCustomLineItemsFilter that specifies the custom line item names and/or billing group Amazon Resource Names (ARNs) to retrieve FFLI information.
A list of custom line items to retrieve information.
The billing group Amazon Resource Names (ARNs) to retrieve information.
A list of custom line item ARNs to retrieve information.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'CustomLineItems': [
{
'Arn': 'string',
'Name': 'string',
'ChargeDetails': {
'Flat': {
'ChargeValue': 123.0
},
'Percentage': {
'PercentageValue': 123.0
},
'Type': 'CREDIT'|'FEE'
},
'CurrencyCode': 'USD'|'CNY',
'Description': 'string',
'ProductCode': 'string',
'BillingGroupArn': 'string',
'CreationTime': 123,
'LastModifiedTime': 123,
'AssociationSize': 123
},
],
}
Response Structure
(dict) --
CustomLineItems (list) --
A list of FreeFormLineItemListElements received.
(dict) --
A representation of a custom line item.
Arn (string) --
The Amazon Resource Names (ARNs) for custom line items.
Name (string) --
The custom line item's name.
ChargeDetails (dict) --
A ListCustomLineItemChargeDetails that describes the charge details of a custom line item.
Flat (dict) --
A ListCustomLineItemFlatChargeDetails that describes the charge details of a flat custom line item.
ChargeValue (float) --
The custom line item's fixed charge value in USD.
Percentage (dict) --
A ListCustomLineItemPercentageChargeDetails that describes the charge details of a percentage custom line item.
PercentageValue (float) --
The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
Type (string) --
The type of the custom line item that indicates whether the charge is a fee or credit .
CurrencyCode (string) --
The custom line item's charge value currency. Only one of the valid values can be used.
Description (string) --
The custom line item's description. This is shown on the Bills page in association with the charge value.
ProductCode (string) --
The product code associated with the custom line item.
BillingGroupArn (string) --
The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
CreationTime (integer) --
The time created.
LastModifiedTime (integer) --
The most recent time the custom line item was modified.
AssociationSize (integer) --
The number of resources that are associated to the custom line item.
BillingConductor.Paginator.ListPricingPlans¶paginator = client.get_paginator('list_pricing_plans')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_pricing_plans().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'Arns': [
'string',
]
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A ListPricingPlansFilter that specifies the Amazon Resource Name (ARNs) of pricing plans to retrieve pricing plans information.
A list of pricing plan Amazon Resource Names (ARNs) to retrieve information.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingPlans': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'Size': 123,
'CreationTime': 123,
'LastModifiedTime': 123
},
],
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the described pricing plans are applicable.
PricingPlans (list) --
A list of PricingPlanListElement retrieved.
(dict) --
A representation of a pricing plan.
Name (string) --
The name of a pricing plan.
Arn (string) --
The pricing plan Amazon Resource Names (ARN). This can be used to uniquely identify a pricing plan.
Description (string) --
The pricing plan description.
Size (integer) --
The pricing rules count currently associated with this pricing plan list element.
CreationTime (integer) --
The time the pricing plan was created.
LastModifiedTime (integer) --
The most recent time the pricing plan was modified.
BillingConductor.Paginator.ListPricingPlansAssociatedWithPricingRule¶paginator = client.get_paginator('list_pricing_plans_associated_with_pricing_rule')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_pricing_plans_associated_with_pricing_rule().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
PricingRuleArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The pricing rule Amazon Resource Name (ARN) for which associations will be listed.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingRuleArn': 'string',
'PricingPlanArns': [
'string',
],
}
Response Structure
(dict) --
BillingPeriod (string) --
The pricing plan billing period for which associations will be listed.
PricingRuleArn (string) --
The pricing rule Amazon Resource Name (ARN) for which associations will be listed.
PricingPlanArns (list) --
The list containing pricing plans associated with the requested pricing rule.
BillingConductor.Paginator.ListPricingRules¶paginator = client.get_paginator('list_pricing_rules')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_pricing_rules().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Filters={
'Arns': [
'string',
]
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A DescribePricingRuleFilter that specifies the Amazon Resource Name (ARNs) of pricing rules to retrieve pricing rules information.
A list containing the pricing rule Amazon Resource Names (ARNs) to include in the API response.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingRules': [
{
'Name': 'string',
'Arn': 'string',
'Description': 'string',
'Scope': 'GLOBAL'|'SERVICE',
'Type': 'MARKUP'|'DISCOUNT',
'ModifierPercentage': 123.0,
'Service': 'string',
'AssociatedPricingPlanCount': 123,
'CreationTime': 123,
'LastModifiedTime': 123
},
],
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the described pricing rules are applicable.
PricingRules (list) --
A list containing the described pricing rules.
(dict) --
A representation of a pricing rule.
Name (string) --
The name of a pricing rule.
Arn (string) --
The Amazon Resource Name (ARN) used to uniquely identify a pricing rule.
Description (string) --
The pricing rule description.
Scope (string) --
The scope of pricing rule that indicates if it is globally applicable, or if it is service-specific.
Type (string) --
The type of pricing rule.
ModifierPercentage (float) --
A percentage modifier applied on the public pricing rates.
Service (string) --
If the Scope attribute is SERVICE , this attribute indicates which service the PricingRule is applicable for.
AssociatedPricingPlanCount (integer) --
The pricing plans count that this pricing rule is associated with.
CreationTime (integer) --
The time the pricing rule was created.
LastModifiedTime (integer) --
The most recent time the pricing rule was modified.
BillingConductor.Paginator.ListPricingRulesAssociatedToPricingPlan¶paginator = client.get_paginator('list_pricing_rules_associated_to_pricing_plan')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_pricing_rules_associated_to_pricing_plan().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
PricingPlanArn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the pricing plan for which associations are to be listed.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'BillingPeriod': 'string',
'PricingPlanArn': 'string',
'PricingRuleArns': [
'string',
],
}
Response Structure
(dict) --
BillingPeriod (string) --
The billing period for which the pricing rule associations are listed.
PricingPlanArn (string) --
The Amazon Resource Name (ARN) of the pricing plan for which associations are listed.
PricingRuleArns (list) --
A list containing pricing rules associated with the requested pricing plan.
BillingConductor.Paginator.ListResourcesAssociatedToCustomLineItem¶paginator = client.get_paginator('list_resources_associated_to_custom_line_item')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from BillingConductor.Client.list_resources_associated_to_custom_line_item().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
BillingPeriod='string',
Arn='string',
Filters={
'Relationship': 'PARENT'|'CHILD'
},
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The ARN of the custom line item for which the resource associations will be listed.
(Optional) A ListResourcesAssociatedToCustomLineItemFilter that can specify the types of resources that should be retrieved.
The type of relationship between the custom line item and the associated resource.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'Arn': 'string',
'AssociatedResources': [
{
'Arn': 'string',
'Relationship': 'PARENT'|'CHILD'
},
],
}
Response Structure
(dict) --
Arn (string) --
The custom line item ARN for which the resource associations are listed.
AssociatedResources (list) --
A list of ListResourcesAssociatedToCustomLineItemResponseElement for each resource association retrieved.
(dict) --
A representation of a resource association for a custom line item.
Arn (string) --
The ARN of the associated resource.
Relationship (string) --
The type of relationship between the custom line item and the associated resource.