aws-sdk-sustainability 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e21adc3c47bf3ebee5daf52bdc58ba115689a6511882ccdbfec1a2c5158b7354
-  data.tar.gz: 1402f3d7ba0687e75e4a7edd84c63e46dbda666536a90f98cd968aba9557bd48
+  metadata.gz: 62a23a263dc75248e6348c4d8e8aba5947b504f124e2295f5d7c8a51ec4ec085
+  data.tar.gz: 3d7a5daeab43c1b3e0a5118c15c0c80ffe641920d18cf53f56ebdb45532d916e
 SHA512:
-  metadata.gz: ee59e8dbd8d0bb8209a33f41c5253e6e0dcc85ce9d463bdc156b05d1241465b827c9f4c205d7ad51e74767a75171531b1a7ac525b2f6b1de8b716babbed526d0
-  data.tar.gz: 6822ef3f84c8a23e45f711d95233b6730b919e680907c13d42e6bc7088f815d66cba7fbfed898e6efb8c8ffad27e260f895308670aef4e5bb012ff696017584e
+  metadata.gz: bef2154223da72015ad3f7f15535b3e1b02135139c655a16ec499fd1f23de9e2ee10b82e32ee014f0c098decf63a5eda18ef9ac7b53254bcc97a0a58f23b983c
+  data.tar.gz: 3dda60f099de460f6442095aaa6e8db5cb16b88e8faf2cf122074c4ed940d209f76861ed509ed06bf32905bfebb549bd75df0d68222c4a61018f8571ef25c9b2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.5.0 (2026-07-16)
+------------------
+
+* Feature - Adds support for retrieving estimated water allocation data.
+
 1.4.0 (2026-07-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.4.0
+1.5.0

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

@@ -479,13 +479,17 @@ module Aws::Sustainability
     # the operation returns quickly and successfully.
     #
     # @option params [required, Types::TimePeriod] :time_period
-    #   The date range for fetching estimated carbon emissions.
+    #   The date range for fetching estimated carbon emissions. The range must
+    #   include the start date of a month for that month's data to be
+    #   included in the response.
     #
     # @option params [Array<String>] :group_by
     #   The dimensions available for grouping estimated carbon emissions.
     #
     # @option params [Types::FilterExpression] :filter_by
-    #   The criteria for filtering estimated carbon emissions.
+    #   The criteria for filtering estimated carbon emissions. To determine
+    #   which dimensions are available to be filtered by, you can first call
+    #   GetEstimatedCarbonEmissionsDimensionValues
     #
     # @option params [Array<String>] :emissions_types
     #   The emission types to include in the results. If absent, returns
@@ -494,7 +498,14 @@ module Aws::Sustainability
     #
     # @option params [String] :granularity
     #   The time granularity for the results. If absent, uses `MONTHLY` time
-    #   granularity.
+    #   granularity. The smallest supported granularity for carbon emissions
+    #   is `MONTHLY`.
+    #
+    #   If requesting partial time periods, data will be returned based on the
+    #   smallest supported granularity. For example, requesting
+    #   `2025-04-01T00:00:00Z` to `2026-04-01T00:00:00Z` with
+    #   `YEARLY_CALENDAR` granularity will return the last 9 months for 2025
+    #   and the first 3 months of 2026.
     #
     # @option params [Types::GranularityConfiguration] :granularity_configuration
     #   Configuration for fiscal year calculations when using `YEARLY_FISCAL`
@@ -502,7 +513,7 @@ module Aws::Sustainability
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in a single call. Default is
-    #   40.
+    #   1000.
     #
     # @option params [String] :next_token
     #   The pagination token specifying which page of results to return in the
@@ -594,7 +605,7 @@ module Aws::Sustainability
     #     group_by: ["USAGE_ACCOUNT_ID"], # accepts USAGE_ACCOUNT_ID, REGION, SERVICE
     #     filter_by: {
     #       dimensions: {
-    #         "USAGE_ACCOUNT_ID" => ["String"],
+    #         "USAGE_ACCOUNT_ID" => ["DimensionValue"],
     #       },
     #     },
     #     emissions_types: ["TOTAL_LBM_CARBON_EMISSIONS"], # accepts TOTAL_LBM_CARBON_EMISSIONS, TOTAL_MBM_CARBON_EMISSIONS, TOTAL_SCOPE_1_CARBON_EMISSIONS, TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS, TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS, TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS, TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS
@@ -633,14 +644,16 @@ module Aws::Sustainability
     # returns quickly and successfully.
     #
     # @option params [required, Types::TimePeriod] :time_period
-    #   The date range for fetching the dimension values.
+    #   The date range for fetching the dimension values. The range must
+    #   include the start date of a month for that month's dimensions to be
+    #   included in the response.
     #
     # @option params [required, Array<String>] :dimensions
     #   The dimensions available for grouping estimated carbon emissions.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in a single call. Default is
-    #   40.
+    #   1000.
     #
     # @option params [String] :next_token
     #   The pagination token specifying which page of results to return in the
@@ -730,6 +743,236 @@ module Aws::Sustainability
       req.send_request(options)
     end
 
+    # Returns estimated water allocation values based on customer grouping
+    # and filtering parameters. We recommend using pagination to ensure that
+    # the operation returns quickly and successfully.
+    #
+    # @option params [required, Types::TimePeriod] :time_period
+    #   The date range for fetching estimated water allocation. The range must
+    #   include the start date of a year for that year's data to be included
+    #   in the response.
+    #
+    # @option params [Array<String>] :group_by
+    #   The dimensions available for grouping estimated water allocation.
+    #
+    # @option params [Types::FilterExpression] :filter_by
+    #   The criteria for filtering estimated water allocation. To determine
+    #   which dimensions are available to be filtered by, you can first call
+    #   GetEstimatedWaterAllocationDimensionValues
+    #
+    # @option params [Array<String>] :allocation_types
+    #   The allocation types to include in the results. If absent, returns
+    #   `TOTAL_WATER_WITHDRAWALS` allocation types.
+    #
+    # @option params [String] :granularity
+    #   The time granularity for the results. Only `YEARLY_CALENDAR` time
+    #   granularity is currently supported for water allocation. Defaults to
+    #   `YEARLY_CALENDAR` if absent.
+    #
+    #   If requesting partial time periods, data will be returned based on the
+    #   smallest supported granularity. For example, requesting
+    #   `2025-04-01T00:00:00Z` to `2026-04-01T00:00:00Z` with
+    #   `YEARLY_CALENDAR` will return all the data for 2026 only.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in a single call. Default is
+    #   1000.
+    #
+    # @option params [String] :next_token
+    #   The pagination token specifying which page of results to return in the
+    #   response. If no token is provided, the default page is the first page.
+    #
+    # @return [Types::GetEstimatedWaterAllocationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetEstimatedWaterAllocationResponse#results #results} => Array&lt;Types::EstimatedWaterAllocation&gt;
+    #   * {Types::GetEstimatedWaterAllocationResponse#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: GetEstimatedWaterAllocationSuccess
+    #
+    #   resp = client.get_estimated_water_allocation({
+    #     allocation_types: [
+    #       "TOTAL_WATER_WITHDRAWALS", 
+    #     ], 
+    #     granularity: "YEARLY_CALENDAR", 
+    #     group_by: [
+    #       "SERVICE", 
+    #     ], 
+    #     time_period: {
+    #       end: Time.parse("2026-01-01T00:00:00.00Z"), 
+    #       start: Time.parse("2025-01-01T00:00:00.00Z"), 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     results: [
+    #       {
+    #         allocation_values: {
+    #           "TOTAL_WATER_WITHDRAWALS" => {
+    #             unit: "m3", 
+    #             value: 1, 
+    #           }, 
+    #         }, 
+    #         dimensions_values: {
+    #           "SERVICE" => "AmazonEC2", 
+    #         }, 
+    #         model_version: "v1.0.0", 
+    #         time_period: {
+    #           end: Time.parse("2026-01-01T00:00:00Z"), 
+    #           start: Time.parse("2025-01-01T00:00:00Z"), 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_estimated_water_allocation({
+    #     time_period: { # required
+    #       start: Time.now, # required
+    #       end: Time.now, # required
+    #     },
+    #     group_by: ["USAGE_ACCOUNT_ID"], # accepts USAGE_ACCOUNT_ID, REGION, SERVICE
+    #     filter_by: {
+    #       dimensions: {
+    #         "USAGE_ACCOUNT_ID" => ["DimensionValue"],
+    #       },
+    #     },
+    #     allocation_types: ["TOTAL_WATER_WITHDRAWALS"], # accepts TOTAL_WATER_WITHDRAWALS
+    #     granularity: "YEARLY_CALENDAR", # accepts YEARLY_CALENDAR, YEARLY_FISCAL, QUARTERLY_CALENDAR, QUARTERLY_FISCAL, MONTHLY
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.results #=> Array
+    #   resp.results[0].time_period.start #=> Time
+    #   resp.results[0].time_period.end #=> Time
+    #   resp.results[0].dimensions_values #=> Hash
+    #   resp.results[0].dimensions_values["Dimension"] #=> String
+    #   resp.results[0].model_version #=> String
+    #   resp.results[0].allocation_values #=> Hash
+    #   resp.results[0].allocation_values["WaterAllocationType"].value #=> Float
+    #   resp.results[0].allocation_values["WaterAllocationType"].unit #=> String, one of "m3"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocation AWS API Documentation
+    #
+    # @overload get_estimated_water_allocation(params = {})
+    # @param [Hash] params ({})
+    def get_estimated_water_allocation(params = {}, options = {})
+      req = build_request(:get_estimated_water_allocation, params)
+      req.send_request(options)
+    end
+
+    # Returns the possible dimension values available for a customer's
+    # account. We recommend using pagination to ensure that the operation
+    # returns quickly and successfully.
+    #
+    # @option params [required, Types::TimePeriod] :time_period
+    #   The date range for fetching the dimension values. The range must
+    #   include the start date of a year for that year's data to be included
+    #   in the response.
+    #
+    # @option params [required, Array<String>] :dimensions
+    #   The dimensions available for grouping estimated water allocation.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in a single call. Default is
+    #   1000.
+    #
+    # @option params [String] :next_token
+    #   The pagination token specifying which page of results to return in the
+    #   response. If no token is provided, the default page is the first page.
+    #
+    # @return [Types::GetEstimatedWaterAllocationDimensionValuesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetEstimatedWaterAllocationDimensionValuesResponse#results #results} => Array&lt;Types::DimensionEntry&gt;
+    #   * {Types::GetEstimatedWaterAllocationDimensionValuesResponse#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: GetEstimatedWaterAllocationDimensionValuesSuccess
+    #
+    #   resp = client.get_estimated_water_allocation_dimension_values({
+    #     dimensions: [
+    #       "REGION", 
+    #       "SERVICE", 
+    #       "USAGE_ACCOUNT_ID", 
+    #     ], 
+    #     time_period: {
+    #       end: Time.parse("2026-01-01T00:00:00.00Z"), 
+    #       start: Time.parse("2025-01-01T00:00:00.00Z"), 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     results: [
+    #       {
+    #         dimension: "SERVICE", 
+    #         value: "AmazonEC2", 
+    #       }, 
+    #       {
+    #         dimension: "SERVICE", 
+    #         value: "AmazonS3", 
+    #       }, 
+    #       {
+    #         dimension: "SERVICE", 
+    #         value: "AmazonCloudFront", 
+    #       }, 
+    #       {
+    #         dimension: "REGION", 
+    #         value: "global", 
+    #       }, 
+    #       {
+    #         dimension: "REGION", 
+    #         value: "us-east-1", 
+    #       }, 
+    #       {
+    #         dimension: "REGION", 
+    #         value: "us-west-2", 
+    #       }, 
+    #       {
+    #         dimension: "USAGE_ACCOUNT_ID", 
+    #         value: "111222333444", 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_estimated_water_allocation_dimension_values({
+    #     time_period: { # required
+    #       start: Time.now, # required
+    #       end: Time.now, # required
+    #     },
+    #     dimensions: ["USAGE_ACCOUNT_ID"], # required, accepts USAGE_ACCOUNT_ID, REGION, SERVICE
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.results #=> Array
+    #   resp.results[0].dimension #=> String, one of "USAGE_ACCOUNT_ID", "REGION", "SERVICE"
+    #   resp.results[0].value #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocationDimensionValues AWS API Documentation
+    #
+    # @overload get_estimated_water_allocation_dimension_values(params = {})
+    # @param [Hash] params ({})
+    def get_estimated_water_allocation_dimension_values(params = {}, options = {})
+      req = build_request(:get_estimated_water_allocation_dimension_values, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -748,7 +991,7 @@ module Aws::Sustainability
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sustainability'
-      context[:gem_version] = '1.4.0'
+      context[:gem_version] = '1.5.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -20,6 +20,7 @@ module Aws::Sustainability
     DimensionEntryList = Shapes::ListShape.new(name: 'DimensionEntryList')
     DimensionList = Shapes::ListShape.new(name: 'DimensionList')
     DimensionListMap = Shapes::MapShape.new(name: 'DimensionListMap')
+    DimensionValue = Shapes::StringShape.new(name: 'DimensionValue')
     DimensionValueList = Shapes::ListShape.new(name: 'DimensionValueList')
     DimensionsMap = Shapes::MapShape.new(name: 'DimensionsMap')
     Double = Shapes::FloatShape.new(name: 'Double')
@@ -30,11 +31,17 @@ module Aws::Sustainability
     EmissionsUnit = Shapes::StringShape.new(name: 'EmissionsUnit')
     EstimatedCarbonEmissions = Shapes::StructureShape.new(name: 'EstimatedCarbonEmissions')
     EstimatedCarbonEmissionsList = Shapes::ListShape.new(name: 'EstimatedCarbonEmissionsList')
+    EstimatedWaterAllocation = Shapes::StructureShape.new(name: 'EstimatedWaterAllocation')
+    EstimatedWaterAllocationList = Shapes::ListShape.new(name: 'EstimatedWaterAllocationList')
     FilterExpression = Shapes::StructureShape.new(name: 'FilterExpression')
     GetEstimatedCarbonEmissionsDimensionValuesRequest = Shapes::StructureShape.new(name: 'GetEstimatedCarbonEmissionsDimensionValuesRequest')
     GetEstimatedCarbonEmissionsDimensionValuesResponse = Shapes::StructureShape.new(name: 'GetEstimatedCarbonEmissionsDimensionValuesResponse')
     GetEstimatedCarbonEmissionsRequest = Shapes::StructureShape.new(name: 'GetEstimatedCarbonEmissionsRequest')
     GetEstimatedCarbonEmissionsResponse = Shapes::StructureShape.new(name: 'GetEstimatedCarbonEmissionsResponse')
+    GetEstimatedWaterAllocationDimensionValuesRequest = Shapes::StructureShape.new(name: 'GetEstimatedWaterAllocationDimensionValuesRequest')
+    GetEstimatedWaterAllocationDimensionValuesResponse = Shapes::StructureShape.new(name: 'GetEstimatedWaterAllocationDimensionValuesResponse')
+    GetEstimatedWaterAllocationRequest = Shapes::StructureShape.new(name: 'GetEstimatedWaterAllocationRequest')
+    GetEstimatedWaterAllocationResponse = Shapes::StructureShape.new(name: 'GetEstimatedWaterAllocationResponse')
     GranularityConfiguration = Shapes::StructureShape.new(name: 'GranularityConfiguration')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
@@ -47,12 +54,17 @@ module Aws::Sustainability
     TimePeriod = Shapes::StructureShape.new(name: 'TimePeriod')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp', timestampFormat: "iso8601")
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
+    WaterAllocation = Shapes::StructureShape.new(name: 'WaterAllocation')
+    WaterAllocationMap = Shapes::MapShape.new(name: 'WaterAllocationMap')
+    WaterAllocationType = Shapes::StringShape.new(name: 'WaterAllocationType')
+    WaterAllocationTypeList = Shapes::ListShape.new(name: 'WaterAllocationTypeList')
+    WaterAllocationUnit = Shapes::StringShape.new(name: 'WaterAllocationUnit')
 
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
     DimensionEntry.add_member(:dimension, Shapes::ShapeRef.new(shape: Dimension, required: true, location_name: "Dimension"))
-    DimensionEntry.add_member(:value, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Value"))
+    DimensionEntry.add_member(:value, Shapes::ShapeRef.new(shape: DimensionValue, required: true, location_name: "Value"))
     DimensionEntry.struct_class = Types::DimensionEntry
 
     DimensionEntryList.member = Shapes::ShapeRef.new(shape: DimensionEntry)
@@ -62,10 +74,10 @@ module Aws::Sustainability
     DimensionListMap.key = Shapes::ShapeRef.new(shape: Dimension)
     DimensionListMap.value = Shapes::ShapeRef.new(shape: DimensionValueList)
 
-    DimensionValueList.member = Shapes::ShapeRef.new(shape: String)
+    DimensionValueList.member = Shapes::ShapeRef.new(shape: DimensionValue)
 
     DimensionsMap.key = Shapes::ShapeRef.new(shape: Dimension)
-    DimensionsMap.value = Shapes::ShapeRef.new(shape: String)
+    DimensionsMap.value = Shapes::ShapeRef.new(shape: DimensionValue)
 
     Emissions.add_member(:value, Shapes::ShapeRef.new(shape: Double, required: true, location_name: "Value"))
     Emissions.add_member(:unit, Shapes::ShapeRef.new(shape: EmissionsUnit, required: true, location_name: "Unit"))
@@ -84,6 +96,14 @@ module Aws::Sustainability
 
     EstimatedCarbonEmissionsList.member = Shapes::ShapeRef.new(shape: EstimatedCarbonEmissions)
 
+    EstimatedWaterAllocation.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, required: true, location_name: "TimePeriod"))
+    EstimatedWaterAllocation.add_member(:dimensions_values, Shapes::ShapeRef.new(shape: DimensionsMap, required: true, location_name: "DimensionsValues"))
+    EstimatedWaterAllocation.add_member(:model_version, Shapes::ShapeRef.new(shape: ModelVersion, required: true, location_name: "ModelVersion"))
+    EstimatedWaterAllocation.add_member(:allocation_values, Shapes::ShapeRef.new(shape: WaterAllocationMap, required: true, location_name: "AllocationValues"))
+    EstimatedWaterAllocation.struct_class = Types::EstimatedWaterAllocation
+
+    EstimatedWaterAllocationList.member = Shapes::ShapeRef.new(shape: EstimatedWaterAllocation)
+
     FilterExpression.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionListMap, location_name: "Dimensions"))
     FilterExpression.struct_class = Types::FilterExpression
 
@@ -111,6 +131,29 @@ module Aws::Sustainability
     GetEstimatedCarbonEmissionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     GetEstimatedCarbonEmissionsResponse.struct_class = Types::GetEstimatedCarbonEmissionsResponse
 
+    GetEstimatedWaterAllocationDimensionValuesRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, required: true, location_name: "TimePeriod"))
+    GetEstimatedWaterAllocationDimensionValuesRequest.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionList, required: true, location_name: "Dimensions"))
+    GetEstimatedWaterAllocationDimensionValuesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    GetEstimatedWaterAllocationDimensionValuesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetEstimatedWaterAllocationDimensionValuesRequest.struct_class = Types::GetEstimatedWaterAllocationDimensionValuesRequest
+
+    GetEstimatedWaterAllocationDimensionValuesResponse.add_member(:results, Shapes::ShapeRef.new(shape: DimensionEntryList, required: true, location_name: "Results"))
+    GetEstimatedWaterAllocationDimensionValuesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetEstimatedWaterAllocationDimensionValuesResponse.struct_class = Types::GetEstimatedWaterAllocationDimensionValuesResponse
+
+    GetEstimatedWaterAllocationRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, required: true, location_name: "TimePeriod"))
+    GetEstimatedWaterAllocationRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: DimensionList, location_name: "GroupBy"))
+    GetEstimatedWaterAllocationRequest.add_member(:filter_by, Shapes::ShapeRef.new(shape: FilterExpression, location_name: "FilterBy"))
+    GetEstimatedWaterAllocationRequest.add_member(:allocation_types, Shapes::ShapeRef.new(shape: WaterAllocationTypeList, location_name: "AllocationTypes"))
+    GetEstimatedWaterAllocationRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: TimeGranularity, location_name: "Granularity"))
+    GetEstimatedWaterAllocationRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    GetEstimatedWaterAllocationRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetEstimatedWaterAllocationRequest.struct_class = Types::GetEstimatedWaterAllocationRequest
+
+    GetEstimatedWaterAllocationResponse.add_member(:results, Shapes::ShapeRef.new(shape: EstimatedWaterAllocationList, required: true, location_name: "Results"))
+    GetEstimatedWaterAllocationResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetEstimatedWaterAllocationResponse.struct_class = Types::GetEstimatedWaterAllocationResponse
+
     GranularityConfiguration.add_member(:fiscal_year_start_month, Shapes::ShapeRef.new(shape: Month, location_name: "FiscalYearStartMonth"))
     GranularityConfiguration.struct_class = Types::GranularityConfiguration
 
@@ -127,6 +170,15 @@ module Aws::Sustainability
     ValidationException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     ValidationException.struct_class = Types::ValidationException
 
+    WaterAllocation.add_member(:value, Shapes::ShapeRef.new(shape: Double, required: true, location_name: "Value"))
+    WaterAllocation.add_member(:unit, Shapes::ShapeRef.new(shape: WaterAllocationUnit, required: true, location_name: "Unit"))
+    WaterAllocation.struct_class = Types::WaterAllocation
+
+    WaterAllocationMap.key = Shapes::ShapeRef.new(shape: WaterAllocationType)
+    WaterAllocationMap.value = Shapes::ShapeRef.new(shape: WaterAllocation)
+
+    WaterAllocationTypeList.member = Shapes::ShapeRef.new(shape: WaterAllocationType)
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|
@@ -181,6 +233,42 @@ module Aws::Sustainability
           }
         )
       end)
+
+      api.add_operation(:get_estimated_water_allocation, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetEstimatedWaterAllocation"
+        o.http_method = "POST"
+        o.http_request_uri = "/v1/estimated-water-allocation"
+        o.input = Shapes::ShapeRef.new(shape: GetEstimatedWaterAllocationRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetEstimatedWaterAllocationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:get_estimated_water_allocation_dimension_values, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetEstimatedWaterAllocationDimensionValues"
+        o.http_method = "POST"
+        o.http_request_uri = "/v1/estimated-water-allocation-dimension-values"
+        o.input = Shapes::ShapeRef.new(shape: GetEstimatedWaterAllocationDimensionValuesRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetEstimatedWaterAllocationDimensionValuesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
     end
 
   end

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

@@ -107,10 +107,47 @@ module Aws::Sustainability
       include Aws::Structure
     end
 
-    # Filters emission values by specific dimension values.
+    # Contains estimated water allocation data for a specific time period
+    # and dimension grouping.
+    #
+    # @!attribute [rw] time_period
+    #   The reporting period for water allocation values.
+    #   @return [Types::TimePeriod]
+    #
+    # @!attribute [rw] dimensions_values
+    #   The dimensions used to group water allocation values.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] model_version
+    #   The semantic version-formatted string that indicates the methodology
+    #   version used to calculate the water allocation values.
+    #
+    #   <note markdown="1"> The AWS Sustainability service reflects the most recent model
+    #   version for every month. You will not see two entries for the same
+    #   month with different `ModelVersion` values.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] allocation_values
+    #   The allocation values for the requested water allocation types.
+    #   @return [Hash<String,Types::WaterAllocation>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/EstimatedWaterAllocation AWS API Documentation
+    #
+    class EstimatedWaterAllocation < Struct.new(
+      :time_period,
+      :dimensions_values,
+      :model_version,
+      :allocation_values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Filters environmental impact values by specific dimension values.
     #
     # @!attribute [rw] dimensions
-    #   Filters emission values by specific dimension values.
+    #   Filters environmental impact values by specific dimension values.
     #   @return [Hash<String,Array<String>>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/FilterExpression AWS API Documentation
@@ -122,7 +159,9 @@ module Aws::Sustainability
     end
 
     # @!attribute [rw] time_period
-    #   The date range for fetching the dimension values.
+    #   The date range for fetching the dimension values. The range must
+    #   include the start date of a month for that month's dimensions to be
+    #   included in the response.
     #   @return [Types::TimePeriod]
     #
     # @!attribute [rw] dimensions
@@ -131,7 +170,7 @@ module Aws::Sustainability
     #
     # @!attribute [rw] max_results
     #   The maximum number of results to return in a single call. Default is
-    #   40.
+    #   1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -172,7 +211,9 @@ module Aws::Sustainability
     end
 
     # @!attribute [rw] time_period
-    #   The date range for fetching estimated carbon emissions.
+    #   The date range for fetching estimated carbon emissions. The range
+    #   must include the start date of a month for that month's data to be
+    #   included in the response.
     #   @return [Types::TimePeriod]
     #
     # @!attribute [rw] group_by
@@ -180,7 +221,9 @@ module Aws::Sustainability
     #   @return [Array<String>]
     #
     # @!attribute [rw] filter_by
-    #   The criteria for filtering estimated carbon emissions.
+    #   The criteria for filtering estimated carbon emissions. To determine
+    #   which dimensions are available to be filtered by, you can first call
+    #   GetEstimatedCarbonEmissionsDimensionValues
     #   @return [Types::FilterExpression]
     #
     # @!attribute [rw] emissions_types
@@ -191,7 +234,14 @@ module Aws::Sustainability
     #
     # @!attribute [rw] granularity
     #   The time granularity for the results. If absent, uses `MONTHLY` time
-    #   granularity.
+    #   granularity. The smallest supported granularity for carbon emissions
+    #   is `MONTHLY`.
+    #
+    #   If requesting partial time periods, data will be returned based on
+    #   the smallest supported granularity. For example, requesting
+    #   `2025-04-01T00:00:00Z` to `2026-04-01T00:00:00Z` with
+    #   `YEARLY_CALENDAR` granularity will return the last 9 months for 2025
+    #   and the first 3 months of 2026.
     #   @return [String]
     #
     # @!attribute [rw] granularity_configuration
@@ -201,7 +251,7 @@ module Aws::Sustainability
     #
     # @!attribute [rw] max_results
     #   The maximum number of results to return in a single call. Default is
-    #   40.
+    #   1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -244,6 +294,134 @@ module Aws::Sustainability
       include Aws::Structure
     end
 
+    # @!attribute [rw] time_period
+    #   The date range for fetching the dimension values. The range must
+    #   include the start date of a year for that year's data to be
+    #   included in the response.
+    #   @return [Types::TimePeriod]
+    #
+    # @!attribute [rw] dimensions
+    #   The dimensions available for grouping estimated water allocation.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return in a single call. Default is
+    #   1000.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token specifying which page of results to return in
+    #   the response. If no token is provided, the default page is the first
+    #   page.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocationDimensionValuesRequest AWS API Documentation
+    #
+    class GetEstimatedWaterAllocationDimensionValuesRequest < Struct.new(
+      :time_period,
+      :dimensions,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] results
+    #   The list of possible dimensions over which the allocation data is
+    #   aggregated.
+    #   @return [Array<Types::DimensionEntry>]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token indicating there are additional pages
+    #   available. You can use the token in a following request to fetch the
+    #   next set of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocationDimensionValuesResponse AWS API Documentation
+    #
+    class GetEstimatedWaterAllocationDimensionValuesResponse < Struct.new(
+      :results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] time_period
+    #   The date range for fetching estimated water allocation. The range
+    #   must include the start date of a year for that year's data to be
+    #   included in the response.
+    #   @return [Types::TimePeriod]
+    #
+    # @!attribute [rw] group_by
+    #   The dimensions available for grouping estimated water allocation.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] filter_by
+    #   The criteria for filtering estimated water allocation. To determine
+    #   which dimensions are available to be filtered by, you can first call
+    #   GetEstimatedWaterAllocationDimensionValues
+    #   @return [Types::FilterExpression]
+    #
+    # @!attribute [rw] allocation_types
+    #   The allocation types to include in the results. If absent, returns
+    #   `TOTAL_WATER_WITHDRAWALS` allocation types.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] granularity
+    #   The time granularity for the results. Only `YEARLY_CALENDAR` time
+    #   granularity is currently supported for water allocation. Defaults to
+    #   `YEARLY_CALENDAR` if absent.
+    #
+    #   If requesting partial time periods, data will be returned based on
+    #   the smallest supported granularity. For example, requesting
+    #   `2025-04-01T00:00:00Z` to `2026-04-01T00:00:00Z` with
+    #   `YEARLY_CALENDAR` will return all the data for 2026 only.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return in a single call. Default is
+    #   1000.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token specifying which page of results to return in
+    #   the response. If no token is provided, the default page is the first
+    #   page.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocationRequest AWS API Documentation
+    #
+    class GetEstimatedWaterAllocationRequest < Struct.new(
+      :time_period,
+      :group_by,
+      :filter_by,
+      :allocation_types,
+      :granularity,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] results
+    #   The result of the requested inputs.
+    #   @return [Array<Types::EstimatedWaterAllocation>]
+    #
+    # @!attribute [rw] next_token
+    #   The pagination token indicating there are additional pages
+    #   available. You can use the token in a following request to fetch the
+    #   next set of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/GetEstimatedWaterAllocationResponse AWS API Documentation
+    #
+    class GetEstimatedWaterAllocationResponse < Struct.new(
+      :results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains configuration for the fiscal year granularities (e.g.,
     # `YEARLY_FISCAL`, `QUARTERLY_FISCAL`.
     #
@@ -323,6 +501,26 @@ module Aws::Sustainability
       include Aws::Structure
     end
 
+    # Represents a water allocation quantity with its value and unit of
+    # measurement.
+    #
+    # @!attribute [rw] value
+    #   The numeric value of the allocation quantity.
+    #   @return [Float]
+    #
+    # @!attribute [rw] unit
+    #   The unit of measurement for the allocation value.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sustainability-2018-05-10/WaterAllocation AWS API Documentation
+    #
+    class WaterAllocation < Struct.new(
+      :value,
+      :unit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
   end
 end
 

data/lib/aws-sdk-sustainability.rb

@@ -54,7 +54,7 @@ module Aws::Sustainability
   autoload :EndpointProvider, 'aws-sdk-sustainability/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-sustainability/endpoints'
 
-  GEM_VERSION = '1.4.0'
+  GEM_VERSION = '1.5.0'
 
 end
 

data/sig/client.rbs

@@ -119,6 +119,45 @@ module Aws
                                                              ?next_token: ::String
                                                            ) -> _GetEstimatedCarbonEmissionsDimensionValuesResponseSuccess
                                                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetEstimatedCarbonEmissionsDimensionValuesResponseSuccess
+
+      interface _GetEstimatedWaterAllocationResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetEstimatedWaterAllocationResponse]
+        def results: () -> ::Array[Types::EstimatedWaterAllocation]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Sustainability/Client.html#get_estimated_water_allocation-instance_method
+      def get_estimated_water_allocation: (
+                                            time_period: {
+                                              start: ::Time,
+                                              end: ::Time
+                                            },
+                                            ?group_by: Array[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE")],
+                                            ?filter_by: {
+                                              dimensions: Hash[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE"), Array[::String]]?
+                                            },
+                                            ?allocation_types: Array[("TOTAL_WATER_WITHDRAWALS")],
+                                            ?granularity: ("YEARLY_CALENDAR" | "YEARLY_FISCAL" | "QUARTERLY_CALENDAR" | "QUARTERLY_FISCAL" | "MONTHLY"),
+                                            ?max_results: ::Integer,
+                                            ?next_token: ::String
+                                          ) -> _GetEstimatedWaterAllocationResponseSuccess
+                                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetEstimatedWaterAllocationResponseSuccess
+
+      interface _GetEstimatedWaterAllocationDimensionValuesResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetEstimatedWaterAllocationDimensionValuesResponse]
+        def results: () -> ::Array[Types::DimensionEntry]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Sustainability/Client.html#get_estimated_water_allocation_dimension_values-instance_method
+      def get_estimated_water_allocation_dimension_values: (
+                                                             time_period: {
+                                                               start: ::Time,
+                                                               end: ::Time
+                                                             },
+                                                             dimensions: Array[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE")],
+                                                             ?max_results: ::Integer,
+                                                             ?next_token: ::String
+                                                           ) -> _GetEstimatedWaterAllocationDimensionValuesResponseSuccess
+                                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetEstimatedWaterAllocationDimensionValuesResponseSuccess
     end
   end
 end

data/sig/types.rbs

@@ -33,6 +33,14 @@ module Aws::Sustainability
       SENSITIVE: []
     end
 
+    class EstimatedWaterAllocation
+      attr_accessor time_period: Types::TimePeriod
+      attr_accessor dimensions_values: ::Hash[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE"), ::String]
+      attr_accessor model_version: ::String
+      attr_accessor allocation_values: ::Hash[("TOTAL_WATER_WITHDRAWALS"), Types::WaterAllocation]
+      SENSITIVE: []
+    end
+
     class FilterExpression
       attr_accessor dimensions: ::Hash[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE"), ::Array[::String]]
       SENSITIVE: []
@@ -70,6 +78,37 @@ module Aws::Sustainability
       SENSITIVE: []
     end
 
+    class GetEstimatedWaterAllocationDimensionValuesRequest
+      attr_accessor time_period: Types::TimePeriod
+      attr_accessor dimensions: ::Array[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE")]
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class GetEstimatedWaterAllocationDimensionValuesResponse
+      attr_accessor results: ::Array[Types::DimensionEntry]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class GetEstimatedWaterAllocationRequest
+      attr_accessor time_period: Types::TimePeriod
+      attr_accessor group_by: ::Array[("USAGE_ACCOUNT_ID" | "REGION" | "SERVICE")]
+      attr_accessor filter_by: Types::FilterExpression
+      attr_accessor allocation_types: ::Array[("TOTAL_WATER_WITHDRAWALS")]
+      attr_accessor granularity: ("YEARLY_CALENDAR" | "YEARLY_FISCAL" | "QUARTERLY_CALENDAR" | "QUARTERLY_FISCAL" | "MONTHLY")
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class GetEstimatedWaterAllocationResponse
+      attr_accessor results: ::Array[Types::EstimatedWaterAllocation]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class GranularityConfiguration
       attr_accessor fiscal_year_start_month: ::Integer
       SENSITIVE: []
@@ -95,5 +134,11 @@ module Aws::Sustainability
       attr_accessor message: ::String
       SENSITIVE: []
     end
+
+    class WaterAllocation
+      attr_accessor value: ::Float
+      attr_accessor unit: ("m3")
+      SENSITIVE: []
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sustainability
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Amazon Web Services