orb-billing 1.28.1 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f08e40cee1132ccfdf37c2ca335239dca8012678897c474d325c9eb180953502
-  data.tar.gz: 1d2a73ae5808fccab65086206ccefaea08ae1e8e507cb2d5d3d5e23a59093ab5
+  metadata.gz: f5a6e4855b8279d4e1a6bdf28f4c400529e61861a120047763a6ffdaed8e5575
+  data.tar.gz: 36fe46e75224e82fb729f71d0d754736174092708fc02b1692600360eff66dc7
 SHA512:
-  metadata.gz: c5ac4d9687e33fe77a4bbdf07fc4ef84e5cceee491d14f9dc6c9a3c36ef0c244bc02a77c59fecb0ba8c49e7fbb30b4d1d8d94686c539eae58966734635ee277f
-  data.tar.gz: 884291fba079ed20ef2afa070f84fbe1a156eb5d088bcfba97914ea17c02c9d17a9176bc1c2acb957f15f27a84be92bbe81e584b4c4e3ff3388b81227fa9246e
+  metadata.gz: b6a5c380bac65e5c3636214e5dd68535b327a427ad3b24519af8de62f7426c95a321d492e8ba9940f5426da4df5ac39be566b756f91ba73ea3445aea90450708
+  data.tar.gz: a20cd6d63c5af3f339fbaaba7d3fd549b137a4218f7d6f5ccf9021a74c274ae8beaa6bf2f40f885f23e31267bf03c45cad819a0c329abd281d9de5832f65d5d1

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.29.0](https://github.com/orbcorp/orb-ruby/compare/v1.28.1...v1.29.0) (2026-09-03)
+
+
+### Features
+
+* **api:** support partial grouping key targeting in alert threshold overrides ([df6a1c5](https://github.com/orbcorp/orb-ruby/commit/df6a1c56eb5008b4659900048b555e6fff7dcd30))
+
 ## [1.28.1](https://github.com/orbcorp/orb-ruby/compare/v1.28.0...v1.28.1) (2026-08-28)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.28.1"
+gem "orb-billing", "~> 1.29.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/alert.rb

@@ -308,8 +308,8 @@ module Orb
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
-        #   The values of the grouping keys that identify this group. The list length
-        #   matches the alert's grouping_keys.
+        #   The values identifying this group, ordered to match group_keys when set and the
+        #   alert's grouping_keys otherwise.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -320,7 +320,14 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys this override binds. Null when the
+        #   override targets one exact group across every grouping key.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Alert::ThresholdOverride} for more details.
         #
@@ -329,9 +336,11 @@ module Orb
         #   An empty `thresholds` list means the group is silenced (never fires). A
         #   non-empty list fully replaces the default thresholds for that group.
         #
-        #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length matche
+        #   @param group_values [Array<String>] The values identifying this group, ordered to match group_keys when set and the
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds applied to this group. An empty list means the group is silenced.
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys this override binds. Null when the overr
       end
     end
   end

data/lib/orb/models/alert_create_for_subscription_params.rb

@@ -160,8 +160,8 @@ module Orb
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
         #   The values of the grouping keys that identify this group. The list length must
-        #   match the alert's grouping_keys, and values appear in the same order as
-        #   grouping_keys.
+        #   match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        #   values in the same order as whichever applies.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -173,7 +173,16 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys that this override binds. Any grouping
+        #   key not named is unconstrained, so the override applies to every group matching
+        #   the named values. When omitted, group_values must cover every grouping key in
+        #   order.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::AlertCreateForSubscriptionParams::ThresholdOverride} for more
         #   details.
@@ -186,6 +195,8 @@ module Orb
         #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length must m
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds to apply to this group. An empty list silences alerts for this gr
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys that this override binds. Any grouping k
       end
     end
   end

data/lib/orb/models/alert_update_params.rb

@@ -112,8 +112,8 @@ module Orb
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         # @!attribute group_values
         #   The values of the grouping keys that identify this group. The list length must
-        #   match the alert's grouping_keys, and values appear in the same order as
-        #   grouping_keys.
+        #   match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        #   values in the same order as whichever applies.
         #
         #   @return [Array<String>]
         required :group_values, Orb::Internal::Type::ArrayOf[String]
@@ -125,7 +125,16 @@ module Orb
         #   @return [Array<Orb::Models::Threshold>]
         required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Threshold] }
 
-        # @!method initialize(group_values:, thresholds:)
+        # @!attribute group_keys
+        #   The subset of the alert's grouping_keys that this override binds. Any grouping
+        #   key not named is unconstrained, so the override applies to every group matching
+        #   the named values. When omitted, group_values must cover every grouping key in
+        #   order.
+        #
+        #   @return [Array<String>, nil]
+        optional :group_keys, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(group_values:, thresholds:, group_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::AlertUpdateParams::ThresholdOverride} for more details.
         #
@@ -137,6 +146,8 @@ module Orb
         #   @param group_values [Array<String>] The values of the grouping keys that identify this group. The list length must m
         #
         #   @param thresholds [Array<Orb::Models::Threshold>] The thresholds to apply to this group. An empty list silences alerts for this gr
+        #
+        #   @param group_keys [Array<String>, nil] The subset of the alert's grouping_keys that this override binds. Any grouping k
       end
     end
   end

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "1.28.1"
+  VERSION = "1.29.0"
 end

data/rbi/orb/models/alert.rbi

@@ -442,8 +442,8 @@ module Orb
             T.any(Orb::Alert::ThresholdOverride, Orb::Internal::AnyHash)
           end
 
-        # The values of the grouping keys that identify this group. The list length
-        # matches the alert's grouping_keys.
+        # The values identifying this group, ordered to match group_keys when set and the
+        # alert's grouping_keys otherwise.
         sig { returns(T::Array[String]) }
         attr_accessor :group_values
 
@@ -451,6 +451,11 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         attr_accessor :thresholds
 
+        # The subset of the alert's grouping_keys this override binds. Null when the
+        # override targets one exact group across every grouping key.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :group_keys
+
         # A per-group threshold override on a grouped cost alert.
         #
         # An empty `thresholds` list means the group is silenced (never fires). A
@@ -458,15 +463,19 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
-          # The values of the grouping keys that identify this group. The list length
-          # matches the alert's grouping_keys.
+          # The values identifying this group, ordered to match group_keys when set and the
+          # alert's grouping_keys otherwise.
           group_values:,
           # The thresholds applied to this group. An empty list means the group is silenced.
-          thresholds:
+          thresholds:,
+          # The subset of the alert's grouping_keys this override binds. Null when the
+          # override targets one exact group across every grouping key.
+          group_keys: nil
         )
         end
 
@@ -474,7 +483,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/rbi/orb/models/alert_create_for_subscription_params.rbi

@@ -334,8 +334,8 @@ module Orb
           end
 
         # The values of the grouping keys that identify this group. The list length must
-        # match the alert's grouping_keys, and values appear in the same order as
-        # grouping_keys.
+        # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        # values in the same order as whichever applies.
         sig { returns(T::Array[String]) }
         attr_accessor :group_values
 
@@ -344,6 +344,13 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         attr_accessor :thresholds
 
+        # The subset of the alert's grouping_keys that this override binds. Any grouping
+        # key not named is unconstrained, so the override applies to every group matching
+        # the named values. When omitted, group_values must cover every grouping key in
+        # order.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :group_keys
+
         # Per-group threshold override on a grouped cost alert.
         #
         # - An empty `thresholds` list silences alerts for this group (never fires).
@@ -351,17 +358,23 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
           # The values of the grouping keys that identify this group. The list length must
-          # match the alert's grouping_keys, and values appear in the same order as
-          # grouping_keys.
+          # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+          # values in the same order as whichever applies.
           group_values:,
           # The thresholds to apply to this group. An empty list silences alerts for this
           # group. A non-empty list fully replaces the default thresholds for this group.
-          thresholds:
+          thresholds:,
+          # The subset of the alert's grouping_keys that this override binds. Any grouping
+          # key not named is unconstrained, so the override applies to every group matching
+          # the named values. When omitted, group_values must cover every grouping key in
+          # order.
+          group_keys: nil
         )
         end
 
@@ -369,7 +382,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/rbi/orb/models/alert_update_params.rbi

@@ -212,8 +212,8 @@ module Orb
           end
 
         # The values of the grouping keys that identify this group. The list length must
-        # match the alert's grouping_keys, and values appear in the same order as
-        # grouping_keys.
+        # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+        # values in the same order as whichever applies.
         sig { returns(T::Array[String]) }
         attr_accessor :group_values
 
@@ -222,6 +222,13 @@ module Orb
         sig { returns(T::Array[Orb::Threshold]) }
         attr_accessor :thresholds
 
+        # The subset of the alert's grouping_keys that this override binds. Any grouping
+        # key not named is unconstrained, so the override applies to every group matching
+        # the named values. When omitted, group_values must cover every grouping key in
+        # order.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_accessor :group_keys
+
         # Per-group threshold override on a grouped cost alert.
         #
         # - An empty `thresholds` list silences alerts for this group (never fires).
@@ -229,17 +236,23 @@ module Orb
         sig do
           params(
             group_values: T::Array[String],
-            thresholds: T::Array[Orb::Threshold::OrHash]
+            thresholds: T::Array[Orb::Threshold::OrHash],
+            group_keys: T.nilable(T::Array[String])
           ).returns(T.attached_class)
         end
         def self.new(
           # The values of the grouping keys that identify this group. The list length must
-          # match the alert's grouping_keys, and values appear in the same order as
-          # grouping_keys.
+          # match group_keys when it is set, and the alert's grouping_keys otherwise, with
+          # values in the same order as whichever applies.
           group_values:,
           # The thresholds to apply to this group. An empty list silences alerts for this
           # group. A non-empty list fully replaces the default thresholds for this group.
-          thresholds:
+          thresholds:,
+          # The subset of the alert's grouping_keys that this override binds. Any grouping
+          # key not named is unconstrained, so the override applies to every group matching
+          # the named values. When omitted, group_values must cover every grouping key in
+          # order.
+          group_keys: nil
         )
         end
 
@@ -247,7 +260,8 @@ module Orb
           override.returns(
             {
               group_values: T::Array[String],
-              thresholds: T::Array[Orb::Threshold]
+              thresholds: T::Array[Orb::Threshold],
+              group_keys: T.nilable(T::Array[String])
             }
           )
         end

data/sig/orb/models/alert.rbs

@@ -227,21 +227,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

data/sig/orb/models/alert_create_for_subscription_params.rbs

@@ -123,21 +123,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

data/sig/orb/models/alert_update_params.rbs

@@ -91,21 +91,29 @@ module Orb
       end
 
       type threshold_override =
-        { group_values: ::Array[String], thresholds: ::Array[Orb::Threshold] }
+        {
+          group_values: ::Array[String],
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
+        }
 
       class ThresholdOverride < Orb::Internal::Type::BaseModel
         attr_accessor group_values: ::Array[String]
 
         attr_accessor thresholds: ::Array[Orb::Threshold]
 
+        attr_accessor group_keys: ::Array[String]?
+
         def initialize: (
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          ?group_keys: ::Array[String]?
         ) -> void
 
         def to_hash: -> {
           group_values: ::Array[String],
-          thresholds: ::Array[Orb::Threshold]
+          thresholds: ::Array[Orb::Threshold],
+          group_keys: ::Array[String]?
         }
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 1.28.1
+  version: 1.29.0
 platform: ruby
 authors:
 - Orb
@@ -1407,7 +1407,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Ruby library to access the Orb API
 test_files: []