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.
- checksums.yaml +4 -4
- data/README.md +3 -2
- data/lib/volcano/client.rb +3 -2
- data/lib/volcano/generated/lib/volcano-generated/api/auth_configuration_api.rb +6 -6
- data/lib/volcano/generated/lib/volcano-generated/api/databases_api.rb +4 -4
- data/lib/volcano/generated/lib/volcano-generated/api/frontends_api.rb +2 -2
- data/lib/volcano/generated/lib/volcano-generated/api/logs_api.rb +6 -6
- data/lib/volcano/generated/lib/volcano-generated/api/sandboxes_api.rb +1433 -0
- data/lib/volcano/generated/lib/volcano-generated/models/auth_config.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/create_sandbox_session_request.rb +294 -0
- data/lib/volcano/generated/lib/volcano-generated/models/create_sandbox_template_request.rb +247 -0
- data/lib/volcano/generated/lib/volcano-generated/models/project.rb +3 -3
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_auth_signup.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_custom_domain.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_email_template.rb +2 -2
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_email_templates.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_hosted_pages.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/project_config_project.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/publish_sandbox_preset_request.rb +268 -0
- data/lib/volcano/generated/lib/volcano-generated/models/realtime_plan_limits.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_access.rb +216 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_access_request.rb +221 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_capacity.rb +199 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_capacity_list.rb +166 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_command_request.rb +251 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_command_result.rb +294 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_deployment.rb +242 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_deployment_page.rb +192 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_execution_request.rb +329 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_execution_result.rb +381 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_read_request.rb +182 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_result.rb +164 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_file_write_request.rb +217 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_pagination.rb +199 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_preset.rb +294 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_preset_list.rb +166 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_session.rb +407 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_session_page.rb +192 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_subject_grant_request.rb +164 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_template.rb +321 -0
- data/lib/volcano/generated/lib/volcano-generated/models/sandbox_template_page.rb +192 -0
- data/lib/volcano/generated/lib/volcano-generated/models/update_auth_config_request.rb +1 -1
- data/lib/volcano/generated/lib/volcano-generated/models/update_sandbox_template_request.rb +175 -0
- data/lib/volcano/generated/lib/volcano-generated.rb +26 -0
- data/lib/volcano/generated_transport.rb +1 -0
- data/lib/volcano/generated_transport_sandbox.rb +69 -0
- data/lib/volcano/sandbox_files.rb +37 -0
- data/lib/volcano/sandbox_models.rb +24 -0
- data/lib/volcano/sandbox_request.rb +92 -0
- data/lib/volcano/sandbox_response.rb +74 -0
- data/lib/volcano/sandbox_session.rb +78 -0
- data/lib/volcano/sandboxes.rb +67 -0
- data/lib/volcano/version.rb +1 -1
- data/lib/volcano.rb +7 -0
- data/sig/client.rbs +1 -0
- data/sig/sandboxes.rbs +83 -0
- metadata +50 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 6f70aca387b3651859ed9b1ce7fbc2ff100811d50823a3e3939ae14fdd49d737
|
|
4
|
+
data.tar.gz: 1c30afc50e2d95d0071ae85709631c10e20ef874a2ef62a86fc2665e32c0bf39
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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.
|
|
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
|
|
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
|
|
data/lib/volcano/client.rb
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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. **
|
|
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. **
|
|
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 (
|
|
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 (
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|