volcano-sdk 0.32.6 → 0.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +3 -2
  3. data/lib/volcano/client.rb +3 -2
  4. data/lib/volcano/generated/lib/volcano-generated/api/auth_configuration_api.rb +6 -6
  5. data/lib/volcano/generated/lib/volcano-generated/api/databases_api.rb +4 -4
  6. data/lib/volcano/generated/lib/volcano-generated/api/frontends_api.rb +2 -2
  7. data/lib/volcano/generated/lib/volcano-generated/api/logs_api.rb +6 -6
  8. data/lib/volcano/generated/lib/volcano-generated/api/sandboxes_api.rb +1433 -0
  9. data/lib/volcano/generated/lib/volcano-generated/models/auth_config.rb +1 -1
  10. data/lib/volcano/generated/lib/volcano-generated/models/create_sandbox_session_request.rb +294 -0
  11. data/lib/volcano/generated/lib/volcano-generated/models/create_sandbox_template_request.rb +247 -0
  12. data/lib/volcano/generated/lib/volcano-generated/models/project.rb +3 -3
  13. data/lib/volcano/generated/lib/volcano-generated/models/project_config_auth_signup.rb +1 -1
  14. data/lib/volcano/generated/lib/volcano-generated/models/project_config_custom_domain.rb +1 -1
  15. data/lib/volcano/generated/lib/volcano-generated/models/project_config_email_template.rb +2 -2
  16. data/lib/volcano/generated/lib/volcano-generated/models/project_config_email_templates.rb +1 -1
  17. data/lib/volcano/generated/lib/volcano-generated/models/project_config_hosted_pages.rb +1 -1
  18. data/lib/volcano/generated/lib/volcano-generated/models/project_config_project.rb +1 -1
  19. data/lib/volcano/generated/lib/volcano-generated/models/publish_sandbox_preset_request.rb +268 -0
  20. data/lib/volcano/generated/lib/volcano-generated/models/realtime_plan_limits.rb +1 -1
  21. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_access.rb +216 -0
  22. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_access_request.rb +221 -0
  23. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_capacity.rb +199 -0
  24. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_capacity_list.rb +166 -0
  25. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_command_request.rb +251 -0
  26. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_command_result.rb +294 -0
  27. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_deployment.rb +242 -0
  28. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_deployment_page.rb +192 -0
  29. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_execution_request.rb +329 -0
  30. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_execution_result.rb +381 -0
  31. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_read_request.rb +182 -0
  32. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_result.rb +164 -0
  33. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_write_request.rb +217 -0
  34. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_pagination.rb +199 -0
  35. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_preset.rb +294 -0
  36. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_preset_list.rb +166 -0
  37. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_session.rb +407 -0
  38. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_session_page.rb +192 -0
  39. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_subject_grant_request.rb +164 -0
  40. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_template.rb +321 -0
  41. data/lib/volcano/generated/lib/volcano-generated/models/sandbox_template_page.rb +192 -0
  42. data/lib/volcano/generated/lib/volcano-generated/models/update_auth_config_request.rb +1 -1
  43. data/lib/volcano/generated/lib/volcano-generated/models/update_sandbox_template_request.rb +175 -0
  44. data/lib/volcano/generated/lib/volcano-generated.rb +26 -0
  45. data/lib/volcano/generated_transport.rb +1 -0
  46. data/lib/volcano/generated_transport_sandbox.rb +69 -0
  47. data/lib/volcano/sandbox_files.rb +37 -0
  48. data/lib/volcano/sandbox_models.rb +24 -0
  49. data/lib/volcano/sandbox_request.rb +92 -0
  50. data/lib/volcano/sandbox_response.rb +74 -0
  51. data/lib/volcano/sandbox_session.rb +78 -0
  52. data/lib/volcano/sandboxes.rb +67 -0
  53. data/lib/volcano/version.rb +1 -1
  54. data/lib/volcano.rb +7 -0
  55. data/sig/client.rbs +1 -0
  56. data/sig/sandboxes.rbs +83 -0
  57. metadata +50 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '00829ccc78685de8e0fb7fed50d6db137c861678c872b39a75eaba44e391e723'
4
- data.tar.gz: 7b29d87a5bf1fc3b683620df34d76293c013f7c0dca361107b1045b2b5326cd4
3
+ metadata.gz: 6f70aca387b3651859ed9b1ce7fbc2ff100811d50823a3e3939ae14fdd49d737
4
+ data.tar.gz: 1c30afc50e2d95d0071ae85709631c10e20ef874a2ef62a86fc2665e32c0bf39
5
5
  SHA512:
6
- metadata.gz: 4c8376c90f0720047bc743b650657f7fc73289e103f57ddd7cb17beb3cdd8c085b6562c48b79967f60c789e6ca4ffa87b88a4ae70c1fec064d966d56342f18c1
7
- data.tar.gz: 800f5bcc14498c14f08d3b6d96b1c9387fdf47cd51461749a38868417c1dfbea128c9390b71fcc2423176db287edb3f608afe1085b4b274046338dae17a09bb7
6
+ metadata.gz: 6a4752c01a40435051cc380077c8107e921c2d8990bba76a7c127ab1faa799c0589d80d81fdeabd285ebec9f25e997a44408922c685478de9cd4de4352cc12e1
7
+ data.tar.gz: 037ecea94fbe86893befc7449856ed41d9a63cd6a93a5e348472bcb335b22db849b3498f442bbb68a22d3819374a6ebd50e50911541d00dafe087a2d948146d3
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Volcano Ruby SDK
2
2
 
3
- Official Ruby SDK for Volcano. Requires Ruby 3.2 or later.
3
+ Official Ruby SDK for Volcano. Requires Ruby 3.3 or later.
4
4
 
5
5
  Start with the [Ruby quickstart](https://github.com/Kong/volcano-sdk-ruby/blob/main/docs/README.md).
6
6
 
@@ -881,7 +881,7 @@ delivery.
881
881
 
882
882
  ## Dependencies
883
883
 
884
- Installing `volcano-sdk` pulls in eight gems, plus their own transitive
884
+ Installing `volcano-sdk` pulls in nine gems, plus their own transitive
885
885
  dependencies:
886
886
 
887
887
  | Gem | Why |
@@ -892,6 +892,7 @@ dependencies:
892
892
  | [`async-http`](https://rubygems.org/gems/async-http) | The endpoint realtime dials |
893
893
  | [`async-websocket`](https://rubygems.org/gems/async-websocket) | The realtime transport itself |
894
894
  | [`protocol-rack`](https://rubygems.org/gems/protocol-rack) | A requirement of `async-websocket`, pinned here so the version is ours |
895
+ | [`io-event`](https://rubygems.org/gems/io-event) | The event loop under `async`, with a floor at the release that fixes AIKIDO-2026-10943 |
895
896
  | [`base64`](https://rubygems.org/gems/base64) | Required by the generated client, and no longer a default gem since Ruby 3.4 |
896
897
  | [`json`](https://rubygems.org/gems/json) | Request and response encoding for the generated client |
897
898
 
@@ -16,9 +16,9 @@ module Volcano
16
16
  end
17
17
  private_constant :SessionToken
18
18
 
19
- attr_reader :auth, :functions, :durable, :logs, :storage, :locks, :realtime
19
+ attr_reader :sandboxes, :auth, :functions, :durable, :logs, :storage, :locks, :realtime
20
20
 
21
- # @dynamic auth, functions, durable, logs, storage, locks, realtime
21
+ # @dynamic sandboxes, auth, functions, durable, logs, storage, locks, realtime
22
22
 
23
23
  def initialize( # rubocop:disable Metrics/ParameterLists -- Preserve typed constructor keywords.
24
24
  anon_key:,
@@ -122,6 +122,7 @@ module Volcano
122
122
  @logs = Logs.new(self, @transport)
123
123
  @storage = Storage.new(self, @transport, api_url: @api_url, anon_key: @anon_key)
124
124
  @locks = Locks.new(self, @transport)
125
+ @sandboxes = Sandboxes.new(self, @transport)
125
126
  @realtime = Realtime.new(
126
127
  self,
127
128
  api_url: @api_url,
@@ -88,7 +88,7 @@ module Volcano::Generated
88
88
  end
89
89
 
90
90
  # Create email template
91
- # Creates a custom email template for the project. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403, and FREE projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed
91
+ # Creates a custom email template for the project. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed
92
92
  # @param id [String] Project ID
93
93
  # @param create_email_template_request [CreateEmailTemplateRequest]
94
94
  # @param [Hash] opts the optional parameters
@@ -99,7 +99,7 @@ module Volcano::Generated
99
99
  end
100
100
 
101
101
  # Create email template
102
- # Creates a custom email template for the project. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403, and FREE projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed
102
+ # Creates a custom email template for the project. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403, and HOBBY projects always send the built-in default templates regardless of any previously saved custom rows. Every project is created with one template per type, so customizing one is usually a PUT; creating a type the project already has returns 409. Valid template types: welcome, confirmation, password_reset, password_changed
103
103
  # @param id [String] Project ID
104
104
  # @param create_email_template_request [CreateEmailTemplateRequest]
105
105
  # @param [Hash] opts the optional parameters
@@ -290,7 +290,7 @@ module Volcano::Generated
290
290
  end
291
291
 
292
292
  # Delete email template
293
- # Deletes a custom template, reverting to the default. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403.
293
+ # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403.
294
294
  # @param id [String] Project ID
295
295
  # @param type [String]
296
296
  # @param [Hash] opts the optional parameters
@@ -301,7 +301,7 @@ module Volcano::Generated
301
301
  end
302
302
 
303
303
  # Delete email template
304
- # Deletes a custom template, reverting to the default. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403.
304
+ # Deletes a custom template, reverting to the default. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403.
305
305
  # @param id [String] Project ID
306
306
  # @param type [String]
307
307
  # @param [Hash] opts the optional parameters
@@ -1711,7 +1711,7 @@ module Volcano::Generated
1711
1711
  end
1712
1712
 
1713
1713
  # Update email template
1714
- # Updates a custom email template. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403 (including after a PRO→FREE downgrade), so a FREE project cannot modify templates and always sends the built-in defaults.
1714
+ # Updates a custom email template. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403 (including after a SUPERAGENT→HOBBY downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults.
1715
1715
  # @param id [String] Project ID
1716
1716
  # @param type [String]
1717
1717
  # @param update_email_template_request [UpdateEmailTemplateRequest]
@@ -1723,7 +1723,7 @@ module Volcano::Generated
1723
1723
  end
1724
1724
 
1725
1725
  # Update email template
1726
- # Updates a custom email template. Custom email templates are a PRO-plan feature: requests from a FREE-plan project owner are rejected with 403 (including after a PRO→FREE downgrade), so a FREE project cannot modify templates and always sends the built-in defaults.
1726
+ # Updates a custom email template. Custom email templates are a SUPERAGENT-plan feature: requests from a HOBBY-plan project owner are rejected with 403 (including after a SUPERAGENT→HOBBY downgrade), so a HOBBY project cannot modify templates and always sends the built-in defaults.
1727
1727
  # @param id [String] Project ID
1728
1728
  # @param type [String]
1729
1729
  # @param update_email_template_request [UpdateEmailTemplateRequest]
@@ -20,7 +20,7 @@ module Volcano::Generated
20
20
  @api_client = api_client
21
21
  end
22
22
  # Create a new serverless PostgreSQL database
23
- # Creates a serverless PostgreSQL database in the project. Each project can hold 1 database on Free and up to 10,000 on Pro. Requests over the plan's cap return 403.
23
+ # Creates a serverless PostgreSQL database in the project. Each project can hold 1 database on Hobby and up to 10,000 on Superagent. Requests over the plan's cap return 403.
24
24
  # @param id [String] Project ID
25
25
  # @param create_database_request [CreateDatabaseRequest]
26
26
  # @param [Hash] opts the optional parameters
@@ -31,7 +31,7 @@ module Volcano::Generated
31
31
  end
32
32
 
33
33
  # Create a new serverless PostgreSQL database
34
- # Creates a serverless PostgreSQL database in the project. Each project can hold 1 database on Free and up to 10,000 on Pro. Requests over the plan's cap return 403.
34
+ # Creates a serverless PostgreSQL database in the project. Each project can hold 1 database on Hobby and up to 10,000 on Superagent. Requests over the plan's cap return 403.
35
35
  # @param id [String] Project ID
36
36
  # @param create_database_request [CreateDatabaseRequest]
37
37
  # @param [Hash] opts the optional parameters
@@ -339,7 +339,7 @@ module Volcano::Generated
339
339
  end
340
340
 
341
341
  # Get database queries
342
- # Returns the database's current top queries from pg_stat_statements ranked by total execution time. **PRO plan required.** This endpoint is only available to projects owned by users on the PRO billing plan.
342
+ # Returns the database's current top queries from pg_stat_statements ranked by total execution time. **SUPERAGENT plan required.** This endpoint is only available to projects owned by users on the SUPERAGENT billing plan.
343
343
  # @param id [String] Project ID
344
344
  # @param database_name [String] Database name (unique within project, lowercase letters, numbers, and underscores only)
345
345
  # @param [Hash] opts the optional parameters
@@ -351,7 +351,7 @@ module Volcano::Generated
351
351
  end
352
352
 
353
353
  # Get database queries
354
- # Returns the database's current top queries from pg_stat_statements ranked by total execution time. **PRO plan required.** This endpoint is only available to projects owned by users on the PRO billing plan.
354
+ # Returns the database's current top queries from pg_stat_statements ranked by total execution time. **SUPERAGENT plan required.** This endpoint is only available to projects owned by users on the SUPERAGENT billing plan.
355
355
  # @param id [String] Project ID
356
356
  # @param database_name [String] Database name (unique within project, lowercase letters, numbers, and underscores only)
357
357
  # @param [Hash] opts the optional parameters
@@ -124,7 +124,7 @@ module Volcano::Generated
124
124
  return data, status_code, headers
125
125
  end
126
126
 
127
- # Configure frontend custom domain (PRO)
127
+ # Configure frontend custom domain (SUPERAGENT)
128
128
  # Configures one custom domain for a frontend. The default Volcano-generated frontend URL remains active. Wildcard Volcano frontend TLS remains valid and isolated from custom-domain certificate changes.
129
129
  # @param id [String] Project ID
130
130
  # @param frontend_id [String] Frontend ID
@@ -136,7 +136,7 @@ module Volcano::Generated
136
136
  data
137
137
  end
138
138
 
139
- # Configure frontend custom domain (PRO)
139
+ # Configure frontend custom domain (SUPERAGENT)
140
140
  # Configures one custom domain for a frontend. The default Volcano-generated frontend URL remains active. Wildcard Volcano frontend TLS remains valid and isolated from custom-domain certificate changes.
141
141
  # @param id [String] Project ID
142
142
  # @param frontend_id [String] Frontend ID
@@ -20,7 +20,7 @@ module Volcano::Generated
20
20
  @api_client = api_client
21
21
  end
22
22
  # Get project log activity
23
- # Retrieve bucketed log counts for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to count deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; `resource.type=database` from a FREE-plan project owner returns 403. The activity window is limited to the plan's retention window (FREE: 1 day, PRO: 30 days); older start times are clamped to that window.
23
+ # Retrieve bucketed log counts for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to count deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; `resource.type=database` from a HOBBY-plan project owner returns 403. The activity window is limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days); older start times are clamped to that window.
24
24
  # @param id [String] Project ID
25
25
  # @param log_activity_request [LogActivityRequest]
26
26
  # @param [Hash] opts the optional parameters
@@ -31,7 +31,7 @@ module Volcano::Generated
31
31
  end
32
32
 
33
33
  # Get project log activity
34
- # Retrieve bucketed log counts for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to count deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; `resource.type=database` from a FREE-plan project owner returns 403. The activity window is limited to the plan's retention window (FREE: 1 day, PRO: 30 days); older start times are clamped to that window.
34
+ # Retrieve bucketed log counts for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to count deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; `resource.type=database` from a HOBBY-plan project owner returns 403. The activity window is limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days); older start times are clamped to that window.
35
35
  # @param id [String] Project ID
36
36
  # @param log_activity_request [LogActivityRequest]
37
37
  # @param [Hash] opts the optional parameters
@@ -94,7 +94,7 @@ module Volcano::Generated
94
94
  end
95
95
 
96
96
  # Search project logs
97
- # Search or filter logs for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to read deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; requests for `resource.type=database` from a FREE-plan project owner return 403. Log history (runtime and deployment) is limited to the plan's retention window (FREE: 1 day, PRO: 30 days); older time ranges are clamped to that window.
97
+ # Search or filter logs for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to read deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; requests for `resource.type=database` from a HOBBY-plan project owner return 403. Log history (runtime and deployment) is limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days); older time ranges are clamped to that window.
98
98
  # @param id [String] Project ID
99
99
  # @param log_search_request [LogSearchRequest]
100
100
  # @param [Hash] opts the optional parameters
@@ -105,7 +105,7 @@ module Volcano::Generated
105
105
  end
106
106
 
107
107
  # Search project logs
108
- # Search or filter logs for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to read deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; requests for `resource.type=database` from a FREE-plan project owner return 403. Log history (runtime and deployment) is limited to the plan's retention window (FREE: 1 day, PRO: 30 days); older time ranges are clamped to that window.
108
+ # Search or filter logs for one resource type in the project. Set `resource.type` to `function`, `frontend`, or `database`. Add `resource.ids` to filter to one or more resources, and add `resource.deployments.ids` to read deployment logs instead of runtime logs for functions and frontends. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; requests for `resource.type=database` from a HOBBY-plan project owner return 403. Log history (runtime and deployment) is limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days); older time ranges are clamped to that window.
109
109
  # @param id [String] Project ID
110
110
  # @param log_search_request [LogSearchRequest]
111
111
  # @param [Hash] opts the optional parameters
@@ -168,7 +168,7 @@ module Volcano::Generated
168
168
  end
169
169
 
170
170
  # Stream project logs
171
- # Live-tail project logs as Server-Sent Events. The request body uses the resource selector plus `q`, `start_time`, and `limit`, including runtime logs and function/frontend deployment logs selected with `resource.deployments`. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; `resource.type=database` from a FREE-plan project owner returns 403. The `q` field uses the same syntax as search and activity requests. Do not send `cursor` or `end_time`; use `/logs/search` for range backfills. Explicit historical `start_time` values are limited to the plan's retention window (FREE: 1 day, PRO: 30 days). Resume with `Last-Event-ID` or the `last_event_id` query parameter. The cursor is bound to the request body: the resource selector and every filter must match the original request when reconnecting, otherwise the request is rejected with `400`. This is a live tail, not a gap-free backfill. On connect or reconnect the server delivers at most `limit` of the most recent matching events from the cursor position and then follows new events; events older than that window are not replayed. Use `/logs/search` to backfill a time range.
171
+ # Live-tail project logs as Server-Sent Events. The request body uses the resource selector plus `q`, `start_time`, and `limit`, including runtime logs and function/frontend deployment logs selected with `resource.deployments`. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; `resource.type=database` from a HOBBY-plan project owner returns 403. The `q` field uses the same syntax as search and activity requests. Do not send `cursor` or `end_time`; use `/logs/search` for range backfills. Explicit historical `start_time` values are limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days). Resume with `Last-Event-ID` or the `last_event_id` query parameter. The cursor is bound to the request body: the resource selector and every filter must match the original request when reconnecting, otherwise the request is rejected with `400`. This is a live tail, not a gap-free backfill. On connect or reconnect the server delivers at most `limit` of the most recent matching events from the cursor position and then follows new events; events older than that window are not replayed. Use `/logs/search` to backfill a time range.
172
172
  # @param id [String] Project ID
173
173
  # @param log_stream_request [LogStreamRequest]
174
174
  # @param [Hash] opts the optional parameters
@@ -181,7 +181,7 @@ module Volcano::Generated
181
181
  end
182
182
 
183
183
  # Stream project logs
184
- # Live-tail project logs as Server-Sent Events. The request body uses the resource selector plus `q`, `start_time`, and `limit`, including runtime logs and function/frontend deployment logs selected with `resource.deployments`. Deployment logs are not supported for databases. Database logs are a PRO-plan feature; `resource.type=database` from a FREE-plan project owner returns 403. The `q` field uses the same syntax as search and activity requests. Do not send `cursor` or `end_time`; use `/logs/search` for range backfills. Explicit historical `start_time` values are limited to the plan's retention window (FREE: 1 day, PRO: 30 days). Resume with `Last-Event-ID` or the `last_event_id` query parameter. The cursor is bound to the request body: the resource selector and every filter must match the original request when reconnecting, otherwise the request is rejected with `400`. This is a live tail, not a gap-free backfill. On connect or reconnect the server delivers at most `limit` of the most recent matching events from the cursor position and then follows new events; events older than that window are not replayed. Use `/logs/search` to backfill a time range.
184
+ # Live-tail project logs as Server-Sent Events. The request body uses the resource selector plus `q`, `start_time`, and `limit`, including runtime logs and function/frontend deployment logs selected with `resource.deployments`. Deployment logs are not supported for databases. Database logs are a SUPERAGENT-plan feature; `resource.type=database` from a HOBBY-plan project owner returns 403. The `q` field uses the same syntax as search and activity requests. Do not send `cursor` or `end_time`; use `/logs/search` for range backfills. Explicit historical `start_time` values are limited to the plan's retention window (HOBBY: 1 day, SUPERAGENT: 30 days). Resume with `Last-Event-ID` or the `last_event_id` query parameter. The cursor is bound to the request body: the resource selector and every filter must match the original request when reconnecting, otherwise the request is rejected with `400`. This is a live tail, not a gap-free backfill. On connect or reconnect the server delivers at most `limit` of the most recent matching events from the cursor position and then follows new events; events older than that window are not replayed. Use `/logs/search` to backfill a time range.
185
185
  # @param id [String] Project ID
186
186
  # @param log_stream_request [LogStreamRequest]
187
187
  # @param [Hash] opts the optional parameters