google-cloud-logging-v2 0.1.1 → 0.3.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/google/cloud/logging/v2.rb +3 -0
- data/lib/google/cloud/logging/v2/config_service/client.rb +677 -12
- data/lib/google/cloud/logging/v2/config_service/paths.rb +81 -0
- data/lib/google/cloud/logging/v2/logging_service/client.rb +93 -8
- data/lib/google/cloud/logging/v2/metrics_service/client.rb +6 -6
- data/lib/google/cloud/logging/v2/version.rb +1 -1
- data/lib/google/logging/v2/logging_config_pb.rb +55 -0
- data/lib/google/logging/v2/logging_config_services_pb.rb +40 -18
- data/lib/google/logging/v2/logging_metrics_services_pb.rb +5 -5
- data/lib/google/logging/v2/logging_pb.rb +23 -0
- data/lib/google/logging/v2/logging_services_pb.rb +8 -5
- data/proto_docs/google/api/resource.rb +50 -14
- data/proto_docs/google/logging/type/http_request.rb +4 -2
- data/proto_docs/google/logging/v2/logging.rb +99 -0
- data/proto_docs/google/logging/v2/logging_config.rb +215 -8
- data/proto_docs/google/logging/v2/logging_metrics.rb +2 -2
- metadata +3 -3
@@ -34,15 +34,15 @@ module Google
|
|
34
34
|
self.service_name = 'google.logging.v2.MetricsServiceV2'
|
35
35
|
|
36
36
|
# Lists logs-based metrics.
|
37
|
-
rpc :ListLogMetrics, Google::Cloud::Logging::V2::ListLogMetricsRequest, Google::Cloud::Logging::V2::ListLogMetricsResponse
|
37
|
+
rpc :ListLogMetrics, ::Google::Cloud::Logging::V2::ListLogMetricsRequest, ::Google::Cloud::Logging::V2::ListLogMetricsResponse
|
38
38
|
# Gets a logs-based metric.
|
39
|
-
rpc :GetLogMetric, Google::Cloud::Logging::V2::GetLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
39
|
+
rpc :GetLogMetric, ::Google::Cloud::Logging::V2::GetLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
40
40
|
# Creates a logs-based metric.
|
41
|
-
rpc :CreateLogMetric, Google::Cloud::Logging::V2::CreateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
41
|
+
rpc :CreateLogMetric, ::Google::Cloud::Logging::V2::CreateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
42
42
|
# Creates or updates a logs-based metric.
|
43
|
-
rpc :UpdateLogMetric, Google::Cloud::Logging::V2::UpdateLogMetricRequest, Google::Cloud::Logging::V2::LogMetric
|
43
|
+
rpc :UpdateLogMetric, ::Google::Cloud::Logging::V2::UpdateLogMetricRequest, ::Google::Cloud::Logging::V2::LogMetric
|
44
44
|
# Deletes a logs-based metric.
|
45
|
-
rpc :DeleteLogMetric, Google::Cloud::Logging::V2::DeleteLogMetricRequest, Google::Protobuf::Empty
|
45
|
+
rpc :DeleteLogMetric, ::Google::Cloud::Logging::V2::DeleteLogMetricRequest, ::Google::Protobuf::Empty
|
46
46
|
end
|
47
47
|
|
48
48
|
Stub = Service.rpc_stub_class
|
@@ -56,11 +56,30 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
56
56
|
optional :parent, :string, 1
|
57
57
|
optional :page_size, :int32, 2
|
58
58
|
optional :page_token, :string, 3
|
59
|
+
repeated :resource_names, :string, 8
|
59
60
|
end
|
60
61
|
add_message "google.logging.v2.ListLogsResponse" do
|
61
62
|
repeated :log_names, :string, 3
|
62
63
|
optional :next_page_token, :string, 2
|
63
64
|
end
|
65
|
+
add_message "google.logging.v2.TailLogEntriesRequest" do
|
66
|
+
repeated :resource_names, :string, 1
|
67
|
+
optional :filter, :string, 2
|
68
|
+
optional :buffer_window, :message, 3, "google.protobuf.Duration"
|
69
|
+
end
|
70
|
+
add_message "google.logging.v2.TailLogEntriesResponse" do
|
71
|
+
repeated :entries, :message, 1, "google.logging.v2.LogEntry"
|
72
|
+
repeated :suppression_info, :message, 2, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo"
|
73
|
+
end
|
74
|
+
add_message "google.logging.v2.TailLogEntriesResponse.SuppressionInfo" do
|
75
|
+
optional :reason, :enum, 1, "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason"
|
76
|
+
optional :suppressed_count, :int32, 2
|
77
|
+
end
|
78
|
+
add_enum "google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason" do
|
79
|
+
value :REASON_UNSPECIFIED, 0
|
80
|
+
value :RATE_LIMIT, 1
|
81
|
+
value :NOT_CONSUMED, 2
|
82
|
+
end
|
64
83
|
end
|
65
84
|
end
|
66
85
|
|
@@ -78,6 +97,10 @@ module Google
|
|
78
97
|
ListMonitoredResourceDescriptorsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListMonitoredResourceDescriptorsResponse").msgclass
|
79
98
|
ListLogsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsRequest").msgclass
|
80
99
|
ListLogsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLogsResponse").msgclass
|
100
|
+
TailLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesRequest").msgclass
|
101
|
+
TailLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse").msgclass
|
102
|
+
TailLogEntriesResponse::SuppressionInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo").msgclass
|
103
|
+
TailLogEntriesResponse::SuppressionInfo::Reason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.TailLogEntriesResponse.SuppressionInfo.Reason").enummodule
|
81
104
|
end
|
82
105
|
end
|
83
106
|
end
|
@@ -37,7 +37,7 @@ module Google
|
|
37
37
|
# entries. Log entries written shortly before the delete operation might not
|
38
38
|
# be deleted. Entries received after the delete operation with a timestamp
|
39
39
|
# before the operation will be deleted.
|
40
|
-
rpc :DeleteLog, Google::Cloud::Logging::V2::DeleteLogRequest, Google::Protobuf::Empty
|
40
|
+
rpc :DeleteLog, ::Google::Cloud::Logging::V2::DeleteLogRequest, ::Google::Protobuf::Empty
|
41
41
|
# Writes log entries to Logging. This API method is the
|
42
42
|
# only way to send log entries to Logging. This method
|
43
43
|
# is used, directly or indirectly, by the Logging agent
|
@@ -45,17 +45,20 @@ module Google
|
|
45
45
|
# A single request may contain log entries for a maximum of 1000
|
46
46
|
# different resources (projects, organizations, billing accounts or
|
47
47
|
# folders)
|
48
|
-
rpc :WriteLogEntries, Google::Cloud::Logging::V2::WriteLogEntriesRequest, Google::Cloud::Logging::V2::WriteLogEntriesResponse
|
48
|
+
rpc :WriteLogEntries, ::Google::Cloud::Logging::V2::WriteLogEntriesRequest, ::Google::Cloud::Logging::V2::WriteLogEntriesResponse
|
49
49
|
# Lists log entries. Use this method to retrieve log entries that originated
|
50
50
|
# from a project/folder/organization/billing account. For ways to export log
|
51
51
|
# entries, see [Exporting
|
52
52
|
# Logs](https://cloud.google.com/logging/docs/export).
|
53
|
-
rpc :ListLogEntries, Google::Cloud::Logging::V2::ListLogEntriesRequest, Google::Cloud::Logging::V2::ListLogEntriesResponse
|
53
|
+
rpc :ListLogEntries, ::Google::Cloud::Logging::V2::ListLogEntriesRequest, ::Google::Cloud::Logging::V2::ListLogEntriesResponse
|
54
54
|
# Lists the descriptors for monitored resource types used by Logging.
|
55
|
-
rpc :ListMonitoredResourceDescriptors, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
|
55
|
+
rpc :ListMonitoredResourceDescriptors, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsRequest, ::Google::Cloud::Logging::V2::ListMonitoredResourceDescriptorsResponse
|
56
56
|
# Lists the logs in projects, organizations, folders, or billing accounts.
|
57
57
|
# Only logs that have entries are listed.
|
58
|
-
rpc :ListLogs, Google::Cloud::Logging::V2::ListLogsRequest, Google::Cloud::Logging::V2::ListLogsResponse
|
58
|
+
rpc :ListLogs, ::Google::Cloud::Logging::V2::ListLogsRequest, ::Google::Cloud::Logging::V2::ListLogsResponse
|
59
|
+
# Streaming read of log entries as they are ingested. Until the stream is
|
60
|
+
# terminated, it will continue reading logs.
|
61
|
+
rpc :TailLogEntries, stream(::Google::Cloud::Logging::V2::TailLogEntriesRequest), stream(::Google::Cloud::Logging::V2::TailLogEntriesResponse)
|
59
62
|
end
|
60
63
|
|
61
64
|
Stub = Service.rpc_stub_class
|
@@ -43,12 +43,12 @@ module Google
|
|
43
43
|
#
|
44
44
|
# The ResourceDescriptor Yaml config will look like:
|
45
45
|
#
|
46
|
-
#
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
#
|
51
|
-
#
|
46
|
+
# resources:
|
47
|
+
# - type: "pubsub.googleapis.com/Topic"
|
48
|
+
# name_descriptor:
|
49
|
+
# - pattern: "projects/{project}/topics/{topic}"
|
50
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
51
|
+
# parent_name_extractor: "projects/{project}"
|
52
52
|
#
|
53
53
|
# Sometimes, resources have multiple patterns, typically because they can
|
54
54
|
# live under multiple parents.
|
@@ -183,15 +183,24 @@ module Google
|
|
183
183
|
# }
|
184
184
|
# @!attribute [rw] plural
|
185
185
|
# @return [::String]
|
186
|
-
# The plural name used in the resource name, such as
|
187
|
-
# the name of 'projects/\\{project}'
|
188
|
-
#
|
186
|
+
# The plural name used in the resource name and permission names, such as
|
187
|
+
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
188
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
|
189
|
+
# concept of the `plural` field in k8s CRD spec
|
189
190
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
191
|
+
#
|
192
|
+
# Note: The plural form is required even for singleton resources. See
|
193
|
+
# https://aip.dev/156
|
190
194
|
# @!attribute [rw] singular
|
191
195
|
# @return [::String]
|
192
196
|
# The same concept of the `singular` field in k8s CRD spec
|
193
197
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
194
198
|
# Such as "project" for the `resourcemanager.googleapis.com/Project` type.
|
199
|
+
# @!attribute [rw] style
|
200
|
+
# @return [::Array<::Google::Api::ResourceDescriptor::Style>]
|
201
|
+
# Style flag(s) for this resource.
|
202
|
+
# These indicate that a resource is expected to conform to a given
|
203
|
+
# style. See the specific style flags for additional information.
|
195
204
|
class ResourceDescriptor
|
196
205
|
include ::Google::Protobuf::MessageExts
|
197
206
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -211,6 +220,22 @@ module Google
|
|
211
220
|
# that from being necessary once there are multiple patterns.)
|
212
221
|
FUTURE_MULTI_PATTERN = 2
|
213
222
|
end
|
223
|
+
|
224
|
+
# A flag representing a specific style that a resource claims to conform to.
|
225
|
+
module Style
|
226
|
+
# The unspecified value. Do not use.
|
227
|
+
STYLE_UNSPECIFIED = 0
|
228
|
+
|
229
|
+
# This resource is intended to be "declarative-friendly".
|
230
|
+
#
|
231
|
+
# Declarative-friendly resources must be more strictly consistent, and
|
232
|
+
# setting this to true communicates to tools that this resource should
|
233
|
+
# adhere to declarative-friendly expectations.
|
234
|
+
#
|
235
|
+
# Note: This is used by the API linter (linter.aip.dev) to enable
|
236
|
+
# additional checks.
|
237
|
+
DECLARATIVE_FRIENDLY = 1
|
238
|
+
end
|
214
239
|
end
|
215
240
|
|
216
241
|
# Defines a proto annotation that describes a string field that refers to
|
@@ -226,6 +251,17 @@ module Google
|
|
226
251
|
# type: "pubsub.googleapis.com/Topic"
|
227
252
|
# }];
|
228
253
|
# }
|
254
|
+
#
|
255
|
+
# Occasionally, a field may reference an arbitrary resource. In this case,
|
256
|
+
# APIs use the special value * in their resource reference.
|
257
|
+
#
|
258
|
+
# Example:
|
259
|
+
#
|
260
|
+
# message GetIamPolicyRequest {
|
261
|
+
# string resource = 2 [(google.api.resource_reference) = {
|
262
|
+
# type: "*"
|
263
|
+
# }];
|
264
|
+
# }
|
229
265
|
# @!attribute [rw] child_type
|
230
266
|
# @return [::String]
|
231
267
|
# The resource type of a child collection that the annotated field
|
@@ -234,11 +270,11 @@ module Google
|
|
234
270
|
#
|
235
271
|
# Example:
|
236
272
|
#
|
237
|
-
#
|
238
|
-
#
|
239
|
-
#
|
240
|
-
#
|
241
|
-
#
|
273
|
+
# message ListLogEntriesRequest {
|
274
|
+
# string parent = 1 [(google.api.resource_reference) = {
|
275
|
+
# child_type: "logging.googleapis.com/LogEntry"
|
276
|
+
# };
|
277
|
+
# }
|
242
278
|
class ResourceReference
|
243
279
|
include ::Google::Protobuf::MessageExts
|
244
280
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -52,11 +52,13 @@ module Google
|
|
52
52
|
# @!attribute [rw] remote_ip
|
53
53
|
# @return [::String]
|
54
54
|
# The IP address (IPv4 or IPv6) of the client that issued the HTTP
|
55
|
-
# request.
|
55
|
+
# request. This field can include port information. Examples:
|
56
|
+
# `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
|
56
57
|
# @!attribute [rw] server_ip
|
57
58
|
# @return [::String]
|
58
59
|
# The IP address (IPv4 or IPv6) of the origin server that the request was
|
59
|
-
# sent to.
|
60
|
+
# sent to. This field can include port information. Examples:
|
61
|
+
# `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
|
60
62
|
# @!attribute [rw] referer
|
61
63
|
# @return [::String]
|
62
64
|
# The referer URL of the request, as defined in
|
@@ -169,6 +169,11 @@ module Google
|
|
169
169
|
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
170
170
|
# "folders/[FOLDER_ID]"
|
171
171
|
#
|
172
|
+
# May alternatively be one or more views
|
173
|
+
# projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
174
|
+
# organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
175
|
+
# billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
176
|
+
# folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
172
177
|
#
|
173
178
|
# Projects listed in the `project_ids` field are added to this list.
|
174
179
|
# @!attribute [rw] filter
|
@@ -279,6 +284,19 @@ module Google
|
|
279
284
|
# preceding call to this method. `pageToken` must be the value of
|
280
285
|
# `nextPageToken` from the previous response. The values of other method
|
281
286
|
# parameters should be identical to those in the previous call.
|
287
|
+
# @!attribute [rw] resource_names
|
288
|
+
# @return [::Array<::String>]
|
289
|
+
# Optional. The resource name that owns the logs:
|
290
|
+
# projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
291
|
+
# organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
292
|
+
# billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
293
|
+
# folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]
|
294
|
+
#
|
295
|
+
# To support legacy queries, it could also be:
|
296
|
+
# "projects/[PROJECT_ID]"
|
297
|
+
# "organizations/[ORGANIZATION_ID]"
|
298
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
299
|
+
# "folders/[FOLDER_ID]"
|
282
300
|
class ListLogsRequest
|
283
301
|
include ::Google::Protobuf::MessageExts
|
284
302
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -299,6 +317,87 @@ module Google
|
|
299
317
|
include ::Google::Protobuf::MessageExts
|
300
318
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
301
319
|
end
|
320
|
+
|
321
|
+
# The parameters to `TailLogEntries`.
|
322
|
+
# @!attribute [rw] resource_names
|
323
|
+
# @return [::Array<::String>]
|
324
|
+
# Required. Name of a parent resource from which to retrieve log entries:
|
325
|
+
#
|
326
|
+
# "projects/[PROJECT_ID]"
|
327
|
+
# "organizations/[ORGANIZATION_ID]"
|
328
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
329
|
+
# "folders/[FOLDER_ID]"
|
330
|
+
#
|
331
|
+
# May alternatively be one or more views:
|
332
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
333
|
+
# "organization/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
334
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
335
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
336
|
+
# @!attribute [rw] filter
|
337
|
+
# @return [::String]
|
338
|
+
# Optional. A filter that chooses which log entries to return. See [Advanced
|
339
|
+
# Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
|
340
|
+
# Only log entries that match the filter are returned. An empty filter
|
341
|
+
# matches all log entries in the resources listed in `resource_names`.
|
342
|
+
# Referencing a parent resource that is not in `resource_names` will cause
|
343
|
+
# the filter to return no results. The maximum length of the filter is 20000
|
344
|
+
# characters.
|
345
|
+
# @!attribute [rw] buffer_window
|
346
|
+
# @return [::Google::Protobuf::Duration]
|
347
|
+
# Optional. The amount of time to buffer log entries at the server before
|
348
|
+
# being returned to prevent out of order results due to late arriving log
|
349
|
+
# entries. Valid values are between 0-60000 milliseconds. Defaults to 2000
|
350
|
+
# milliseconds.
|
351
|
+
class TailLogEntriesRequest
|
352
|
+
include ::Google::Protobuf::MessageExts
|
353
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
354
|
+
end
|
355
|
+
|
356
|
+
# Result returned from `TailLogEntries`.
|
357
|
+
# @!attribute [rw] entries
|
358
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogEntry>]
|
359
|
+
# A list of log entries. Each response in the stream will order entries with
|
360
|
+
# increasing values of `LogEntry.timestamp`. Ordering is not guaranteed
|
361
|
+
# between separate responses.
|
362
|
+
# @!attribute [rw] suppression_info
|
363
|
+
# @return [::Array<::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo>]
|
364
|
+
# If entries that otherwise would have been included in the session were not
|
365
|
+
# sent back to the client, counts of relevant entries omitted from the
|
366
|
+
# session with the reason that they were not included. There will be at most
|
367
|
+
# one of each reason per response. The counts represent the number of
|
368
|
+
# suppressed entries since the last streamed response.
|
369
|
+
class TailLogEntriesResponse
|
370
|
+
include ::Google::Protobuf::MessageExts
|
371
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
372
|
+
|
373
|
+
# Information about entries that were omitted from the session.
|
374
|
+
# @!attribute [rw] reason
|
375
|
+
# @return [::Google::Cloud::Logging::V2::TailLogEntriesResponse::SuppressionInfo::Reason]
|
376
|
+
# The reason that entries were omitted from the session.
|
377
|
+
# @!attribute [rw] suppressed_count
|
378
|
+
# @return [::Integer]
|
379
|
+
# A lower bound on the count of entries omitted due to `reason`.
|
380
|
+
class SuppressionInfo
|
381
|
+
include ::Google::Protobuf::MessageExts
|
382
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
383
|
+
|
384
|
+
# An indicator of why entries were omitted.
|
385
|
+
module Reason
|
386
|
+
# Unexpected default.
|
387
|
+
REASON_UNSPECIFIED = 0
|
388
|
+
|
389
|
+
# Indicates suppression occurred due to relevant entries being
|
390
|
+
# received in excess of rate limits. For quotas and limits, see
|
391
|
+
# [Logging API quotas and
|
392
|
+
# limits](https://cloud.google.com/logging/quotas#api-limits).
|
393
|
+
RATE_LIMIT = 1
|
394
|
+
|
395
|
+
# Indicates suppression occurred due to the client not consuming
|
396
|
+
# responses quickly enough.
|
397
|
+
NOT_CONSUMED = 2
|
398
|
+
end
|
399
|
+
end
|
400
|
+
end
|
302
401
|
end
|
303
402
|
end
|
304
403
|
end
|
@@ -21,7 +21,7 @@ module Google
|
|
21
21
|
module Cloud
|
22
22
|
module Logging
|
23
23
|
module V2
|
24
|
-
# Describes a repository of logs
|
24
|
+
# Describes a repository of logs.
|
25
25
|
# @!attribute [rw] name
|
26
26
|
# @return [::String]
|
27
27
|
# The resource name of the bucket.
|
@@ -29,7 +29,6 @@ module Google
|
|
29
29
|
# "projects/my-project-id/locations/my-location/buckets/my-bucket-id The
|
30
30
|
# supported locations are:
|
31
31
|
# "global"
|
32
|
-
# "us-central1"
|
33
32
|
#
|
34
33
|
# For the location of `global` it is unspecified where logs are actually
|
35
34
|
# stored.
|
@@ -50,6 +49,11 @@ module Google
|
|
50
49
|
# will automatically be deleted. The minimum retention period is 1 day.
|
51
50
|
# If this value is set to zero at bucket creation time, the default time of
|
52
51
|
# 30 days will be used.
|
52
|
+
# @!attribute [rw] locked
|
53
|
+
# @return [::Boolean]
|
54
|
+
# Whether the bucket has been locked.
|
55
|
+
# The retention period on a locked bucket may not be changed.
|
56
|
+
# Locked buckets may only be deleted if they are empty.
|
53
57
|
# @!attribute [r] lifecycle_state
|
54
58
|
# @return [::Google::Cloud::Logging::V2::LifecycleState]
|
55
59
|
# Output only. The bucket lifecycle state.
|
@@ -58,6 +62,36 @@ module Google
|
|
58
62
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
59
63
|
end
|
60
64
|
|
65
|
+
# Describes a view over logs in a bucket.
|
66
|
+
# @!attribute [rw] name
|
67
|
+
# @return [::String]
|
68
|
+
# The resource name of the view.
|
69
|
+
# For example
|
70
|
+
# "projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
|
71
|
+
# @!attribute [rw] description
|
72
|
+
# @return [::String]
|
73
|
+
# Describes this view.
|
74
|
+
# @!attribute [r] create_time
|
75
|
+
# @return [::Google::Protobuf::Timestamp]
|
76
|
+
# Output only. The creation timestamp of the view.
|
77
|
+
# @!attribute [r] update_time
|
78
|
+
# @return [::Google::Protobuf::Timestamp]
|
79
|
+
# Output only. The last update timestamp of the view.
|
80
|
+
# @!attribute [rw] filter
|
81
|
+
# @return [::String]
|
82
|
+
# Filter that restricts which log entries in a bucket are visible in this
|
83
|
+
# view. Filters are restricted to be a logical AND of ==/!= of any of the
|
84
|
+
# following:
|
85
|
+
# originating project/folder/organization/billing account.
|
86
|
+
# resource type
|
87
|
+
# log id
|
88
|
+
# Example: SOURCE("projects/myproject") AND resource.type = "gce_instance"
|
89
|
+
# AND LOG_ID("stdout")
|
90
|
+
class LogView
|
91
|
+
include ::Google::Protobuf::MessageExts
|
92
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
93
|
+
end
|
94
|
+
|
61
95
|
# Describes a sink used to export log entries to one of the following
|
62
96
|
# destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
|
63
97
|
# Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
|
@@ -99,12 +133,17 @@ module Google
|
|
99
133
|
# @return [::Boolean]
|
100
134
|
# Optional. If set to True, then this sink is disabled and it does not
|
101
135
|
# export any log entries.
|
136
|
+
# @!attribute [rw] exclusions
|
137
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogExclusion>]
|
138
|
+
# Optional. Log entries that match any of the exclusion filters will not be exported.
|
139
|
+
# If a log entry is matched by both `filter` and one of `exclusion_filters`
|
140
|
+
# it will not be exported.
|
102
141
|
# @!attribute [rw] output_version_format
|
103
142
|
# @return [::Google::Cloud::Logging::V2::LogSink::VersionFormat]
|
104
143
|
# Deprecated. This field is unused.
|
105
144
|
# @!attribute [r] writer_identity
|
106
145
|
# @return [::String]
|
107
|
-
# Output only. An IAM identity
|
146
|
+
# Output only. An IAM identity—a service account or group—under which Logging
|
108
147
|
# writes the exported log entries to the sink's destination. This field is
|
109
148
|
# set by {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#create_sink sinks.create} and
|
110
149
|
# {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_sink sinks.update} based on the
|
@@ -185,7 +224,7 @@ module Google
|
|
185
224
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
186
225
|
end
|
187
226
|
|
188
|
-
# The parameters to `ListBuckets
|
227
|
+
# The parameters to `ListBuckets`.
|
189
228
|
# @!attribute [rw] parent
|
190
229
|
# @return [::String]
|
191
230
|
# Required. The parent resource whose buckets are to be listed:
|
@@ -214,7 +253,7 @@ module Google
|
|
214
253
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
215
254
|
end
|
216
255
|
|
217
|
-
# The response from ListBuckets
|
256
|
+
# The response from ListBuckets.
|
218
257
|
# @!attribute [rw] buckets
|
219
258
|
# @return [::Array<::Google::Cloud::Logging::V2::LogBucket>]
|
220
259
|
# A list of buckets.
|
@@ -228,7 +267,30 @@ module Google
|
|
228
267
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
229
268
|
end
|
230
269
|
|
231
|
-
# The parameters to `
|
270
|
+
# The parameters to `CreateBucket`.
|
271
|
+
# @!attribute [rw] parent
|
272
|
+
# @return [::String]
|
273
|
+
# Required. The resource in which to create the bucket:
|
274
|
+
#
|
275
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
|
276
|
+
#
|
277
|
+
# Example: `"projects/my-logging-project/locations/global"`
|
278
|
+
# @!attribute [rw] bucket_id
|
279
|
+
# @return [::String]
|
280
|
+
# Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
|
281
|
+
# limited to 100 characters and can include only letters, digits,
|
282
|
+
# underscores, hyphens, and periods.
|
283
|
+
# @!attribute [rw] bucket
|
284
|
+
# @return [::Google::Cloud::Logging::V2::LogBucket]
|
285
|
+
# Required. The new bucket. The region specified in the new bucket must be compliant
|
286
|
+
# with any Location Restriction Org Policy. The name field in the bucket is
|
287
|
+
# ignored.
|
288
|
+
class CreateBucketRequest
|
289
|
+
include ::Google::Protobuf::MessageExts
|
290
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
291
|
+
end
|
292
|
+
|
293
|
+
# The parameters to `UpdateBucket`.
|
232
294
|
# @!attribute [rw] name
|
233
295
|
# @return [::String]
|
234
296
|
# Required. The full resource name of the bucket to update.
|
@@ -260,7 +322,7 @@ module Google
|
|
260
322
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
261
323
|
end
|
262
324
|
|
263
|
-
# The parameters to `GetBucket
|
325
|
+
# The parameters to `GetBucket`.
|
264
326
|
# @!attribute [rw] name
|
265
327
|
# @return [::String]
|
266
328
|
# Required. The resource name of the bucket:
|
@@ -277,6 +339,151 @@ module Google
|
|
277
339
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
278
340
|
end
|
279
341
|
|
342
|
+
# The parameters to `DeleteBucket`.
|
343
|
+
# @!attribute [rw] name
|
344
|
+
# @return [::String]
|
345
|
+
# Required. The full resource name of the bucket to delete.
|
346
|
+
#
|
347
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
348
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
349
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
350
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
351
|
+
#
|
352
|
+
# Example:
|
353
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
|
354
|
+
class DeleteBucketRequest
|
355
|
+
include ::Google::Protobuf::MessageExts
|
356
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
357
|
+
end
|
358
|
+
|
359
|
+
# The parameters to `UndeleteBucket`.
|
360
|
+
# @!attribute [rw] name
|
361
|
+
# @return [::String]
|
362
|
+
# Required. The full resource name of the bucket to undelete.
|
363
|
+
#
|
364
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
365
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
366
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
367
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
368
|
+
#
|
369
|
+
# Example:
|
370
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
|
371
|
+
class UndeleteBucketRequest
|
372
|
+
include ::Google::Protobuf::MessageExts
|
373
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
374
|
+
end
|
375
|
+
|
376
|
+
# The parameters to `ListViews`.
|
377
|
+
# @!attribute [rw] parent
|
378
|
+
# @return [::String]
|
379
|
+
# Required. The bucket whose views are to be listed:
|
380
|
+
#
|
381
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
382
|
+
# @!attribute [rw] page_token
|
383
|
+
# @return [::String]
|
384
|
+
# Optional. If present, then retrieve the next batch of results from the
|
385
|
+
# preceding call to this method. `pageToken` must be the value of
|
386
|
+
# `nextPageToken` from the previous response. The values of other method
|
387
|
+
# parameters should be identical to those in the previous call.
|
388
|
+
# @!attribute [rw] page_size
|
389
|
+
# @return [::Integer]
|
390
|
+
# Optional. The maximum number of results to return from this request.
|
391
|
+
# Non-positive values are ignored. The presence of `nextPageToken` in the
|
392
|
+
# response indicates that more results might be available.
|
393
|
+
class ListViewsRequest
|
394
|
+
include ::Google::Protobuf::MessageExts
|
395
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
396
|
+
end
|
397
|
+
|
398
|
+
# The response from ListViews.
|
399
|
+
# @!attribute [rw] views
|
400
|
+
# @return [::Array<::Google::Cloud::Logging::V2::LogView>]
|
401
|
+
# A list of views.
|
402
|
+
# @!attribute [rw] next_page_token
|
403
|
+
# @return [::String]
|
404
|
+
# If there might be more results than appear in this response, then
|
405
|
+
# `nextPageToken` is included. To get the next set of results, call the same
|
406
|
+
# method again using the value of `nextPageToken` as `pageToken`.
|
407
|
+
class ListViewsResponse
|
408
|
+
include ::Google::Protobuf::MessageExts
|
409
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
410
|
+
end
|
411
|
+
|
412
|
+
# The parameters to `CreateView`.
|
413
|
+
# @!attribute [rw] parent
|
414
|
+
# @return [::String]
|
415
|
+
# Required. The bucket in which to create the view
|
416
|
+
#
|
417
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
418
|
+
#
|
419
|
+
# Example:
|
420
|
+
# `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
|
421
|
+
# @!attribute [rw] view_id
|
422
|
+
# @return [::String]
|
423
|
+
# Required. The id to use for this view.
|
424
|
+
# @!attribute [rw] view
|
425
|
+
# @return [::Google::Cloud::Logging::V2::LogView]
|
426
|
+
# Required. The new view.
|
427
|
+
class CreateViewRequest
|
428
|
+
include ::Google::Protobuf::MessageExts
|
429
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
430
|
+
end
|
431
|
+
|
432
|
+
# The parameters to `UpdateView`.
|
433
|
+
# @!attribute [rw] name
|
434
|
+
# @return [::String]
|
435
|
+
# Required. The full resource name of the view to update
|
436
|
+
#
|
437
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
438
|
+
#
|
439
|
+
# Example:
|
440
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
441
|
+
# @!attribute [rw] view
|
442
|
+
# @return [::Google::Cloud::Logging::V2::LogView]
|
443
|
+
# Required. The updated view.
|
444
|
+
# @!attribute [rw] update_mask
|
445
|
+
# @return [::Google::Protobuf::FieldMask]
|
446
|
+
# Optional. Field mask that specifies the fields in `view` that need
|
447
|
+
# an update. A field will be overwritten if, and only if, it is
|
448
|
+
# in the update mask. `name` and output only fields cannot be updated.
|
449
|
+
#
|
450
|
+
# For a detailed `FieldMask` definition, see
|
451
|
+
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
452
|
+
#
|
453
|
+
# Example: `updateMask=filter`.
|
454
|
+
class UpdateViewRequest
|
455
|
+
include ::Google::Protobuf::MessageExts
|
456
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
457
|
+
end
|
458
|
+
|
459
|
+
# The parameters to `GetView`.
|
460
|
+
# @!attribute [rw] name
|
461
|
+
# @return [::String]
|
462
|
+
# Required. The resource name of the policy:
|
463
|
+
#
|
464
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
465
|
+
#
|
466
|
+
# Example:
|
467
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
468
|
+
class GetViewRequest
|
469
|
+
include ::Google::Protobuf::MessageExts
|
470
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
471
|
+
end
|
472
|
+
|
473
|
+
# The parameters to `DeleteView`.
|
474
|
+
# @!attribute [rw] name
|
475
|
+
# @return [::String]
|
476
|
+
# Required. The full resource name of the view to delete:
|
477
|
+
#
|
478
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
479
|
+
#
|
480
|
+
# Example:
|
481
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
|
482
|
+
class DeleteViewRequest
|
483
|
+
include ::Google::Protobuf::MessageExts
|
484
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
485
|
+
end
|
486
|
+
|
280
487
|
# The parameters to `ListSinks`.
|
281
488
|
# @!attribute [rw] parent
|
282
489
|
# @return [::String]
|
@@ -724,7 +931,7 @@ module Google
|
|
724
931
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
725
932
|
end
|
726
933
|
|
727
|
-
# LogBucket lifecycle states
|
934
|
+
# LogBucket lifecycle states.
|
728
935
|
module LifecycleState
|
729
936
|
# Unspecified state. This is only used/useful for distinguishing
|
730
937
|
# unset values.
|