google-api-client 0.9.23 → 0.9.24

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.
Files changed (40) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +1 -1
  3. data/api_names.yaml +2556 -0
  4. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  5. data/generated/google/apis/adsense_v1_4.rb +1 -1
  6. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  7. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  8. data/generated/google/apis/androidenterprise_v1/service.rb +0 -46
  9. data/generated/google/apis/appstate_v1.rb +1 -1
  10. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  11. data/generated/google/apis/cloudbuild_v1/classes.rb +578 -578
  12. data/generated/google/apis/cloudbuild_v1/representations.rb +113 -113
  13. data/generated/google/apis/cloudbuild_v1/service.rb +182 -182
  14. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  15. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  16. data/generated/google/apis/dfareporting_v2_7.rb +40 -0
  17. data/generated/google/apis/dfareporting_v2_7/classes.rb +11876 -0
  18. data/generated/google/apis/dfareporting_v2_7/representations.rb +4243 -0
  19. data/generated/google/apis/dfareporting_v2_7/service.rb +9095 -0
  20. data/generated/google/apis/dns_v1.rb +1 -1
  21. data/generated/google/apis/dns_v2beta1.rb +1 -1
  22. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  23. data/generated/google/apis/games_management_v1management.rb +1 -1
  24. data/generated/google/apis/games_v1.rb +1 -1
  25. data/generated/google/apis/logging_v2beta1/classes.rb +837 -837
  26. data/generated/google/apis/logging_v2beta1/representations.rb +165 -165
  27. data/generated/google/apis/logging_v2beta1/service.rb +208 -208
  28. data/generated/google/apis/monitoring_v3.rb +1 -1
  29. data/generated/google/apis/plus_domains_v1.rb +1 -1
  30. data/generated/google/apis/plus_v1.rb +1 -1
  31. data/generated/google/apis/sheets_v4.rb +3 -3
  32. data/generated/google/apis/sheets_v4/classes.rb +4203 -4203
  33. data/generated/google/apis/sheets_v4/representations.rb +835 -835
  34. data/generated/google/apis/sheets_v4/service.rb +195 -195
  35. data/generated/google/apis/slides_v1.rb +1 -1
  36. data/generated/google/apis/webmasters_v3.rb +1 -1
  37. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  38. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  39. data/lib/google/apis/version.rb +1 -1
  40. metadata +6 -2
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/cloud-dns
26
26
  module DnsV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170102'
28
+ REVISION = '20170118'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/cloud-dns
26
26
  module DnsV2beta1
27
27
  VERSION = 'V2beta1'
28
- REVISION = '20170102'
28
+ REVISION = '20170118'
29
29
 
30
30
  # View and manage your data across Google Cloud Platform services
31
31
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/games/services
26
26
  module GamesConfigurationV1configuration
27
27
  VERSION = 'V1configuration'
28
- REVISION = '20170111'
28
+ REVISION = '20170119'
29
29
 
30
30
  # View and manage your Google Play Developer account
31
31
  AUTH_ANDROIDPUBLISHER = 'https://www.googleapis.com/auth/androidpublisher'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/games/services
26
26
  module GamesManagementV1management
27
27
  VERSION = 'V1management'
28
- REVISION = '20170111'
28
+ REVISION = '20170119'
29
29
 
30
30
  # Share your Google+ profile information and view and manage your game activity
31
31
  AUTH_GAMES = 'https://www.googleapis.com/auth/games'
@@ -25,7 +25,7 @@ module Google
25
25
  # @see https://developers.google.com/games/services/
26
26
  module GamesV1
27
27
  VERSION = 'V1'
28
- REVISION = '20170111'
28
+ REVISION = '20170119'
29
29
 
30
30
  # View and manage its own configuration data in your Google Drive
31
31
  AUTH_DRIVE_APPDATA = 'https://www.googleapis.com/auth/drive.appdata'
@@ -22,42 +22,42 @@ module Google
22
22
  module Apis
23
23
  module LoggingV2beta1
24
24
 
25
- # Result returned from ListLogMetrics.
26
- class ListLogMetricsResponse
25
+ # Describes a logs-based metric. The value of the metric is the number of log
26
+ # entries that match a logs filter in a given time interval.
27
+ class LogMetric
27
28
  include Google::Apis::Core::Hashable
28
29
 
29
- # A list of logs-based metrics.
30
- # Corresponds to the JSON property `metrics`
31
- # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
32
- attr_accessor :metrics
33
-
34
- # If there might be more results than appear in this response, then
35
- # nextPageToken is included. To get the next set of results, call this method
36
- # again using the value of nextPageToken as pageToken.
37
- # Corresponds to the JSON property `nextPageToken`
30
+ # Output only. The API version that created or updated this metric. The version
31
+ # also dictates the syntax of the filter expression. When a value for this field
32
+ # is missing, the default value of V2 should be assumed.
33
+ # Corresponds to the JSON property `version`
38
34
  # @return [String]
39
- attr_accessor :next_page_token
35
+ attr_accessor :version
40
36
 
41
- def initialize(**args)
42
- update!(**args)
43
- end
37
+ # Required. An advanced logs filter which is used to match log entries. Example:
38
+ # "resource.type=gae_app AND severity>=ERROR"
39
+ # The maximum length of the filter is 20000 characters.
40
+ # Corresponds to the JSON property `filter`
41
+ # @return [String]
42
+ attr_accessor :filter
44
43
 
45
- # Update properties of this object
46
- def update!(**args)
47
- @metrics = args[:metrics] if args.key?(:metrics)
48
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
49
- end
50
- end
44
+ # Required. The client-assigned metric identifier. Examples: "error_count", "
45
+ # nginx/requests".Metric identifiers are limited to 100 characters and can
46
+ # include only the following characters: A-Z, a-z, 0-9, and the special
47
+ # characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy
48
+ # of name pieces, and it cannot be the first character of the name.The metric
49
+ # identifier in this field must not be URL-encoded (https://en.wikipedia.org/
50
+ # wiki/Percent-encoding). However, when the metric identifier appears as the [
51
+ # METRIC_ID] part of a metric_name API parameter, then the metric identifier
52
+ # must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
53
+ # Corresponds to the JSON property `name`
54
+ # @return [String]
55
+ attr_accessor :name
51
56
 
52
- # A generic empty message that you can re-use to avoid defining duplicated empty
53
- # messages in your APIs. A typical example is to use it as the request or the
54
- # response type of an API method. For instance:
55
- # service Foo `
56
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
57
- # `
58
- # The JSON representation for Empty is empty JSON object ``.
59
- class Empty
60
- include Google::Apis::Core::Hashable
57
+ # Optional. A description of this metric, which is used in documentation.
58
+ # Corresponds to the JSON property `description`
59
+ # @return [String]
60
+ attr_accessor :description
61
61
 
62
62
  def initialize(**args)
63
63
  update!(**args)
@@ -65,114 +65,97 @@ module Google
65
65
 
66
66
  # Update properties of this object
67
67
  def update!(**args)
68
+ @version = args[:version] if args.key?(:version)
69
+ @filter = args[:filter] if args.key?(:filter)
70
+ @name = args[:name] if args.key?(:name)
71
+ @description = args[:description] if args.key?(:description)
68
72
  end
69
73
  end
70
74
 
71
- # An individual entry in a log.
72
- class LogEntry
75
+ # Additional information about a potentially long-running operation with which a
76
+ # log entry is associated.
77
+ class LogEntryOperation
73
78
  include Google::Apis::Core::Hashable
74
79
 
75
- # Optional. The time the event described by the log entry occurred. If omitted,
76
- # Stackdriver Logging will use the time the log entry is received.
77
- # Corresponds to the JSON property `timestamp`
80
+ # Optional. An arbitrary operation identifier. Log entries with the same
81
+ # identifier are assumed to be part of the same operation.
82
+ # Corresponds to the JSON property `id`
78
83
  # @return [String]
79
- attr_accessor :timestamp
84
+ attr_accessor :id
80
85
 
81
- # Required. The resource name of the log to which this log entry belongs:
82
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
83
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
84
- # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/
85
- # 1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must
86
- # be less than 512 characters long and can only include the following characters:
87
- # upper and lower case alphanumeric characters, forward-slash, underscore,
88
- # hyphen, and period.For backward compatibility, if log_name begins with a
89
- # forward-slash, such as /projects/..., then the log entry is ingested as usual
90
- # but the forward-slash is removed. Listing the log entry will not show the
91
- # leading slash and filtering for a log name with a leading slash will never
92
- # return any results.
93
- # Corresponds to the JSON property `logName`
86
+ # Optional. An arbitrary producer identifier. The combination of id and producer
87
+ # must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com",
88
+ # "github.com/MyProject/MyApplication".
89
+ # Corresponds to the JSON property `producer`
94
90
  # @return [String]
95
- attr_accessor :log_name
91
+ attr_accessor :producer
96
92
 
97
- # A common proto for logging HTTP requests. Only contains semantics defined by
98
- # the HTTP specification. Product-specific logging information MUST be defined
99
- # in a separate message.
100
- # Corresponds to the JSON property `httpRequest`
101
- # @return [Google::Apis::LoggingV2beta1::HttpRequest]
102
- attr_accessor :http_request
93
+ # Optional. Set this to True if this is the first log entry in the operation.
94
+ # Corresponds to the JSON property `first`
95
+ # @return [Boolean]
96
+ attr_accessor :first
97
+ alias_method :first?, :first
103
98
 
104
- # An object representing a resource that can be used for monitoring, logging,
105
- # billing, or other purposes. Examples include virtual machine instances,
106
- # databases, and storage devices such as disks. The type field identifies a
107
- # MonitoredResourceDescriptor object that describes the resource's schema.
108
- # Information in the labels field identifies the actual resource and its
109
- # attributes according to the schema. For example, a particular Compute Engine
110
- # VM instance could be represented by the following object, because the
111
- # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
112
- # zone":
113
- # ` "type": "gce_instance",
114
- # "labels": ` "instance_id": "12345678901234",
115
- # "zone": "us-central1-a" ``
116
- # Corresponds to the JSON property `resource`
117
- # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
118
- attr_accessor :resource
99
+ # Optional. Set this to True if this is the last log entry in the operation.
100
+ # Corresponds to the JSON property `last`
101
+ # @return [Boolean]
102
+ attr_accessor :last
103
+ alias_method :last?, :last
119
104
 
120
- # The log entry payload, represented as a structure that is expressed as a JSON
121
- # object.
122
- # Corresponds to the JSON property `jsonPayload`
123
- # @return [Hash<String,Object>]
124
- attr_accessor :json_payload
105
+ def initialize(**args)
106
+ update!(**args)
107
+ end
125
108
 
126
- # Optional. A unique ID for the log entry. If you provide this field, the
127
- # logging service considers other log entries in the same project with the same
128
- # ID as duplicates which can be removed. If omitted, Stackdriver Logging will
129
- # generate a unique ID for this log entry.
130
- # Corresponds to the JSON property `insertId`
131
- # @return [String]
132
- attr_accessor :insert_id
109
+ # Update properties of this object
110
+ def update!(**args)
111
+ @id = args[:id] if args.key?(:id)
112
+ @producer = args[:producer] if args.key?(:producer)
113
+ @first = args[:first] if args.key?(:first)
114
+ @last = args[:last] if args.key?(:last)
115
+ end
116
+ end
133
117
 
134
- # Additional information about a potentially long-running operation with which a
135
- # log entry is associated.
136
- # Corresponds to the JSON property `operation`
137
- # @return [Google::Apis::LoggingV2beta1::LogEntryOperation]
138
- attr_accessor :operation
118
+ # Result returned from WriteLogEntries. empty
119
+ class WriteLogEntriesResponse
120
+ include Google::Apis::Core::Hashable
139
121
 
140
- # The log entry payload, represented as a Unicode string (UTF-8).
141
- # Corresponds to the JSON property `textPayload`
142
- # @return [String]
143
- attr_accessor :text_payload
122
+ def initialize(**args)
123
+ update!(**args)
124
+ end
144
125
 
145
- # The log entry payload, represented as a protocol buffer. Some Google Cloud
146
- # Platform services use this field for their log entry payloads.
147
- # Corresponds to the JSON property `protoPayload`
148
- # @return [Hash<String,Object>]
149
- attr_accessor :proto_payload
126
+ # Update properties of this object
127
+ def update!(**args)
128
+ end
129
+ end
150
130
 
151
- # Optional. Resource name of the trace associated with the log entry, if any. If
152
- # it contains a relative resource name, the name is assumed to be relative to //
153
- # tracing.googleapis.com. Example: projects/my-projectid/traces/
154
- # 06796866738c859f2f19b7cfb3214824
155
- # Corresponds to the JSON property `trace`
156
- # @return [String]
157
- attr_accessor :trace
131
+ # An object representing a resource that can be used for monitoring, logging,
132
+ # billing, or other purposes. Examples include virtual machine instances,
133
+ # databases, and storage devices such as disks. The type field identifies a
134
+ # MonitoredResourceDescriptor object that describes the resource's schema.
135
+ # Information in the labels field identifies the actual resource and its
136
+ # attributes according to the schema. For example, a particular Compute Engine
137
+ # VM instance could be represented by the following object, because the
138
+ # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
139
+ # zone":
140
+ # ` "type": "gce_instance",
141
+ # "labels": ` "instance_id": "12345678901234",
142
+ # "zone": "us-central1-a" ``
143
+ class MonitoredResource
144
+ include Google::Apis::Core::Hashable
158
145
 
159
- # Optional. A set of user-defined (key, value) data that provides additional
160
- # information about the log entry.
146
+ # Required. Values for all of the labels listed in the associated monitored
147
+ # resource descriptor. For example, Cloud SQL databases use the labels "
148
+ # database_id" and "zone".
161
149
  # Corresponds to the JSON property `labels`
162
150
  # @return [Hash<String,String>]
163
151
  attr_accessor :labels
164
152
 
165
- # Optional. The severity of the log entry. The default value is LogSeverity.
166
- # DEFAULT.
167
- # Corresponds to the JSON property `severity`
153
+ # Required. The monitored resource type. This field must match the type field of
154
+ # a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL
155
+ # database is "cloudsql_database".
156
+ # Corresponds to the JSON property `type`
168
157
  # @return [String]
169
- attr_accessor :severity
170
-
171
- # Additional information about the source code location that produced the log
172
- # entry.
173
- # Corresponds to the JSON property `sourceLocation`
174
- # @return [Google::Apis::LoggingV2beta1::LogEntrySourceLocation]
175
- attr_accessor :source_location
158
+ attr_accessor :type
176
159
 
177
160
  def initialize(**args)
178
161
  update!(**args)
@@ -180,45 +163,80 @@ module Google
180
163
 
181
164
  # Update properties of this object
182
165
  def update!(**args)
183
- @timestamp = args[:timestamp] if args.key?(:timestamp)
184
- @log_name = args[:log_name] if args.key?(:log_name)
185
- @http_request = args[:http_request] if args.key?(:http_request)
186
- @resource = args[:resource] if args.key?(:resource)
187
- @json_payload = args[:json_payload] if args.key?(:json_payload)
188
- @insert_id = args[:insert_id] if args.key?(:insert_id)
189
- @operation = args[:operation] if args.key?(:operation)
190
- @text_payload = args[:text_payload] if args.key?(:text_payload)
191
- @proto_payload = args[:proto_payload] if args.key?(:proto_payload)
192
- @trace = args[:trace] if args.key?(:trace)
193
166
  @labels = args[:labels] if args.key?(:labels)
194
- @severity = args[:severity] if args.key?(:severity)
195
- @source_location = args[:source_location] if args.key?(:source_location)
167
+ @type = args[:type] if args.key?(:type)
196
168
  end
197
169
  end
198
170
 
199
- # Specifies a location in a source code file.
200
- class SourceLocation
171
+ # Describes a sink used to export log entries to one of the following
172
+ # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
173
+ # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
174
+ # The sink must be created within a project or organization.
175
+ class LogSink
201
176
  include Google::Apis::Core::Hashable
202
177
 
203
- # Line within the source file.
204
- # Corresponds to the JSON property `line`
178
+ # Output only. An IAM identity&mdash;a service account or group&mdash;under
179
+ # which Stackdriver Logging writes the exported log entries to the sink's
180
+ # destination. This field is set by sinks.create and sinks.update, based on the
181
+ # setting of unique_writer_identity in those methods.Until you grant this
182
+ # identity write-access to the destination, log entry exports from this sink
183
+ # will fail. For more information, see Granting access for a resource. Consult
184
+ # the destination service's documentation to determine the appropriate IAM roles
185
+ # to assign to the identity.
186
+ # Corresponds to the JSON property `writerIdentity`
205
187
  # @return [String]
206
- attr_accessor :line
188
+ attr_accessor :writer_identity
207
189
 
208
- # Source file name. Depending on the runtime environment, this might be a simple
209
- # name or a fully-qualified name.
210
- # Corresponds to the JSON property `file`
190
+ # Optional. The time at which this sink will begin exporting log entries. Log
191
+ # entries are exported only if their timestamp is not earlier than the start
192
+ # time. The default value of this field is the time the sink is created or
193
+ # updated.
194
+ # Corresponds to the JSON property `startTime`
211
195
  # @return [String]
212
- attr_accessor :file
196
+ attr_accessor :start_time
213
197
 
214
- # Human-readable name of the function or method being invoked, with optional
215
- # context such as the class or package name. This information is used in
216
- # contexts such as the logs viewer, where a file and line number are less
217
- # meaningful. The format can vary by language. For example: qual.if.ied.Class.
218
- # method (Java), dir/package.func (Go), function (Python).
219
- # Corresponds to the JSON property `functionName`
198
+ # Optional. The log entry format to use for this sink's exported log entries.
199
+ # The v2 format is used by default. The v1 format is deprecated and should be
200
+ # used only as part of a migration effort to v2. See Migration to the v2 API.
201
+ # Corresponds to the JSON property `outputVersionFormat`
220
202
  # @return [String]
221
- attr_accessor :function_name
203
+ attr_accessor :output_version_format
204
+
205
+ # Required. The client-assigned sink identifier, unique within the project.
206
+ # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
207
+ # characters and can include only the following characters: upper and lower-case
208
+ # alphanumeric characters, underscores, hyphens, and periods.
209
+ # Corresponds to the JSON property `name`
210
+ # @return [String]
211
+ attr_accessor :name
212
+
213
+ # Optional. An advanced logs filter. The only exported log entries are those
214
+ # that are in the resource owning the sink and that match the filter. The filter
215
+ # must use the log entry format specified by the output_version_format parameter.
216
+ # For example, in the v2 format:
217
+ # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
218
+ # Corresponds to the JSON property `filter`
219
+ # @return [String]
220
+ attr_accessor :filter
221
+
222
+ # Required. The export destination:
223
+ # "storage.googleapis.com/[GCS_BUCKET]"
224
+ # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
225
+ # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
226
+ # The sink's writer_identity, set when the sink is created, must have permission
227
+ # to write to the destination or else the log entries are not exported. For more
228
+ # information, see Exporting Logs With Sinks.
229
+ # Corresponds to the JSON property `destination`
230
+ # @return [String]
231
+ attr_accessor :destination
232
+
233
+ # Optional. The time at which this sink will stop exporting log entries. Log
234
+ # entries are exported only if their timestamp is earlier than the end time. If
235
+ # this field is not supplied, there is no end time. If both a start time and an
236
+ # end time are provided, then the end time must be later than the start time.
237
+ # Corresponds to the JSON property `endTime`
238
+ # @return [String]
239
+ attr_accessor :end_time
222
240
 
223
241
  def initialize(**args)
224
242
  update!(**args)
@@ -226,65 +244,73 @@ module Google
226
244
 
227
245
  # Update properties of this object
228
246
  def update!(**args)
229
- @line = args[:line] if args.key?(:line)
230
- @file = args[:file] if args.key?(:file)
231
- @function_name = args[:function_name] if args.key?(:function_name)
247
+ @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
248
+ @start_time = args[:start_time] if args.key?(:start_time)
249
+ @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
250
+ @name = args[:name] if args.key?(:name)
251
+ @filter = args[:filter] if args.key?(:filter)
252
+ @destination = args[:destination] if args.key?(:destination)
253
+ @end_time = args[:end_time] if args.key?(:end_time)
232
254
  end
233
255
  end
234
256
 
235
- # The parameters to ListLogEntries.
236
- class ListLogEntriesRequest
257
+ # The parameters to WriteLogEntries.
258
+ class WriteLogEntriesRequest
237
259
  include Google::Apis::Core::Hashable
238
260
 
239
- # Deprecated. Use resource_names instead. One or more project identifiers or
240
- # project numbers from which to retrieve log entries. Example: "my-project-1A".
241
- # If present, these project identifiers are converted to resource name format
242
- # and added to the list of resources in resource_names.
243
- # Corresponds to the JSON property `projectIds`
244
- # @return [Array<String>]
245
- attr_accessor :project_ids
261
+ # Optional. Default labels that are added to the labels field of all log entries
262
+ # in entries. If a log entry already has a label with the same key as a label in
263
+ # this parameter, then the log entry's label is not changed. See LogEntry.
264
+ # Corresponds to the JSON property `labels`
265
+ # @return [Hash<String,String>]
266
+ attr_accessor :labels
246
267
 
247
- # Optional. A filter that chooses which log entries to return. See Advanced Logs
248
- # Filters. Only log entries that match the filter are returned. An empty filter
249
- # matches all log entries in the resources listed in resource_names. Referencing
250
- # a parent resource that is not listed in resource_names will cause the filter
251
- # to return no results. The maximum length of the filter is 20000 characters.
252
- # Corresponds to the JSON property `filter`
253
- # @return [String]
254
- attr_accessor :filter
268
+ # An object representing a resource that can be used for monitoring, logging,
269
+ # billing, or other purposes. Examples include virtual machine instances,
270
+ # databases, and storage devices such as disks. The type field identifies a
271
+ # MonitoredResourceDescriptor object that describes the resource's schema.
272
+ # Information in the labels field identifies the actual resource and its
273
+ # attributes according to the schema. For example, a particular Compute Engine
274
+ # VM instance could be represented by the following object, because the
275
+ # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
276
+ # zone":
277
+ # ` "type": "gce_instance",
278
+ # "labels": ` "instance_id": "12345678901234",
279
+ # "zone": "us-central1-a" ``
280
+ # Corresponds to the JSON property `resource`
281
+ # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
282
+ attr_accessor :resource
255
283
 
256
- # Optional. If present, then retrieve the next batch of results from the
257
- # preceding call to this method. pageToken must be the value of nextPageToken
258
- # from the previous response. The values of other method parameters should be
259
- # identical to those in the previous call.
260
- # Corresponds to the JSON property `pageToken`
284
+ # Optional. A default log resource name that is assigned to all log entries in
285
+ # entries that do not specify a value for log_name:
286
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
287
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
288
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
289
+ # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
290
+ # 2Factivity". For more information about log names, see LogEntry.
291
+ # Corresponds to the JSON property `logName`
261
292
  # @return [String]
262
- attr_accessor :page_token
263
-
264
- # Optional. The maximum number of results to return from this request. Non-
265
- # positive values are ignored. The presence of nextPageToken in the response
266
- # indicates that more results might be available.
267
- # Corresponds to the JSON property `pageSize`
268
- # @return [Fixnum]
269
- attr_accessor :page_size
293
+ attr_accessor :log_name
270
294
 
271
- # Optional. How the results should be sorted. Presently, the only permitted
272
- # values are "timestamp asc" (default) and "timestamp desc". The first option
273
- # returns entries in order of increasing values of LogEntry.timestamp (oldest
274
- # first), and the second option returns entries in order of decreasing
275
- # timestamps (newest first). Entries with equal timestamps are returned in order
276
- # of LogEntry.insertId.
277
- # Corresponds to the JSON property `orderBy`
278
- # @return [String]
279
- attr_accessor :order_by
295
+ # Required. The log entries to write. Values supplied for the fields log_name,
296
+ # resource, and labels in this entries.write request are added to those log
297
+ # entries that do not provide their own values for the fields.To improve
298
+ # throughput and to avoid exceeding the quota limit for calls to entries.write,
299
+ # you should write multiple log entries at once rather than calling this method
300
+ # for each individual log entry.
301
+ # Corresponds to the JSON property `entries`
302
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
303
+ attr_accessor :entries
280
304
 
281
- # Required. Names of one or more resources from which to retrieve log entries:
282
- # "projects/[PROJECT_ID]"
283
- # "organizations/[ORGANIZATION_ID]"
284
- # Projects listed in the project_ids field are added to this list.
285
- # Corresponds to the JSON property `resourceNames`
286
- # @return [Array<String>]
287
- attr_accessor :resource_names
305
+ # Optional. Whether valid entries should be written even if some other entries
306
+ # fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not
307
+ # written, the response status will be the error associated with one of the
308
+ # failed entries and include error details in the form of
309
+ # WriteLogEntriesPartialErrors.
310
+ # Corresponds to the JSON property `partialSuccess`
311
+ # @return [Boolean]
312
+ attr_accessor :partial_success
313
+ alias_method :partial_success?, :partial_success
288
314
 
289
315
  def initialize(**args)
290
316
  update!(**args)
@@ -292,196 +318,130 @@ module Google
292
318
 
293
319
  # Update properties of this object
294
320
  def update!(**args)
295
- @project_ids = args[:project_ids] if args.key?(:project_ids)
296
- @filter = args[:filter] if args.key?(:filter)
297
- @page_token = args[:page_token] if args.key?(:page_token)
298
- @page_size = args[:page_size] if args.key?(:page_size)
299
- @order_by = args[:order_by] if args.key?(:order_by)
300
- @resource_names = args[:resource_names] if args.key?(:resource_names)
321
+ @labels = args[:labels] if args.key?(:labels)
322
+ @resource = args[:resource] if args.key?(:resource)
323
+ @log_name = args[:log_name] if args.key?(:log_name)
324
+ @entries = args[:entries] if args.key?(:entries)
325
+ @partial_success = args[:partial_success] if args.key?(:partial_success)
301
326
  end
302
327
  end
303
328
 
304
- # Complete log information about a single HTTP request to an App Engine
305
- # application.
306
- class RequestLog
329
+ # Result returned from ListLogs.
330
+ class ListLogsResponse
307
331
  include Google::Apis::Core::Hashable
308
332
 
309
- # The logged-in user who made the request.Most likely, this is the part of the
310
- # user's email before the @ sign. The field value is the same for different
311
- # requests from the same user, but different users can have similar names. This
312
- # information is also available to the application via the App Engine Users API.
313
- # This field will be populated starting with App Engine 1.9.21.
314
- # Corresponds to the JSON property `nickname`
315
- # @return [String]
316
- attr_accessor :nickname
317
-
318
- # HTTP response status code. Example: 200, 404.
319
- # Corresponds to the JSON property `status`
320
- # @return [Fixnum]
321
- attr_accessor :status
333
+ # A list of log names. For example, "projects/my-project/syslog" or "
334
+ # organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
335
+ # Corresponds to the JSON property `logNames`
336
+ # @return [Array<String>]
337
+ attr_accessor :log_names
322
338
 
323
- # Contains the path and query portion of the URL that was requested. For example,
324
- # if the URL was "http://example.com/app?name=val", the resource would be "/app?
325
- # name=val". The fragment identifier, which is identified by the # character, is
326
- # not included.
327
- # Corresponds to the JSON property `resource`
339
+ # If there might be more results than those appearing in this response, then
340
+ # nextPageToken is included. To get the next set of results, call this method
341
+ # again using the value of nextPageToken as pageToken.
342
+ # Corresponds to the JSON property `nextPageToken`
328
343
  # @return [String]
329
- attr_accessor :resource
344
+ attr_accessor :next_page_token
330
345
 
331
- # Time this request spent in the pending request queue.
332
- # Corresponds to the JSON property `pendingTime`
333
- # @return [String]
334
- attr_accessor :pending_time
346
+ def initialize(**args)
347
+ update!(**args)
348
+ end
335
349
 
336
- # Task name of the request, in the case of an offline request.
337
- # Corresponds to the JSON property `taskName`
338
- # @return [String]
339
- attr_accessor :task_name
350
+ # Update properties of this object
351
+ def update!(**args)
352
+ @log_names = args[:log_names] if args.key?(:log_names)
353
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
354
+ end
355
+ end
340
356
 
341
- # File or class that handled the request.
342
- # Corresponds to the JSON property `urlMapEntry`
343
- # @return [String]
344
- attr_accessor :url_map_entry
357
+ # A common proto for logging HTTP requests. Only contains semantics defined by
358
+ # the HTTP specification. Product-specific logging information MUST be defined
359
+ # in a separate message.
360
+ class HttpRequest
361
+ include Google::Apis::Core::Hashable
345
362
 
346
- # If the instance processing this request belongs to a manually scaled module,
347
- # then this is the 0-based index of the instance. Otherwise, this value is -1.
348
- # Corresponds to the JSON property `instanceIndex`
349
- # @return [Fixnum]
350
- attr_accessor :instance_index
363
+ # Whether or not a cache lookup was attempted.
364
+ # Corresponds to the JSON property `cacheLookup`
365
+ # @return [Boolean]
366
+ attr_accessor :cache_lookup
367
+ alias_method :cache_lookup?, :cache_lookup
351
368
 
352
- # Internet host and port number of the resource being requested.
353
- # Corresponds to the JSON property `host`
354
- # @return [String]
355
- attr_accessor :host
369
+ # Whether or not an entity was served from cache (with or without validation).
370
+ # Corresponds to the JSON property `cacheHit`
371
+ # @return [Boolean]
372
+ attr_accessor :cache_hit
373
+ alias_method :cache_hit?, :cache_hit
356
374
 
357
- # Whether this request is finished or active.
358
- # Corresponds to the JSON property `finished`
375
+ # Whether or not the response was validated with the origin server before being
376
+ # served from cache. This field is only meaningful if cache_hit is True.
377
+ # Corresponds to the JSON property `cacheValidatedWithOriginServer`
359
378
  # @return [Boolean]
360
- attr_accessor :finished
361
- alias_method :finished?, :finished
379
+ attr_accessor :cache_validated_with_origin_server
380
+ alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
362
381
 
363
- # HTTP version of request. Example: "HTTP/1.1".
364
- # Corresponds to the JSON property `httpVersion`
365
- # @return [String]
366
- attr_accessor :http_version
382
+ # The response code indicating the status of response. Examples: 200, 404.
383
+ # Corresponds to the JSON property `status`
384
+ # @return [Fixnum]
385
+ attr_accessor :status
367
386
 
368
- # Time when the request started.
369
- # Corresponds to the JSON property `startTime`
387
+ # The referer URL of the request, as defined in HTTP/1.1 Header Field
388
+ # Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
389
+ # Corresponds to the JSON property `referer`
370
390
  # @return [String]
371
- attr_accessor :start_time
391
+ attr_accessor :referer
372
392
 
373
- # Latency of the request.
393
+ # The request processing latency on the server, from the time the request was
394
+ # received until the response was sent.
374
395
  # Corresponds to the JSON property `latency`
375
396
  # @return [String]
376
397
  attr_accessor :latency
377
398
 
378
- # Origin IP address.
379
- # Corresponds to the JSON property `ip`
380
- # @return [String]
381
- attr_accessor :ip
382
-
383
- # Application that handled this request.
384
- # Corresponds to the JSON property `appId`
385
- # @return [String]
386
- attr_accessor :app_id
387
-
388
- # App Engine release version.
389
- # Corresponds to the JSON property `appEngineRelease`
390
- # @return [String]
391
- attr_accessor :app_engine_release
392
-
393
- # Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE".
394
- # Corresponds to the JSON property `method`
395
- # @return [String]
396
- attr_accessor :method_prop
397
-
398
- # An indication of the relative cost of serving this request.
399
- # Corresponds to the JSON property `cost`
400
- # @return [Float]
401
- attr_accessor :cost
402
-
403
- # An identifier for the instance that handled the request.
404
- # Corresponds to the JSON property `instanceId`
405
- # @return [String]
406
- attr_accessor :instance_id
407
-
408
- # Number of CPU megacycles used to process request.
409
- # Corresponds to the JSON property `megaCycles`
410
- # @return [String]
411
- attr_accessor :mega_cycles
412
-
413
- # Whether this is the first RequestLog entry for this request. If an active
414
- # request has several RequestLog entries written to Stackdriver Logging, then
415
- # this field will be set for one of them.
416
- # Corresponds to the JSON property `first`
417
- # @return [Boolean]
418
- attr_accessor :first
419
- alias_method :first?, :first
420
-
421
- # Version of the application that handled this request.
422
- # Corresponds to the JSON property `versionId`
423
- # @return [String]
424
- attr_accessor :version_id
425
-
426
- # Module of the application that handled this request.
427
- # Corresponds to the JSON property `moduleId`
428
- # @return [String]
429
- attr_accessor :module_id
430
-
431
- # Time when the request finished.
432
- # Corresponds to the JSON property `endTime`
433
- # @return [String]
434
- attr_accessor :end_time
435
-
436
- # User agent that made the request.
399
+ # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0;
400
+ # Windows 98; Q312461; .NET CLR 1.0.3705)".
437
401
  # Corresponds to the JSON property `userAgent`
438
402
  # @return [String]
439
403
  attr_accessor :user_agent
440
404
 
441
- # Whether this was a loading request for the instance.
442
- # Corresponds to the JSON property `wasLoadingRequest`
443
- # @return [Boolean]
444
- attr_accessor :was_loading_request
445
- alias_method :was_loading_request?, :was_loading_request
405
+ # The number of HTTP response bytes inserted into cache. Set only when a cache
406
+ # fill was attempted.
407
+ # Corresponds to the JSON property `cacheFillBytes`
408
+ # @return [String]
409
+ attr_accessor :cache_fill_bytes
446
410
 
447
- # Source code for the application that handled this request. There can be more
448
- # than one source reference per deployed application if source code is
449
- # distributed among multiple repositories.
450
- # Corresponds to the JSON property `sourceReference`
451
- # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
452
- attr_accessor :source_reference
411
+ # The request method. Examples: "GET", "HEAD", "PUT", "POST".
412
+ # Corresponds to the JSON property `requestMethod`
413
+ # @return [String]
414
+ attr_accessor :request_method
453
415
 
454
- # Size in bytes sent back to client by request.
416
+ # The size of the HTTP response message sent back to the client, in bytes,
417
+ # including the response headers and the response body.
455
418
  # Corresponds to the JSON property `responseSize`
456
419
  # @return [String]
457
420
  attr_accessor :response_size
458
421
 
459
- # Stackdriver Trace identifier for this request.
460
- # Corresponds to the JSON property `traceId`
422
+ # The size of the HTTP request message in bytes, including the request headers
423
+ # and the request body.
424
+ # Corresponds to the JSON property `requestSize`
461
425
  # @return [String]
462
- attr_accessor :trace_id
463
-
464
- # A list of log lines emitted by the application while serving this request.
465
- # Corresponds to the JSON property `line`
466
- # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
467
- attr_accessor :line
426
+ attr_accessor :request_size
468
427
 
469
- # Queue name of the request, in the case of an offline request.
470
- # Corresponds to the JSON property `taskQueueName`
428
+ # The scheme (http, https), the host name, the path and the query portion of the
429
+ # URL that was requested. Example: "http://example.com/some/info?color=red".
430
+ # Corresponds to the JSON property `requestUrl`
471
431
  # @return [String]
472
- attr_accessor :task_queue_name
432
+ attr_accessor :request_url
473
433
 
474
- # Referrer URL of request.
475
- # Corresponds to the JSON property `referrer`
434
+ # The IP address (IPv4 or IPv6) of the origin server that the request was sent
435
+ # to.
436
+ # Corresponds to the JSON property `serverIp`
476
437
  # @return [String]
477
- attr_accessor :referrer
438
+ attr_accessor :server_ip
478
439
 
479
- # Globally unique identifier for a request, which is based on the request start
480
- # time. Request IDs for requests which started later will compare greater as
481
- # strings than those for requests which started earlier.
482
- # Corresponds to the JSON property `requestId`
440
+ # The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
441
+ # Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
442
+ # Corresponds to the JSON property `remoteIp`
483
443
  # @return [String]
484
- attr_accessor :request_id
444
+ attr_accessor :remote_ip
485
445
 
486
446
  def initialize(**args)
487
447
  update!(**args)
@@ -489,56 +449,38 @@ module Google
489
449
 
490
450
  # Update properties of this object
491
451
  def update!(**args)
492
- @nickname = args[:nickname] if args.key?(:nickname)
452
+ @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
453
+ @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
454
+ @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
493
455
  @status = args[:status] if args.key?(:status)
494
- @resource = args[:resource] if args.key?(:resource)
495
- @pending_time = args[:pending_time] if args.key?(:pending_time)
496
- @task_name = args[:task_name] if args.key?(:task_name)
497
- @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
498
- @instance_index = args[:instance_index] if args.key?(:instance_index)
499
- @host = args[:host] if args.key?(:host)
500
- @finished = args[:finished] if args.key?(:finished)
501
- @http_version = args[:http_version] if args.key?(:http_version)
502
- @start_time = args[:start_time] if args.key?(:start_time)
456
+ @referer = args[:referer] if args.key?(:referer)
503
457
  @latency = args[:latency] if args.key?(:latency)
504
- @ip = args[:ip] if args.key?(:ip)
505
- @app_id = args[:app_id] if args.key?(:app_id)
506
- @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
507
- @method_prop = args[:method_prop] if args.key?(:method_prop)
508
- @cost = args[:cost] if args.key?(:cost)
509
- @instance_id = args[:instance_id] if args.key?(:instance_id)
510
- @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
511
- @first = args[:first] if args.key?(:first)
512
- @version_id = args[:version_id] if args.key?(:version_id)
513
- @module_id = args[:module_id] if args.key?(:module_id)
514
- @end_time = args[:end_time] if args.key?(:end_time)
515
458
  @user_agent = args[:user_agent] if args.key?(:user_agent)
516
- @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
517
- @source_reference = args[:source_reference] if args.key?(:source_reference)
459
+ @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
460
+ @request_method = args[:request_method] if args.key?(:request_method)
518
461
  @response_size = args[:response_size] if args.key?(:response_size)
519
- @trace_id = args[:trace_id] if args.key?(:trace_id)
520
- @line = args[:line] if args.key?(:line)
521
- @task_queue_name = args[:task_queue_name] if args.key?(:task_queue_name)
522
- @referrer = args[:referrer] if args.key?(:referrer)
523
- @request_id = args[:request_id] if args.key?(:request_id)
462
+ @request_size = args[:request_size] if args.key?(:request_size)
463
+ @request_url = args[:request_url] if args.key?(:request_url)
464
+ @server_ip = args[:server_ip] if args.key?(:server_ip)
465
+ @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
524
466
  end
525
467
  end
526
468
 
527
- # Result returned from ListMonitoredResourceDescriptors.
528
- class ListMonitoredResourceDescriptorsResponse
469
+ # Result returned from ListSinks.
470
+ class ListSinksResponse
529
471
  include Google::Apis::Core::Hashable
530
472
 
531
- # If there might be more results than those appearing in this response, then
532
- # nextPageToken is included. To get the next set of results, call this method
533
- # again using the value of nextPageToken as pageToken.
473
+ # If there might be more results than appear in this response, then
474
+ # nextPageToken is included. To get the next set of results, call the same
475
+ # method again using the value of nextPageToken as pageToken.
534
476
  # Corresponds to the JSON property `nextPageToken`
535
477
  # @return [String]
536
478
  attr_accessor :next_page_token
537
479
 
538
- # A list of resource descriptors.
539
- # Corresponds to the JSON property `resourceDescriptors`
540
- # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
541
- attr_accessor :resource_descriptors
480
+ # A list of sinks.
481
+ # Corresponds to the JSON property `sinks`
482
+ # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
483
+ attr_accessor :sinks
542
484
 
543
485
  def initialize(**args)
544
486
  update!(**args)
@@ -547,26 +489,28 @@ module Google
547
489
  # Update properties of this object
548
490
  def update!(**args)
549
491
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
550
- @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
492
+ @sinks = args[:sinks] if args.key?(:sinks)
551
493
  end
552
494
  end
553
495
 
554
- # A reference to a particular snapshot of the source tree used to build and
555
- # deploy an application.
556
- class SourceReference
496
+ # A description of a label.
497
+ class LabelDescriptor
557
498
  include Google::Apis::Core::Hashable
558
499
 
559
- # Optional. A URI string identifying the repository. Example: "https://github.
560
- # com/GoogleCloudPlatform/kubernetes.git"
561
- # Corresponds to the JSON property `repository`
500
+ # The label key.
501
+ # Corresponds to the JSON property `key`
562
502
  # @return [String]
563
- attr_accessor :repository
503
+ attr_accessor :key
564
504
 
565
- # The canonical and persistent identifier of the deployed revision. Example (git)
566
- # : "0035781c50ec7aa23385dc841529ce8a4b70db1b"
567
- # Corresponds to the JSON property `revisionId`
505
+ # A human-readable description for the label.
506
+ # Corresponds to the JSON property `description`
568
507
  # @return [String]
569
- attr_accessor :revision_id
508
+ attr_accessor :description
509
+
510
+ # The type of data that can be assigned to the label.
511
+ # Corresponds to the JSON property `valueType`
512
+ # @return [String]
513
+ attr_accessor :value_type
570
514
 
571
515
  def initialize(**args)
572
516
  update!(**args)
@@ -574,47 +518,58 @@ module Google
574
518
 
575
519
  # Update properties of this object
576
520
  def update!(**args)
577
- @repository = args[:repository] if args.key?(:repository)
578
- @revision_id = args[:revision_id] if args.key?(:revision_id)
521
+ @key = args[:key] if args.key?(:key)
522
+ @description = args[:description] if args.key?(:description)
523
+ @value_type = args[:value_type] if args.key?(:value_type)
579
524
  end
580
525
  end
581
526
 
582
- # Describes a logs-based metric. The value of the metric is the number of log
583
- # entries that match a logs filter in a given time interval.
584
- class LogMetric
527
+ # An object that describes the schema of a MonitoredResource object using a type
528
+ # name and a set of labels. For example, the monitored resource descriptor for
529
+ # Google Compute Engine VM instances has a type of "gce_instance" and specifies
530
+ # the use of the labels "instance_id" and "zone" to identify particular VM
531
+ # instances.Different APIs can support different monitored resource types. APIs
532
+ # generally provide a list method that returns the monitored resource
533
+ # descriptors used by the API.
534
+ class MonitoredResourceDescriptor
585
535
  include Google::Apis::Core::Hashable
586
536
 
587
- # Required. The client-assigned metric identifier. Examples: "error_count", "
588
- # nginx/requests".Metric identifiers are limited to 100 characters and can
589
- # include only the following characters: A-Z, a-z, 0-9, and the special
590
- # characters _-.,+!*',()%/. The forward-slash character (/) denotes a hierarchy
591
- # of name pieces, and it cannot be the first character of the name.The metric
592
- # identifier in this field must not be URL-encoded (https://en.wikipedia.org/
593
- # wiki/Percent-encoding). However, when the metric identifier appears as the [
594
- # METRIC_ID] part of a metric_name API parameter, then the metric identifier
595
- # must be URL-encoded. Example: "projects/my-project/metrics/nginx%2Frequests".
537
+ # Optional. The resource name of the monitored resource descriptor: "projects/`
538
+ # project_id`/monitoredResourceDescriptors/`type`" where `type` is the value of
539
+ # the type field in this object and `project_id` is a project ID that provides
540
+ # API-specific context for accessing the type. APIs that do not use project
541
+ # information can use the resource name format "monitoredResourceDescriptors/`
542
+ # type`".
596
543
  # Corresponds to the JSON property `name`
597
544
  # @return [String]
598
545
  attr_accessor :name
599
546
 
600
- # Optional. A description of this metric, which is used in documentation.
547
+ # Optional. A concise name for the monitored resource type that might be
548
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
549
+ # any article or other determiners. For example, "Google Cloud SQL Database".
550
+ # Corresponds to the JSON property `displayName`
551
+ # @return [String]
552
+ attr_accessor :display_name
553
+
554
+ # Optional. A detailed description of the monitored resource type that might be
555
+ # used in documentation.
601
556
  # Corresponds to the JSON property `description`
602
557
  # @return [String]
603
558
  attr_accessor :description
604
559
 
605
- # Output only. The API version that created or updated this metric. The version
606
- # also dictates the syntax of the filter expression. When a value for this field
607
- # is missing, the default value of V2 should be assumed.
608
- # Corresponds to the JSON property `version`
560
+ # Required. The monitored resource type. For example, the type "
561
+ # cloudsql_database" represents databases in Google Cloud SQL. The maximum
562
+ # length of this value is 256 characters.
563
+ # Corresponds to the JSON property `type`
609
564
  # @return [String]
610
- attr_accessor :version
565
+ attr_accessor :type
611
566
 
612
- # Required. An advanced logs filter which is used to match log entries. Example:
613
- # "resource.type=gae_app AND severity>=ERROR"
614
- # The maximum length of the filter is 20000 characters.
615
- # Corresponds to the JSON property `filter`
616
- # @return [String]
617
- attr_accessor :filter
567
+ # Required. A set of labels used to describe instances of this monitored
568
+ # resource type. For example, an individual Google Cloud SQL database is
569
+ # identified by values for the labels "database_id" and "zone".
570
+ # Corresponds to the JSON property `labels`
571
+ # @return [Array<Google::Apis::LoggingV2beta1::LabelDescriptor>]
572
+ attr_accessor :labels
618
573
 
619
574
  def initialize(**args)
620
575
  update!(**args)
@@ -623,41 +578,107 @@ module Google
623
578
  # Update properties of this object
624
579
  def update!(**args)
625
580
  @name = args[:name] if args.key?(:name)
581
+ @display_name = args[:display_name] if args.key?(:display_name)
626
582
  @description = args[:description] if args.key?(:description)
627
- @version = args[:version] if args.key?(:version)
628
- @filter = args[:filter] if args.key?(:filter)
583
+ @type = args[:type] if args.key?(:type)
584
+ @labels = args[:labels] if args.key?(:labels)
629
585
  end
630
586
  end
631
587
 
632
- # Additional information about a potentially long-running operation with which a
633
- # log entry is associated.
634
- class LogEntryOperation
588
+ # Additional information about the source code location that produced the log
589
+ # entry.
590
+ class LogEntrySourceLocation
635
591
  include Google::Apis::Core::Hashable
636
592
 
637
- # Optional. An arbitrary operation identifier. Log entries with the same
638
- # identifier are assumed to be part of the same operation.
639
- # Corresponds to the JSON property `id`
593
+ # Optional. Line within the source file. 1-based; 0 indicates no line number
594
+ # available.
595
+ # Corresponds to the JSON property `line`
640
596
  # @return [String]
641
- attr_accessor :id
597
+ attr_accessor :line
642
598
 
643
- # Optional. An arbitrary producer identifier. The combination of id and producer
644
- # must be globally unique. Examples for producer: "MyDivision.MyBigCompany.com",
645
- # "github.com/MyProject/MyApplication".
646
- # Corresponds to the JSON property `producer`
599
+ # Optional. Source file name. Depending on the runtime environment, this might
600
+ # be a simple name or a fully-qualified name.
601
+ # Corresponds to the JSON property `file`
647
602
  # @return [String]
648
- attr_accessor :producer
603
+ attr_accessor :file
649
604
 
650
- # Optional. Set this to True if this is the first log entry in the operation.
651
- # Corresponds to the JSON property `first`
652
- # @return [Boolean]
653
- attr_accessor :first
654
- alias_method :first?, :first
605
+ # Optional. Human-readable name of the function or method being invoked, with
606
+ # optional context such as the class or package name. This information may be
607
+ # used in contexts such as the logs viewer, where a file and line number are
608
+ # less meaningful. The format can vary by language. For example: qual.if.ied.
609
+ # Class.method (Java), dir/package.func (Go), function (Python).
610
+ # Corresponds to the JSON property `function`
611
+ # @return [String]
612
+ attr_accessor :function
655
613
 
656
- # Optional. Set this to True if this is the last log entry in the operation.
657
- # Corresponds to the JSON property `last`
658
- # @return [Boolean]
659
- attr_accessor :last
660
- alias_method :last?, :last
614
+ def initialize(**args)
615
+ update!(**args)
616
+ end
617
+
618
+ # Update properties of this object
619
+ def update!(**args)
620
+ @line = args[:line] if args.key?(:line)
621
+ @file = args[:file] if args.key?(:file)
622
+ @function = args[:function] if args.key?(:function)
623
+ end
624
+ end
625
+
626
+ # Result returned from ListLogEntries.
627
+ class ListLogEntriesResponse
628
+ include Google::Apis::Core::Hashable
629
+
630
+ # A list of log entries.
631
+ # Corresponds to the JSON property `entries`
632
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
633
+ attr_accessor :entries
634
+
635
+ # If there might be more results than those appearing in this response, then
636
+ # nextPageToken is included. To get the next set of results, call this method
637
+ # again using the value of nextPageToken as pageToken.If a value for
638
+ # next_page_token appears and the entries field is empty, it means that the
639
+ # search found no log entries so far but it did not have time to search all the
640
+ # possible log entries. Retry the method with this value for page_token to
641
+ # continue the search. Alternatively, consider speeding up the search by
642
+ # changing your filter to specify a single log name or resource type, or to
643
+ # narrow the time range of the search.
644
+ # Corresponds to the JSON property `nextPageToken`
645
+ # @return [String]
646
+ attr_accessor :next_page_token
647
+
648
+ def initialize(**args)
649
+ update!(**args)
650
+ end
651
+
652
+ # Update properties of this object
653
+ def update!(**args)
654
+ @entries = args[:entries] if args.key?(:entries)
655
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
656
+ end
657
+ end
658
+
659
+ # Application log line emitted while processing a request.
660
+ class LogLine
661
+ include Google::Apis::Core::Hashable
662
+
663
+ # Severity of this log entry.
664
+ # Corresponds to the JSON property `severity`
665
+ # @return [String]
666
+ attr_accessor :severity
667
+
668
+ # App-provided log message.
669
+ # Corresponds to the JSON property `logMessage`
670
+ # @return [String]
671
+ attr_accessor :log_message
672
+
673
+ # Specifies a location in a source code file.
674
+ # Corresponds to the JSON property `sourceLocation`
675
+ # @return [Google::Apis::LoggingV2beta1::SourceLocation]
676
+ attr_accessor :source_location
677
+
678
+ # Approximate time when this log entry was made.
679
+ # Corresponds to the JSON property `time`
680
+ # @return [String]
681
+ attr_accessor :time
661
682
 
662
683
  def initialize(**args)
663
684
  update!(**args)
@@ -665,193 +686,117 @@ module Google
665
686
 
666
687
  # Update properties of this object
667
688
  def update!(**args)
668
- @id = args[:id] if args.key?(:id)
669
- @producer = args[:producer] if args.key?(:producer)
670
- @first = args[:first] if args.key?(:first)
671
- @last = args[:last] if args.key?(:last)
689
+ @severity = args[:severity] if args.key?(:severity)
690
+ @log_message = args[:log_message] if args.key?(:log_message)
691
+ @source_location = args[:source_location] if args.key?(:source_location)
692
+ @time = args[:time] if args.key?(:time)
672
693
  end
673
694
  end
674
695
 
675
- # Result returned from WriteLogEntries. empty
676
- class WriteLogEntriesResponse
696
+ # Result returned from ListLogMetrics.
697
+ class ListLogMetricsResponse
677
698
  include Google::Apis::Core::Hashable
678
699
 
700
+ # A list of logs-based metrics.
701
+ # Corresponds to the JSON property `metrics`
702
+ # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
703
+ attr_accessor :metrics
704
+
705
+ # If there might be more results than appear in this response, then
706
+ # nextPageToken is included. To get the next set of results, call this method
707
+ # again using the value of nextPageToken as pageToken.
708
+ # Corresponds to the JSON property `nextPageToken`
709
+ # @return [String]
710
+ attr_accessor :next_page_token
711
+
679
712
  def initialize(**args)
680
713
  update!(**args)
681
714
  end
682
715
 
683
716
  # Update properties of this object
684
717
  def update!(**args)
718
+ @metrics = args[:metrics] if args.key?(:metrics)
719
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
685
720
  end
686
721
  end
687
722
 
688
- # An object representing a resource that can be used for monitoring, logging,
689
- # billing, or other purposes. Examples include virtual machine instances,
690
- # databases, and storage devices such as disks. The type field identifies a
691
- # MonitoredResourceDescriptor object that describes the resource's schema.
692
- # Information in the labels field identifies the actual resource and its
693
- # attributes according to the schema. For example, a particular Compute Engine
694
- # VM instance could be represented by the following object, because the
695
- # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and "
696
- # zone":
697
- # ` "type": "gce_instance",
698
- # "labels": ` "instance_id": "12345678901234",
699
- # "zone": "us-central1-a" ``
700
- class MonitoredResource
723
+ # A generic empty message that you can re-use to avoid defining duplicated empty
724
+ # messages in your APIs. A typical example is to use it as the request or the
725
+ # response type of an API method. For instance:
726
+ # service Foo `
727
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
728
+ # `
729
+ # The JSON representation for Empty is empty JSON object ``.
730
+ class Empty
701
731
  include Google::Apis::Core::Hashable
702
732
 
703
- # Required. Values for all of the labels listed in the associated monitored
704
- # resource descriptor. For example, Cloud SQL databases use the labels "
705
- # database_id" and "zone".
706
- # Corresponds to the JSON property `labels`
707
- # @return [Hash<String,String>]
708
- attr_accessor :labels
709
-
710
- # Required. The monitored resource type. This field must match the type field of
711
- # a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL
712
- # database is "cloudsql_database".
713
- # Corresponds to the JSON property `type`
714
- # @return [String]
715
- attr_accessor :type
716
-
717
733
  def initialize(**args)
718
734
  update!(**args)
719
735
  end
720
736
 
721
737
  # Update properties of this object
722
738
  def update!(**args)
723
- @labels = args[:labels] if args.key?(:labels)
724
- @type = args[:type] if args.key?(:type)
725
739
  end
726
740
  end
727
741
 
728
- # Describes a sink used to export log entries to one of the following
729
- # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
730
- # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
731
- # The sink must be created within a project or organization.
732
- class LogSink
742
+ # An individual entry in a log.
743
+ class LogEntry
733
744
  include Google::Apis::Core::Hashable
734
745
 
735
- # Optional. The log entry format to use for this sink's exported log entries.
736
- # The v2 format is used by default. The v1 format is deprecated and should be
737
- # used only as part of a migration effort to v2. See Migration to the v2 API.
738
- # Corresponds to the JSON property `outputVersionFormat`
739
- # @return [String]
740
- attr_accessor :output_version_format
741
-
742
- # Required. The client-assigned sink identifier, unique within the project.
743
- # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
744
- # characters and can include only the following characters: upper and lower-case
745
- # alphanumeric characters, underscores, hyphens, and periods.
746
- # Corresponds to the JSON property `name`
747
- # @return [String]
748
- attr_accessor :name
749
-
750
- # Required. The export destination:
751
- # "storage.googleapis.com/[GCS_BUCKET]"
752
- # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
753
- # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
754
- # The sink's writer_identity, set when the sink is created, must have permission
755
- # to write to the destination or else the log entries are not exported. For more
756
- # information, see Exporting Logs With Sinks.
757
- # Corresponds to the JSON property `destination`
758
- # @return [String]
759
- attr_accessor :destination
746
+ # Optional. A set of user-defined (key, value) data that provides additional
747
+ # information about the log entry.
748
+ # Corresponds to the JSON property `labels`
749
+ # @return [Hash<String,String>]
750
+ attr_accessor :labels
760
751
 
761
- # Optional. An advanced logs filter. The only exported log entries are those
762
- # that are in the resource owning the sink and that match the filter. The filter
763
- # must use the log entry format specified by the output_version_format parameter.
764
- # For example, in the v2 format:
765
- # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
766
- # Corresponds to the JSON property `filter`
752
+ # Optional. Resource name of the trace associated with the log entry, if any. If
753
+ # it contains a relative resource name, the name is assumed to be relative to //
754
+ # tracing.googleapis.com. Example: projects/my-projectid/traces/
755
+ # 06796866738c859f2f19b7cfb3214824
756
+ # Corresponds to the JSON property `trace`
767
757
  # @return [String]
768
- attr_accessor :filter
758
+ attr_accessor :trace
769
759
 
770
- # Optional. The time at which this sink will stop exporting log entries. Log
771
- # entries are exported only if their timestamp is earlier than the end time. If
772
- # this field is not supplied, there is no end time. If both a start time and an
773
- # end time are provided, then the end time must be later than the start time.
774
- # Corresponds to the JSON property `endTime`
760
+ # Optional. The severity of the log entry. The default value is LogSeverity.
761
+ # DEFAULT.
762
+ # Corresponds to the JSON property `severity`
775
763
  # @return [String]
776
- attr_accessor :end_time
764
+ attr_accessor :severity
777
765
 
778
- # Optional. The time at which this sink will begin exporting log entries. Log
779
- # entries are exported only if their timestamp is not earlier than the start
780
- # time. The default value of this field is the time the sink is created or
781
- # updated.
782
- # Corresponds to the JSON property `startTime`
783
- # @return [String]
784
- attr_accessor :start_time
766
+ # Additional information about the source code location that produced the log
767
+ # entry.
768
+ # Corresponds to the JSON property `sourceLocation`
769
+ # @return [Google::Apis::LoggingV2beta1::LogEntrySourceLocation]
770
+ attr_accessor :source_location
785
771
 
786
- # Output only. An IAM identity&mdash;a service account or group&mdash;under
787
- # which Stackdriver Logging writes the exported log entries to the sink's
788
- # destination. This field is set by sinks.create and sinks.update, based on the
789
- # setting of unique_writer_identity in those methods.Until you grant this
790
- # identity write-access to the destination, log entry exports from this sink
791
- # will fail. For more information, see Granting access for a resource. Consult
792
- # the destination service's documentation to determine the appropriate IAM roles
793
- # to assign to the identity.
794
- # Corresponds to the JSON property `writerIdentity`
772
+ # Optional. The time the event described by the log entry occurred. If omitted,
773
+ # Stackdriver Logging will use the time the log entry is received.
774
+ # Corresponds to the JSON property `timestamp`
795
775
  # @return [String]
796
- attr_accessor :writer_identity
797
-
798
- def initialize(**args)
799
- update!(**args)
800
- end
801
-
802
- # Update properties of this object
803
- def update!(**args)
804
- @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
805
- @name = args[:name] if args.key?(:name)
806
- @destination = args[:destination] if args.key?(:destination)
807
- @filter = args[:filter] if args.key?(:filter)
808
- @end_time = args[:end_time] if args.key?(:end_time)
809
- @start_time = args[:start_time] if args.key?(:start_time)
810
- @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
811
- end
812
- end
813
-
814
- # The parameters to WriteLogEntries.
815
- class WriteLogEntriesRequest
816
- include Google::Apis::Core::Hashable
776
+ attr_accessor :timestamp
817
777
 
818
- # Optional. A default log resource name that is assigned to all log entries in
819
- # entries that do not specify a value for log_name:
778
+ # Required. The resource name of the log to which this log entry belongs:
820
779
  # "projects/[PROJECT_ID]/logs/[LOG_ID]"
821
780
  # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
822
- # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
823
- # or "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
824
- # 2Factivity". For more information about log names, see LogEntry.
781
+ # [LOG_ID] must be URL-encoded within log_name. Example: "organizations/
782
+ # 1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must
783
+ # be less than 512 characters long and can only include the following characters:
784
+ # upper and lower case alphanumeric characters, forward-slash, underscore,
785
+ # hyphen, and period.For backward compatibility, if log_name begins with a
786
+ # forward-slash, such as /projects/..., then the log entry is ingested as usual
787
+ # but the forward-slash is removed. Listing the log entry will not show the
788
+ # leading slash and filtering for a log name with a leading slash will never
789
+ # return any results.
825
790
  # Corresponds to the JSON property `logName`
826
791
  # @return [String]
827
792
  attr_accessor :log_name
828
793
 
829
- # Required. The log entries to write. Values supplied for the fields log_name,
830
- # resource, and labels in this entries.write request are added to those log
831
- # entries that do not provide their own values for the fields.To improve
832
- # throughput and to avoid exceeding the quota limit for calls to entries.write,
833
- # you should write multiple log entries at once rather than calling this method
834
- # for each individual log entry.
835
- # Corresponds to the JSON property `entries`
836
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
837
- attr_accessor :entries
838
-
839
- # Optional. Whether valid entries should be written even if some other entries
840
- # fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not
841
- # written, the response status will be the error associated with one of the
842
- # failed entries and include error details in the form of
843
- # WriteLogEntriesPartialErrors.
844
- # Corresponds to the JSON property `partialSuccess`
845
- # @return [Boolean]
846
- attr_accessor :partial_success
847
- alias_method :partial_success?, :partial_success
848
-
849
- # Optional. Default labels that are added to the labels field of all log entries
850
- # in entries. If a log entry already has a label with the same key as a label in
851
- # this parameter, then the log entry's label is not changed. See LogEntry.
852
- # Corresponds to the JSON property `labels`
853
- # @return [Hash<String,String>]
854
- attr_accessor :labels
794
+ # A common proto for logging HTTP requests. Only contains semantics defined by
795
+ # the HTTP specification. Product-specific logging information MUST be defined
796
+ # in a separate message.
797
+ # Corresponds to the JSON property `httpRequest`
798
+ # @return [Google::Apis::LoggingV2beta1::HttpRequest]
799
+ attr_accessor :http_request
855
800
 
856
801
  # An object representing a resource that can be used for monitoring, logging,
857
802
  # billing, or other purposes. Examples include virtual machine instances,
@@ -869,36 +814,82 @@ module Google
869
814
  # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
870
815
  attr_accessor :resource
871
816
 
817
+ # The log entry payload, represented as a structure that is expressed as a JSON
818
+ # object.
819
+ # Corresponds to the JSON property `jsonPayload`
820
+ # @return [Hash<String,Object>]
821
+ attr_accessor :json_payload
822
+
823
+ # Additional information about a potentially long-running operation with which a
824
+ # log entry is associated.
825
+ # Corresponds to the JSON property `operation`
826
+ # @return [Google::Apis::LoggingV2beta1::LogEntryOperation]
827
+ attr_accessor :operation
828
+
829
+ # Optional. A unique ID for the log entry. If you provide this field, the
830
+ # logging service considers other log entries in the same project with the same
831
+ # ID as duplicates which can be removed. If omitted, Stackdriver Logging will
832
+ # generate a unique ID for this log entry.
833
+ # Corresponds to the JSON property `insertId`
834
+ # @return [String]
835
+ attr_accessor :insert_id
836
+
837
+ # The log entry payload, represented as a Unicode string (UTF-8).
838
+ # Corresponds to the JSON property `textPayload`
839
+ # @return [String]
840
+ attr_accessor :text_payload
841
+
842
+ # The log entry payload, represented as a protocol buffer. Some Google Cloud
843
+ # Platform services use this field for their log entry payloads.
844
+ # Corresponds to the JSON property `protoPayload`
845
+ # @return [Hash<String,Object>]
846
+ attr_accessor :proto_payload
847
+
872
848
  def initialize(**args)
873
849
  update!(**args)
874
850
  end
875
851
 
876
852
  # Update properties of this object
877
853
  def update!(**args)
878
- @log_name = args[:log_name] if args.key?(:log_name)
879
- @entries = args[:entries] if args.key?(:entries)
880
- @partial_success = args[:partial_success] if args.key?(:partial_success)
881
854
  @labels = args[:labels] if args.key?(:labels)
855
+ @trace = args[:trace] if args.key?(:trace)
856
+ @severity = args[:severity] if args.key?(:severity)
857
+ @source_location = args[:source_location] if args.key?(:source_location)
858
+ @timestamp = args[:timestamp] if args.key?(:timestamp)
859
+ @log_name = args[:log_name] if args.key?(:log_name)
860
+ @http_request = args[:http_request] if args.key?(:http_request)
882
861
  @resource = args[:resource] if args.key?(:resource)
862
+ @json_payload = args[:json_payload] if args.key?(:json_payload)
863
+ @operation = args[:operation] if args.key?(:operation)
864
+ @insert_id = args[:insert_id] if args.key?(:insert_id)
865
+ @text_payload = args[:text_payload] if args.key?(:text_payload)
866
+ @proto_payload = args[:proto_payload] if args.key?(:proto_payload)
883
867
  end
884
868
  end
885
869
 
886
- # Result returned from ListLogs.
887
- class ListLogsResponse
870
+ # Specifies a location in a source code file.
871
+ class SourceLocation
888
872
  include Google::Apis::Core::Hashable
889
873
 
890
- # A list of log names. For example, "projects/my-project/syslog" or "
891
- # organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
892
- # Corresponds to the JSON property `logNames`
893
- # @return [Array<String>]
894
- attr_accessor :log_names
874
+ # Line within the source file.
875
+ # Corresponds to the JSON property `line`
876
+ # @return [String]
877
+ attr_accessor :line
895
878
 
896
- # If there might be more results than those appearing in this response, then
897
- # nextPageToken is included. To get the next set of results, call this method
898
- # again using the value of nextPageToken as pageToken.
899
- # Corresponds to the JSON property `nextPageToken`
879
+ # Source file name. Depending on the runtime environment, this might be a simple
880
+ # name or a fully-qualified name.
881
+ # Corresponds to the JSON property `file`
900
882
  # @return [String]
901
- attr_accessor :next_page_token
883
+ attr_accessor :file
884
+
885
+ # Human-readable name of the function or method being invoked, with optional
886
+ # context such as the class or package name. This information is used in
887
+ # contexts such as the logs viewer, where a file and line number are less
888
+ # meaningful. The format can vary by language. For example: qual.if.ied.Class.
889
+ # method (Java), dir/package.func (Go), function (Python).
890
+ # Corresponds to the JSON property `functionName`
891
+ # @return [String]
892
+ attr_accessor :function_name
902
893
 
903
894
  def initialize(**args)
904
895
  update!(**args)
@@ -906,26 +897,65 @@ module Google
906
897
 
907
898
  # Update properties of this object
908
899
  def update!(**args)
909
- @log_names = args[:log_names] if args.key?(:log_names)
910
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
900
+ @line = args[:line] if args.key?(:line)
901
+ @file = args[:file] if args.key?(:file)
902
+ @function_name = args[:function_name] if args.key?(:function_name)
911
903
  end
912
904
  end
913
905
 
914
- # Result returned from ListSinks.
915
- class ListSinksResponse
906
+ # The parameters to ListLogEntries.
907
+ class ListLogEntriesRequest
916
908
  include Google::Apis::Core::Hashable
917
909
 
918
- # A list of sinks.
919
- # Corresponds to the JSON property `sinks`
920
- # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
921
- attr_accessor :sinks
910
+ # Optional. How the results should be sorted. Presently, the only permitted
911
+ # values are "timestamp asc" (default) and "timestamp desc". The first option
912
+ # returns entries in order of increasing values of LogEntry.timestamp (oldest
913
+ # first), and the second option returns entries in order of decreasing
914
+ # timestamps (newest first). Entries with equal timestamps are returned in order
915
+ # of LogEntry.insertId.
916
+ # Corresponds to the JSON property `orderBy`
917
+ # @return [String]
918
+ attr_accessor :order_by
922
919
 
923
- # If there might be more results than appear in this response, then
924
- # nextPageToken is included. To get the next set of results, call the same
925
- # method again using the value of nextPageToken as pageToken.
926
- # Corresponds to the JSON property `nextPageToken`
920
+ # Required. Names of one or more resources from which to retrieve log entries:
921
+ # "projects/[PROJECT_ID]"
922
+ # "organizations/[ORGANIZATION_ID]"
923
+ # Projects listed in the project_ids field are added to this list.
924
+ # Corresponds to the JSON property `resourceNames`
925
+ # @return [Array<String>]
926
+ attr_accessor :resource_names
927
+
928
+ # Optional. A filter that chooses which log entries to return. See Advanced Logs
929
+ # Filters. Only log entries that match the filter are returned. An empty filter
930
+ # matches all log entries in the resources listed in resource_names. Referencing
931
+ # a parent resource that is not listed in resource_names will cause the filter
932
+ # to return no results. The maximum length of the filter is 20000 characters.
933
+ # Corresponds to the JSON property `filter`
927
934
  # @return [String]
928
- attr_accessor :next_page_token
935
+ attr_accessor :filter
936
+
937
+ # Deprecated. Use resource_names instead. One or more project identifiers or
938
+ # project numbers from which to retrieve log entries. Example: "my-project-1A".
939
+ # If present, these project identifiers are converted to resource name format
940
+ # and added to the list of resources in resource_names.
941
+ # Corresponds to the JSON property `projectIds`
942
+ # @return [Array<String>]
943
+ attr_accessor :project_ids
944
+
945
+ # Optional. If present, then retrieve the next batch of results from the
946
+ # preceding call to this method. pageToken must be the value of nextPageToken
947
+ # from the previous response. The values of other method parameters should be
948
+ # identical to those in the previous call.
949
+ # Corresponds to the JSON property `pageToken`
950
+ # @return [String]
951
+ attr_accessor :page_token
952
+
953
+ # Optional. The maximum number of results to return from this request. Non-
954
+ # positive values are ignored. The presence of nextPageToken in the response
955
+ # indicates that more results might be available.
956
+ # Corresponds to the JSON property `pageSize`
957
+ # @return [Fixnum]
958
+ attr_accessor :page_size
929
959
 
930
960
  def initialize(**args)
931
961
  update!(**args)
@@ -933,240 +963,196 @@ module Google
933
963
 
934
964
  # Update properties of this object
935
965
  def update!(**args)
936
- @sinks = args[:sinks] if args.key?(:sinks)
937
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
966
+ @order_by = args[:order_by] if args.key?(:order_by)
967
+ @resource_names = args[:resource_names] if args.key?(:resource_names)
968
+ @filter = args[:filter] if args.key?(:filter)
969
+ @project_ids = args[:project_ids] if args.key?(:project_ids)
970
+ @page_token = args[:page_token] if args.key?(:page_token)
971
+ @page_size = args[:page_size] if args.key?(:page_size)
938
972
  end
939
973
  end
940
974
 
941
- # A common proto for logging HTTP requests. Only contains semantics defined by
942
- # the HTTP specification. Product-specific logging information MUST be defined
943
- # in a separate message.
944
- class HttpRequest
975
+ # Complete log information about a single HTTP request to an App Engine
976
+ # application.
977
+ class RequestLog
945
978
  include Google::Apis::Core::Hashable
946
979
 
947
- # The size of the HTTP request message in bytes, including the request headers
948
- # and the request body.
949
- # Corresponds to the JSON property `requestSize`
950
- # @return [String]
951
- attr_accessor :request_size
952
-
953
- # The size of the HTTP response message sent back to the client, in bytes,
954
- # including the response headers and the response body.
955
- # Corresponds to the JSON property `responseSize`
980
+ # Version of the application that handled this request.
981
+ # Corresponds to the JSON property `versionId`
956
982
  # @return [String]
957
- attr_accessor :response_size
983
+ attr_accessor :version_id
958
984
 
959
- # The scheme (http, https), the host name, the path and the query portion of the
960
- # URL that was requested. Example: "http://example.com/some/info?color=red".
961
- # Corresponds to the JSON property `requestUrl`
985
+ # Module of the application that handled this request.
986
+ # Corresponds to the JSON property `moduleId`
962
987
  # @return [String]
963
- attr_accessor :request_url
988
+ attr_accessor :module_id
964
989
 
965
- # The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
966
- # Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
967
- # Corresponds to the JSON property `remoteIp`
990
+ # Time when the request finished.
991
+ # Corresponds to the JSON property `endTime`
968
992
  # @return [String]
969
- attr_accessor :remote_ip
993
+ attr_accessor :end_time
970
994
 
971
- # The IP address (IPv4 or IPv6) of the origin server that the request was sent
972
- # to.
973
- # Corresponds to the JSON property `serverIp`
995
+ # User agent that made the request.
996
+ # Corresponds to the JSON property `userAgent`
974
997
  # @return [String]
975
- attr_accessor :server_ip
976
-
977
- # Whether or not a cache lookup was attempted.
978
- # Corresponds to the JSON property `cacheLookup`
979
- # @return [Boolean]
980
- attr_accessor :cache_lookup
981
- alias_method :cache_lookup?, :cache_lookup
982
-
983
- # Whether or not an entity was served from cache (with or without validation).
984
- # Corresponds to the JSON property `cacheHit`
985
- # @return [Boolean]
986
- attr_accessor :cache_hit
987
- alias_method :cache_hit?, :cache_hit
998
+ attr_accessor :user_agent
988
999
 
989
- # Whether or not the response was validated with the origin server before being
990
- # served from cache. This field is only meaningful if cache_hit is True.
991
- # Corresponds to the JSON property `cacheValidatedWithOriginServer`
1000
+ # Whether this was a loading request for the instance.
1001
+ # Corresponds to the JSON property `wasLoadingRequest`
992
1002
  # @return [Boolean]
993
- attr_accessor :cache_validated_with_origin_server
994
- alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
1003
+ attr_accessor :was_loading_request
1004
+ alias_method :was_loading_request?, :was_loading_request
995
1005
 
996
- # The response code indicating the status of response. Examples: 200, 404.
997
- # Corresponds to the JSON property `status`
998
- # @return [Fixnum]
999
- attr_accessor :status
1006
+ # Source code for the application that handled this request. There can be more
1007
+ # than one source reference per deployed application if source code is
1008
+ # distributed among multiple repositories.
1009
+ # Corresponds to the JSON property `sourceReference`
1010
+ # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
1011
+ attr_accessor :source_reference
1000
1012
 
1001
- # The referer URL of the request, as defined in HTTP/1.1 Header Field
1002
- # Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
1003
- # Corresponds to the JSON property `referer`
1013
+ # Size in bytes sent back to client by request.
1014
+ # Corresponds to the JSON property `responseSize`
1004
1015
  # @return [String]
1005
- attr_accessor :referer
1016
+ attr_accessor :response_size
1006
1017
 
1007
- # The request processing latency on the server, from the time the request was
1008
- # received until the response was sent.
1009
- # Corresponds to the JSON property `latency`
1018
+ # Stackdriver Trace identifier for this request.
1019
+ # Corresponds to the JSON property `traceId`
1010
1020
  # @return [String]
1011
- attr_accessor :latency
1021
+ attr_accessor :trace_id
1012
1022
 
1013
- # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0;
1014
- # Windows 98; Q312461; .NET CLR 1.0.3705)".
1015
- # Corresponds to the JSON property `userAgent`
1016
- # @return [String]
1017
- attr_accessor :user_agent
1023
+ # A list of log lines emitted by the application while serving this request.
1024
+ # Corresponds to the JSON property `line`
1025
+ # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
1026
+ attr_accessor :line
1018
1027
 
1019
- # The number of HTTP response bytes inserted into cache. Set only when a cache
1020
- # fill was attempted.
1021
- # Corresponds to the JSON property `cacheFillBytes`
1028
+ # Referrer URL of request.
1029
+ # Corresponds to the JSON property `referrer`
1022
1030
  # @return [String]
1023
- attr_accessor :cache_fill_bytes
1031
+ attr_accessor :referrer
1024
1032
 
1025
- # The request method. Examples: "GET", "HEAD", "PUT", "POST".
1026
- # Corresponds to the JSON property `requestMethod`
1033
+ # Queue name of the request, in the case of an offline request.
1034
+ # Corresponds to the JSON property `taskQueueName`
1027
1035
  # @return [String]
1028
- attr_accessor :request_method
1029
-
1030
- def initialize(**args)
1031
- update!(**args)
1032
- end
1033
-
1034
- # Update properties of this object
1035
- def update!(**args)
1036
- @request_size = args[:request_size] if args.key?(:request_size)
1037
- @response_size = args[:response_size] if args.key?(:response_size)
1038
- @request_url = args[:request_url] if args.key?(:request_url)
1039
- @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
1040
- @server_ip = args[:server_ip] if args.key?(:server_ip)
1041
- @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
1042
- @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
1043
- @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
1044
- @status = args[:status] if args.key?(:status)
1045
- @referer = args[:referer] if args.key?(:referer)
1046
- @latency = args[:latency] if args.key?(:latency)
1047
- @user_agent = args[:user_agent] if args.key?(:user_agent)
1048
- @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
1049
- @request_method = args[:request_method] if args.key?(:request_method)
1050
- end
1051
- end
1036
+ attr_accessor :task_queue_name
1052
1037
 
1053
- # A description of a label.
1054
- class LabelDescriptor
1055
- include Google::Apis::Core::Hashable
1038
+ # Globally unique identifier for a request, which is based on the request start
1039
+ # time. Request IDs for requests which started later will compare greater as
1040
+ # strings than those for requests which started earlier.
1041
+ # Corresponds to the JSON property `requestId`
1042
+ # @return [String]
1043
+ attr_accessor :request_id
1056
1044
 
1057
- # A human-readable description for the label.
1058
- # Corresponds to the JSON property `description`
1045
+ # The logged-in user who made the request.Most likely, this is the part of the
1046
+ # user's email before the @ sign. The field value is the same for different
1047
+ # requests from the same user, but different users can have similar names. This
1048
+ # information is also available to the application via the App Engine Users API.
1049
+ # This field will be populated starting with App Engine 1.9.21.
1050
+ # Corresponds to the JSON property `nickname`
1059
1051
  # @return [String]
1060
- attr_accessor :description
1052
+ attr_accessor :nickname
1061
1053
 
1062
- # The type of data that can be assigned to the label.
1063
- # Corresponds to the JSON property `valueType`
1054
+ # Contains the path and query portion of the URL that was requested. For example,
1055
+ # if the URL was "http://example.com/app?name=val", the resource would be "/app?
1056
+ # name=val". The fragment identifier, which is identified by the # character, is
1057
+ # not included.
1058
+ # Corresponds to the JSON property `resource`
1064
1059
  # @return [String]
1065
- attr_accessor :value_type
1060
+ attr_accessor :resource
1066
1061
 
1067
- # The label key.
1068
- # Corresponds to the JSON property `key`
1062
+ # Time this request spent in the pending request queue.
1063
+ # Corresponds to the JSON property `pendingTime`
1069
1064
  # @return [String]
1070
- attr_accessor :key
1065
+ attr_accessor :pending_time
1071
1066
 
1072
- def initialize(**args)
1073
- update!(**args)
1074
- end
1067
+ # HTTP response status code. Example: 200, 404.
1068
+ # Corresponds to the JSON property `status`
1069
+ # @return [Fixnum]
1070
+ attr_accessor :status
1075
1071
 
1076
- # Update properties of this object
1077
- def update!(**args)
1078
- @description = args[:description] if args.key?(:description)
1079
- @value_type = args[:value_type] if args.key?(:value_type)
1080
- @key = args[:key] if args.key?(:key)
1081
- end
1082
- end
1072
+ # Task name of the request, in the case of an offline request.
1073
+ # Corresponds to the JSON property `taskName`
1074
+ # @return [String]
1075
+ attr_accessor :task_name
1083
1076
 
1084
- # An object that describes the schema of a MonitoredResource object using a type
1085
- # name and a set of labels. For example, the monitored resource descriptor for
1086
- # Google Compute Engine VM instances has a type of "gce_instance" and specifies
1087
- # the use of the labels "instance_id" and "zone" to identify particular VM
1088
- # instances.Different APIs can support different monitored resource types. APIs
1089
- # generally provide a list method that returns the monitored resource
1090
- # descriptors used by the API.
1091
- class MonitoredResourceDescriptor
1092
- include Google::Apis::Core::Hashable
1077
+ # File or class that handled the request.
1078
+ # Corresponds to the JSON property `urlMapEntry`
1079
+ # @return [String]
1080
+ attr_accessor :url_map_entry
1093
1081
 
1094
- # Required. The monitored resource type. For example, the type "
1095
- # cloudsql_database" represents databases in Google Cloud SQL. The maximum
1096
- # length of this value is 256 characters.
1097
- # Corresponds to the JSON property `type`
1082
+ # If the instance processing this request belongs to a manually scaled module,
1083
+ # then this is the 0-based index of the instance. Otherwise, this value is -1.
1084
+ # Corresponds to the JSON property `instanceIndex`
1085
+ # @return [Fixnum]
1086
+ attr_accessor :instance_index
1087
+
1088
+ # Internet host and port number of the resource being requested.
1089
+ # Corresponds to the JSON property `host`
1098
1090
  # @return [String]
1099
- attr_accessor :type
1091
+ attr_accessor :host
1100
1092
 
1101
- # Required. A set of labels used to describe instances of this monitored
1102
- # resource type. For example, an individual Google Cloud SQL database is
1103
- # identified by values for the labels "database_id" and "zone".
1104
- # Corresponds to the JSON property `labels`
1105
- # @return [Array<Google::Apis::LoggingV2beta1::LabelDescriptor>]
1106
- attr_accessor :labels
1093
+ # Whether this request is finished or active.
1094
+ # Corresponds to the JSON property `finished`
1095
+ # @return [Boolean]
1096
+ attr_accessor :finished
1097
+ alias_method :finished?, :finished
1107
1098
 
1108
- # Optional. The resource name of the monitored resource descriptor: "projects/`
1109
- # project_id`/monitoredResourceDescriptors/`type`" where `type` is the value of
1110
- # the type field in this object and `project_id` is a project ID that provides
1111
- # API-specific context for accessing the type. APIs that do not use project
1112
- # information can use the resource name format "monitoredResourceDescriptors/`
1113
- # type`".
1114
- # Corresponds to the JSON property `name`
1099
+ # HTTP version of request. Example: "HTTP/1.1".
1100
+ # Corresponds to the JSON property `httpVersion`
1115
1101
  # @return [String]
1116
- attr_accessor :name
1102
+ attr_accessor :http_version
1117
1103
 
1118
- # Optional. A concise name for the monitored resource type that might be
1119
- # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
1120
- # any article or other determiners. For example, "Google Cloud SQL Database".
1121
- # Corresponds to the JSON property `displayName`
1104
+ # Time when the request started.
1105
+ # Corresponds to the JSON property `startTime`
1122
1106
  # @return [String]
1123
- attr_accessor :display_name
1107
+ attr_accessor :start_time
1124
1108
 
1125
- # Optional. A detailed description of the monitored resource type that might be
1126
- # used in documentation.
1127
- # Corresponds to the JSON property `description`
1109
+ # Latency of the request.
1110
+ # Corresponds to the JSON property `latency`
1128
1111
  # @return [String]
1129
- attr_accessor :description
1112
+ attr_accessor :latency
1130
1113
 
1131
- def initialize(**args)
1132
- update!(**args)
1133
- end
1114
+ # Origin IP address.
1115
+ # Corresponds to the JSON property `ip`
1116
+ # @return [String]
1117
+ attr_accessor :ip
1134
1118
 
1135
- # Update properties of this object
1136
- def update!(**args)
1137
- @type = args[:type] if args.key?(:type)
1138
- @labels = args[:labels] if args.key?(:labels)
1139
- @name = args[:name] if args.key?(:name)
1140
- @display_name = args[:display_name] if args.key?(:display_name)
1141
- @description = args[:description] if args.key?(:description)
1142
- end
1143
- end
1119
+ # Application that handled this request.
1120
+ # Corresponds to the JSON property `appId`
1121
+ # @return [String]
1122
+ attr_accessor :app_id
1144
1123
 
1145
- # Additional information about the source code location that produced the log
1146
- # entry.
1147
- class LogEntrySourceLocation
1148
- include Google::Apis::Core::Hashable
1124
+ # App Engine release version.
1125
+ # Corresponds to the JSON property `appEngineRelease`
1126
+ # @return [String]
1127
+ attr_accessor :app_engine_release
1149
1128
 
1150
- # Optional. Source file name. Depending on the runtime environment, this might
1151
- # be a simple name or a fully-qualified name.
1152
- # Corresponds to the JSON property `file`
1129
+ # Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE".
1130
+ # Corresponds to the JSON property `method`
1153
1131
  # @return [String]
1154
- attr_accessor :file
1132
+ attr_accessor :method_prop
1155
1133
 
1156
- # Optional. Human-readable name of the function or method being invoked, with
1157
- # optional context such as the class or package name. This information may be
1158
- # used in contexts such as the logs viewer, where a file and line number are
1159
- # less meaningful. The format can vary by language. For example: qual.if.ied.
1160
- # Class.method (Java), dir/package.func (Go), function (Python).
1161
- # Corresponds to the JSON property `function`
1134
+ # An indication of the relative cost of serving this request.
1135
+ # Corresponds to the JSON property `cost`
1136
+ # @return [Float]
1137
+ attr_accessor :cost
1138
+
1139
+ # An identifier for the instance that handled the request.
1140
+ # Corresponds to the JSON property `instanceId`
1162
1141
  # @return [String]
1163
- attr_accessor :function
1142
+ attr_accessor :instance_id
1164
1143
 
1165
- # Optional. Line within the source file. 1-based; 0 indicates no line number
1166
- # available.
1167
- # Corresponds to the JSON property `line`
1144
+ # Number of CPU megacycles used to process request.
1145
+ # Corresponds to the JSON property `megaCycles`
1168
1146
  # @return [String]
1169
- attr_accessor :line
1147
+ attr_accessor :mega_cycles
1148
+
1149
+ # Whether this is the first RequestLog entry for this request. If an active
1150
+ # request has several RequestLog entries written to Stackdriver Logging, then
1151
+ # this field will be set for one of them.
1152
+ # Corresponds to the JSON property `first`
1153
+ # @return [Boolean]
1154
+ attr_accessor :first
1155
+ alias_method :first?, :first
1170
1156
 
1171
1157
  def initialize(**args)
1172
1158
  update!(**args)
@@ -1174,30 +1160,53 @@ module Google
1174
1160
 
1175
1161
  # Update properties of this object
1176
1162
  def update!(**args)
1177
- @file = args[:file] if args.key?(:file)
1178
- @function = args[:function] if args.key?(:function)
1163
+ @version_id = args[:version_id] if args.key?(:version_id)
1164
+ @module_id = args[:module_id] if args.key?(:module_id)
1165
+ @end_time = args[:end_time] if args.key?(:end_time)
1166
+ @user_agent = args[:user_agent] if args.key?(:user_agent)
1167
+ @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
1168
+ @source_reference = args[:source_reference] if args.key?(:source_reference)
1169
+ @response_size = args[:response_size] if args.key?(:response_size)
1170
+ @trace_id = args[:trace_id] if args.key?(:trace_id)
1179
1171
  @line = args[:line] if args.key?(:line)
1172
+ @referrer = args[:referrer] if args.key?(:referrer)
1173
+ @task_queue_name = args[:task_queue_name] if args.key?(:task_queue_name)
1174
+ @request_id = args[:request_id] if args.key?(:request_id)
1175
+ @nickname = args[:nickname] if args.key?(:nickname)
1176
+ @resource = args[:resource] if args.key?(:resource)
1177
+ @pending_time = args[:pending_time] if args.key?(:pending_time)
1178
+ @status = args[:status] if args.key?(:status)
1179
+ @task_name = args[:task_name] if args.key?(:task_name)
1180
+ @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
1181
+ @instance_index = args[:instance_index] if args.key?(:instance_index)
1182
+ @host = args[:host] if args.key?(:host)
1183
+ @finished = args[:finished] if args.key?(:finished)
1184
+ @http_version = args[:http_version] if args.key?(:http_version)
1185
+ @start_time = args[:start_time] if args.key?(:start_time)
1186
+ @latency = args[:latency] if args.key?(:latency)
1187
+ @ip = args[:ip] if args.key?(:ip)
1188
+ @app_id = args[:app_id] if args.key?(:app_id)
1189
+ @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
1190
+ @method_prop = args[:method_prop] if args.key?(:method_prop)
1191
+ @cost = args[:cost] if args.key?(:cost)
1192
+ @instance_id = args[:instance_id] if args.key?(:instance_id)
1193
+ @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
1194
+ @first = args[:first] if args.key?(:first)
1180
1195
  end
1181
1196
  end
1182
1197
 
1183
- # Result returned from ListLogEntries.
1184
- class ListLogEntriesResponse
1198
+ # Result returned from ListMonitoredResourceDescriptors.
1199
+ class ListMonitoredResourceDescriptorsResponse
1185
1200
  include Google::Apis::Core::Hashable
1186
1201
 
1187
- # A list of log entries.
1188
- # Corresponds to the JSON property `entries`
1189
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
1190
- attr_accessor :entries
1202
+ # A list of resource descriptors.
1203
+ # Corresponds to the JSON property `resourceDescriptors`
1204
+ # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
1205
+ attr_accessor :resource_descriptors
1191
1206
 
1192
1207
  # If there might be more results than those appearing in this response, then
1193
1208
  # nextPageToken is included. To get the next set of results, call this method
1194
- # again using the value of nextPageToken as pageToken.If a value for
1195
- # next_page_token appears and the entries field is empty, it means that the
1196
- # search found no log entries so far but it did not have time to search all the
1197
- # possible log entries. Retry the method with this value for page_token to
1198
- # continue the search. Alternatively, consider speeding up the search by
1199
- # changing your filter to specify a single log name or resource type, or to
1200
- # narrow the time range of the search.
1209
+ # again using the value of nextPageToken as pageToken.
1201
1210
  # Corresponds to the JSON property `nextPageToken`
1202
1211
  # @return [String]
1203
1212
  attr_accessor :next_page_token
@@ -1208,34 +1217,27 @@ module Google
1208
1217
 
1209
1218
  # Update properties of this object
1210
1219
  def update!(**args)
1211
- @entries = args[:entries] if args.key?(:entries)
1220
+ @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
1212
1221
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1213
1222
  end
1214
1223
  end
1215
1224
 
1216
- # Application log line emitted while processing a request.
1217
- class LogLine
1225
+ # A reference to a particular snapshot of the source tree used to build and
1226
+ # deploy an application.
1227
+ class SourceReference
1218
1228
  include Google::Apis::Core::Hashable
1219
1229
 
1220
- # Severity of this log entry.
1221
- # Corresponds to the JSON property `severity`
1222
- # @return [String]
1223
- attr_accessor :severity
1224
-
1225
- # App-provided log message.
1226
- # Corresponds to the JSON property `logMessage`
1230
+ # Optional. A URI string identifying the repository. Example: "https://github.
1231
+ # com/GoogleCloudPlatform/kubernetes.git"
1232
+ # Corresponds to the JSON property `repository`
1227
1233
  # @return [String]
1228
- attr_accessor :log_message
1229
-
1230
- # Specifies a location in a source code file.
1231
- # Corresponds to the JSON property `sourceLocation`
1232
- # @return [Google::Apis::LoggingV2beta1::SourceLocation]
1233
- attr_accessor :source_location
1234
+ attr_accessor :repository
1234
1235
 
1235
- # Approximate time when this log entry was made.
1236
- # Corresponds to the JSON property `time`
1236
+ # The canonical and persistent identifier of the deployed revision. Example (git)
1237
+ # : "0035781c50ec7aa23385dc841529ce8a4b70db1b"
1238
+ # Corresponds to the JSON property `revisionId`
1237
1239
  # @return [String]
1238
- attr_accessor :time
1240
+ attr_accessor :revision_id
1239
1241
 
1240
1242
  def initialize(**args)
1241
1243
  update!(**args)
@@ -1243,10 +1245,8 @@ module Google
1243
1245
 
1244
1246
  # Update properties of this object
1245
1247
  def update!(**args)
1246
- @severity = args[:severity] if args.key?(:severity)
1247
- @log_message = args[:log_message] if args.key?(:log_message)
1248
- @source_location = args[:source_location] if args.key?(:source_location)
1249
- @time = args[:time] if args.key?(:time)
1248
+ @repository = args[:repository] if args.key?(:repository)
1249
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
1250
1250
  end
1251
1251
  end
1252
1252
  end