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.
@@ -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
- # 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.