aws-sdk-billing 1.32.0 → 1.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e94479ed6bf2ad73c6a7ef678d7fd7035654cbb3eae27ce23c73ba07c0b377
-  data.tar.gz: d266056edc6b1d253f0ce779be7e10b625fb7a8294df4720ae0eee8e068fcf70
+  metadata.gz: 396f3aaf6d0fb6382027061c490bcbbe3ad9e763861fc0d15a6908b87cd17630
+  data.tar.gz: f4d9e85d95d09508fb131d7a07eefccaee47b32338ef442e67ef08fe2048ce17
 SHA512:
-  metadata.gz: 5caf564b60653bf3f86c1b708e3c121b4cd349338e5205f2bdb63ee1b86a1078ed8c13aaecb0fadcfc760ed16e848fd8b170ba4ebf569e11b9baed2ccae90964
-  data.tar.gz: 6da0b7d3dd6f917019c07d4472ac5a27f367752cfa5b1f638f36db878a3ba12b368a8faf5cab564b746a038015aead3b29b41f0abc13f8300f30f17734cb11c7
+  metadata.gz: fbba2ecbaa9088e3ee2faafad02828dcd828a24d4b9f87ef586d4a7016fa56ef7dd4083e1e22c4090920a59e4e13558bd9362b640cbca2ffc4c7f3ce9a3768d0
+  data.tar.gz: fd670937acea1f2e3e6ae94b496c526024da5f5aa6f53979a231928ae59ccb8bdb93822bc47d7b3f06fbb741425fa1cfd91769f8b60b592e5e24e1c362d50740

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.34.0 (2026-09-23)
+------------------
+
+* Feature - Added the ListBillingViewSegments API, which returns billing view segment information for a specified billing view ARN and time range. This API enables customers and integrated tools to programmatically determine the billing context of their accounts.
+
+1.33.0 (2026-09-14)
+------------------
+
+* Feature - Increased the maximum number of services returned in the supportEligibleSpendByService field of ListEnterpriseSupportLinkedAccountCharges
+
 1.32.0 (2026-09-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.32.0
+1.34.0

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

@@ -1235,6 +1235,110 @@ module Aws::Billing
       req.send_request(options)
     end
 
+    # Lists the segments of a billing view over a given time period. Each
+    # segment identifies the billing domain (`PRO_FORMA` or `BILLABLE`) and
+    # the account relationships that apply during its time range.
+    #
+    # If you don't provide an `arn`, the response includes segments for the
+    # caller's `PRIMARY` billing view.
+    #
+    # If a mid-period change occurs, the response includes multiple
+    # segments, each with its own time range. The response omits hidden
+    # segments, so the segments it returns might not cover the entire
+    # requested time period.
+    #
+    # @option params [Types::BillingViewSegmentTimeRange] :time_range
+    #   The billing period to query. If you don't provide a time range, the
+    #   current billing period, which is the calendar month in UTC, is used.
+    #
+    # @option params [String] :arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the billing
+    #   view to query. If you don't provide an ARN, the caller's `PRIMARY`
+    #   billing view is used. The ARN must reference a primary billing view.
+    #   Custom billing views aren't supported.
+    #
+    # @option params [Integer] :max_results
+    #   The number of entries a paginated response contains. Valid values
+    #   range from 1 to 100. The default is 100.
+    #
+    # @option params [String] :next_token
+    #   The pagination token that is used on subsequent calls to list billing
+    #   view segments.
+    #
+    # @return [Types::ListBillingViewSegmentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListBillingViewSegmentsResponse#items #items} => Array<Types::BillingViewSegmentsListElement>
+    #   * {Types::ListBillingViewSegmentsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: Invoke ListBillingViewSegments
+    #
+    #   resp = client.list_billing_view_segments({
+    #     time_range: {
+    #       begin_date_inclusive: Time.parse(1719792000), 
+    #       end_date_exclusive: Time.parse(1722470400), 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         billing_group_primary_account_id: "333333333333", 
+    #         billing_transfer_account_id: "111111111111", 
+    #         domain: "BILLABLE", 
+    #         management_account_id: "222222222222", 
+    #         time_range: {
+    #           begin_date_inclusive: Time.parse(1719792000), 
+    #           end_date_exclusive: Time.parse(1722470400), 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Example: Error example for ListBillingViewSegments
+    #
+    #   resp = client.list_billing_view_segments({
+    #     time_range: {
+    #       begin_date_inclusive: Time.parse(1722470400), 
+    #       end_date_exclusive: Time.parse(1719792000), 
+    #     }, 
+    #   })
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_billing_view_segments({
+    #     time_range: {
+    #       begin_date_inclusive: Time.now,
+    #       end_date_exclusive: Time.now,
+    #     },
+    #     arn: "BillingViewArn",
+    #     max_results: 1,
+    #     next_token: "PageToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.items #=> Array
+    #   resp.items[0].domain #=> String, one of "BILLABLE", "PRO_FORMA"
+    #   resp.items[0].time_range.begin_date_inclusive #=> Time
+    #   resp.items[0].time_range.end_date_exclusive #=> Time
+    #   resp.items[0].billing_transfer_account_id #=> String
+    #   resp.items[0].management_account_id #=> String
+    #   resp.items[0].billing_group_primary_account_id #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListBillingViewSegments AWS API Documentation
+    #
+    # @overload list_billing_view_segments(params = {})
+    # @param [Hash] params ({})
+    def list_billing_view_segments(params = {}, options = {})
+      req = build_request(:list_billing_view_segments, params)
+      req.send_request(options)
+    end
+
     # Lists the billing views available for a given time period.
     #
     # Every Amazon Web Services account has a unique `PRIMARY` billing view
@@ -1794,7 +1898,7 @@ module Aws::Billing
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-billing'
-      context[:gem_version] = '1.32.0'
+      context[:gem_version] = '1.34.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -24,6 +24,7 @@ module Aws::Billing
     ApplicationType = Shapes::StringShape.new(name: 'ApplicationType')
     AssociateSourceViewsRequest = Shapes::StructureShape.new(name: 'AssociateSourceViewsRequest')
     AssociateSourceViewsResponse = Shapes::StructureShape.new(name: 'AssociateSourceViewsResponse')
+    BillingDomain = Shapes::StringShape.new(name: 'BillingDomain')
     BillingFeature = Shapes::StringShape.new(name: 'BillingFeature')
     BillingFeatureFilter = Shapes::StructureShape.new(name: 'BillingFeatureFilter')
     BillingFeatureFilterName = Shapes::StringShape.new(name: 'BillingFeatureFilterName')
@@ -44,6 +45,9 @@ module Aws::Billing
     BillingViewList = Shapes::ListShape.new(name: 'BillingViewList')
     BillingViewListElement = Shapes::StructureShape.new(name: 'BillingViewListElement')
     BillingViewName = Shapes::StringShape.new(name: 'BillingViewName')
+    BillingViewSegmentTimeRange = Shapes::StructureShape.new(name: 'BillingViewSegmentTimeRange')
+    BillingViewSegmentsList = Shapes::ListShape.new(name: 'BillingViewSegmentsList')
+    BillingViewSegmentsListElement = Shapes::StructureShape.new(name: 'BillingViewSegmentsListElement')
     BillingViewSourceViewsList = Shapes::ListShape.new(name: 'BillingViewSourceViewsList')
     BillingViewStatus = Shapes::StringShape.new(name: 'BillingViewStatus')
     BillingViewStatusReason = Shapes::StringShape.new(name: 'BillingViewStatusReason')
@@ -106,6 +110,8 @@ module Aws::Billing
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     LinkedAccountCharge = Shapes::StructureShape.new(name: 'LinkedAccountCharge')
     LinkedAccountChargeList = Shapes::ListShape.new(name: 'LinkedAccountChargeList')
+    ListBillingViewSegmentsRequest = Shapes::StructureShape.new(name: 'ListBillingViewSegmentsRequest')
+    ListBillingViewSegmentsResponse = Shapes::StructureShape.new(name: 'ListBillingViewSegmentsResponse')
     ListBillingViewsRequest = Shapes::StructureShape.new(name: 'ListBillingViewsRequest')
     ListBillingViewsResponse = Shapes::StructureShape.new(name: 'ListBillingViewsResponse')
     ListEnterpriseSupportLinkedAccountChargesRequest = Shapes::StructureShape.new(name: 'ListEnterpriseSupportLinkedAccountChargesRequest')
@@ -259,6 +265,19 @@ module Aws::Billing
     BillingViewListElement.add_member(:health_status, Shapes::ShapeRef.new(shape: BillingViewHealthStatus, location_name: "healthStatus"))
     BillingViewListElement.struct_class = Types::BillingViewListElement
 
+    BillingViewSegmentTimeRange.add_member(:begin_date_inclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "beginDateInclusive"))
+    BillingViewSegmentTimeRange.add_member(:end_date_exclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endDateExclusive"))
+    BillingViewSegmentTimeRange.struct_class = Types::BillingViewSegmentTimeRange
+
+    BillingViewSegmentsList.member = Shapes::ShapeRef.new(shape: BillingViewSegmentsListElement)
+
+    BillingViewSegmentsListElement.add_member(:domain, Shapes::ShapeRef.new(shape: BillingDomain, location_name: "domain"))
+    BillingViewSegmentsListElement.add_member(:time_range, Shapes::ShapeRef.new(shape: BillingViewSegmentTimeRange, location_name: "timeRange"))
+    BillingViewSegmentsListElement.add_member(:billing_transfer_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "billingTransferAccountId"))
+    BillingViewSegmentsListElement.add_member(:management_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "managementAccountId"))
+    BillingViewSegmentsListElement.add_member(:billing_group_primary_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "billingGroupPrimaryAccountId"))
+    BillingViewSegmentsListElement.struct_class = Types::BillingViewSegmentsListElement
+
     BillingViewSourceViewsList.member = Shapes::ShapeRef.new(shape: BillingViewArn)
 
     BillingViewStatusReasons.member = Shapes::ShapeRef.new(shape: BillingViewStatusReason)
@@ -469,6 +488,16 @@ module Aws::Billing
 
     LinkedAccountChargeList.member = Shapes::ShapeRef.new(shape: LinkedAccountCharge)
 
+    ListBillingViewSegmentsRequest.add_member(:time_range, Shapes::ShapeRef.new(shape: BillingViewSegmentTimeRange, location_name: "timeRange"))
+    ListBillingViewSegmentsRequest.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, location_name: "arn"))
+    ListBillingViewSegmentsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: BillingViewsMaxResults, location_name: "maxResults"))
+    ListBillingViewSegmentsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PageToken, location_name: "nextToken"))
+    ListBillingViewSegmentsRequest.struct_class = Types::ListBillingViewSegmentsRequest
+
+    ListBillingViewSegmentsResponse.add_member(:items, Shapes::ShapeRef.new(shape: BillingViewSegmentsList, required: true, location_name: "items"))
+    ListBillingViewSegmentsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PageToken, location_name: "nextToken"))
+    ListBillingViewSegmentsResponse.struct_class = Types::ListBillingViewSegmentsResponse
+
     ListBillingViewsRequest.add_member(:active_time_range, Shapes::ShapeRef.new(shape: ActiveTimeRange, location_name: "activeTimeRange"))
     ListBillingViewsRequest.add_member(:arns, Shapes::ShapeRef.new(shape: BillingViewArnList, location_name: "arns"))
     ListBillingViewsRequest.add_member(:billing_view_types, Shapes::ShapeRef.new(shape: BillingViewTypeList, location_name: "billingViewTypes"))
@@ -806,6 +835,26 @@ module Aws::Billing
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:list_billing_view_segments, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListBillingViewSegments"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListBillingViewSegmentsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListBillingViewSegmentsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BillingViewHealthStatusException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_billing_views, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListBillingViews"
         o.http_method = "POST"

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

@@ -384,6 +384,75 @@ module Aws::Billing
       include Aws::Structure
     end
 
+    # Specifies a time range with an inclusive begin date and an exclusive
+    # end date.
+    #
+    # @!attribute [rw] begin_date_inclusive
+    #   The inclusive start of the time range. This value can't be in the
+    #   future.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_date_exclusive
+    #   The exclusive end of the time range. This value must be after
+    #   `beginDateInclusive`.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewSegmentTimeRange AWS API Documentation
+    #
+    class BillingViewSegmentTimeRange < Struct.new(
+      :begin_date_inclusive,
+      :end_date_exclusive)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A billing view segment. A segment represents a time range during which
+    # the billing domain and account relationships for a billing view
+    # remained unchanged.
+    #
+    # @!attribute [rw] domain
+    #   The billing domain for this segment. The following values are valid:
+    #
+    #   * `PRO_FORMA` - Data shaped by Billing Conductor that doesn't
+    #     reflect the final charges owed to Amazon Web Services.
+    #
+    #   * `BILLABLE` - Data that represents the final charges owed to Amazon
+    #     Web Services.
+    #   @return [String]
+    #
+    # @!attribute [rw] time_range
+    #   The time range during which this segment is effective.
+    #   @return [Types::BillingViewSegmentTimeRange]
+    #
+    # @!attribute [rw] billing_transfer_account_id
+    #   The billing transfer account ID. The response includes this field
+    #   only when the caller is a billing transfer source account. The
+    #   response omits this field for billing group billing views.
+    #   @return [String]
+    #
+    # @!attribute [rw] management_account_id
+    #   The management account ID of the organization. The response includes
+    #   this field for organization member accounts.
+    #   @return [String]
+    #
+    # @!attribute [rw] billing_group_primary_account_id
+    #   The billing group primary account ID. The response includes this
+    #   field for billing group members. Compare this value to your own
+    #   account ID to determine whether you are the primary account.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewSegmentsListElement AWS API Documentation
+    #
+    class BillingViewSegmentsListElement < Struct.new(
+      :domain,
+      :time_range,
+      :billing_transfer_account_id,
+      :management_account_id,
+      :billing_group_primary_account_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An account that is charged all or a portion of the total Support
     # charge and the percentage of the charge allocated to it.
     #
@@ -1382,6 +1451,60 @@ module Aws::Billing
       include Aws::Structure
     end
 
+    # @!attribute [rw] time_range
+    #   The billing period to query. If you don't provide a time range, the
+    #   current billing period, which is the calendar month in UTC, is used.
+    #   @return [Types::BillingViewSegmentTimeRange]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the billing
+    #   view to query. If you don't provide an ARN, the caller's `PRIMARY`
+    #   billing view is used. The ARN must reference a primary billing view.
+    #   Custom billing views aren't supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The number of entries a paginated response contains. Valid values
+    #   range from 1 to 100. The default is 100.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token that is used on subsequent calls to list
+    #   billing view segments.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListBillingViewSegmentsRequest AWS API Documentation
+    #
+    class ListBillingViewSegmentsRequest < Struct.new(
+      :time_range,
+      :arn,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] items
+    #   A list of billing view segments. Each segment covers a portion of
+    #   the requested time period. The response omits hidden segments, so
+    #   the segments it returns might not cover the entire requested time
+    #   period.
+    #   @return [Array<Types::BillingViewSegmentsListElement>]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token that is used on subsequent calls to list
+    #   billing view segments.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListBillingViewSegmentsResponse AWS API Documentation
+    #
+    class ListBillingViewSegmentsResponse < Struct.new(
+      :items,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] active_time_range
     #   The time range for the billing views listed. `PRIMARY` billing view
     #   is always listed. `BILLING_GROUP` billing views are listed for time

data/lib/aws-sdk-billing.rb

@@ -55,7 +55,7 @@ module Aws::Billing
   autoload :EndpointProvider, 'aws-sdk-billing/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-billing/endpoints'
 
-  GEM_VERSION = '1.32.0'
+  GEM_VERSION = '1.34.0'
 
 end
 

data/sig/client.rbs

@@ -249,6 +249,23 @@ module Aws
                                ) -> _GetResourcePolicyResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetResourcePolicyResponseSuccess
 
+      interface _ListBillingViewSegmentsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListBillingViewSegmentsResponse]
+        def items: () -> ::Array[Types::BillingViewSegmentsListElement]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#list_billing_view_segments-instance_method
+      def list_billing_view_segments: (
+                                        ?time_range: {
+                                          begin_date_inclusive: ::Time?,
+                                          end_date_exclusive: ::Time?
+                                        },
+                                        ?arn: ::String,
+                                        ?max_results: ::Integer,
+                                        ?next_token: ::String
+                                      ) -> _ListBillingViewSegmentsResponseSuccess
+                                    | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListBillingViewSegmentsResponseSuccess
+
       interface _ListBillingViewsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListBillingViewsResponse]
         def billing_views: () -> ::Array[Types::BillingViewListElement]

data/sig/types.rbs

@@ -110,6 +110,21 @@ module Aws::Billing
       SENSITIVE: [:name, :description]
     end
 
+    class BillingViewSegmentTimeRange
+      attr_accessor begin_date_inclusive: ::Time
+      attr_accessor end_date_exclusive: ::Time
+      SENSITIVE: []
+    end
+
+    class BillingViewSegmentsListElement
+      attr_accessor domain: ("BILLABLE" | "PRO_FORMA")
+      attr_accessor time_range: Types::BillingViewSegmentTimeRange
+      attr_accessor billing_transfer_account_id: ::String
+      attr_accessor management_account_id: ::String
+      attr_accessor billing_group_primary_account_id: ::String
+      SENSITIVE: []
+    end
+
     class ChargeAccount
       attr_accessor account_id: ::String
       attr_accessor charge_percentage: ::String
@@ -360,6 +375,20 @@ module Aws::Billing
       SENSITIVE: []
     end
 
+    class ListBillingViewSegmentsRequest
+      attr_accessor time_range: Types::BillingViewSegmentTimeRange
+      attr_accessor arn: ::String
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class ListBillingViewSegmentsResponse
+      attr_accessor items: ::Array[Types::BillingViewSegmentsListElement]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListBillingViewsRequest
       attr_accessor active_time_range: Types::ActiveTimeRange
       attr_accessor arns: ::Array[::String]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-billing
 version: !ruby/object:Gem::Version
-  version: 1.32.0
+  version: 1.34.0
 platform: ruby
 authors:
 - Amazon Web Services