hetznercloud 3.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79a6b89356738d96488c66c11fe1db0898ec7d49a3e9916860e8b181b0d81ad9
-  data.tar.gz: c8fff383978d3f10d96997a4abe1cd25b03517d9aea0c95b332173cfaa18fe9b
+  metadata.gz: 0e9575422834c710e68322d4d3d9d738521d1a45d8924f90eee7b64da43e47ed
+  data.tar.gz: 4edab154b29f3c5d3a43d55bdf5d9282418d470105d272446283e564b2f3ee12
 SHA512:
-  metadata.gz: 0375abf58d85d71138bfa68aa23e62d15f3e7a1230d7d7c175925f141138e256d6dbb0e4518995130bfab9cc8990ea3362a367d64f416a5d45adbcc0a8459257
-  data.tar.gz: 42aeba6192a1b77f2b7f123256ef6eb331faa28bf0fe28ccd50be4258576cef4408ff572d676342584a41104e5daedb238bf4727df1ab54f64c555e1fc3c0e70
+  metadata.gz: 5009c504916ca8404c11bd855377e101121fd77e7a53517f4f1b740d540ac36815a47b710429520ddb93458db29e43311444655196931f6a88c3c1dd7bd49461
+  data.tar.gz: 8af42a4fe808cd090033913f1bb5b3d73eca8066da3ace50e470df6355a90b93981e7fe6167679f7b877b572fb26c2d7b5772b3ac15bd633f0a844353ab343a8

data/CHANGELOG.md

@@ -1,85 +1,176 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+### Changed
+
+### Removed
+
+### Fixed
+
+## HCloud v4.1.0 (2025-09-02)
+
+### Added
+
+- Add `category` attribute to `ServerType`
+
+### Changed
+
+- Allow certain `create` and `delete` methods to return a `HCloud::Action` instance instead of a resource, as returned by the API (e.g. Storage Box API)
+
+## HCloud v4.0.0 (2025-07-26)
+
+### Added
+
+- Add `LoadBalancerPublicInterfaceDisabled` error class
+- Implement Storage Boxes
+- Implement Storage Box Types
+- Implement Storage Box Subaccounts
+- Implement Storage Box Subaccount actions
+
+### Changed
+
+- Change `HCloud::Collection#where` interface: now accepts a string instead of a hash to allow for more complex queries
+  - For example: `HCloud::Server.where(label_selector: "env=prod,app!=web")`
+- Cache total entries in `HCloud::Collection` when calling #count
+
+### Fixed
+
+- Fix a zero division error in the rate limiter when rate limit headers are not set
+- Fix an error in the error parsing code when the error details are not present
+
 ## HCloud v3.0.0 (2024-11-25)
 
-- Removed `included_traffic` attribute from `ServerType`
-- Removed `traffic` attribute from `Pricing`
+### Removed
+
+- Remove `included_traffic` attribute from `ServerType`
+- Remove `traffic` attribute from `Pricing`
 
 ## HCloud v2.2.1 (2024-08-30)
 
+### Changed
+
 - Add deprecation warning for `Pricing#floating_ip`
 
 ## HCloud v2.2.0 (2024-08-22)
 
+### Added
+
 - Add support for (de-)compression of HTTP requests
 
 ## HCloud v2.1.0 (2024-07-28)
 
+### Added
+
 - Add `included_traffic` attribute to `ServerType#prices` and `LoadBalancerType#prices`
 - Add `price_per_tb_traffic` attribute to `ServerType#prices` and `LoadBalancerType#prices`
+
+### Changed
+
 - Add deprecation warning for `Pricing#traffic`
 - Add deprecation warning for `ServerType#included_traffic`
+
+### Fixed
+
 - Fix crash on prices when using `Pricing` API
 
 ## HCloud v2.0.0 (2024-01-10)
 
+### Removed
+
 - Remove `deprecated` attribute from `ISO`
 
 ## HCloud v1.7.2 (2023-10-16)
 
+### Added
+
 - Add `deprecation` attribute to `ISO`
 
 ## HCloud v1.7.1 (2023-07-25)
 
+### Changed
+
 - Add deprecation warning for `HCloud::Action.all`
 
 ## HCloud v1.7.0 (2023-06-30)
 
+### Added
+
 - Add load balancer actions
 
 ## HCloud v1.6.1 (2023-06-22)
 
+### Added
+
 - Add `expose_routes_to_vswitch` attribute to `Network`
 
 ## HCloud v1.6.0 (2023-06-07)
 
+### Added
+
 - Add `deprecation` attribute to `ServerType`
+
+### Changed
+
 - Parse `private_net` attribute on `Server` as array
 - Parse `public_net.firewalls` attribute on `Server` as array of objects with status (not array of `Firewall`s)
 
 ## HCloud v1.5.4 (2023-05-17)
 
+### Changed
+
 - Allow defining attributes on the fly
 
 ## HCloud v1.5.3 (2023-05-09)
 
+### Added
+
 - Add `included_traffic` attribute to `ServerType`
 
 ## HCloud v1.5.2 (2023-04-22)
 
+### Added
+
 - Add `architecture` attribute to `Image` and `ISO`
 
 ## HCloud v1.5.1 (2023-04-20)
 
+### Added
+
 - Add `Unavailable` error class
 - Add `architecture` attribute to `ServerType`
 
 ## HCloud v1.5.0 (2023-02-01)
 
+### Added
+
 - Add pricing for Primary IPs
 - Add server Metadata resource
 - Add support for rate limits
-- `Action#resources` now returns a list of resources instead of a list of hashes
-- Separate server protection entity from other protection entity (only server protection includes `rebuild`)
 - Add shorthand methods for `.first`, `.last`, `.count`, `.where`, `.sort`, `.each`, and `.empty?` on resource
 - Add `label_selector:` argument to `HCloud::Collection`
 
+### Changed
+
+- `Action#resources` now returns a list of resources instead of a list of hashes
+- Separate server protection entity from other protection entity (only server protection includes `rebuild`)
+
 ## HCloud v1.4.0 (2023-01-22)
 
+### Added
+
 - Implemented Primary IPs
 - Implemented Primary IP Actions
-- Allow calling `#update` with additional attributes to be updated
+
+### Changed
+
 - Return the resource when calling `#create`, `#update` or `#delete`
+
+### Fixed
+
+- Allow calling `#update` with additional attributes to be updated
 - Add additional primary IP mismatch errors:
   - `PrimaryIPAssigned`
   - `PrimaryIPDatacenterMismatch`
@@ -87,15 +178,21 @@
 
 ## HCloud v1.3.1 (2022-02-06)
 
-- Add missing `Server#user_data`
+### Added
+
+- Add `user_data` attribute to `Server`
 
 ## HCloud v1.3.0 (2022-02-04)
 
+### Added
+
 - Implemented Load Balancers
 - Implemented Load Balancer Types
 
 ## HCloud v1.2.0 (2022-02-01)
 
+### Added
+
 - Implemented Networks
 - Implemented Network Actions
 - Implemented Pricing
@@ -104,6 +201,8 @@
 
 ## HCloud v1.1.0 (2022-01-30)
 
+### Added
+
 - Implemented Firewall Actions
 
 ## HCloud v1.0.0 (2022-01-16)

data/README.md

@@ -69,36 +69,42 @@ It expects you to use it in a sane way.
 
 The following table lists the Hetzner Cloud API endpoints that are currently implemented.
 
-| Resource                                                       | State                 |
-|----------------------------------------------------------------|-----------------------|
-| [Actions](lib/hcloud/resources/action.rb)                      | Implemented           |
-| [Certificates](lib/hcloud/resources/certificate.rb)            | Implemented           |
-| [Certificate Actions](lib/hcloud/resources/certificate.rb)     | Implemented           |
-| [Datacenters](lib/hcloud/resources/datacenter.rb)              | Implemented           |
-| [Firewalls](lib/hcloud/resources/firewall.rb)                  | Implemented           |
-| [Firewall Actions](lib/hcloud/resources/firewall.rb)           | Implemented           |
-| [Floating IPs](lib/hcloud/resources/floating_ip.rb)            | Implemented           |
-| [Floating IP Actions](lib/hcloud/resources/floating_ip.rb)     | Implemented           |
-| [Images](lib/hcloud/resources/image.rb)                        | Implemented           |
-| [Image Actions](lib/hcloud/resources/image.rb)                 | Implemented           |
-| [ISOs](lib/hcloud/resources/iso.rb)                            | Implemented           |
-| [Load Balancers](lib/hcloud/resources/load_balancer.rb)        | Implemented           |
-| [Load Balancer Actions](lib/hcloud/resources/load_balancer.rb) | Implemented           |
-| [Load Balancer Types](lib/hcloud/resources/load_balancer.rb)   | Implemented           |
-| [Locations](lib/hcloud/resources/location.rb)                  | Implemented           |
-| [Primary IPs](lib/hcloud/resources/primary_ip.rb)              | Implemented           |
-| [Primary IP Actions](lib/hcloud/resources/primary_ip.rb)       | Implemented           |
-| [Networks](lib/hcloud/resources/network.rb)                    | Implemented           |
-| [Network Actions](lib/hcloud/resources/network.rb)             | Implemented           |
-| [Placement Groups](lib/hcloud/resources/placement_group.rb)    | Implemented           |
-| [Pricing](lib/hcloud/resources/pricing.rb)                     | Implemented           |
-| [Servers](lib/hcloud/resources/server.rb)                      | Partially implemented |
-| [Server Actions](lib/hcloud/resources/server.rb)               | Not implemented       |
-| [Server Types](lib/hcloud/resources/server_type.rb)            | Implemented           |
-| [SSH Keys](lib/hcloud/resources/ssh_key.rb)                    | Implemented           |
-| [Volumes](lib/hcloud/resources/volume.rb)                      | Implemented           |
-| [Volume Actions](lib/hcloud/resources/volume.rb)               | Implemented           |
-| [Metadata](lib/hcloud/resources/metadata.rb)                   | Implemented           |
+| Resource                                                                         | State                 |
+|----------------------------------------------------------------------------------|-----------------------|
+| [Actions](lib/hcloud/resources/action.rb)                                        | Implemented           |
+| [Certificates](lib/hcloud/resources/certificate.rb)                              | Implemented           |
+| [Certificate Actions](lib/hcloud/resources/certificate.rb)                       | Implemented           |
+| [Datacenters](lib/hcloud/resources/datacenter.rb)                                | Implemented           |
+| [Firewalls](lib/hcloud/resources/firewall.rb)                                    | Implemented           |
+| [Firewall Actions](lib/hcloud/resources/firewall.rb)                             | Implemented           |
+| [Floating IPs](lib/hcloud/resources/floating_ip.rb)                              | Implemented           |
+| [Floating IP Actions](lib/hcloud/resources/floating_ip.rb)                       | Implemented           |
+| [Images](lib/hcloud/resources/image.rb)                                          | Implemented           |
+| [Image Actions](lib/hcloud/resources/image.rb)                                   | Implemented           |
+| [ISOs](lib/hcloud/resources/iso.rb)                                              | Implemented           |
+| [Load Balancers](lib/hcloud/resources/load_balancer.rb)                          | Implemented           |
+| [Load Balancer Actions](lib/hcloud/resources/load_balancer.rb)                   | Implemented           |
+| [Load Balancer Types](lib/hcloud/resources/load_balancer.rb)                     | Implemented           |
+| [Locations](lib/hcloud/resources/location.rb)                                    | Implemented           |
+| [Primary IPs](lib/hcloud/resources/primary_ip.rb)                                | Implemented           |
+| [Primary IP Actions](lib/hcloud/resources/primary_ip.rb)                         | Implemented           |
+| [Networks](lib/hcloud/resources/network.rb)                                      | Implemented           |
+| [Network Actions](lib/hcloud/resources/network.rb)                               | Implemented           |
+| [Placement Groups](lib/hcloud/resources/placement_group.rb)                      | Implemented           |
+| [Pricing](lib/hcloud/resources/pricing.rb)                                       | Implemented           |
+| [Servers](lib/hcloud/resources/server.rb)                                        | Partially implemented |
+| [Server Actions](lib/hcloud/resources/server.rb)                                 | Not implemented       |
+| [Server Types](lib/hcloud/resources/server_type.rb)                              | Implemented           |
+| [SSH Keys](lib/hcloud/resources/ssh_key.rb)                                      | Implemented           |
+| [Storage Boxes](lib/hcloud/resources/storage_box.rb)                             | Implemented           |
+| [Storage Box Actions](lib/hcloud/resources/storage_box.rb)                       | Implemented           |
+| [Storage Box Types](lib/hcloud/resources/storage_box_type.rb)                    | Implemented           |
+| [Storage Box Subaccount](lib/hcloud/resources/storage_box_subaccount.rb)         | Implemented           |
+| [Storage Box Subaccount Actions](lib/hcloud/resources/storage_box_subaccount.rb) | Implemented           |
+| [Storage Box Snapshot](lib/hcloud/resources/storage_box_snapshot.rb)             | Implemented           |
+| [Volumes](lib/hcloud/resources/volume.rb)                                        | Implemented           |
+| [Volume Actions](lib/hcloud/resources/volume.rb)                                 | Implemented           |
+| [Metadata](lib/hcloud/resources/metadata.rb)                                     | Implemented           |
 
 ### Pagination
 
@@ -159,6 +165,13 @@ To use Brotli compression, you need to install the `brotli` gem (at least versio
 gem "brotli"
 ```
 
+## Storage boxes
+
+Please note that storage boxes require a different API endpoint.
+The endpoint for **storage boxes** is `https://api.hetzner.com/v1`.
+The endpoint for **all other resources** is `https://api.hetzner.cloud/v1`.
+The storage box endpoint is passed as an extra argument to the `HCloud::Client`, see [Endpoint](#endpoint) for more information.
+
 ## Testing
 
 ```ssh
@@ -186,10 +199,14 @@ When executing the test suite, set `LOG_LEVEL` environment variable to `debug` i
 
 ### Endpoint
 
-`HCloud::Client` also accepts an alternate endpoint:
+`HCloud::Client` also accepts alternate endpoints:
 
 ```ruby
-client = HCloud::Client.new(access_token: "my_access_token", endpoint: "https://myproxy/v1")
+client = HCloud::Client.new(
+  endpoint: "https://myproxy/v1",
+  storage_box_endpoint: "https://myproxy/storage-box/v1",
+  access_token: "my_access_token",
+)
 ```
 
 ## Releasing

data/lib/hcloud/action_collection.rb

@@ -14,7 +14,7 @@ module HCloud
     def find(id)
       Action.new resource
         .client
-        .get("/#{resource.resource_name.pluralize}/#{resource.id}/actions/#{id}")
+        .get("#{resource.resource_path}/#{resource.id}/actions/#{id}")
         .fetch(:action)
     end
 
@@ -23,7 +23,7 @@ module HCloud
     def all(params)
       response = resource
         .client
-        .get("/#{resource.resource_name.pluralize}/#{resource.id}/actions", params)
+        .get("#{resource.resource_path}/#{resource.id}/actions", params)
 
       data = response
         .fetch(:actions)

data/lib/hcloud/client.rb

@@ -21,17 +21,43 @@ module HCloud
 
     self.connection = NilConnection.new
 
-    attr_reader :access_token, :endpoint, :logger, :rate_limit, :timeout, :compression
+    attr_reader :access_token,
+                :endpoint,
+                :storage_box_endpoint,
+                :logger,
+                :rate_limit,
+                :timeout,
+                :compression
 
-    def initialize(access_token:, endpoint: "https://api.hetzner.cloud/v1", logger: Logger.new("/dev/null"), rate_limit: false, timeout: 10, compression: nil)
+    def initialize(
+      access_token:,
+      endpoint: "https://api.hetzner.cloud/v1",
+      storage_box_endpoint: "https://api.hetzner.com/v1",
+      logger: Logger.new(File::NULL),
+      rate_limit: false,
+      timeout: 10,
+      compression: nil
+    )
       @access_token = access_token
       @endpoint = endpoint
+      @storage_box_endpoint = storage_box_endpoint
       @logger = logger
       @rate_limit = rate_limit
       @timeout = timeout
       @compression = compression
     end
 
+    def storage_box_client
+      @storage_box_client ||= HCloud::Client.new(
+        access_token: access_token,
+        endpoint: storage_box_endpoint,
+        logger: logger,
+        rate_limit: rate_limit,
+        timeout: timeout,
+        compression: compression,
+      )
+    end
+
     delegate :get, :put, :post, :delete, to: :http
 
     private

data/lib/hcloud/collection.rb

@@ -56,13 +56,21 @@ module HCloud
 
     def count
       # Fetch total_entries if not present
-      @count ||= total_entries || proc.call(params.merge(page: 1)).last.dig(:pagination, :total_entries)
+      @count ||= @total_entries ||= proc.call(params.merge(page: 1)).last.dig(:pagination, :total_entries) # rubocop:disable Naming/MemoizedInstanceVariableName
     end
 
     def empty?
       count.zero?
     end
 
+    def inspect
+      filters = filter_by.any? ? "filters: (#{filter_by.map { |k, v| "#{k} = #{v.inspect}" }.join(', ')})" : nil
+      sort = sort_by ? "sort: (#{sort_by.join(', ')})" : nil
+      label_selector = label_selector ? "labels_selector: (#{label_selector})" : nil
+
+      "#<#{self.class}#{[filters, sort, label_selector].compact.join(', ').presence&.prepend(' ')} page: #{page}, per_page: #{per_page}, total_entries: #{total_entries.inspect}>"
+    end
+
     delegate :[], :last, to: :to_a
 
     private
@@ -72,7 +80,7 @@ module HCloud
         page: page,
         per_page: per_page,
         sort: sort_by,
-        label_selector: label_selector&.map { |k, v| "#{k}=#{v}" }&.join(","),
+        label_selector: label_selector,
         **filter_by,
       }
     end

data/lib/hcloud/concerns/actionable.rb

@@ -23,7 +23,7 @@ module HCloud
           raise Errors::MissingIDError unless id
 
           response = client
-            .post("/#{resource_name.pluralize}/#{id}/actions/#{name}", params)
+            .post("#{resource_path}/#{id}/actions/#{name}", params)
 
           if response.key?(:actions)
             response[:actions].map { |r| Action.new r }

data/lib/hcloud/concerns/creatable.rb

@@ -5,16 +5,31 @@ module HCloud
   module Creatable
     extend ActiveSupport::Concern
 
-    included do
+    included do # rubocop:disable Metrics/BlockLength
       attribute :created, :datetime
 
       def create
-        assign_attributes client
-          .post("/#{resource_name.pluralize}", creatable_params)
-          .tap { |r| r[resource_name.to_sym].merge!(r.slice(:root_password)) }
-          .fetch(resource_name.to_sym)
+        response = client
+          .post(resource_path, creatable_params)
 
-        self
+        # Some resources return an action instead of the resource itself (e.g. Storage Box API)
+        if response.key?(:action)
+          # Set the ID from the action response
+          self.id = response
+            .dig(:action, :resources)
+            .find { |r| r[:type] == [resource_class&.resource_name, resource_name].compact.join("_") }
+            .fetch(:id)
+
+          # Return an Action instance
+          Action.new response[:action]
+        else
+          # Set the attributes from the response
+          assign_attributes response[resource_name.to_sym]
+            .merge!(response.slice(:root_password))
+
+          # Return the resource instance
+          self
+        end
       end
 
       def created?

data/lib/hcloud/concerns/deletable.rb

@@ -9,12 +9,17 @@ module HCloud
       def delete
         raise Errors::MissingIDError unless id
 
-        client
-          .delete("/#{resource_name.pluralize}/#{id}")
+        response = client
+          .delete("#{resource_path}/#{id}")
 
         @deleted = true
 
-        self
+        # Return the resource instance
+        return self unless response.is_a?(Hash) && response.key?(:action)
+
+        # Some resources return an action instead of the resource itself (e.g. Storage Box API)
+        # Return an Action instance
+        Action.new response[:action]
       end
 
       def deleted?

data/lib/hcloud/concerns/meterable.rb

@@ -10,7 +10,7 @@ module HCloud
         raise Errors::MissingIDError unless id
 
         Metrics.new client
-          .get("/#{resource_name.pluralize}/#{id}/metrics", type: Array(type).join(","), start: from.iso8601, end: to.iso8601, step: step)
+          .get("#{resource_path}/#{id}/metrics", type: Array(type).join(","), start: from.iso8601, end: to.iso8601, step: step)
           .fetch(:metrics)
       end
     end

data/lib/hcloud/concerns/queryable.rb

@@ -10,7 +10,7 @@ module HCloud
         raise Errors::MissingIDError unless id
 
         assign_attributes client
-          .get("/#{resource_name.pluralize}/#{id}")
+          .get("#{resource_path}/#{id}")
           .fetch(resource_name.to_sym)
 
         self
@@ -24,14 +24,14 @@ module HCloud
         raise Errors::MissingIDError unless id
 
         new client
-          .get("/#{resource_name.pluralize}/#{id}")
+          .get("#{resource_path}/#{id}")
           .fetch(resource_name.to_sym)
       end
 
       def all
         Collection.new do |params|
           response = client
-            .get("/#{resource_name.pluralize}", params)
+            .get(resource_path, params)
 
           data = response
             .fetch(resource_name.pluralize.to_sym)

data/lib/hcloud/concerns/subresource.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module HCloud
+  # @!visibility private
+  module Subresource
+    extend ActiveSupport::Concern
+
+    included do
+      # For super resources
+      class_attribute :subresource_names
+
+      self.subresource_names = []
+
+      # For subresources
+      class_attribute :resource_class
+    end
+
+    class_methods do
+      def inherited(subclass)
+        super
+
+        subclass.subresource_names = subresource_names.dup
+      end
+
+      # For super resources
+      def subresource(name, type = name)
+        subresource_names << name.to_s.pluralize
+
+        define_method(name.to_s.pluralize) do
+          raise Errors::MissingIDError unless id
+
+          SubCollection.new(name, type, self)
+        end
+      end
+
+      # For subresources
+      def subresource_of(name, type = name)
+        self.resource_class = ActiveModel::Type
+          .lookup(type)
+          .resource_class
+
+        attribute name, :integer
+
+        # TODO: override that returns the resource class instance instead of the ID?
+      end
+
+      def resource_path
+        "/#{resource_name.pluralize}"
+      end
+    end
+
+    def resource_path
+      if resource_class && (id = send(resource_class.resource_name)).present?
+        # Nested resources (e.g. /storage_boxes/123/subaccounts)
+        "/#{resource_class.resource_name.pluralize}/#{id}/#{resource_name.pluralize}"
+      else
+        # Top-level resources (e.g. /servers)
+        "/#{resource_name.pluralize}"
+      end
+    end
+  end
+end

data/lib/hcloud/concerns/updatable.rb

@@ -12,7 +12,7 @@ module HCloud
         assign_attributes attributes
 
         assign_attributes client
-          .put("/#{resource_name.pluralize}/#{id}", updatable_params)
+          .put("#{resource_path}/#{id}", updatable_params)
           .fetch(resource_name.to_sym)
 
         self

data/lib/hcloud/entities/storage_box_access_settings.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module HCloud
+  class StorageBoxAccessSettings < Entity
+    attribute :reachable_externally, :boolean
+    attribute :samba_enabled, :boolean
+    attribute :ssh_enabled, :boolean
+    attribute :webdav_enabled, :boolean
+    attribute :zfs_enabled, :boolean
+
+    alias reachable_externally? reachable_externally
+    alias samba_enabled? samba_enabled
+    alias ssh_enabled? ssh_enabled
+    alias webdav_enabled? webdav_enabled
+    alias zfs_enabled? zfs_enabled
+  end
+end

data/lib/hcloud/entities/storage_box_price.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HCloud
+  class StorageBoxPrice < Entity
+    attribute :location
+    attribute :price_hourly, :amount
+    attribute :price_monthly, :amount
+    attribute :setup_fee, :amount
+  end
+end

data/lib/hcloud/entities/storage_box_snapshot_plan.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HCloud
+  class StorageBoxSnapshotPlan < Entity
+    attribute :max_snapshots, :integer
+    attribute :minute, :integer
+    attribute :hour, :integer
+    attribute :day_of_week, :integer
+    attribute :day_of_month, :integer
+  end
+end

data/lib/hcloud/entities/storage_box_snapshot_stats.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class StorageBoxSnapshotStats < Entity
+    attribute :size, :integer
+    attribute :size_filesystem, :integer
+  end
+end

data/lib/hcloud/entities/storage_box_stats.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HCloud
+  class StorageBoxStats < Entity
+    attribute :size, :integer
+    attribute :size_data, :integer
+    attribute :size_snapshots, :integer
+  end
+end