google-cloud-logging-v2 0.1.3 → 0.2.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.
@@ -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