google-cloud-logging-v2 0.1.3 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -359,6 +359,87 @@ module Google
359
359
  resource.call(**args)
360
360
  end
361
361
 
362
+ ##
363
+ # Create a fully-qualified LogView resource string.
364
+ #
365
+ # @overload log_view_path(project:, location:, bucket:, view:)
366
+ # The resource will be in the following format:
367
+ #
368
+ # `projects/{project}/locations/{location}/buckets/{bucket}/views/{view}`
369
+ #
370
+ # @param project [String]
371
+ # @param location [String]
372
+ # @param bucket [String]
373
+ # @param view [String]
374
+ #
375
+ # @overload log_view_path(organization:, location:, bucket:, view:)
376
+ # The resource will be in the following format:
377
+ #
378
+ # `organizations/{organization}/locations/{location}/buckets/{bucket}/views/{view}`
379
+ #
380
+ # @param organization [String]
381
+ # @param location [String]
382
+ # @param bucket [String]
383
+ # @param view [String]
384
+ #
385
+ # @overload log_view_path(folder:, location:, bucket:, view:)
386
+ # The resource will be in the following format:
387
+ #
388
+ # `folders/{folder}/locations/{location}/buckets/{bucket}/views/{view}`
389
+ #
390
+ # @param folder [String]
391
+ # @param location [String]
392
+ # @param bucket [String]
393
+ # @param view [String]
394
+ #
395
+ # @overload log_view_path(billing_account:, location:, bucket:, view:)
396
+ # The resource will be in the following format:
397
+ #
398
+ # `billingAccounts/{billing_account}/locations/{location}/buckets/{bucket}/views/{view}`
399
+ #
400
+ # @param billing_account [String]
401
+ # @param location [String]
402
+ # @param bucket [String]
403
+ # @param view [String]
404
+ #
405
+ # @return [::String]
406
+ def log_view_path **args
407
+ resources = {
408
+ "bucket:location:project:view" => (proc do |project:, location:, bucket:, view:|
409
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
410
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
411
+ raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
412
+
413
+ "projects/#{project}/locations/#{location}/buckets/#{bucket}/views/#{view}"
414
+ end),
415
+ "bucket:location:organization:view" => (proc do |organization:, location:, bucket:, view:|
416
+ raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
417
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
418
+ raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
419
+
420
+ "organizations/#{organization}/locations/#{location}/buckets/#{bucket}/views/#{view}"
421
+ end),
422
+ "bucket:folder:location:view" => (proc do |folder:, location:, bucket:, view:|
423
+ raise ::ArgumentError, "folder cannot contain /" if folder.to_s.include? "/"
424
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
425
+ raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
426
+
427
+ "folders/#{folder}/locations/#{location}/buckets/#{bucket}/views/#{view}"
428
+ end),
429
+ "billing_account:bucket:location:view" => (proc do |billing_account:, location:, bucket:, view:|
430
+ raise ::ArgumentError, "billing_account cannot contain /" if billing_account.to_s.include? "/"
431
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
432
+ raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
433
+
434
+ "billingAccounts/#{billing_account}/locations/#{location}/buckets/#{bucket}/views/#{view}"
435
+ end)
436
+ }
437
+
438
+ resource = resources[args.keys.sort.join(":")]
439
+ raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
440
+ resource.call(**args)
441
+ end
442
+
362
443
  ##
363
444
  # Create a fully-qualified Organization resource string.
364
445
  #
@@ -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.2.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
@@ -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,17 @@ 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
59
  end
60
60
 
61
61
  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