Billingconductor

associate_accounts(account_ids, arn)
associate_accounts(account_ids, arn, params::Dict{String,<:Any})

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.

Arguments

• account_ids: The associating array of account IDs.
• arn: The Amazon Resource Name (ARN) of the billing group that associates the array of account IDs.

associate_pricing_rules(arn, pricing_rule_arns)
associate_pricing_rules(arn, pricing_rule_arns, params::Dict{String,<:Any})

Connects an array of PricingRuleArns to a defined PricingPlan. The maximum number PricingRuleArn that can be associated in one call is 30.

Arguments

• arn: The PricingPlanArn that the PricingRuleArns are associated with.
• pricing_rule_arns: The PricingRuleArns that are associated with the Pricing Plan.

batch_associate_resources_to_custom_line_item(resource_arns, target_arn)
batch_associate_resources_to_custom_line_item(resource_arns, target_arn, params::Dict{String,<:Any})

Associates a batch of resources to a percentage custom line item.

Arguments

• resource_arns: A list containing the ARNs of the resources to be associated.
• target_arn: A percentage custom line item ARN to associate the resources to.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriodRange":

batch_disassociate_resources_from_custom_line_item(resource_arns, target_arn)
batch_disassociate_resources_from_custom_line_item(resource_arns, target_arn, params::Dict{String,<:Any})

Disassociates a batch of resources from a percentage custom line item.

Arguments

• resource_arns: A list containing the ARNs of resources to be disassociated.
• target_arn: A percentage custom line item ARN to disassociate the resources from.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriodRange":

create_billing_group(account_grouping, computation_preference, name)
create_billing_group(account_grouping, computation_preference, name, params::Dict{String,<:Any})

Creates a billing group that resembles a consolidated billing family that Amazon Web Services charges, based off of the predefined pricing plan computation.

Arguments

• account_grouping: The set of accounts that will be under the billing group. The set of accounts resemble the linked accounts in a consolidated family.
• computation_preference: The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
• name: The billing group name. The names must be unique.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "Description": The billing group description.
• "PrimaryAccountId": The account ID that serves as the main account in a billing group.
• "Tags": A map that contains tag keys and tag values that are attached to a billing group. This feature isn't available during the beta.
• "X-Amzn-Client-Token": The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.

create_custom_line_item(billing_group_arn, charge_details, description, name)
create_custom_line_item(billing_group_arn, charge_details, description, name, params::Dict{String,<:Any})

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.

Arguments

• billing_group_arn: The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
• charge_details: A CustomLineItemChargeDetails that describes the charge details for a custom line item.
• description: The description of the custom line item. This is shown on the Bills page in association with the charge value.
• name: The name of the custom line item.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriodRange": A time range for which the custom line item is effective.
• "Tags": A map that contains tag keys and tag values that are attached to a custom line item.
• "X-Amzn-Client-Token": The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.

create_pricing_plan(name)
create_pricing_plan(name, params::Dict{String,<:Any})

Creates a pricing plan that is used for computing Amazon Web Services charges for billing groups.

Arguments

• name: The pricing plan name. The names must be unique to each pricing plan.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "Description": The pricing plan description.
• "PricingRuleArns": A list of Amazon Resource Names (ARNs) that define the pricing plan parameters.
• "Tags": A map that contains tag keys and tag values that are attached to a pricing plan.
• "X-Amzn-Client-Token": The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.

create_pricing_rule(modifier_percentage, name, scope, type)
create_pricing_rule(modifier_percentage, name, scope, type, params::Dict{String,<:Any})

Creates a pricing rule can be associated to a pricing plan, or a set of pricing plans.

Arguments

• modifier_percentage: A percentage modifier applied on the public pricing rates.
• name: The pricing rule name. The names must be unique to each pricing rule.
• scope: The scope of pricing rule that indicates if it is globally applicable, or is service-specific.
• type: The type of pricing rule.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "Description": The pricing rule description.
• "Service": If the Scope attribute is set to SERVICE, the attribute indicates which service the PricingRule is applicable for.
• "Tags": A map that contains tag keys and tag values that are attached to a pricing rule.
• "X-Amzn-Client-Token": The token that is needed to support idempotency. Idempotency isn't currently supported, but will be implemented in a future update.

delete_billing_group(arn)
delete_billing_group(arn, params::Dict{String,<:Any})

Deletes a billing group.

Arguments

• arn: The Amazon Resource Name (ARN) of the billing group you're deleting.

delete_custom_line_item(arn)
delete_custom_line_item(arn, params::Dict{String,<:Any})

Deletes the custom line item identified by the given ARN in the current, or previous billing period.

Arguments

• arn: The ARN of the custom line item to be deleted.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriodRange":

delete_pricing_plan(arn)
delete_pricing_plan(arn, params::Dict{String,<:Any})

Deletes a pricing plan. The pricing plan must not be associated with any billing groups to delete successfully.

Arguments

• arn: The Amazon Resource Name (ARN) of the pricing plan you're deleting.

delete_pricing_rule(arn)
delete_pricing_rule(arn, params::Dict{String,<:Any})

Deletes the pricing rule identified by the input Amazon Resource Name (ARN).

Arguments

• arn: The Amazon Resource Name (ARN) of the pricing rule you are deleting.

disassociate_accounts(account_ids, arn)
disassociate_accounts(account_ids, arn, params::Dict{String,<:Any})

Removes the specified list of account IDs from the given billing group.

Arguments

• account_ids: The array of account IDs to disassociate.
• arn: The Amazon Resource Name (ARN) of the billing group that the array of account IDs will disassociate from.

disassociate_pricing_rules(arn, pricing_rule_arns)
disassociate_pricing_rules(arn, pricing_rule_arns, params::Dict{String,<:Any})

Disassociates a list of pricing rules from a pricing plan.

Arguments

• arn: The pricing plan Amazon Resource Name (ARN) to disassociate pricing rules from.
• pricing_rule_arns: A list containing the Amazon Resource Name (ARN) of the pricing rules that will be disassociated.

list_account_associations()
list_account_associations(params::Dict{String,<:Any})

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 (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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period to get account associations.
• "Filters": 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.
• "NextToken": The pagination token used on subsequent calls to retrieve accounts.

list_billing_group_cost_reports()
list_billing_group_cost_reports(params::Dict{String,<:Any})

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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period for your report.
• "Filters": A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.
• "MaxResults": The maximum number of reports to retrieve.
• "NextToken": The pagination token used on subsequent calls to get reports.

list_billing_groups()
list_billing_groups(params::Dict{String,<:Any})

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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period to get billing groups.
• "Filters": A ListBillingGroupsFilter that specifies the billing group and pricing plan to retrieve billing group information.
• "MaxResults": The maximum number of billing groups to retrieve.
• "NextToken": The pagination token used on subsequent calls to get billing groups.

list_custom_line_items()
list_custom_line_items(params::Dict{String,<:Any})

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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period to get custom line items (FFLIs).
• "Filters": A ListCustomLineItemsFilter that specifies the custom line item names and/or billing group Amazon Resource Names (ARNs) to retrieve FFLI information.
• "MaxResults": The maximum number of billing groups to retrieve.
• "NextToken": The pagination token used on subsequent calls to get custom line items (FFLIs).

list_pricing_plans()
list_pricing_plans(params::Dict{String,<:Any})

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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period to get pricing plan.
• "Filters": A ListPricingPlansFilter that specifies the Amazon Resource Name (ARNs) of pricing plans to retrieve pricing plans information.
• "MaxResults": The maximum number of pricing plans to retrieve.
• "NextToken": The pagination token used on subsequent call to get pricing plans.

list_pricing_plans_associated_with_pricing_rule(pricing_rule_arn)
list_pricing_plans_associated_with_pricing_rule(pricing_rule_arn, params::Dict{String,<:Any})

A list of the pricing plans associated with a pricing rule.

Arguments

• pricing_rule_arn: The pricing rule Amazon Resource Name (ARN) for which associations will be listed.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The pricing plan billing period for which associations will be listed.
• "MaxResults": The optional maximum number of pricing rule associations to retrieve.
• "NextToken": The optional pagination token returned by a previous call.

list_pricing_rules()
list_pricing_rules(params::Dict{String,<:Any})

Describes a pricing rule that can be associated to a pricing plan, or set of pricing plans.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The preferred billing period to get the pricing plan.
• "Filters": A DescribePricingRuleFilter that specifies the Amazon Resource Name (ARNs) of pricing rules to retrieve pricing rules information.
• "MaxResults": The maximum number of pricing rules to retrieve.
• "NextToken": The pagination token used on subsequent call to get pricing rules.

list_pricing_rules_associated_to_pricing_plan(pricing_plan_arn)
list_pricing_rules_associated_to_pricing_plan(pricing_plan_arn, params::Dict{String,<:Any})

Lists the pricing rules associated with a pricing plan.

Arguments

• pricing_plan_arn: The Amazon Resource Name (ARN) of the pricing plan for which associations are to be listed.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The billing period for which the pricing rule associations are to be listed.
• "MaxResults": The optional maximum number of pricing rule associations to retrieve.
• "NextToken": The optional pagination token returned by a previous call.

list_resources_associated_to_custom_line_item(arn)
list_resources_associated_to_custom_line_item(arn, params::Dict{String,<:Any})

List the resources associated to a custom line item.

Arguments

• arn: The ARN of the custom line item for which the resource associations will be listed.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriod": The billing period for which the resource associations will be listed.
• "Filters": (Optional) A ListResourcesAssociatedToCustomLineItemFilter that can specify the types of resources that should be retrieved.
• "MaxResults": (Optional) The maximum number of resource associations to be retrieved.
• "NextToken": (Optional) The pagination token returned by a previous request.

list_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})

A list the tags for a resource.

Arguments

• resource_arn: The Amazon Resource Name (ARN) that identifies the resource to list the tags.

tag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})

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.

Arguments

• resource_arn: The Amazon Resource Name (ARN) of the resource to which to add tags.
• tags: The tags to add to the resource as a list of key-value pairs.

untag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})

Deletes specified tags from a resource.

Arguments

• resource_arn: The Amazon Resource Name (ARN) of the resource to which to delete tags.
• tag_keys: The tags to delete from the resource as a list of key-value pairs.

update_billing_group(arn)
update_billing_group(arn, params::Dict{String,<:Any})

This updates an existing billing group.

Arguments

• arn: The Amazon Resource Name (ARN) of the billing group being updated.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "ComputationPreference": The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
• "Description": A description of the billing group.
• "Name": The name of the billing group. The names must be unique to each billing group.
• "Status": The status of the billing group. Only one of the valid values can be used.

update_custom_line_item(arn)
update_custom_line_item(arn, params::Dict{String,<:Any})

Update an existing custom line item in the current or previous billing period.

Arguments

• arn: The ARN of the custom line item to be updated.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "BillingPeriodRange":
• "ChargeDetails": A ListCustomLineItemChargeDetails containing the new charge details for the custom line item.
• "Description": The new line item description of the custom line item.
• "Name": The new name for the custom line item.

update_pricing_plan(arn)
update_pricing_plan(arn, params::Dict{String,<:Any})

This updates an existing pricing plan.

Arguments

• arn: The Amazon Resource Name (ARN) of the pricing plan you're updating.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "Description": The pricing plan description.
• "Name": The name of the pricing plan. The name must be unique to each pricing plan.

update_pricing_rule(arn)
update_pricing_rule(arn, params::Dict{String,<:Any})

Updates an existing pricing rule.

Arguments

• arn: The Amazon Resource Name (ARN) of the pricing rule to update.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

• "Description": The new description for the pricing rule.
• "ModifierPercentage": The new modifier to show pricing plan rates as a percentage.
• "Name": The new name of the pricing rule. The name must be unique to each pricing rule.
• "Type": The new pricing rule type.