aws-sdk-billingconductor 1.17.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f938856c5ad9eb17255ab658ea49935ce68472e9c3eacb96d7ab8660ccddaef
-  data.tar.gz: 7353a191067127cd3b8480a616132be9322141a75bfe939e986b3e21d7b777ac
+  metadata.gz: b792d769e4dbc91a7104a520e6ff25b236cc9f275f84c6e800cc7d5fe5b419f7
+  data.tar.gz: ed59f60bfd1789aefae2743fc0ff3ad0cfc1bdbe7a7f54f1e60ab52c49ab4345
 SHA512:
-  metadata.gz: 452f58c84c9818629aa8caa24b809986ede32d9aae611ee5f9338aa35164a792216751108a0b70abea9f9ace03bb6b46a627378680f8fe246de6e086c22625fc
-  data.tar.gz: ddad6051c852f245c021fe92c12b0cf76d014c2da53f4fde929e132cb4c2b0b2d03610a9df9ae441461243572d7404d9f9ce56d515b49f6cd5d63427e2dcf9e7
+  metadata.gz: e0d86edb633f6ae518084e4ea7b330fa1910aba1001c15b37f429a8f604541306d76d807a15118481f5b1560290f4f1dbf25965abf2c63c3faaa65acd194638d
+  data.tar.gz: 611ab7c4d4fdf8541bd2f158d93330c2c8b09440ee22468e03f2f173cfb4aba25899f24c1fd6a144632835dda9ab144a4827368c566bcde61cce35ded4d440f7

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2023-12-14)
+------------------
+
+* Feature - Billing Conductor is releasing a new API, GetBillingGroupCostReport, which provides the ability to retrieve/view the Billing Group Cost Report broken down by attributes for a specific billing group.
+
+1.18.0 (2023-12-04)
+------------------
+
+* Feature - This release adds the ability to specify a linked account of the billing group for the custom line item resource.
+
 1.17.0 (2023-11-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.19.0

data/lib/aws-sdk-billingconductor/client.rb

@@ -658,6 +658,10 @@ module Aws::BillingConductor
     #   A `CustomLineItemChargeDetails` that describes the charge details for
     #   a custom line item.
     #
+    # @option params [String] :account_id
+    #   The Amazon Web Services account in which this custom line item will be
+    #   applied to.
+    #
     # @return [Types::CreateCustomLineItemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateCustomLineItemOutput#arn #arn} => String
@@ -693,6 +697,7 @@ module Aws::BillingConductor
     #         },
     #       ],
     #     },
+    #     account_id: "AccountId",
     #   })
     #
     # @example Response structure
@@ -1056,6 +1061,71 @@ module Aws::BillingConductor
       req.send_request(options)
     end
 
+    # Retrieves the margin summary report, which includes the Amazon Web
+    # Services cost and charged amount (pro forma cost) by Amazon Web
+    # Service for a specific billing group.
+    #
+    # @option params [required, String] :arn
+    #   The Amazon Resource Number (ARN) that uniquely identifies the billing
+    #   group.
+    #
+    # @option params [Types::BillingPeriodRange] :billing_period_range
+    #   A time range for which the margin summary is effective. You can
+    #   specify up to 12 months.
+    #
+    # @option params [Array<String>] :group_by
+    #   A list of strings that specify the attributes that are used to break
+    #   down costs in the margin summary reports for the billing group. For
+    #   example, you can view your costs by the Amazon Web Service name or the
+    #   billing period.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of margin summary reports to retrieve.
+    #
+    # @option params [String] :next_token
+    #   The pagination token used on subsequent calls to get reports.
+    #
+    # @return [Types::GetBillingGroupCostReportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBillingGroupCostReportOutput#billing_group_cost_report_results #billing_group_cost_report_results} => Array&lt;Types::BillingGroupCostReportResultElement&gt;
+    #   * {Types::GetBillingGroupCostReportOutput#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_billing_group_cost_report({
+    #     arn: "BillingGroupArn", # required
+    #     billing_period_range: {
+    #       inclusive_start_billing_period: "BillingPeriod", # required
+    #       exclusive_end_billing_period: "BillingPeriod", # required
+    #     },
+    #     group_by: ["PRODUCT_NAME"], # accepts PRODUCT_NAME, BILLING_PERIOD
+    #     max_results: 1,
+    #     next_token: "Token",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.billing_group_cost_report_results #=> Array
+    #   resp.billing_group_cost_report_results[0].arn #=> String
+    #   resp.billing_group_cost_report_results[0].aws_cost #=> String
+    #   resp.billing_group_cost_report_results[0].proforma_cost #=> String
+    #   resp.billing_group_cost_report_results[0].margin #=> String
+    #   resp.billing_group_cost_report_results[0].margin_percentage #=> String
+    #   resp.billing_group_cost_report_results[0].currency #=> String
+    #   resp.billing_group_cost_report_results[0].attributes #=> Array
+    #   resp.billing_group_cost_report_results[0].attributes[0].key #=> String
+    #   resp.billing_group_cost_report_results[0].attributes[0].value #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/GetBillingGroupCostReport AWS API Documentation
+    #
+    # @overload get_billing_group_cost_report(params = {})
+    # @param [Hash] params ({})
+    def get_billing_group_cost_report(params = {}, options = {})
+      req = build_request(:get_billing_group_cost_report, params)
+      req.send_request(options)
+    end
+
     # 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
@@ -1297,6 +1367,7 @@ module Aws::BillingConductor
     #   resp.custom_line_item_versions[0].end_billing_period #=> String
     #   resp.custom_line_item_versions[0].arn #=> String
     #   resp.custom_line_item_versions[0].start_time #=> Integer
+    #   resp.custom_line_item_versions[0].account_id #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/ListCustomLineItemVersions AWS API Documentation
@@ -1344,6 +1415,7 @@ module Aws::BillingConductor
     #       names: ["CustomLineItemName"],
     #       billing_groups: ["BillingGroupArn"],
     #       arns: ["CustomLineItemArn"],
+    #       account_ids: ["AccountId"],
     #     },
     #   })
     #
@@ -1367,6 +1439,7 @@ module Aws::BillingConductor
     #   resp.custom_line_items[0].creation_time #=> Integer
     #   resp.custom_line_items[0].last_modified_time #=> Integer
     #   resp.custom_line_items[0].association_size #=> Integer
+    #   resp.custom_line_items[0].account_id #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/ListCustomLineItems AWS API Documentation
@@ -2041,7 +2114,7 @@ module Aws::BillingConductor
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-billingconductor'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-billingconductor/client_api.rb

@@ -33,6 +33,8 @@ module Aws::BillingConductor
     AssociateResourceResponseElement = Shapes::StructureShape.new(name: 'AssociateResourceResponseElement')
     AssociateResourcesResponseList = Shapes::ListShape.new(name: 'AssociateResourcesResponseList')
     Association = Shapes::StringShape.new(name: 'Association')
+    Attribute = Shapes::StructureShape.new(name: 'Attribute')
+    AttributesList = Shapes::ListShape.new(name: 'AttributesList')
     BatchAssociateResourcesToCustomLineItemInput = Shapes::StructureShape.new(name: 'BatchAssociateResourcesToCustomLineItemInput')
     BatchAssociateResourcesToCustomLineItemOutput = Shapes::StructureShape.new(name: 'BatchAssociateResourcesToCustomLineItemOutput')
     BatchDisassociateResourcesFromCustomLineItemInput = Shapes::StructureShape.new(name: 'BatchDisassociateResourcesFromCustomLineItemInput')
@@ -42,6 +44,8 @@ module Aws::BillingConductor
     BillingGroupArnList = Shapes::ListShape.new(name: 'BillingGroupArnList')
     BillingGroupCostReportElement = Shapes::StructureShape.new(name: 'BillingGroupCostReportElement')
     BillingGroupCostReportList = Shapes::ListShape.new(name: 'BillingGroupCostReportList')
+    BillingGroupCostReportResultElement = Shapes::StructureShape.new(name: 'BillingGroupCostReportResultElement')
+    BillingGroupCostReportResultsList = Shapes::ListShape.new(name: 'BillingGroupCostReportResultsList')
     BillingGroupDescription = Shapes::StringShape.new(name: 'BillingGroupDescription')
     BillingGroupFullArn = Shapes::StringShape.new(name: 'BillingGroupFullArn')
     BillingGroupList = Shapes::ListShape.new(name: 'BillingGroupList')
@@ -51,6 +55,7 @@ module Aws::BillingConductor
     BillingGroupStatusList = Shapes::ListShape.new(name: 'BillingGroupStatusList')
     BillingGroupStatusReason = Shapes::StringShape.new(name: 'BillingGroupStatusReason')
     BillingPeriod = Shapes::StringShape.new(name: 'BillingPeriod')
+    BillingPeriodRange = Shapes::StructureShape.new(name: 'BillingPeriodRange')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     ClientToken = Shapes::StringShape.new(name: 'ClientToken')
     ComputationPreference = Shapes::StructureShape.new(name: 'ComputationPreference')
@@ -105,6 +110,10 @@ module Aws::BillingConductor
     DisassociateResourceResponseElement = Shapes::StructureShape.new(name: 'DisassociateResourceResponseElement')
     DisassociateResourcesResponseList = Shapes::ListShape.new(name: 'DisassociateResourcesResponseList')
     FreeTierConfig = Shapes::StructureShape.new(name: 'FreeTierConfig')
+    GetBillingGroupCostReportInput = Shapes::StructureShape.new(name: 'GetBillingGroupCostReportInput')
+    GetBillingGroupCostReportOutput = Shapes::StructureShape.new(name: 'GetBillingGroupCostReportOutput')
+    GroupByAttributeName = Shapes::StringShape.new(name: 'GroupByAttributeName')
+    GroupByAttributesList = Shapes::ListShape.new(name: 'GroupByAttributesList')
     Instant = Shapes::IntegerShape.new(name: 'Instant')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     LineItemFilter = Shapes::StructureShape.new(name: 'LineItemFilter')
@@ -152,6 +161,7 @@ module Aws::BillingConductor
     Margin = Shapes::StringShape.new(name: 'Margin')
     MarginPercentage = Shapes::StringShape.new(name: 'MarginPercentage')
     MatchOption = Shapes::StringShape.new(name: 'MatchOption')
+    MaxBillingGroupCostReportResults = Shapes::IntegerShape.new(name: 'MaxBillingGroupCostReportResults')
     MaxBillingGroupResults = Shapes::IntegerShape.new(name: 'MaxBillingGroupResults')
     MaxCustomLineItemResults = Shapes::IntegerShape.new(name: 'MaxCustomLineItemResults')
     MaxPricingPlanResults = Shapes::IntegerShape.new(name: 'MaxPricingPlanResults')
@@ -260,6 +270,12 @@ module Aws::BillingConductor
 
     AssociateResourcesResponseList.member = Shapes::ShapeRef.new(shape: AssociateResourceResponseElement)
 
+    Attribute.add_member(:key, Shapes::ShapeRef.new(shape: String, location_name: "Key"))
+    Attribute.add_member(:value, Shapes::ShapeRef.new(shape: String, location_name: "Value"))
+    Attribute.struct_class = Types::Attribute
+
+    AttributesList.member = Shapes::ShapeRef.new(shape: Attribute)
+
     BatchAssociateResourcesToCustomLineItemInput.add_member(:target_arn, Shapes::ShapeRef.new(shape: CustomLineItemArn, required: true, location_name: "TargetArn"))
     BatchAssociateResourcesToCustomLineItemInput.add_member(:resource_arns, Shapes::ShapeRef.new(shape: CustomLineItemBatchAssociationsList, required: true, location_name: "ResourceArns"))
     BatchAssociateResourcesToCustomLineItemInput.add_member(:billing_period_range, Shapes::ShapeRef.new(shape: CustomLineItemBillingPeriodRange, location_name: "BillingPeriodRange"))
@@ -290,6 +306,17 @@ module Aws::BillingConductor
 
     BillingGroupCostReportList.member = Shapes::ShapeRef.new(shape: BillingGroupCostReportElement)
 
+    BillingGroupCostReportResultElement.add_member(:arn, Shapes::ShapeRef.new(shape: BillingGroupArn, location_name: "Arn"))
+    BillingGroupCostReportResultElement.add_member(:aws_cost, Shapes::ShapeRef.new(shape: AWSCost, location_name: "AWSCost"))
+    BillingGroupCostReportResultElement.add_member(:proforma_cost, Shapes::ShapeRef.new(shape: ProformaCost, location_name: "ProformaCost"))
+    BillingGroupCostReportResultElement.add_member(:margin, Shapes::ShapeRef.new(shape: Margin, location_name: "Margin"))
+    BillingGroupCostReportResultElement.add_member(:margin_percentage, Shapes::ShapeRef.new(shape: MarginPercentage, location_name: "MarginPercentage"))
+    BillingGroupCostReportResultElement.add_member(:currency, Shapes::ShapeRef.new(shape: Currency, location_name: "Currency"))
+    BillingGroupCostReportResultElement.add_member(:attributes, Shapes::ShapeRef.new(shape: AttributesList, location_name: "Attributes"))
+    BillingGroupCostReportResultElement.struct_class = Types::BillingGroupCostReportResultElement
+
+    BillingGroupCostReportResultsList.member = Shapes::ShapeRef.new(shape: BillingGroupCostReportResultElement)
+
     BillingGroupList.member = Shapes::ShapeRef.new(shape: BillingGroupListElement)
 
     BillingGroupListElement.add_member(:name, Shapes::ShapeRef.new(shape: BillingGroupName, location_name: "Name"))
@@ -307,6 +334,10 @@ module Aws::BillingConductor
 
     BillingGroupStatusList.member = Shapes::ShapeRef.new(shape: BillingGroupStatus)
 
+    BillingPeriodRange.add_member(:inclusive_start_billing_period, Shapes::ShapeRef.new(shape: BillingPeriod, required: true, location_name: "InclusiveStartBillingPeriod"))
+    BillingPeriodRange.add_member(:exclusive_end_billing_period, Shapes::ShapeRef.new(shape: BillingPeriod, required: true, location_name: "ExclusiveEndBillingPeriod"))
+    BillingPeriodRange.struct_class = Types::BillingPeriodRange
+
     ComputationPreference.add_member(:pricing_plan_arn, Shapes::ShapeRef.new(shape: PricingPlanFullArn, required: true, location_name: "PricingPlanArn"))
     ComputationPreference.struct_class = Types::ComputationPreference
 
@@ -335,6 +366,7 @@ module Aws::BillingConductor
     CreateCustomLineItemInput.add_member(:billing_period_range, Shapes::ShapeRef.new(shape: CustomLineItemBillingPeriodRange, location_name: "BillingPeriodRange"))
     CreateCustomLineItemInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     CreateCustomLineItemInput.add_member(:charge_details, Shapes::ShapeRef.new(shape: CustomLineItemChargeDetails, required: true, location_name: "ChargeDetails"))
+    CreateCustomLineItemInput.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "AccountId"))
     CreateCustomLineItemInput.struct_class = Types::CreateCustomLineItemInput
 
     CreateCustomLineItemOutput.add_member(:arn, Shapes::ShapeRef.new(shape: CustomLineItemArn, location_name: "Arn"))
@@ -406,6 +438,7 @@ module Aws::BillingConductor
     CustomLineItemListElement.add_member(:creation_time, Shapes::ShapeRef.new(shape: Instant, location_name: "CreationTime"))
     CustomLineItemListElement.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Instant, location_name: "LastModifiedTime"))
     CustomLineItemListElement.add_member(:association_size, Shapes::ShapeRef.new(shape: NumberOfAssociations, location_name: "AssociationSize"))
+    CustomLineItemListElement.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "AccountId"))
     CustomLineItemListElement.struct_class = Types::CustomLineItemListElement
 
     CustomLineItemNameList.member = Shapes::ShapeRef.new(shape: CustomLineItemName)
@@ -429,6 +462,7 @@ module Aws::BillingConductor
     CustomLineItemVersionListElement.add_member(:end_billing_period, Shapes::ShapeRef.new(shape: BillingPeriod, location_name: "EndBillingPeriod"))
     CustomLineItemVersionListElement.add_member(:arn, Shapes::ShapeRef.new(shape: CustomLineItemArn, location_name: "Arn"))
     CustomLineItemVersionListElement.add_member(:start_time, Shapes::ShapeRef.new(shape: Instant, location_name: "StartTime"))
+    CustomLineItemVersionListElement.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "AccountId"))
     CustomLineItemVersionListElement.struct_class = Types::CustomLineItemVersionListElement
 
     DeleteBillingGroupInput.add_member(:arn, Shapes::ShapeRef.new(shape: BillingGroupArn, required: true, location_name: "Arn"))
@@ -479,6 +513,19 @@ module Aws::BillingConductor
     FreeTierConfig.add_member(:activated, Shapes::ShapeRef.new(shape: TieringActivated, required: true, location_name: "Activated"))
     FreeTierConfig.struct_class = Types::FreeTierConfig
 
+    GetBillingGroupCostReportInput.add_member(:arn, Shapes::ShapeRef.new(shape: BillingGroupArn, required: true, location_name: "Arn"))
+    GetBillingGroupCostReportInput.add_member(:billing_period_range, Shapes::ShapeRef.new(shape: BillingPeriodRange, location_name: "BillingPeriodRange"))
+    GetBillingGroupCostReportInput.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupByAttributesList, location_name: "GroupBy"))
+    GetBillingGroupCostReportInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxBillingGroupCostReportResults, location_name: "MaxResults"))
+    GetBillingGroupCostReportInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
+    GetBillingGroupCostReportInput.struct_class = Types::GetBillingGroupCostReportInput
+
+    GetBillingGroupCostReportOutput.add_member(:billing_group_cost_report_results, Shapes::ShapeRef.new(shape: BillingGroupCostReportResultsList, location_name: "BillingGroupCostReportResults"))
+    GetBillingGroupCostReportOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
+    GetBillingGroupCostReportOutput.struct_class = Types::GetBillingGroupCostReportOutput
+
+    GroupByAttributesList.member = Shapes::ShapeRef.new(shape: GroupByAttributeName)
+
     InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Message"))
     InternalServerException.add_member(:retry_after_seconds, Shapes::ShapeRef.new(shape: RetryAfterSeconds, location: "header", location_name: "Retry-After"))
     InternalServerException.struct_class = Types::InternalServerException
@@ -570,6 +617,7 @@ module Aws::BillingConductor
     ListCustomLineItemsFilter.add_member(:names, Shapes::ShapeRef.new(shape: CustomLineItemNameList, location_name: "Names"))
     ListCustomLineItemsFilter.add_member(:billing_groups, Shapes::ShapeRef.new(shape: BillingGroupArnList, location_name: "BillingGroups"))
     ListCustomLineItemsFilter.add_member(:arns, Shapes::ShapeRef.new(shape: CustomLineItemArns, location_name: "Arns"))
+    ListCustomLineItemsFilter.add_member(:account_ids, Shapes::ShapeRef.new(shape: AccountIdList, location_name: "AccountIds"))
     ListCustomLineItemsFilter.struct_class = Types::ListCustomLineItemsFilter
 
     ListCustomLineItemsInput.add_member(:billing_period, Shapes::ShapeRef.new(shape: BillingPeriod, location_name: "BillingPeriod"))
@@ -1049,6 +1097,19 @@ module Aws::BillingConductor
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:get_billing_group_cost_report, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetBillingGroupCostReport"
+        o.http_method = "POST"
+        o.http_request_uri = "/get-billing-group-cost-report"
+        o.input = Shapes::ShapeRef.new(shape: GetBillingGroupCostReportInput)
+        o.output = Shapes::ShapeRef.new(shape: GetBillingGroupCostReportOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:list_account_associations, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListAccountAssociations"
         o.http_method = "POST"

data/lib/aws-sdk-billingconductor/endpoint_provider.rb

@@ -35,7 +35,7 @@ module Aws::BillingConductor
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://billingconductor-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-billingconductor/endpoints.rb

@@ -208,6 +208,20 @@ module Aws::BillingConductor
       end
     end
 
+    class GetBillingGroupCostReport
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::BillingConductor::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListAccountAssociations
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-billingconductor/plugins/endpoints.rb

@@ -85,6 +85,8 @@ module Aws::BillingConductor
             Aws::BillingConductor::Endpoints::DisassociateAccounts.build(context)
           when :disassociate_pricing_rules
             Aws::BillingConductor::Endpoints::DisassociatePricingRules.build(context)
+          when :get_billing_group_cost_report
+            Aws::BillingConductor::Endpoints::GetBillingGroupCostReport.build(context)
           when :list_account_associations
             Aws::BillingConductor::Endpoints::ListAccountAssociations.build(context)
           when :list_billing_group_cost_reports

data/lib/aws-sdk-billingconductor/types.rb

@@ -176,6 +176,29 @@ module Aws::BillingConductor
       include Aws::Structure
     end
 
+    # The key-value pair that represents the attribute by which the
+    # `BillingGroupCostReportResults` are grouped. For example, if you want
+    # a service-level breakdown for Amazon Simple Storage Service (Amazon
+    # S3) of the billing group, the attribute will be a key-value pair of
+    # `"PRODUCT_NAME"` and `"S3"`.
+    #
+    # @!attribute [rw] key
+    #   The key in a key-value pair that describes the margin summary.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   The value in a key-value pair that describes the margin summary.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/Attribute AWS API Documentation
+    #
+    class Attribute < Struct.new(
+      :key,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] target_arn
     #   A percentage custom line item ARN to associate the resources to.
     #   @return [String]
@@ -305,6 +328,59 @@ module Aws::BillingConductor
       include Aws::Structure
     end
 
+    # A paginated call to retrieve a list of summary reports of actual
+    # Amazon Web Services charges and the calculated Amazon Web Services
+    # charges, broken down by attributes.
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Number (ARN) that uniquely identifies the
+    #   billing group.
+    #   @return [String]
+    #
+    # @!attribute [rw] aws_cost
+    #   The actual Amazon Web Services charges for the billing group.
+    #   @return [String]
+    #
+    # @!attribute [rw] proforma_cost
+    #   The hypothetical Amazon Web Services charges based on the associated
+    #   pricing plan of a billing group.
+    #   @return [String]
+    #
+    # @!attribute [rw] margin
+    #   The billing group margin.
+    #   @return [String]
+    #
+    # @!attribute [rw] margin_percentage
+    #   The percentage of the billing group margin.
+    #   @return [String]
+    #
+    # @!attribute [rw] currency
+    #   The displayed currency.
+    #   @return [String]
+    #
+    # @!attribute [rw] attributes
+    #   The list of key-value pairs that represent the attributes by which
+    #   the `BillingGroupCostReportResults` are grouped. For example, if you
+    #   want the Amazon S3 service-level breakdown of a billing group for
+    #   November 2023, the attributes list will contain a key-value pair of
+    #   `"PRODUCT_NAME"` and `"S3"` and a key-value pair of
+    #   `"BILLING_PERIOD"` and `"Nov 2023"`.
+    #   @return [Array<Types::Attribute>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/BillingGroupCostReportResultElement AWS API Documentation
+    #
+    class BillingGroupCostReportResultElement < Struct.new(
+      :arn,
+      :aws_cost,
+      :proforma_cost,
+      :margin,
+      :margin_percentage,
+      :currency,
+      :attributes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A representation of a billing group.
     #
     # @!attribute [rw] name
@@ -372,6 +448,30 @@ module Aws::BillingConductor
       include Aws::Structure
     end
 
+    # A time range for which the margin summary is effective. The time range
+    # can be up to 12 months.
+    #
+    # @!attribute [rw] inclusive_start_billing_period
+    #   The inclusive start billing period that defines a billing period
+    #   range for the margin summary.
+    #   @return [String]
+    #
+    # @!attribute [rw] exclusive_end_billing_period
+    #   The exclusive end billing period that defines a billing period range
+    #   for the margin summary. For example, if you choose a billing period
+    #   that starts in October 2023 and ends in December 2023, the margin
+    #   summary will only include data from October 2023 and November 2023.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/BillingPeriodRange AWS API Documentation
+    #
+    class BillingPeriodRange < Struct.new(
+      :inclusive_start_billing_period,
+      :exclusive_end_billing_period)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The preferences and settings that will be used to compute the Amazon
     # Web Services charges for a billing group.
     #
@@ -515,6 +615,11 @@ module Aws::BillingConductor
     #   for a custom line item.
     #   @return [Types::CustomLineItemChargeDetails]
     #
+    # @!attribute [rw] account_id
+    #   The Amazon Web Services account in which this custom line item will
+    #   be applied to.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/CreateCustomLineItemInput AWS API Documentation
     #
     class CreateCustomLineItemInput < Struct.new(
@@ -524,7 +629,8 @@ module Aws::BillingConductor
       :billing_group_arn,
       :billing_period_range,
       :tags,
-      :charge_details)
+      :charge_details,
+      :account_id)
       SENSITIVE = [:name, :description]
       include Aws::Structure
     end
@@ -837,6 +943,11 @@ module Aws::BillingConductor
     #   The number of resources that are associated to the custom line item.
     #   @return [Integer]
     #
+    # @!attribute [rw] account_id
+    #   The Amazon Web Services account in which this custom line item will
+    #   be applied to.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/CustomLineItemListElement AWS API Documentation
     #
     class CustomLineItemListElement < Struct.new(
@@ -849,7 +960,8 @@ module Aws::BillingConductor
       :billing_group_arn,
       :creation_time,
       :last_modified_time,
-      :association_size)
+      :association_size,
+      :account_id)
       SENSITIVE = [:name, :description]
       include Aws::Structure
     end
@@ -934,6 +1046,11 @@ module Aws::BillingConductor
     #   The inclusive start time.
     #   @return [Integer]
     #
+    # @!attribute [rw] account_id
+    #   The Amazon Web Services account in which this custom line item will
+    #   be applied to.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/CustomLineItemVersionListElement AWS API Documentation
     #
     class CustomLineItemVersionListElement < Struct.new(
@@ -949,7 +1066,8 @@ module Aws::BillingConductor
       :start_billing_period,
       :end_billing_period,
       :arn,
-      :start_time)
+      :start_time,
+      :account_id)
       SENSITIVE = [:name, :description]
       include Aws::Structure
     end
@@ -998,7 +1116,7 @@ module Aws::BillingConductor
     end
 
     # @!attribute [rw] arn
-    #   Then ARN of the deleted custom line item.
+    #   The ARN of the deleted custom line item.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/DeleteCustomLineItemOutput AWS API Documentation
@@ -1156,6 +1274,60 @@ module Aws::BillingConductor
       include Aws::Structure
     end
 
+    # @!attribute [rw] arn
+    #   The Amazon Resource Number (ARN) that uniquely identifies the
+    #   billing group.
+    #   @return [String]
+    #
+    # @!attribute [rw] billing_period_range
+    #   A time range for which the margin summary is effective. You can
+    #   specify up to 12 months.
+    #   @return [Types::BillingPeriodRange]
+    #
+    # @!attribute [rw] group_by
+    #   A list of strings that specify the attributes that are used to break
+    #   down costs in the margin summary reports for the billing group. For
+    #   example, you can view your costs by the Amazon Web Service name or
+    #   the billing period.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of margin summary reports to retrieve.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token used on subsequent calls to get reports.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/GetBillingGroupCostReportInput AWS API Documentation
+    #
+    class GetBillingGroupCostReportInput < Struct.new(
+      :arn,
+      :billing_period_range,
+      :group_by,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] billing_group_cost_report_results
+    #   The list of margin summary reports.
+    #   @return [Array<Types::BillingGroupCostReportResultElement>]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token used on subsequent calls to get reports.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/GetBillingGroupCostReportOutput AWS API Documentation
+    #
+    class GetBillingGroupCostReportOutput < Struct.new(
+      :billing_group_cost_report_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An unexpected error occurred while processing a request.
     #
     # @!attribute [rw] message
@@ -1621,12 +1793,18 @@ module Aws::BillingConductor
     #   A list of custom line item ARNs to retrieve information.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] account_ids
+    #   The Amazon Web Services accounts in which this custom line item will
+    #   be applied to.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billingconductor-2021-07-30/ListCustomLineItemsFilter AWS API Documentation
     #
     class ListCustomLineItemsFilter < Struct.new(
       :names,
       :billing_groups,
-      :arns)
+      :arns,
+      :account_ids)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-billingconductor.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-billingconductor/customizations'
 # @!group service
 module Aws::BillingConductor
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.19.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-billingconductor
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-28 00:00:00.000000000 Z
+date: 2023-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core