google-cloud-logging-v2 0.1.3 → 0.5.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.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Logging
23
23
  module V2
24
- VERSION = "0.1.3"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -19,14 +19,23 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
19
19
  optional :create_time, :message, 4, "google.protobuf.Timestamp"
20
20
  optional :update_time, :message, 5, "google.protobuf.Timestamp"
21
21
  optional :retention_days, :int32, 11
22
+ optional :locked, :bool, 9
22
23
  optional :lifecycle_state, :enum, 12, "google.logging.v2.LifecycleState"
23
24
  end
25
+ add_message "google.logging.v2.LogView" do
26
+ optional :name, :string, 1
27
+ optional :description, :string, 3
28
+ optional :create_time, :message, 4, "google.protobuf.Timestamp"
29
+ optional :update_time, :message, 5, "google.protobuf.Timestamp"
30
+ optional :filter, :string, 7
31
+ end
24
32
  add_message "google.logging.v2.LogSink" do
25
33
  optional :name, :string, 1
26
34
  optional :destination, :string, 3
27
35
  optional :filter, :string, 5
28
36
  optional :description, :string, 18
29
37
  optional :disabled, :bool, 19
38
+ repeated :exclusions, :message, 16, "google.logging.v2.LogExclusion"
30
39
  optional :output_version_format, :enum, 6, "google.logging.v2.LogSink.VersionFormat"
31
40
  optional :writer_identity, :string, 8
32
41
  optional :include_children, :bool, 9
@@ -54,6 +63,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
54
63
  repeated :buckets, :message, 1, "google.logging.v2.LogBucket"
55
64
  optional :next_page_token, :string, 2
56
65
  end
66
+ add_message "google.logging.v2.CreateBucketRequest" do
67
+ optional :parent, :string, 1
68
+ optional :bucket_id, :string, 2
69
+ optional :bucket, :message, 3, "google.logging.v2.LogBucket"
70
+ end
57
71
  add_message "google.logging.v2.UpdateBucketRequest" do
58
72
  optional :name, :string, 1
59
73
  optional :bucket, :message, 2, "google.logging.v2.LogBucket"
@@ -62,6 +76,37 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
62
76
  add_message "google.logging.v2.GetBucketRequest" do
63
77
  optional :name, :string, 1
64
78
  end
79
+ add_message "google.logging.v2.DeleteBucketRequest" do
80
+ optional :name, :string, 1
81
+ end
82
+ add_message "google.logging.v2.UndeleteBucketRequest" do
83
+ optional :name, :string, 1
84
+ end
85
+ add_message "google.logging.v2.ListViewsRequest" do
86
+ optional :parent, :string, 1
87
+ optional :page_token, :string, 2
88
+ optional :page_size, :int32, 3
89
+ end
90
+ add_message "google.logging.v2.ListViewsResponse" do
91
+ repeated :views, :message, 1, "google.logging.v2.LogView"
92
+ optional :next_page_token, :string, 2
93
+ end
94
+ add_message "google.logging.v2.CreateViewRequest" do
95
+ optional :parent, :string, 1
96
+ optional :view_id, :string, 2
97
+ optional :view, :message, 3, "google.logging.v2.LogView"
98
+ end
99
+ add_message "google.logging.v2.UpdateViewRequest" do
100
+ optional :name, :string, 1
101
+ optional :view, :message, 2, "google.logging.v2.LogView"
102
+ optional :update_mask, :message, 4, "google.protobuf.FieldMask"
103
+ end
104
+ add_message "google.logging.v2.GetViewRequest" do
105
+ optional :name, :string, 1
106
+ end
107
+ add_message "google.logging.v2.DeleteViewRequest" do
108
+ optional :name, :string, 1
109
+ end
65
110
  add_message "google.logging.v2.ListSinksRequest" do
66
111
  optional :parent, :string, 1
67
112
  optional :page_token, :string, 2
@@ -146,13 +191,23 @@ module Google
146
191
  module Logging
147
192
  module V2
148
193
  LogBucket = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogBucket").msgclass
194
+ LogView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogView").msgclass
149
195
  LogSink = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink").msgclass
150
196
  LogSink::VersionFormat = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink.VersionFormat").enummodule
151
197
  BigQueryOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BigQueryOptions").msgclass
152
198
  ListBucketsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsRequest").msgclass
153
199
  ListBucketsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsResponse").msgclass
200
+ CreateBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateBucketRequest").msgclass
154
201
  UpdateBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateBucketRequest").msgclass
155
202
  GetBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetBucketRequest").msgclass
203
+ DeleteBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteBucketRequest").msgclass
204
+ UndeleteBucketRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UndeleteBucketRequest").msgclass
205
+ ListViewsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListViewsRequest").msgclass
206
+ ListViewsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListViewsResponse").msgclass
207
+ CreateViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateViewRequest").msgclass
208
+ UpdateViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateViewRequest").msgclass
209
+ GetViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetViewRequest").msgclass
210
+ DeleteViewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteViewRequest").msgclass
156
211
  ListSinksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksRequest").msgclass
157
212
  ListSinksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksResponse").msgclass
158
213
  GetSinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetSinkRequest").msgclass
@@ -33,10 +33,13 @@ module Google
33
33
  self.unmarshal_class_method = :decode
34
34
  self.service_name = 'google.logging.v2.ConfigServiceV2'
35
35
 
36
- # Lists buckets (Beta).
37
- rpc :ListBuckets, Google::Cloud::Logging::V2::ListBucketsRequest, Google::Cloud::Logging::V2::ListBucketsResponse
38
- # Gets a bucket (Beta).
39
- rpc :GetBucket, Google::Cloud::Logging::V2::GetBucketRequest, Google::Cloud::Logging::V2::LogBucket
36
+ # Lists buckets.
37
+ rpc :ListBuckets, ::Google::Cloud::Logging::V2::ListBucketsRequest, ::Google::Cloud::Logging::V2::ListBucketsResponse
38
+ # Gets a bucket.
39
+ rpc :GetBucket, ::Google::Cloud::Logging::V2::GetBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
40
+ # Creates a bucket that can be used to store log entries. Once a bucket has
41
+ # been created, the region cannot be changed.
42
+ rpc :CreateBucket, ::Google::Cloud::Logging::V2::CreateBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
40
43
  # Updates a bucket. This method replaces the following fields in the
41
44
  # existing bucket with values from the new bucket: `retention_period`
42
45
  #
@@ -47,38 +50,57 @@ module Google
47
50
  # will be returned.
48
51
  #
49
52
  # A buckets region may not be modified after it is created.
50
- # This method is in Beta.
51
- rpc :UpdateBucket, Google::Cloud::Logging::V2::UpdateBucketRequest, Google::Cloud::Logging::V2::LogBucket
53
+ rpc :UpdateBucket, ::Google::Cloud::Logging::V2::UpdateBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
54
+ # Deletes a bucket.
55
+ # Moves the bucket to the DELETE_REQUESTED state. After 7 days, the
56
+ # bucket will be purged and all logs in the bucket will be permanently
57
+ # deleted.
58
+ rpc :DeleteBucket, ::Google::Cloud::Logging::V2::DeleteBucketRequest, ::Google::Protobuf::Empty
59
+ # Undeletes a bucket. A bucket that has been deleted may be undeleted within
60
+ # the grace period of 7 days.
61
+ rpc :UndeleteBucket, ::Google::Cloud::Logging::V2::UndeleteBucketRequest, ::Google::Protobuf::Empty
62
+ # Lists views on a bucket.
63
+ rpc :ListViews, ::Google::Cloud::Logging::V2::ListViewsRequest, ::Google::Cloud::Logging::V2::ListViewsResponse
64
+ # Gets a view.
65
+ rpc :GetView, ::Google::Cloud::Logging::V2::GetViewRequest, ::Google::Cloud::Logging::V2::LogView
66
+ # Creates a view over logs in a bucket. A bucket may contain a maximum of
67
+ # 50 views.
68
+ rpc :CreateView, ::Google::Cloud::Logging::V2::CreateViewRequest, ::Google::Cloud::Logging::V2::LogView
69
+ # Updates a view. This method replaces the following fields in the existing
70
+ # view with values from the new view: `filter`.
71
+ rpc :UpdateView, ::Google::Cloud::Logging::V2::UpdateViewRequest, ::Google::Cloud::Logging::V2::LogView
72
+ # Deletes a view from a bucket.
73
+ rpc :DeleteView, ::Google::Cloud::Logging::V2::DeleteViewRequest, ::Google::Protobuf::Empty
52
74
  # Lists sinks.
53
- rpc :ListSinks, Google::Cloud::Logging::V2::ListSinksRequest, Google::Cloud::Logging::V2::ListSinksResponse
75
+ rpc :ListSinks, ::Google::Cloud::Logging::V2::ListSinksRequest, ::Google::Cloud::Logging::V2::ListSinksResponse
54
76
  # Gets a sink.
55
- rpc :GetSink, Google::Cloud::Logging::V2::GetSinkRequest, Google::Cloud::Logging::V2::LogSink
77
+ rpc :GetSink, ::Google::Cloud::Logging::V2::GetSinkRequest, ::Google::Cloud::Logging::V2::LogSink
56
78
  # Creates a sink that exports specified log entries to a destination. The
57
79
  # export of newly-ingested log entries begins immediately, unless the sink's
58
80
  # `writer_identity` is not permitted to write to the destination. A sink can
59
81
  # export log entries only from the resource owning the sink.
60
- rpc :CreateSink, Google::Cloud::Logging::V2::CreateSinkRequest, Google::Cloud::Logging::V2::LogSink
82
+ rpc :CreateSink, ::Google::Cloud::Logging::V2::CreateSinkRequest, ::Google::Cloud::Logging::V2::LogSink
61
83
  # Updates a sink. This method replaces the following fields in the existing
62
84
  # sink with values from the new sink: `destination`, and `filter`.
63
85
  #
64
86
  # The updated sink might also have a new `writer_identity`; see the
65
87
  # `unique_writer_identity` field.
66
- rpc :UpdateSink, Google::Cloud::Logging::V2::UpdateSinkRequest, Google::Cloud::Logging::V2::LogSink
88
+ rpc :UpdateSink, ::Google::Cloud::Logging::V2::UpdateSinkRequest, ::Google::Cloud::Logging::V2::LogSink
67
89
  # Deletes a sink. If the sink has a unique `writer_identity`, then that
68
90
  # service account is also deleted.
69
- rpc :DeleteSink, Google::Cloud::Logging::V2::DeleteSinkRequest, Google::Protobuf::Empty
91
+ rpc :DeleteSink, ::Google::Cloud::Logging::V2::DeleteSinkRequest, ::Google::Protobuf::Empty
70
92
  # Lists all the exclusions in a parent resource.
71
- rpc :ListExclusions, Google::Cloud::Logging::V2::ListExclusionsRequest, Google::Cloud::Logging::V2::ListExclusionsResponse
93
+ rpc :ListExclusions, ::Google::Cloud::Logging::V2::ListExclusionsRequest, ::Google::Cloud::Logging::V2::ListExclusionsResponse
72
94
  # Gets the description of an exclusion.
73
- rpc :GetExclusion, Google::Cloud::Logging::V2::GetExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
95
+ rpc :GetExclusion, ::Google::Cloud::Logging::V2::GetExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
74
96
  # Creates a new exclusion in a specified parent resource.
75
97
  # Only log entries belonging to that resource can be excluded.
76
98
  # You can have up to 10 exclusions in a resource.
77
- rpc :CreateExclusion, Google::Cloud::Logging::V2::CreateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
99
+ rpc :CreateExclusion, ::Google::Cloud::Logging::V2::CreateExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
78
100
  # Changes one or more properties of an existing exclusion.
79
- rpc :UpdateExclusion, Google::Cloud::Logging::V2::UpdateExclusionRequest, Google::Cloud::Logging::V2::LogExclusion
101
+ rpc :UpdateExclusion, ::Google::Cloud::Logging::V2::UpdateExclusionRequest, ::Google::Cloud::Logging::V2::LogExclusion
80
102
  # Deletes an exclusion.
81
- rpc :DeleteExclusion, Google::Cloud::Logging::V2::DeleteExclusionRequest, Google::Protobuf::Empty
103
+ rpc :DeleteExclusion, ::Google::Cloud::Logging::V2::DeleteExclusionRequest, ::Google::Protobuf::Empty
82
104
  # Gets the Logs Router CMEK settings for the given resource.
83
105
  #
84
106
  # Note: CMEK for the Logs Router can currently only be configured for GCP
@@ -88,7 +110,7 @@ module Google
88
110
  # See [Enabling CMEK for Logs
89
111
  # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
90
112
  # for more information.
91
- rpc :GetCmekSettings, Google::Cloud::Logging::V2::GetCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
113
+ rpc :GetCmekSettings, ::Google::Cloud::Logging::V2::GetCmekSettingsRequest, ::Google::Cloud::Logging::V2::CmekSettings
92
114
  # Updates the Logs Router CMEK settings for the given resource.
93
115
  #
94
116
  # Note: CMEK for the Logs Router can currently only be configured for GCP
@@ -104,7 +126,7 @@ module Google
104
126
  # See [Enabling CMEK for Logs
105
127
  # Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
106
128
  # for more information.
107
- rpc :UpdateCmekSettings, Google::Cloud::Logging::V2::UpdateCmekSettingsRequest, Google::Cloud::Logging::V2::CmekSettings
129
+ rpc :UpdateCmekSettings, ::Google::Cloud::Logging::V2::UpdateCmekSettingsRequest, ::Google::Cloud::Logging::V2::CmekSettings
108
130
  end
109
131
 
110
132
  Stub = Service.rpc_stub_class
@@ -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