aws-sdk-billing 1.13.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc7ef46cb52259ef4ca21be32f4e6a1c43e622354efdf9d55dce5175e464619b
-  data.tar.gz: ab9065dd804bb95a31f4cbb178948a5828ea05ded13364b235f0baa87490ac1e
+  metadata.gz: d2bc93a502bd0e0302d15168198648a4606b4a62d625fe0bc96cced5993a5bc3
+  data.tar.gz: 87c78d11b9e8605ccec50061af8fc804c4ba8af0b2418d093a510f1927429d0b
 SHA512:
-  metadata.gz: caf36fff967b91ed70c3f81db68e56cb430729ae256e782e7a659eda43118c750a65bd05849d69eb37a2048dff32796b9e9d43fc7d74b4607db2bcaf80d46e66
-  data.tar.gz: b14de3e1400176b7db2f16e67f56a92e0198548950cfda7dd4913d74641a7db6b3cbc2353b67791830c1cf824956841af8138376b832f40570f2bfab25ab98b3
+  metadata.gz: 5fe643ec2ae6a32933f2c80750f5d0dccd5b512c7079feb3fc9fb19a3b24c04680ae8d26dea3ef3c284a9f25a05543e27279a679af0b7e216403e5f7e86dc1ac
+  data.tar.gz: 6f012d463f1ab17ca1b7e965b724422e230b10d5caa881ef29207ece3b10bdb00be00860a860987a94a1b47caace3f8a79ac422d7f9bbcc18bec0ed4659c7a40

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.14.0 (2025-09-26)
+------------------
+
+* Feature - Add ability to combine custom billing views to create new consolidated views.
+
 1.13.0 (2025-08-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.13.0
+1.14.0

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

@@ -483,6 +483,57 @@ module Aws::Billing
 
     # @!group API Operations
 
+    # Associates one or more source billing views with an existing billing
+    # view. This allows creating aggregate billing views that combine data
+    # from multiple sources.
+    #
+    # @option params [required, String] :arn
+    #   The Amazon Resource Name (ARN) of the billing view to associate source
+    #   views with.
+    #
+    # @option params [required, Array<String>] :source_views
+    #   A list of ARNs of the source billing views to associate.
+    #
+    # @return [Types::AssociateSourceViewsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::AssociateSourceViewsResponse#arn #arn} => String
+    #
+    #
+    # @example Example: Invoke AssociateSourceViews
+    #
+    #   resp = client.associate_source_views({
+    #     arn: "arn:aws:billing::123456789012:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899", 
+    #     source_views: [
+    #       "arn:aws:billing::123456789012:billingview/primary", 
+    #       "arn:aws:billing::123456789012:billingview/custom-d3f9c7e4-8b2f-4a6e-9d3b-2f7c8a1e5f6d", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     arn: "arn:aws:billing::123456789012:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.associate_source_views({
+    #     arn: "BillingViewArn", # required
+    #     source_views: ["BillingViewArn"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateSourceViews AWS API Documentation
+    #
+    # @overload associate_source_views(params = {})
+    # @param [Hash] params ({})
+    def associate_source_views(params = {}, options = {})
+      req = build_request(:associate_source_views, params)
+      req.send_request(options)
+    end
+
     # Creates a billing view with the specified billing view attributes.
     #
     # @option params [required, String] :name
@@ -562,6 +613,10 @@ module Aws::Billing
     #         key: "TagKey", # required
     #         values: ["Value"], # required
     #       },
+    #       time_range: {
+    #         begin_date_inclusive: Time.now,
+    #         end_date_inclusive: Time.now,
+    #       },
     #     },
     #     client_token: "ClientToken",
     #     resource_tags: [
@@ -592,6 +647,11 @@ module Aws::Billing
     #   The Amazon Resource Name (ARN) that can be used to uniquely identify
     #   the billing view.
     #
+    # @option params [Boolean] :force
+    #   If set to true, forces deletion of the billing view even if it has
+    #   derived resources (e.g. other billing views or budgets). Use with
+    #   caution as this may break dependent resources.
+    #
     # @return [Types::DeleteBillingViewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteBillingViewResponse#arn #arn} => String
@@ -612,6 +672,7 @@ module Aws::Billing
     #
     #   resp = client.delete_billing_view({
     #     arn: "BillingViewArn", # required
+    #     force: false,
     #   })
     #
     # @example Response structure
@@ -627,6 +688,57 @@ module Aws::Billing
       req.send_request(options)
     end
 
+    # Removes the association between one or more source billing views and
+    # an existing billing view. This allows modifying the composition of
+    # aggregate billing views.
+    #
+    # @option params [required, String] :arn
+    #   The Amazon Resource Name (ARN) of the billing view to disassociate
+    #   source views from.
+    #
+    # @option params [required, Array<String>] :source_views
+    #   A list of ARNs of the source billing views to disassociate.
+    #
+    # @return [Types::DisassociateSourceViewsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DisassociateSourceViewsResponse#arn #arn} => String
+    #
+    #
+    # @example Example: Invoke DisassociateSourceViews
+    #
+    #   resp = client.disassociate_source_views({
+    #     arn: "arn:aws:billing::123456789012:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899", 
+    #     source_views: [
+    #       "arn:aws:billing::123456789012:billingview/primary", 
+    #       "arn:aws:billing::123456789012:billingview/custom-d3f9c7e4-8b2f-4a6e-9d3b-2f7c8a1e5f6d", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     arn: "arn:aws:billing::123456789012:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.disassociate_source_views({
+    #     arn: "BillingViewArn", # required
+    #     source_views: ["BillingViewArn"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateSourceViews AWS API Documentation
+    #
+    # @overload disassociate_source_views(params = {})
+    # @param [Hash] params ({})
+    def disassociate_source_views(params = {}, options = {})
+      req = build_request(:disassociate_source_views, params)
+      req.send_request(options)
+    end
+
     # Returns the metadata associated to the specified billing view ARN.
     #
     # @option params [required, String] :arn
@@ -676,14 +788,23 @@ module Aws::Billing
     #   resp.billing_view.description #=> String
     #   resp.billing_view.billing_view_type #=> String, one of "PRIMARY", "BILLING_GROUP", "CUSTOM"
     #   resp.billing_view.owner_account_id #=> String
+    #   resp.billing_view.source_account_id #=> String
     #   resp.billing_view.data_filter_expression.dimensions.key #=> String, one of "LINKED_ACCOUNT"
     #   resp.billing_view.data_filter_expression.dimensions.values #=> Array
     #   resp.billing_view.data_filter_expression.dimensions.values[0] #=> String
     #   resp.billing_view.data_filter_expression.tags.key #=> String
     #   resp.billing_view.data_filter_expression.tags.values #=> Array
     #   resp.billing_view.data_filter_expression.tags.values[0] #=> String
+    #   resp.billing_view.data_filter_expression.time_range.begin_date_inclusive #=> Time
+    #   resp.billing_view.data_filter_expression.time_range.end_date_inclusive #=> Time
     #   resp.billing_view.created_at #=> Time
     #   resp.billing_view.updated_at #=> Time
+    #   resp.billing_view.derived_view_count #=> Integer
+    #   resp.billing_view.source_view_count #=> Integer
+    #   resp.billing_view.view_definition_last_updated_at #=> Time
+    #   resp.billing_view.health_status.status_code #=> String, one of "HEALTHY", "UNHEALTHY", "CREATING", "UPDATING"
+    #   resp.billing_view.health_status.status_reasons #=> Array
+    #   resp.billing_view.health_status.status_reasons[0] #=> String, one of "SOURCE_VIEW_UNHEALTHY", "SOURCE_VIEW_UPDATING", "SOURCE_VIEW_ACCESS_DENIED", "SOURCE_VIEW_NOT_FOUND", "CYCLIC_DEPENDENCY", "SOURCE_VIEW_DEPTH_EXCEEDED", "AGGREGATE_SOURCE", "VIEW_OWNER_NOT_MANAGEMENT_ACCOUNT"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/GetBillingView AWS API Documentation
     #
@@ -763,6 +884,10 @@ module Aws::Billing
     # @option params [String] :owner_account_id
     #   The list of owners of the billing view.
     #
+    # @option params [String] :source_account_id
+    #   Filters the results to include only billing views that use the
+    #   specified account as a source.
+    #
     # @option params [Integer] :max_results
     #   The maximum number of billing views to retrieve. Default is 100.
     #
@@ -818,6 +943,7 @@ module Aws::Billing
     #     arns: ["BillingViewArn"],
     #     billing_view_types: ["PRIMARY"], # accepts PRIMARY, BILLING_GROUP, CUSTOM
     #     owner_account_id: "AccountId",
+    #     source_account_id: "AccountId",
     #     max_results: 1,
     #     next_token: "PageToken",
     #   })
@@ -829,7 +955,11 @@ module Aws::Billing
     #   resp.billing_views[0].name #=> String
     #   resp.billing_views[0].description #=> String
     #   resp.billing_views[0].owner_account_id #=> String
+    #   resp.billing_views[0].source_account_id #=> String
     #   resp.billing_views[0].billing_view_type #=> String, one of "PRIMARY", "BILLING_GROUP", "CUSTOM"
+    #   resp.billing_views[0].health_status.status_code #=> String, one of "HEALTHY", "UNHEALTHY", "CREATING", "UPDATING"
+    #   resp.billing_views[0].health_status.status_reasons #=> Array
+    #   resp.billing_views[0].health_status.status_reasons[0] #=> String, one of "SOURCE_VIEW_UNHEALTHY", "SOURCE_VIEW_UPDATING", "SOURCE_VIEW_ACCESS_DENIED", "SOURCE_VIEW_NOT_FOUND", "CYCLIC_DEPENDENCY", "SOURCE_VIEW_DEPTH_EXCEEDED", "AGGREGATE_SOURCE", "VIEW_OWNER_NOT_MANAGEMENT_ACCOUNT"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListBillingViews AWS API Documentation
@@ -1099,6 +1229,10 @@ module Aws::Billing
     #         key: "TagKey", # required
     #         values: ["Value"], # required
     #       },
+    #       time_range: {
+    #         begin_date_inclusive: Time.now,
+    #         end_date_inclusive: Time.now,
+    #       },
     #     },
     #   })
     #
@@ -1134,7 +1268,7 @@ module Aws::Billing
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-billing'
-      context[:gem_version] = '1.13.0'
+      context[:gem_version] = '1.14.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -17,17 +17,25 @@ module Aws::Billing
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     AccountId = Shapes::StringShape.new(name: 'AccountId')
     ActiveTimeRange = Shapes::StructureShape.new(name: 'ActiveTimeRange')
+    AssociateSourceViewsRequest = Shapes::StructureShape.new(name: 'AssociateSourceViewsRequest')
+    AssociateSourceViewsResponse = Shapes::StructureShape.new(name: 'AssociateSourceViewsResponse')
     BillingViewArn = Shapes::StringShape.new(name: 'BillingViewArn')
     BillingViewArnList = Shapes::ListShape.new(name: 'BillingViewArnList')
     BillingViewDescription = Shapes::StringShape.new(name: 'BillingViewDescription')
     BillingViewElement = Shapes::StructureShape.new(name: 'BillingViewElement')
+    BillingViewHealthStatus = Shapes::StructureShape.new(name: 'BillingViewHealthStatus')
+    BillingViewHealthStatusException = Shapes::StructureShape.new(name: 'BillingViewHealthStatusException')
     BillingViewList = Shapes::ListShape.new(name: 'BillingViewList')
     BillingViewListElement = Shapes::StructureShape.new(name: 'BillingViewListElement')
     BillingViewName = Shapes::StringShape.new(name: 'BillingViewName')
     BillingViewSourceViewsList = Shapes::ListShape.new(name: 'BillingViewSourceViewsList')
+    BillingViewStatus = Shapes::StringShape.new(name: 'BillingViewStatus')
+    BillingViewStatusReason = Shapes::StringShape.new(name: 'BillingViewStatusReason')
+    BillingViewStatusReasons = Shapes::ListShape.new(name: 'BillingViewStatusReasons')
     BillingViewType = Shapes::StringShape.new(name: 'BillingViewType')
     BillingViewTypeList = Shapes::ListShape.new(name: 'BillingViewTypeList')
     BillingViewsMaxResults = Shapes::IntegerShape.new(name: 'BillingViewsMaxResults')
+    Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     ClientToken = Shapes::StringShape.new(name: 'ClientToken')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     CreateBillingViewRequest = Shapes::StructureShape.new(name: 'CreateBillingViewRequest')
@@ -36,6 +44,8 @@ module Aws::Billing
     DeleteBillingViewResponse = Shapes::StructureShape.new(name: 'DeleteBillingViewResponse')
     Dimension = Shapes::StringShape.new(name: 'Dimension')
     DimensionValues = Shapes::StructureShape.new(name: 'DimensionValues')
+    DisassociateSourceViewsRequest = Shapes::StructureShape.new(name: 'DisassociateSourceViewsRequest')
+    DisassociateSourceViewsResponse = Shapes::StructureShape.new(name: 'DisassociateSourceViewsResponse')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     Expression = Shapes::StructureShape.new(name: 'Expression')
     FieldName = Shapes::StringShape.new(name: 'FieldName')
@@ -43,6 +53,7 @@ module Aws::Billing
     GetBillingViewResponse = Shapes::StructureShape.new(name: 'GetBillingViewResponse')
     GetResourcePolicyRequest = Shapes::StructureShape.new(name: 'GetResourcePolicyRequest')
     GetResourcePolicyResponse = Shapes::StructureShape.new(name: 'GetResourcePolicyResponse')
+    Integer = Shapes::IntegerShape.new(name: 'Integer')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     ListBillingViewsRequest = Shapes::StructureShape.new(name: 'ListBillingViewsRequest')
     ListBillingViewsResponse = Shapes::StructureShape.new(name: 'ListBillingViewsResponse')
@@ -69,6 +80,7 @@ module Aws::Billing
     TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse')
     TagValues = Shapes::StructureShape.new(name: 'TagValues')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    TimeRange = Shapes::StructureShape.new(name: 'TimeRange')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
@@ -88,6 +100,13 @@ module Aws::Billing
     ActiveTimeRange.add_member(:active_before_inclusive, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "activeBeforeInclusive"))
     ActiveTimeRange.struct_class = Types::ActiveTimeRange
 
+    AssociateSourceViewsRequest.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
+    AssociateSourceViewsRequest.add_member(:source_views, Shapes::ShapeRef.new(shape: BillingViewSourceViewsList, required: true, location_name: "sourceViews"))
+    AssociateSourceViewsRequest.struct_class = Types::AssociateSourceViewsRequest
+
+    AssociateSourceViewsResponse.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
+    AssociateSourceViewsResponse.struct_class = Types::AssociateSourceViewsResponse
+
     BillingViewArnList.member = Shapes::ShapeRef.new(shape: BillingViewArn)
 
     BillingViewElement.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, location_name: "arn"))
@@ -95,22 +114,38 @@ module Aws::Billing
     BillingViewElement.add_member(:description, Shapes::ShapeRef.new(shape: BillingViewDescription, location_name: "description"))
     BillingViewElement.add_member(:billing_view_type, Shapes::ShapeRef.new(shape: BillingViewType, location_name: "billingViewType"))
     BillingViewElement.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "ownerAccountId"))
+    BillingViewElement.add_member(:source_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "sourceAccountId"))
     BillingViewElement.add_member(:data_filter_expression, Shapes::ShapeRef.new(shape: Expression, location_name: "dataFilterExpression"))
     BillingViewElement.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "createdAt"))
     BillingViewElement.add_member(:updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "updatedAt"))
+    BillingViewElement.add_member(:derived_view_count, Shapes::ShapeRef.new(shape: Integer, location_name: "derivedViewCount"))
+    BillingViewElement.add_member(:source_view_count, Shapes::ShapeRef.new(shape: Integer, location_name: "sourceViewCount"))
+    BillingViewElement.add_member(:view_definition_last_updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "viewDefinitionLastUpdatedAt"))
+    BillingViewElement.add_member(:health_status, Shapes::ShapeRef.new(shape: BillingViewHealthStatus, location_name: "healthStatus"))
     BillingViewElement.struct_class = Types::BillingViewElement
 
+    BillingViewHealthStatus.add_member(:status_code, Shapes::ShapeRef.new(shape: BillingViewStatus, location_name: "statusCode"))
+    BillingViewHealthStatus.add_member(:status_reasons, Shapes::ShapeRef.new(shape: BillingViewStatusReasons, location_name: "statusReasons"))
+    BillingViewHealthStatus.struct_class = Types::BillingViewHealthStatus
+
+    BillingViewHealthStatusException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, required: true, location_name: "message"))
+    BillingViewHealthStatusException.struct_class = Types::BillingViewHealthStatusException
+
     BillingViewList.member = Shapes::ShapeRef.new(shape: BillingViewListElement)
 
     BillingViewListElement.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, location_name: "arn"))
     BillingViewListElement.add_member(:name, Shapes::ShapeRef.new(shape: BillingViewName, location_name: "name"))
     BillingViewListElement.add_member(:description, Shapes::ShapeRef.new(shape: BillingViewDescription, location_name: "description"))
     BillingViewListElement.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "ownerAccountId"))
+    BillingViewListElement.add_member(:source_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "sourceAccountId"))
     BillingViewListElement.add_member(:billing_view_type, Shapes::ShapeRef.new(shape: BillingViewType, location_name: "billingViewType"))
+    BillingViewListElement.add_member(:health_status, Shapes::ShapeRef.new(shape: BillingViewHealthStatus, location_name: "healthStatus"))
     BillingViewListElement.struct_class = Types::BillingViewListElement
 
     BillingViewSourceViewsList.member = Shapes::ShapeRef.new(shape: BillingViewArn)
 
+    BillingViewStatusReasons.member = Shapes::ShapeRef.new(shape: BillingViewStatusReason)
+
     BillingViewTypeList.member = Shapes::ShapeRef.new(shape: BillingViewType)
 
     ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, required: true, location_name: "message"))
@@ -131,6 +166,7 @@ module Aws::Billing
     CreateBillingViewResponse.struct_class = Types::CreateBillingViewResponse
 
     DeleteBillingViewRequest.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
+    DeleteBillingViewRequest.add_member(:force, Shapes::ShapeRef.new(shape: Boolean, location_name: "force"))
     DeleteBillingViewRequest.struct_class = Types::DeleteBillingViewRequest
 
     DeleteBillingViewResponse.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
@@ -140,8 +176,16 @@ module Aws::Billing
     DimensionValues.add_member(:values, Shapes::ShapeRef.new(shape: Values, required: true, location_name: "values"))
     DimensionValues.struct_class = Types::DimensionValues
 
+    DisassociateSourceViewsRequest.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
+    DisassociateSourceViewsRequest.add_member(:source_views, Shapes::ShapeRef.new(shape: BillingViewSourceViewsList, required: true, location_name: "sourceViews"))
+    DisassociateSourceViewsRequest.struct_class = Types::DisassociateSourceViewsRequest
+
+    DisassociateSourceViewsResponse.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
+    DisassociateSourceViewsResponse.struct_class = Types::DisassociateSourceViewsResponse
+
     Expression.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionValues, location_name: "dimensions"))
     Expression.add_member(:tags, Shapes::ShapeRef.new(shape: TagValues, location_name: "tags"))
+    Expression.add_member(:time_range, Shapes::ShapeRef.new(shape: TimeRange, location_name: "timeRange"))
     Expression.struct_class = Types::Expression
 
     GetBillingViewRequest.add_member(:arn, Shapes::ShapeRef.new(shape: BillingViewArn, required: true, location_name: "arn"))
@@ -164,6 +208,7 @@ module Aws::Billing
     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"))
     ListBillingViewsRequest.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "ownerAccountId"))
+    ListBillingViewsRequest.add_member(:source_account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "sourceAccountId"))
     ListBillingViewsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: BillingViewsMaxResults, location_name: "maxResults"))
     ListBillingViewsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PageToken, location_name: "nextToken"))
     ListBillingViewsRequest.struct_class = Types::ListBillingViewsRequest
@@ -220,6 +265,10 @@ module Aws::Billing
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, required: true, location_name: "message"))
     ThrottlingException.struct_class = Types::ThrottlingException
 
+    TimeRange.add_member(:begin_date_inclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "beginDateInclusive"))
+    TimeRange.add_member(:end_date_inclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endDateInclusive"))
+    TimeRange.struct_class = Types::TimeRange
+
     UntagResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location_name: "resourceArn"))
     UntagResourceRequest.add_member(:resource_tag_keys, Shapes::ShapeRef.new(shape: ResourceTagKeyList, required: true, location_name: "resourceTagKeys"))
     UntagResourceRequest.struct_class = Types::UntagResourceRequest
@@ -270,14 +319,32 @@ module Aws::Billing
         "uid" => "billing-2023-09-07",
       }
 
+      api.add_operation(:associate_source_views, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "AssociateSourceViews"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: AssociateSourceViewsRequest)
+        o.output = Shapes::ShapeRef.new(shape: AssociateSourceViewsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BillingViewHealthStatusException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        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: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:create_billing_view, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateBillingView"
         o.http_method = "POST"
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: CreateBillingViewRequest)
         o.output = Shapes::ShapeRef.new(shape: CreateBillingViewResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BillingViewHealthStatusException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
         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: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
@@ -297,6 +364,21 @@ module Aws::Billing
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:disassociate_source_views, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DisassociateSourceViews"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DisassociateSourceViewsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DisassociateSourceViewsResponse)
+        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: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:get_billing_view, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetBillingView"
         o.http_method = "POST"
@@ -405,6 +487,7 @@ module Aws::Billing
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: UpdateBillingViewRequest)
         o.output = Shapes::ShapeRef.new(shape: UpdateBillingViewResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BillingViewHealthStatusException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)

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

@@ -28,6 +28,7 @@ module Aws::Billing
   #
   # ## Error Classes
   # * {AccessDeniedException}
+  # * {BillingViewHealthStatusException}
   # * {ConflictException}
   # * {InternalServerException}
   # * {ResourceNotFoundException}
@@ -56,6 +57,21 @@ module Aws::Billing
       end
     end
 
+    class BillingViewHealthStatusException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::Billing::Types::BillingViewHealthStatusException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class ConflictException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -42,6 +42,37 @@ module Aws::Billing
       include Aws::Structure
     end
 
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the billing view to associate
+    #   source views with.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_views
+    #   A list of ARNs of the source billing views to associate.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateSourceViewsRequest AWS API Documentation
+    #
+    class AssociateSourceViewsRequest < Struct.new(
+      :arn,
+      :source_views)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] arn
+    #   The ARN of the billing view that the source views were associated
+    #   with.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateSourceViewsResponse AWS API Documentation
+    #
+    class AssociateSourceViewsResponse < Struct.new(
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The metadata associated to the billing view.
     #
     # @!attribute [rw] arn
@@ -65,6 +96,11 @@ module Aws::Billing
     #   The account owner of the billing view.
     #   @return [String]
     #
+    # @!attribute [rw] source_account_id
+    #   The Amazon Web Services account ID that owns the source billing
+    #   view, if this is a derived billing view.
+    #   @return [String]
+    #
     # @!attribute [rw] data_filter_expression
     #   See [Expression][1]. Billing view only supports `LINKED_ACCOUNT` and
     #   `Tags`.
@@ -82,6 +118,22 @@ module Aws::Billing
     #   The time when the billing view was last updated.
     #   @return [Time]
     #
+    # @!attribute [rw] derived_view_count
+    #   The number of billing views that use this billing view as a source.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] source_view_count
+    #   The number of source views associated with this billing view.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] view_definition_last_updated_at
+    #   The timestamp of when the billing view definition was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] health_status
+    #   The current health status of the billing view.
+    #   @return [Types::BillingViewHealthStatus]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewElement AWS API Documentation
     #
     class BillingViewElement < Struct.new(
@@ -90,13 +142,54 @@ module Aws::Billing
       :description,
       :billing_view_type,
       :owner_account_id,
+      :source_account_id,
       :data_filter_expression,
       :created_at,
-      :updated_at)
+      :updated_at,
+      :derived_view_count,
+      :source_view_count,
+      :view_definition_last_updated_at,
+      :health_status)
       SENSITIVE = [:name, :description]
       include Aws::Structure
     end
 
+    # Represents the health status of a billing view, including a status
+    # code and optional reasons for the status.
+    #
+    # @!attribute [rw] status_code
+    #   The current health status code of the billing view.
+    #   @return [String]
+    #
+    # @!attribute [rw] status_reasons
+    #   A list of reasons explaining the current health status, if
+    #   applicable.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewHealthStatus AWS API Documentation
+    #
+    class BillingViewHealthStatus < Struct.new(
+      :status_code,
+      :status_reasons)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Exception thrown when a billing view's health status prevents an
+    # operation from being performed. This may occur if the billing view is
+    # in a state other than `HEALTHY`.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewHealthStatusException AWS API Documentation
+    #
+    class BillingViewHealthStatusException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A representation of a billing view.
     #
     # @!attribute [rw] arn
@@ -116,10 +209,19 @@ module Aws::Billing
     #   The list of owners of the Billing view.
     #   @return [String]
     #
+    # @!attribute [rw] source_account_id
+    #   The Amazon Web Services account ID that owns the source billing
+    #   view, if this is a derived billing view.
+    #   @return [String]
+    #
     # @!attribute [rw] billing_view_type
     #   The type of billing view.
     #   @return [String]
     #
+    # @!attribute [rw] health_status
+    #   The current health status of the billing view.
+    #   @return [Types::BillingViewHealthStatus]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/BillingViewListElement AWS API Documentation
     #
     class BillingViewListElement < Struct.new(
@@ -127,7 +229,9 @@ module Aws::Billing
       :name,
       :description,
       :owner_account_id,
-      :billing_view_type)
+      :source_account_id,
+      :billing_view_type,
+      :health_status)
       SENSITIVE = [:name, :description]
       include Aws::Structure
     end
@@ -231,10 +335,17 @@ module Aws::Billing
     #   the billing view.
     #   @return [String]
     #
+    # @!attribute [rw] force
+    #   If set to true, forces deletion of the billing view even if it has
+    #   derived resources (e.g. other billing views or budgets). Use with
+    #   caution as this may break dependent resources.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DeleteBillingViewRequest AWS API Documentation
     #
     class DeleteBillingViewRequest < Struct.new(
-      :arn)
+      :arn,
+      :force)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -273,6 +384,37 @@ module Aws::Billing
       include Aws::Structure
     end
 
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the billing view to disassociate
+    #   source views from.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_views
+    #   A list of ARNs of the source billing views to disassociate.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateSourceViewsRequest AWS API Documentation
+    #
+    class DisassociateSourceViewsRequest < Struct.new(
+      :arn,
+      :source_views)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] arn
+    #   The ARN of the billing view that the source views were disassociated
+    #   from.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateSourceViewsResponse AWS API Documentation
+    #
+    class DisassociateSourceViewsResponse < Struct.new(
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # See [Expression][1]. Billing view only supports `LINKED_ACCOUNT` and
     # `Tags`.
     #
@@ -288,11 +430,16 @@ module Aws::Billing
     #   The specific `Tag` to use for `Expression`.
     #   @return [Types::TagValues]
     #
+    # @!attribute [rw] time_range
+    #   Specifies a time range filter for the billing view data.
+    #   @return [Types::TimeRange]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/Expression AWS API Documentation
     #
     class Expression < Struct.new(
       :dimensions,
-      :tags)
+      :tags,
+      :time_range)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -389,6 +536,11 @@ module Aws::Billing
     #   The list of owners of the billing view.
     #   @return [String]
     #
+    # @!attribute [rw] source_account_id
+    #   Filters the results to include only billing views that use the
+    #   specified account as a source.
+    #   @return [String]
+    #
     # @!attribute [rw] max_results
     #   The maximum number of billing views to retrieve. Default is 100.
     #   @return [Integer]
@@ -405,6 +557,7 @@ module Aws::Billing
       :arns,
       :billing_view_types,
       :owner_account_id,
+      :source_account_id,
       :max_results,
       :next_token)
       SENSITIVE = []
@@ -625,6 +778,25 @@ module Aws::Billing
       include Aws::Structure
     end
 
+    # Specifies a time range with inclusive begin and end dates.
+    #
+    # @!attribute [rw] begin_date_inclusive
+    #   The inclusive start date of the time range.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_date_inclusive
+    #   The inclusive end date of the time range.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/TimeRange AWS API Documentation
+    #
+    class TimeRange < Struct.new(
+      :begin_date_inclusive,
+      :end_date_inclusive)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) of the resource.
     #   @return [String]

data/lib/aws-sdk-billing.rb

@@ -23,7 +23,7 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:billing)
 # structure.
 #
 #     billing = Aws::Billing::Client.new
-#     resp = billing.create_billing_view(params)
+#     resp = billing.associate_source_views(params)
 #
 # See {Client} for more information.
 #
@@ -55,7 +55,7 @@ module Aws::Billing
   autoload :EndpointProvider, 'aws-sdk-billing/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-billing/endpoints'
 
-  GEM_VERSION = '1.13.0'
+  GEM_VERSION = '1.14.0'
 
 end
 

data/sig/client.rbs

@@ -79,6 +79,17 @@ module Aws
                   | (?Hash[Symbol, untyped]) -> instance
 
 
+      interface _AssociateSourceViewsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::AssociateSourceViewsResponse]
+        def arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#associate_source_views-instance_method
+      def associate_source_views: (
+                                    arn: ::String,
+                                    source_views: Array[::String]
+                                  ) -> _AssociateSourceViewsResponseSuccess
+                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _AssociateSourceViewsResponseSuccess
+
       interface _CreateBillingViewResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::CreateBillingViewResponse]
         def arn: () -> ::String
@@ -97,6 +108,10 @@ module Aws
                                    tags: {
                                      key: ::String,
                                      values: Array[::String]
+                                   }?,
+                                   time_range: {
+                                     begin_date_inclusive: ::Time?,
+                                     end_date_inclusive: ::Time?
                                    }?
                                  },
                                  ?client_token: ::String,
@@ -115,10 +130,22 @@ module Aws
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#delete_billing_view-instance_method
       def delete_billing_view: (
-                                 arn: ::String
+                                 arn: ::String,
+                                 ?force: bool
                                ) -> _DeleteBillingViewResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteBillingViewResponseSuccess
 
+      interface _DisassociateSourceViewsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DisassociateSourceViewsResponse]
+        def arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#disassociate_source_views-instance_method
+      def disassociate_source_views: (
+                                       arn: ::String,
+                                       source_views: Array[::String]
+                                     ) -> _DisassociateSourceViewsResponseSuccess
+                                   | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DisassociateSourceViewsResponseSuccess
+
       interface _GetBillingViewResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetBillingViewResponse]
         def billing_view: () -> Types::BillingViewElement
@@ -154,6 +181,7 @@ module Aws
                                 ?arns: Array[::String],
                                 ?billing_view_types: Array[("PRIMARY" | "BILLING_GROUP" | "CUSTOM")],
                                 ?owner_account_id: ::String,
+                                ?source_account_id: ::String,
                                 ?max_results: ::Integer,
                                 ?next_token: ::String
                               ) -> _ListBillingViewsResponseSuccess
@@ -225,6 +253,10 @@ module Aws
                                    tags: {
                                      key: ::String,
                                      values: Array[::String]
+                                   }?,
+                                   time_range: {
+                                     begin_date_inclusive: ::Time?,
+                                     end_date_inclusive: ::Time?
                                    }?
                                  }
                                ) -> _UpdateBillingViewResponseSuccess

data/sig/errors.rbs

@@ -14,6 +14,9 @@ module Aws
       class AccessDeniedException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class BillingViewHealthStatusException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class ConflictException < ::Aws::Errors::ServiceError
         def message: () -> ::String
         def resource_id: () -> ::String

data/sig/types.rbs

@@ -19,24 +19,53 @@ module Aws::Billing
       SENSITIVE: []
     end
 
+    class AssociateSourceViewsRequest
+      attr_accessor arn: ::String
+      attr_accessor source_views: ::Array[::String]
+      SENSITIVE: []
+    end
+
+    class AssociateSourceViewsResponse
+      attr_accessor arn: ::String
+      SENSITIVE: []
+    end
+
     class BillingViewElement
       attr_accessor arn: ::String
       attr_accessor name: ::String
       attr_accessor description: ::String
       attr_accessor billing_view_type: ("PRIMARY" | "BILLING_GROUP" | "CUSTOM")
       attr_accessor owner_account_id: ::String
+      attr_accessor source_account_id: ::String
       attr_accessor data_filter_expression: Types::Expression
       attr_accessor created_at: ::Time
       attr_accessor updated_at: ::Time
+      attr_accessor derived_view_count: ::Integer
+      attr_accessor source_view_count: ::Integer
+      attr_accessor view_definition_last_updated_at: ::Time
+      attr_accessor health_status: Types::BillingViewHealthStatus
       SENSITIVE: [:name, :description]
     end
 
+    class BillingViewHealthStatus
+      attr_accessor status_code: ("HEALTHY" | "UNHEALTHY" | "CREATING" | "UPDATING")
+      attr_accessor status_reasons: ::Array[("SOURCE_VIEW_UNHEALTHY" | "SOURCE_VIEW_UPDATING" | "SOURCE_VIEW_ACCESS_DENIED" | "SOURCE_VIEW_NOT_FOUND" | "CYCLIC_DEPENDENCY" | "SOURCE_VIEW_DEPTH_EXCEEDED" | "AGGREGATE_SOURCE" | "VIEW_OWNER_NOT_MANAGEMENT_ACCOUNT")]
+      SENSITIVE: []
+    end
+
+    class BillingViewHealthStatusException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class BillingViewListElement
       attr_accessor arn: ::String
       attr_accessor name: ::String
       attr_accessor description: ::String
       attr_accessor owner_account_id: ::String
+      attr_accessor source_account_id: ::String
       attr_accessor billing_view_type: ("PRIMARY" | "BILLING_GROUP" | "CUSTOM")
+      attr_accessor health_status: Types::BillingViewHealthStatus
       SENSITIVE: [:name, :description]
     end
 
@@ -65,6 +94,7 @@ module Aws::Billing
 
     class DeleteBillingViewRequest
       attr_accessor arn: ::String
+      attr_accessor force: bool
       SENSITIVE: []
     end
 
@@ -79,9 +109,21 @@ module Aws::Billing
       SENSITIVE: []
     end
 
+    class DisassociateSourceViewsRequest
+      attr_accessor arn: ::String
+      attr_accessor source_views: ::Array[::String]
+      SENSITIVE: []
+    end
+
+    class DisassociateSourceViewsResponse
+      attr_accessor arn: ::String
+      SENSITIVE: []
+    end
+
     class Expression
       attr_accessor dimensions: Types::DimensionValues
       attr_accessor tags: Types::TagValues
+      attr_accessor time_range: Types::TimeRange
       SENSITIVE: []
     end
 
@@ -116,6 +158,7 @@ module Aws::Billing
       attr_accessor arns: ::Array[::String]
       attr_accessor billing_view_types: ::Array[("PRIMARY" | "BILLING_GROUP" | "CUSTOM")]
       attr_accessor owner_account_id: ::String
+      attr_accessor source_account_id: ::String
       attr_accessor max_results: ::Integer
       attr_accessor next_token: ::String
       SENSITIVE: []
@@ -192,6 +235,12 @@ module Aws::Billing
       SENSITIVE: []
     end
 
+    class TimeRange
+      attr_accessor begin_date_inclusive: ::Time
+      attr_accessor end_date_inclusive: ::Time
+      SENSITIVE: []
+    end
+
     class UntagResourceRequest
       attr_accessor resource_arn: ::String
       attr_accessor resource_tag_keys: ::Array[::String]

metadata

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