google-cloud-logging-v2 0.1.2 → 0.4.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.
@@ -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
@@ -54,6 +54,12 @@ module Google
54
54
  # This indicates that the field may be set once in a request to create a
55
55
  # resource, but may not be changed thereafter.
56
56
  IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
57
63
  end
58
64
  end
59
65
  end
@@ -43,12 +43,12 @@ module Google
43
43
  #
44
44
  # The ResourceDescriptor Yaml config will look like:
45
45
  #
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}"
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 'projects' for
187
- # the name of 'projects/\\{project}'. It is the same concept of the `plural`
188
- # field in k8s CRD spec
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
- # message ListLogEntriesRequest {
238
- # string parent = 1 [(google.api.resource_reference) = {
239
- # child_type: "logging.googleapis.com/LogEntry"
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. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
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 (Beta).
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 identitya service account or group&mdash;under which Logging
146
+ # Output only. An IAM identity&mdash;a service account or group&mdash;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` (Beta).
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 (Beta).
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 `UpdateBucket` (Beta).
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` (Beta).
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 (Beta).
934
+ # LogBucket lifecycle states.
728
935
  module LifecycleState
729
936
  # Unspecified state. This is only used/useful for distinguishing
730
937
  # unset values.