google-api-client 0.9.15 → 0.9.18

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 (119) hide show
  1. checksums.yaml +4 -4
  2. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +35 -0
  3. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +298 -0
  4. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +122 -0
  5. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +458 -0
  6. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  7. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +82 -3
  8. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +33 -0
  9. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +38 -0
  10. data/generated/google/apis/admin_directory_v1.rb +1 -1
  11. data/generated/google/apis/admin_directory_v1/classes.rb +80 -0
  12. data/generated/google/apis/admin_directory_v1/representations.rb +23 -0
  13. data/generated/google/apis/admin_directory_v1/service.rb +39 -0
  14. data/generated/google/apis/adsense_v1_4.rb +1 -1
  15. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  16. data/generated/google/apis/analytics_v3.rb +1 -1
  17. data/generated/google/apis/analytics_v3/classes.rb +11 -5
  18. data/generated/google/apis/analytics_v3/representations.rb +1 -0
  19. data/generated/google/apis/analytics_v3/service.rb +17 -18
  20. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  21. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  22. data/generated/google/apis/androidenterprise_v1/classes.rb +80 -2
  23. data/generated/google/apis/androidenterprise_v1/representations.rb +30 -0
  24. data/generated/google/apis/androidenterprise_v1/service.rb +55 -6
  25. data/generated/google/apis/androidpublisher_v2.rb +1 -1
  26. data/generated/google/apis/appengine_v1beta5.rb +1 -1
  27. data/generated/google/apis/appengine_v1beta5/classes.rb +1 -1
  28. data/generated/google/apis/appengine_v1beta5/service.rb +36 -0
  29. data/generated/google/apis/appsactivity_v1.rb +1 -1
  30. data/generated/google/apis/bigquery_v2.rb +1 -1
  31. data/generated/google/apis/bigquery_v2/classes.rb +2 -2
  32. data/generated/google/apis/books_v1.rb +1 -1
  33. data/generated/google/apis/books_v1/classes.rb +2 -1
  34. data/generated/google/apis/calendar_v3.rb +1 -1
  35. data/generated/google/apis/classroom_v1.rb +1 -1
  36. data/generated/google/apis/classroom_v1/classes.rb +7 -0
  37. data/generated/google/apis/classroom_v1/representations.rb +1 -0
  38. data/generated/google/apis/classroom_v1/service.rb +25 -15
  39. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  40. data/generated/google/apis/cloudbuild_v1/classes.rb +56 -8
  41. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  42. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +535 -298
  43. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +141 -36
  44. data/generated/google/apis/cloudresourcemanager_v1/service.rb +250 -45
  45. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  46. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +99 -4
  47. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +44 -0
  48. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +24 -33
  49. data/generated/google/apis/compute_beta.rb +1 -1
  50. data/generated/google/apis/compute_beta/classes.rb +44 -29
  51. data/generated/google/apis/compute_beta/representations.rb +1 -0
  52. data/generated/google/apis/compute_beta/service.rb +123 -25
  53. data/generated/google/apis/compute_v1.rb +1 -1
  54. data/generated/google/apis/compute_v1/classes.rb +43 -20
  55. data/generated/google/apis/compute_v1/representations.rb +3 -0
  56. data/generated/google/apis/compute_v1/service.rb +608 -67
  57. data/generated/google/apis/content_v2.rb +1 -1
  58. data/generated/google/apis/dataflow_v1b3.rb +38 -0
  59. data/generated/google/apis/dataflow_v1b3/classes.rb +4009 -0
  60. data/generated/google/apis/dataflow_v1b3/representations.rb +1718 -0
  61. data/generated/google/apis/dataflow_v1b3/service.rb +515 -0
  62. data/generated/google/apis/datastore_v1.rb +1 -1
  63. data/generated/google/apis/dns_v1.rb +1 -1
  64. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  65. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +79 -86
  66. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +25 -28
  67. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +10 -8
  68. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  69. data/generated/google/apis/drive_v2.rb +1 -1
  70. data/generated/google/apis/drive_v2/classes.rb +9 -0
  71. data/generated/google/apis/drive_v2/representations.rb +1 -0
  72. data/generated/google/apis/drive_v2/service.rb +8 -1
  73. data/generated/google/apis/drive_v3.rb +1 -1
  74. data/generated/google/apis/drive_v3/classes.rb +7 -0
  75. data/generated/google/apis/drive_v3/representations.rb +1 -0
  76. data/generated/google/apis/drive_v3/service.rb +8 -1
  77. data/generated/google/apis/genomics_v1.rb +1 -1
  78. data/generated/google/apis/iam_v1.rb +2 -2
  79. data/generated/google/apis/iam_v1/classes.rb +181 -206
  80. data/generated/google/apis/iam_v1/representations.rb +36 -45
  81. data/generated/google/apis/iam_v1/service.rb +101 -67
  82. data/generated/google/apis/identitytoolkit_v3.rb +4 -1
  83. data/generated/google/apis/identitytoolkit_v3/classes.rb +11 -27
  84. data/generated/google/apis/identitytoolkit_v3/representations.rb +2 -16
  85. data/generated/google/apis/language_v1beta1.rb +1 -1
  86. data/generated/google/apis/language_v1beta1/classes.rb +4 -2
  87. data/generated/google/apis/language_v1beta1/service.rb +2 -4
  88. data/generated/google/apis/logging_v2beta1.rb +6 -6
  89. data/generated/google/apis/logging_v2beta1/classes.rb +742 -732
  90. data/generated/google/apis/logging_v2beta1/representations.rb +134 -147
  91. data/generated/google/apis/logging_v2beta1/service.rb +276 -209
  92. data/generated/google/apis/monitoring_v3.rb +1 -1
  93. data/generated/google/apis/monitoring_v3/classes.rb +20 -13
  94. data/generated/google/apis/monitoring_v3/service.rb +1 -1
  95. data/generated/google/apis/oauth2_v2.rb +1 -1
  96. data/generated/google/apis/plus_domains_v1.rb +1 -1
  97. data/generated/google/apis/plus_v1.rb +1 -1
  98. data/generated/google/apis/pubsub_v1.rb +1 -1
  99. data/generated/google/apis/pubsub_v1/classes.rb +10 -9
  100. data/generated/google/apis/pubsub_v1/service.rb +128 -27
  101. data/generated/google/apis/replicapoolupdater_v1beta1.rb +4 -2
  102. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +3 -1
  103. data/generated/google/apis/sheets_v4.rb +1 -1
  104. data/generated/google/apis/sheets_v4/classes.rb +2 -0
  105. data/generated/google/apis/speech_v1beta1.rb +1 -1
  106. data/generated/google/apis/speech_v1beta1/classes.rb +20 -30
  107. data/generated/google/apis/speech_v1beta1/representations.rb +6 -7
  108. data/generated/google/apis/speech_v1beta1/service.rb +68 -65
  109. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  110. data/generated/google/apis/sqladmin_v1beta4/classes.rb +6 -0
  111. data/generated/google/apis/sqladmin_v1beta4/representations.rb +1 -0
  112. data/generated/google/apis/storage_v1.rb +1 -1
  113. data/generated/google/apis/storage_v1/classes.rb +3 -3
  114. data/generated/google/apis/storage_v1/representations.rb +2 -1
  115. data/generated/google/apis/storage_v1/service.rb +5 -2
  116. data/generated/google/apis/vision_v1.rb +1 -1
  117. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  118. data/lib/google/apis/version.rb +1 -1
  119. metadata +10 -2
@@ -25,7 +25,10 @@ module Google
25
25
  # @see https://developers.google.com/identity-toolkit/v3/
26
26
  module IdentitytoolkitV3
27
27
  VERSION = 'V3'
28
- REVISION = '20160902'
28
+ REVISION = '20161010'
29
+
30
+ # View and administer all your Firebase data and settings
31
+ AUTH_FIREBASE = 'https://www.googleapis.com/auth/firebase'
29
32
  end
30
33
  end
31
34
  end
@@ -306,9 +306,11 @@ module Google
306
306
  # @return [String]
307
307
  attr_accessor :continue_uri
308
308
 
309
- # The query parameter that client can customize by themselves in auth url.
309
+ # The query parameter that client can customize by themselves in auth url. The
310
+ # following parameters are reserved for server so that they cannot be customized
311
+ # by clients: client_id, response_type, scope, redirect_uri, state, oauth_token.
310
312
  # Corresponds to the JSON property `customParameter`
311
- # @return [Array<Google::Apis::IdentitytoolkitV3::CreateAuthUriRequest::CustomParameter>]
313
+ # @return [Hash<String,String>]
312
314
  attr_accessor :custom_parameter
313
315
 
314
316
  # The hosted domain to restrict sign-in to accounts at that domain for Google
@@ -376,31 +378,6 @@ module Google
376
378
  @provider_id = args[:provider_id] if args.key?(:provider_id)
377
379
  @session_id = args[:session_id] if args.key?(:session_id)
378
380
  end
379
-
380
- #
381
- class CustomParameter
382
- include Google::Apis::Core::Hashable
383
-
384
- # The key of the query parameter.
385
- # Corresponds to the JSON property `key`
386
- # @return [String]
387
- attr_accessor :key
388
-
389
- # The value of the query parameter.
390
- # Corresponds to the JSON property `value`
391
- # @return [String]
392
- attr_accessor :value
393
-
394
- def initialize(**args)
395
- update!(**args)
396
- end
397
-
398
- # Update properties of this object
399
- def update!(**args)
400
- @key = args[:key] if args.key?(:key)
401
- @value = args[:value] if args.key?(:value)
402
- end
403
- end
404
381
  end
405
382
 
406
383
  # Request to delete account.
@@ -1011,6 +988,12 @@ module Google
1011
988
  # @return [String]
1012
989
  attr_accessor :signer_key
1013
990
 
991
+ # Specify which project (field value is actually project id) to operate. Only
992
+ # used when provided credential.
993
+ # Corresponds to the JSON property `targetProjectId`
994
+ # @return [String]
995
+ attr_accessor :target_project_id
996
+
1014
997
  # The account info to be stored.
1015
998
  # Corresponds to the JSON property `users`
1016
999
  # @return [Array<Google::Apis::IdentitytoolkitV3::UserInfo>]
@@ -1029,6 +1012,7 @@ module Google
1029
1012
  @salt_separator = args[:salt_separator] if args.key?(:salt_separator)
1030
1013
  @sanity_check = args[:sanity_check] if args.key?(:sanity_check)
1031
1014
  @signer_key = args[:signer_key] if args.key?(:signer_key)
1015
+ @target_project_id = args[:target_project_id] if args.key?(:target_project_id)
1032
1016
  @users = args[:users] if args.key?(:users)
1033
1017
  end
1034
1018
  end
@@ -66,12 +66,6 @@ module Google
66
66
 
67
67
  class CreateAuthUriRequest
68
68
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
-
70
- class CustomParameter
71
- class Representation < Google::Apis::Core::JsonRepresentation; end
72
-
73
- include Google::Apis::Core::JsonObjectSupport
74
- end
75
69
 
76
70
  include Google::Apis::Core::JsonObjectSupport
77
71
  end
@@ -322,8 +316,7 @@ module Google
322
316
  property :client_id, as: 'clientId'
323
317
  property :context, as: 'context'
324
318
  property :continue_uri, as: 'continueUri'
325
- collection :custom_parameter, as: 'customParameter', class: Google::Apis::IdentitytoolkitV3::CreateAuthUriRequest::CustomParameter, decorator: Google::Apis::IdentitytoolkitV3::CreateAuthUriRequest::CustomParameter::Representation
326
-
319
+ hash :custom_parameter, as: 'customParameter'
327
320
  property :hosted_domain, as: 'hostedDomain'
328
321
  property :identifier, as: 'identifier'
329
322
  property :oauth_consumer_key, as: 'oauthConsumerKey'
@@ -333,14 +326,6 @@ module Google
333
326
  property :provider_id, as: 'providerId'
334
327
  property :session_id, as: 'sessionId'
335
328
  end
336
-
337
- class CustomParameter
338
- # @private
339
- class Representation < Google::Apis::Core::JsonRepresentation
340
- property :key, as: 'key'
341
- property :value, as: 'value'
342
- end
343
- end
344
329
  end
345
330
 
346
331
  class DeleteAccountRequest
@@ -497,6 +482,7 @@ module Google
497
482
  property :salt_separator, :base64 => true, as: 'saltSeparator'
498
483
  property :sanity_check, as: 'sanityCheck'
499
484
  property :signer_key, :base64 => true, as: 'signerKey'
485
+ property :target_project_id, as: 'targetProjectId'
500
486
  collection :users, as: 'users', class: Google::Apis::IdentitytoolkitV3::UserInfo, decorator: Google::Apis::IdentitytoolkitV3::UserInfo::Representation
501
487
 
502
488
  end
@@ -27,7 +27,7 @@ module Google
27
27
  # @see https://cloud.google.com/natural-language/
28
28
  module LanguageV1beta1
29
29
  VERSION = 'V1beta1'
30
- REVISION = '20160912'
30
+ REVISION = '20161006'
31
31
 
32
32
  # View and manage your data across Google Cloud Platform services
33
33
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -290,8 +290,8 @@ module Google
290
290
  end
291
291
  end
292
292
 
293
- # The request message for the advanced text annotation API, which performs all
294
- # the above plus syntactic analysis.
293
+ # The request message for the text annotation API, which can perform multiple
294
+ # analysis types (sentiment, entities, and syntax) in one call.
295
295
  class AnnotateTextRequest
296
296
  include Google::Apis::Core::Hashable
297
297
 
@@ -416,6 +416,7 @@ module Google
416
416
 
417
417
  # The language of the text, which will be the same as the language specified
418
418
  # in the request or, if not specified, the automatically-detected language.
419
+ # See Document.language field for more details.
419
420
  # Corresponds to the JSON property `language`
420
421
  # @return [String]
421
422
  attr_accessor :language
@@ -577,6 +578,7 @@ module Google
577
578
 
578
579
  # The language of the text, which will be the same as the language specified
579
580
  # in the request or, if not specified, the automatically-detected language.
581
+ # See Document.language field for more details.
580
582
  # Corresponds to the JSON property `language`
581
583
  # @return [String]
582
584
  attr_accessor :language
@@ -78,10 +78,8 @@ module Google
78
78
  execute_or_queue_command(command, &block)
79
79
  end
80
80
 
81
- # Advanced API that analyzes the document and provides a full set of text
82
- # annotations, including semantic, syntactic, and sentiment information. This
83
- # API is intended for users who are familiar with machine learning and need
84
- # in-depth text features to build upon.
81
+ # A convenience method that provides all the features that analyzeSentiment,
82
+ # analyzeEntities, and analyzeSyntax provide in one call.
85
83
  # @param [Google::Apis::LanguageV1beta1::AnnotateTextRequest] annotate_text_request_object
86
84
  # @param [String] quota_user
87
85
  # Available to use for quota purposes for server-side applications. Can be any
@@ -18,14 +18,14 @@ require 'google/apis/logging_v2beta1/representations.rb'
18
18
 
19
19
  module Google
20
20
  module Apis
21
- # Google Cloud Logging API
21
+ # Stackdriver Logging API
22
22
  #
23
- # Writes log entries and manages your logs, log sinks, and logs-based metrics.
23
+ # Writes log entries and manages your Stackdriver Logging configuration.
24
24
  #
25
25
  # @see https://cloud.google.com/logging/docs/
26
26
  module LoggingV2beta1
27
27
  VERSION = 'V2beta1'
28
- REVISION = '20160322'
28
+ REVISION = '20161003'
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'
@@ -33,14 +33,14 @@ module Google
33
33
  # View your data across Google Cloud Platform services
34
34
  AUTH_CLOUD_PLATFORM_READ_ONLY = 'https://www.googleapis.com/auth/cloud-platform.read-only'
35
35
 
36
- # Administrate log data for your projects
37
- AUTH_LOGGING_ADMIN = 'https://www.googleapis.com/auth/logging.admin'
38
-
39
36
  # View log data for your projects
40
37
  AUTH_LOGGING_READ = 'https://www.googleapis.com/auth/logging.read'
41
38
 
42
39
  # Submit log data for your projects
43
40
  AUTH_LOGGING_WRITE = 'https://www.googleapis.com/auth/logging.write'
41
+
42
+ # Administrate log data for your projects
43
+ AUTH_LOGGING_ADMIN = 'https://www.googleapis.com/auth/logging.admin'
44
44
  end
45
45
  end
46
46
  end
@@ -22,70 +22,84 @@ module Google
22
22
  module Apis
23
23
  module LoggingV2beta1
24
24
 
25
- # A generic empty message that you can re-use to avoid defining duplicated empty
26
- # messages in your APIs. A typical example is to use it as the request or the
27
- # response type of an API method. For instance: service Foo ` rpc Bar(google.
28
- # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
29
- # `Empty` is empty JSON object ````.
30
- class Empty
25
+ # Result returned from `ListLogEntries`.
26
+ class ListLogEntriesResponse
31
27
  include Google::Apis::Core::Hashable
32
28
 
29
+ # A list of log entries.
30
+ # Corresponds to the JSON property `entries`
31
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
32
+ attr_accessor :entries
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
36
+ # method again using the value of `nextPageToken` as `pageToken`.
37
+ # Corresponds to the JSON property `nextPageToken`
38
+ # @return [String]
39
+ attr_accessor :next_page_token
40
+
33
41
  def initialize(**args)
34
42
  update!(**args)
35
43
  end
36
44
 
37
45
  # Update properties of this object
38
46
  def update!(**args)
47
+ @entries = args[:entries] if args.key?(:entries)
48
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
39
49
  end
40
50
  end
41
51
 
42
- # The parameters to WriteLogEntries.
43
- class WriteLogEntriesRequest
52
+ # Result returned from `ListSinks`.
53
+ class ListSinksResponse
44
54
  include Google::Apis::Core::Hashable
45
55
 
46
- # Optional. A default log resource name for those log entries in `entries` that
47
- # do not specify their own `logName`. Example: `"projects/my-project/logs/syslog"
48
- # `. See LogEntry.
49
- # Corresponds to the JSON property `logName`
56
+ # If there might be more results than appear in this response, then
57
+ # `nextPageToken` is included. To get the next set of results, call the same
58
+ # method again using the value of `nextPageToken` as `pageToken`.
59
+ # Corresponds to the JSON property `nextPageToken`
50
60
  # @return [String]
51
- attr_accessor :log_name
61
+ attr_accessor :next_page_token
52
62
 
53
- # An object representing a resource that can be used for monitoring, logging,
54
- # billing, or other purposes. Examples include virtual machine instances,
55
- # databases, and storage devices such as disks. The `type` field identifies a
56
- # MonitoredResourceDescriptor object that describes the resource's schema.
57
- # Information in the `labels` field identifies the actual resource and its
58
- # attributes according to the schema. For example, a particular Compute Engine
59
- # VM instance could be represented by the following object, because the
60
- # MonitoredResourceDescriptor for `"gce_instance"` has labels `"instance_id"`
61
- # and `"zone"`: ` "type": "gce_instance", "labels": ` "instance_id": "my-
62
- # instance", "zone": "us-central1-a" ``
63
- # Corresponds to the JSON property `resource`
64
- # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
65
- attr_accessor :resource
63
+ # A list of sinks.
64
+ # Corresponds to the JSON property `sinks`
65
+ # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
66
+ attr_accessor :sinks
66
67
 
67
- # Optional. User-defined `key:value` items that are added to the `labels` field
68
- # of each log entry in `entries`, except when a log entry specifies its own `key:
69
- # value` item with the same key. Example: `` "size": "large", "color":"red" ``
70
- # Corresponds to the JSON property `labels`
71
- # @return [Hash<String,String>]
72
- attr_accessor :labels
68
+ def initialize(**args)
69
+ update!(**args)
70
+ end
73
71
 
74
- # Required. The log entries to write. The log entries must have values for all
75
- # required fields.
76
- # Corresponds to the JSON property `entries`
77
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
78
- attr_accessor :entries
72
+ # Update properties of this object
73
+ def update!(**args)
74
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
75
+ @sinks = args[:sinks] if args.key?(:sinks)
76
+ end
77
+ end
79
78
 
80
- # Optional. Whether valid entries should be written even if some other entries
81
- # fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not
82
- # written, the response status will be the error associated with one of the
83
- # failed entries and include error details in the form of
84
- # WriteLogEntriesPartialErrors.
85
- # Corresponds to the JSON property `partialSuccess`
86
- # @return [Boolean]
87
- attr_accessor :partial_success
88
- alias_method :partial_success?, :partial_success
79
+ # Specifies a location in a source code file.
80
+ class SourceLocation
81
+ include Google::Apis::Core::Hashable
82
+
83
+ # Source file name. Depending on the runtime environment, this might be a
84
+ # simple name or a fully-qualified name.
85
+ # Corresponds to the JSON property `file`
86
+ # @return [String]
87
+ attr_accessor :file
88
+
89
+ # Human-readable name of the function or method being invoked, with optional
90
+ # context such as the class or package name. This information is used in
91
+ # contexts such as the logs viewer, where a file and line number are less
92
+ # meaningful. The format can vary by language. For example:
93
+ # `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
94
+ # (Python).
95
+ # Corresponds to the JSON property `functionName`
96
+ # @return [String]
97
+ attr_accessor :function_name
98
+
99
+ # Line within the source file.
100
+ # Corresponds to the JSON property `line`
101
+ # @return [String]
102
+ attr_accessor :line
89
103
 
90
104
  def initialize(**args)
91
105
  update!(**args)
@@ -93,40 +107,66 @@ module Google
93
107
 
94
108
  # Update properties of this object
95
109
  def update!(**args)
96
- @log_name = args[:log_name] if args.key?(:log_name)
97
- @resource = args[:resource] if args.key?(:resource)
98
- @labels = args[:labels] if args.key?(:labels)
99
- @entries = args[:entries] if args.key?(:entries)
100
- @partial_success = args[:partial_success] if args.key?(:partial_success)
110
+ @file = args[:file] if args.key?(:file)
111
+ @function_name = args[:function_name] if args.key?(:function_name)
112
+ @line = args[:line] if args.key?(:line)
101
113
  end
102
114
  end
103
115
 
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"`
112
- # and `"zone"`: ` "type": "gce_instance", "labels": ` "instance_id": "my-
113
- # instance", "zone": "us-central1-a" ``
114
- class MonitoredResource
116
+ # Describes a sink used to export log entries outside Stackdriver Logging.
117
+ class LogSink
115
118
  include Google::Apis::Core::Hashable
116
119
 
117
- # Required. The monitored resource type. This field must match the `type` field
118
- # of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL
119
- # database is `"cloudsql_database"`.
120
- # Corresponds to the JSON property `type`
120
+ # Output only. The iam identity to which the destination needs to grant write
121
+ # access. This may be a service account or a group.
122
+ # Examples (Do not assume these specific values):
123
+ # "serviceAccount:cloud-logs@system.gserviceaccount.com"
124
+ # "group:cloud-logs@google.com"
125
+ # For GCS destinations, the role "roles/owner" is required on the bucket
126
+ # For Cloud Pubsub destinations, the role "roles/pubsub.publisher" is
127
+ # required on the topic
128
+ # For BigQuery, the role "roles/editor" is required on the dataset
129
+ # Corresponds to the JSON property `writerIdentity`
130
+ # @return [String]
131
+ attr_accessor :writer_identity
132
+
133
+ # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
134
+ # Only log entries matching the filter are exported. The filter
135
+ # must be consistent with the log entry format specified by the
136
+ # `outputVersionFormat` parameter, regardless of the format of the
137
+ # log entry that was originally written to Stackdriver Logging.
138
+ # Example filter (V2 format):
139
+ # logName=projects/my-projectid/logs/syslog AND severity>=ERROR
140
+ # Corresponds to the JSON property `filter`
121
141
  # @return [String]
122
- attr_accessor :type
142
+ attr_accessor :filter
123
143
 
124
- # Required. Values for all of the labels listed in the associated monitored
125
- # resource descriptor. For example, Cloud SQL databases use the labels `"
126
- # database_id"` and `"zone"`.
127
- # Corresponds to the JSON property `labels`
128
- # @return [Hash<String,String>]
129
- attr_accessor :labels
144
+ # Required. The export destination. See
145
+ # [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
146
+ # Examples:
147
+ # "storage.googleapis.com/my-gcs-bucket"
148
+ # "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
149
+ # "pubsub.googleapis.com/projects/my-project/topics/my-topic"
150
+ # Corresponds to the JSON property `destination`
151
+ # @return [String]
152
+ attr_accessor :destination
153
+
154
+ # Optional. The log entry version to use for this sink's exported log
155
+ # entries. This version does not have to correspond to the version of the
156
+ # log entry that was written to Stackdriver Logging. If omitted, the
157
+ # v2 format is used.
158
+ # Corresponds to the JSON property `outputVersionFormat`
159
+ # @return [String]
160
+ attr_accessor :output_version_format
161
+
162
+ # Required. The client-assigned sink identifier, unique within the
163
+ # project. Example: `"my-syslog-errors-to-pubsub"`. Sink identifiers are
164
+ # limited to 1000 characters and can include only the following characters:
165
+ # `A-Z`, `a-z`, `0-9`, and the special characters `_-.`. The maximum length
166
+ # of the name is 100 characters.
167
+ # Corresponds to the JSON property `name`
168
+ # @return [String]
169
+ attr_accessor :name
130
170
 
131
171
  def initialize(**args)
132
172
  update!(**args)
@@ -134,8 +174,59 @@ module Google
134
174
 
135
175
  # Update properties of this object
136
176
  def update!(**args)
137
- @type = args[:type] if args.key?(:type)
138
- @labels = args[:labels] if args.key?(:labels)
177
+ @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
178
+ @filter = args[:filter] if args.key?(:filter)
179
+ @destination = args[:destination] if args.key?(:destination)
180
+ @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
181
+ @name = args[:name] if args.key?(:name)
182
+ end
183
+ end
184
+
185
+ # Describes a logs-based metric. The value of the metric is the
186
+ # number of log entries that match a logs filter.
187
+ class LogMetric
188
+ include Google::Apis::Core::Hashable
189
+
190
+ # Optional. A description of this metric, which is used in documentation.
191
+ # Corresponds to the JSON property `description`
192
+ # @return [String]
193
+ attr_accessor :description
194
+
195
+ # Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
196
+ # Example: `"resource.type=gae_app AND severity>=ERROR"`.
197
+ # Corresponds to the JSON property `filter`
198
+ # @return [String]
199
+ attr_accessor :filter
200
+
201
+ # Required. The client-assigned metric identifier. Example:
202
+ # `"severe_errors"`. Metric identifiers are limited to 100
203
+ # characters and can include only the following characters: `A-Z`,
204
+ # `a-z`, `0-9`, and the special characters `_-.,+!*',()%/`. The
205
+ # forward-slash character (`/`) denotes a hierarchy of name pieces,
206
+ # and it cannot be the first character of the name. The '%' character
207
+ # is used to URL encode unsafe and reserved characters and must be
208
+ # followed by two hexadecimal digits according to RFC 1738.
209
+ # Corresponds to the JSON property `name`
210
+ # @return [String]
211
+ attr_accessor :name
212
+
213
+ # Output only. The API version that created or updated this metric.
214
+ # The version also dictates the syntax of the filter expression. When a value
215
+ # for this field is missing, the default value of V2 should be assumed.
216
+ # Corresponds to the JSON property `version`
217
+ # @return [String]
218
+ attr_accessor :version
219
+
220
+ def initialize(**args)
221
+ update!(**args)
222
+ end
223
+
224
+ # Update properties of this object
225
+ def update!(**args)
226
+ @description = args[:description] if args.key?(:description)
227
+ @filter = args[:filter] if args.key?(:filter)
228
+ @name = args[:name] if args.key?(:name)
229
+ @version = args[:version] if args.key?(:version)
139
230
  end
140
231
  end
141
232
 
@@ -143,82 +234,90 @@ module Google
143
234
  class LogEntry
144
235
  include Google::Apis::Core::Hashable
145
236
 
146
- # Required. The resource name of the log to which this log entry belongs. The
147
- # format of the name is `"projects/
148
- # /logs/"`. Examples: `"projects/my-projectid/logs/syslog"`, `"projects/
149
- # 1234567890/logs/library.googleapis.com%2Fbook_log"`. The log ID part of
150
- # resource name must be less than 512 characters long and can only include the
151
- # following characters: upper and lower case alphanumeric characters: [A-Za-z0-9]
152
- # ; and punctuation characters: forward-slash, underscore, hyphen, and period.
237
+ # The log entry payload, represented as a Unicode string (UTF-8).
238
+ # Corresponds to the JSON property `textPayload`
239
+ # @return [String]
240
+ attr_accessor :text_payload
241
+
242
+ # A common proto for logging HTTP requests. Only contains semantics
243
+ # defined by the HTTP specification. Product-specific logging
244
+ # information MUST be defined in a separate message.
245
+ # Corresponds to the JSON property `httpRequest`
246
+ # @return [Google::Apis::LoggingV2beta1::HttpRequest]
247
+ attr_accessor :http_request
248
+
249
+ # The log entry payload, represented as a structure that
250
+ # is expressed as a JSON object.
251
+ # Corresponds to the JSON property `jsonPayload`
252
+ # @return [Hash<String,Object>]
253
+ attr_accessor :json_payload
254
+
255
+ # Optional. A set of user-defined (key, value) data that provides additional
256
+ # information about the log entry.
257
+ # Corresponds to the JSON property `labels`
258
+ # @return [Hash<String,String>]
259
+ attr_accessor :labels
260
+
261
+ # Required. The resource name of the log to which this log entry
262
+ # belongs. The format of the name is
263
+ # `"projects/<project-id>/logs/<log-id>"`. Examples:
264
+ # `"projects/my-projectid/logs/syslog"`,
265
+ # `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
266
+ # The log ID part of resource name must be less than 512 characters
267
+ # long and can only include the following characters: upper and
268
+ # lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
269
+ # characters: forward-slash, underscore, hyphen, and period.
153
270
  # Forward-slash (`/`) characters in the log ID must be URL-encoded.
154
271
  # Corresponds to the JSON property `logName`
155
272
  # @return [String]
156
273
  attr_accessor :log_name
157
274
 
275
+ # Optional. The severity of the log entry. The default value is
276
+ # `LogSeverity.DEFAULT`.
277
+ # Corresponds to the JSON property `severity`
278
+ # @return [String]
279
+ attr_accessor :severity
280
+
158
281
  # An object representing a resource that can be used for monitoring, logging,
159
282
  # billing, or other purposes. Examples include virtual machine instances,
160
283
  # databases, and storage devices such as disks. The `type` field identifies a
161
- # MonitoredResourceDescriptor object that describes the resource's schema.
162
- # Information in the `labels` field identifies the actual resource and its
163
- # attributes according to the schema. For example, a particular Compute Engine
164
- # VM instance could be represented by the following object, because the
165
- # MonitoredResourceDescriptor for `"gce_instance"` has labels `"instance_id"`
166
- # and `"zone"`: ` "type": "gce_instance", "labels": ` "instance_id": "my-
167
- # instance", "zone": "us-central1-a" ``
284
+ # MonitoredResourceDescriptor object that describes the resource's
285
+ # schema. Information in the `labels` field identifies the actual resource and
286
+ # its attributes according to the schema. For example, a particular Compute
287
+ # Engine VM instance could be represented by the following object, because the
288
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
289
+ # `"instance_id"` and `"zone"`:
290
+ # ` "type": "gce_instance",
291
+ # "labels": ` "instance_id": "12345678901234",
292
+ # "zone": "us-central1-a" ``
168
293
  # Corresponds to the JSON property `resource`
169
294
  # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
170
295
  attr_accessor :resource
171
296
 
172
- # The log entry payload, represented as a protocol buffer. You can only use `
173
- # protoPayload` values that belong to a set of approved types.
297
+ # The log entry payload, represented as a protocol buffer. Some
298
+ # Google Cloud Platform services use this field for their log
299
+ # entry payloads.
174
300
  # Corresponds to the JSON property `protoPayload`
175
301
  # @return [Hash<String,Object>]
176
302
  attr_accessor :proto_payload
177
303
 
178
- # The log entry payload, represented as a Unicode string (UTF-8).
179
- # Corresponds to the JSON property `textPayload`
180
- # @return [String]
181
- attr_accessor :text_payload
182
-
183
- # The log entry payload, represented as a structure that is expressed as a JSON
184
- # object.
185
- # Corresponds to the JSON property `jsonPayload`
186
- # @return [Hash<String,Object>]
187
- attr_accessor :json_payload
188
-
189
- # Optional. The time the event described by the log entry occurred. If omitted,
190
- # Cloud Logging will use the time the log entry is written.
304
+ # Optional. The time the event described by the log entry occurred. If
305
+ # omitted, Stackdriver Logging will use the time the log entry is received.
191
306
  # Corresponds to the JSON property `timestamp`
192
307
  # @return [String]
193
308
  attr_accessor :timestamp
194
309
 
195
- # Optional. The severity of the log entry. The default value is `LogSeverity.
196
- # DEFAULT`.
197
- # Corresponds to the JSON property `severity`
198
- # @return [String]
199
- attr_accessor :severity
200
-
201
- # Optional. A unique ID for the log entry. If you provide this field, the
202
- # logging service considers other log entries in the same log with the same ID
203
- # as duplicates which can be removed. If omitted, Cloud Logging will generate a
204
- # unique ID for this log entry.
310
+ # Optional. A unique ID for the log entry. If you provide this
311
+ # field, the logging service considers other log entries in the
312
+ # same project with the same ID as duplicates which can be removed. If
313
+ # omitted, Stackdriver Logging will generate a unique ID for this
314
+ # log entry.
205
315
  # Corresponds to the JSON property `insertId`
206
316
  # @return [String]
207
317
  attr_accessor :insert_id
208
318
 
209
- # A common proto for logging HTTP requests.
210
- # Corresponds to the JSON property `httpRequest`
211
- # @return [Google::Apis::LoggingV2beta1::HttpRequest]
212
- attr_accessor :http_request
213
-
214
- # Optional. A set of user-defined (key, value) data that provides additional
215
- # information about the log entry.
216
- # Corresponds to the JSON property `labels`
217
- # @return [Hash<String,String>]
218
- attr_accessor :labels
219
-
220
- # Additional information about a potentially long-running operation with which a
221
- # log entry is associated.
319
+ # Additional information about a potentially long-running operation with which
320
+ # a log entry is associated.
222
321
  # Corresponds to the JSON property `operation`
223
322
  # @return [Google::Apis::LoggingV2beta1::LogEntryOperation]
224
323
  attr_accessor :operation
@@ -229,94 +328,73 @@ module Google
229
328
 
230
329
  # Update properties of this object
231
330
  def update!(**args)
331
+ @text_payload = args[:text_payload] if args.key?(:text_payload)
332
+ @http_request = args[:http_request] if args.key?(:http_request)
333
+ @json_payload = args[:json_payload] if args.key?(:json_payload)
334
+ @labels = args[:labels] if args.key?(:labels)
232
335
  @log_name = args[:log_name] if args.key?(:log_name)
336
+ @severity = args[:severity] if args.key?(:severity)
233
337
  @resource = args[:resource] if args.key?(:resource)
234
338
  @proto_payload = args[:proto_payload] if args.key?(:proto_payload)
235
- @text_payload = args[:text_payload] if args.key?(:text_payload)
236
- @json_payload = args[:json_payload] if args.key?(:json_payload)
237
339
  @timestamp = args[:timestamp] if args.key?(:timestamp)
238
- @severity = args[:severity] if args.key?(:severity)
239
340
  @insert_id = args[:insert_id] if args.key?(:insert_id)
240
- @http_request = args[:http_request] if args.key?(:http_request)
241
- @labels = args[:labels] if args.key?(:labels)
242
341
  @operation = args[:operation] if args.key?(:operation)
243
342
  end
244
343
  end
245
344
 
246
- # A common proto for logging HTTP requests.
247
- class HttpRequest
345
+ # Application log line emitted while processing a request.
346
+ class LogLine
248
347
  include Google::Apis::Core::Hashable
249
348
 
250
- # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
251
- # Corresponds to the JSON property `requestMethod`
349
+ # Approximate time when this log entry was made.
350
+ # Corresponds to the JSON property `time`
252
351
  # @return [String]
253
- attr_accessor :request_method
352
+ attr_accessor :time
254
353
 
255
- # The scheme (http, https), the host name, the path and the query portion of the
256
- # URL that was requested. Example: `"http://example.com/some/info?color=red"`.
257
- # Corresponds to the JSON property `requestUrl`
354
+ # Severity of this log entry.
355
+ # Corresponds to the JSON property `severity`
258
356
  # @return [String]
259
- attr_accessor :request_url
357
+ attr_accessor :severity
260
358
 
261
- # The size of the HTTP request message in bytes, including the request headers
262
- # and the request body.
263
- # Corresponds to the JSON property `requestSize`
359
+ # Specifies a location in a source code file.
360
+ # Corresponds to the JSON property `sourceLocation`
361
+ # @return [Google::Apis::LoggingV2beta1::SourceLocation]
362
+ attr_accessor :source_location
363
+
364
+ # App-provided log message.
365
+ # Corresponds to the JSON property `logMessage`
264
366
  # @return [String]
265
- attr_accessor :request_size
367
+ attr_accessor :log_message
266
368
 
267
- # The response code indicating the status of response. Examples: 200, 404.
268
- # Corresponds to the JSON property `status`
269
- # @return [Fixnum]
270
- attr_accessor :status
369
+ def initialize(**args)
370
+ update!(**args)
371
+ end
271
372
 
272
- # The size of the HTTP response message sent back to the client, in bytes,
273
- # including the response headers and the response body.
274
- # Corresponds to the JSON property `responseSize`
275
- # @return [String]
276
- attr_accessor :response_size
373
+ # Update properties of this object
374
+ def update!(**args)
375
+ @time = args[:time] if args.key?(:time)
376
+ @severity = args[:severity] if args.key?(:severity)
377
+ @source_location = args[:source_location] if args.key?(:source_location)
378
+ @log_message = args[:log_message] if args.key?(:log_message)
379
+ end
380
+ end
277
381
 
278
- # The user agent sent by the client. Example: `"Mozilla/4.0 (compatible; MSIE 6.
279
- # 0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
280
- # Corresponds to the JSON property `userAgent`
281
- # @return [String]
282
- attr_accessor :user_agent
382
+ # A reference to a particular snapshot of the source tree used to build and
383
+ # deploy an application.
384
+ class SourceReference
385
+ include Google::Apis::Core::Hashable
283
386
 
284
- # The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
285
- # Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
286
- # Corresponds to the JSON property `remoteIp`
387
+ # Optional. A URI string identifying the repository.
388
+ # Example: "https://github.com/GoogleCloudPlatform/kubernetes.git"
389
+ # Corresponds to the JSON property `repository`
287
390
  # @return [String]
288
- attr_accessor :remote_ip
391
+ attr_accessor :repository
289
392
 
290
- # The referer URL of the request, as defined in [HTTP/1.1 Header Field
291
- # Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
292
- # Corresponds to the JSON property `referer`
393
+ # The canonical and persistent identifier of the deployed revision.
394
+ # Example (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
395
+ # Corresponds to the JSON property `revisionId`
293
396
  # @return [String]
294
- attr_accessor :referer
295
-
296
- # Whether or not a cache lookup was attempted.
297
- # Corresponds to the JSON property `cacheLookup`
298
- # @return [Boolean]
299
- attr_accessor :cache_lookup
300
- alias_method :cache_lookup?, :cache_lookup
301
-
302
- # Whether or not an entity was served from cache (with or without validation).
303
- # Corresponds to the JSON property `cacheHit`
304
- # @return [Boolean]
305
- attr_accessor :cache_hit
306
- alias_method :cache_hit?, :cache_hit
307
-
308
- # Whether or not the response was validated with the origin server before being
309
- # served from cache. This field is only meaningful if `cache_hit` is True.
310
- # Corresponds to the JSON property `cacheValidatedWithOriginServer`
311
- # @return [Boolean]
312
- attr_accessor :cache_validated_with_origin_server
313
- alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
314
-
315
- # The number of HTTP response bytes inserted into cache. Set only when a cache
316
- # fill was attempted.
317
- # Corresponds to the JSON property `cacheFillBytes`
318
- # @return [String]
319
- attr_accessor :cache_fill_bytes
397
+ attr_accessor :revision_id
320
398
 
321
399
  def initialize(**args)
322
400
  update!(**args)
@@ -324,67 +402,39 @@ module Google
324
402
 
325
403
  # Update properties of this object
326
404
  def update!(**args)
327
- @request_method = args[:request_method] if args.key?(:request_method)
328
- @request_url = args[:request_url] if args.key?(:request_url)
329
- @request_size = args[:request_size] if args.key?(:request_size)
330
- @status = args[:status] if args.key?(:status)
331
- @response_size = args[:response_size] if args.key?(:response_size)
332
- @user_agent = args[:user_agent] if args.key?(:user_agent)
333
- @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
334
- @referer = args[:referer] if args.key?(:referer)
335
- @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
336
- @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
337
- @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
338
- @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
405
+ @repository = args[:repository] if args.key?(:repository)
406
+ @revision_id = args[:revision_id] if args.key?(:revision_id)
339
407
  end
340
408
  end
341
409
 
342
- # Additional information about a potentially long-running operation with which a
343
- # log entry is associated.
344
- class LogEntryOperation
410
+ # An object representing a resource that can be used for monitoring, logging,
411
+ # billing, or other purposes. Examples include virtual machine instances,
412
+ # databases, and storage devices such as disks. The `type` field identifies a
413
+ # MonitoredResourceDescriptor object that describes the resource's
414
+ # schema. Information in the `labels` field identifies the actual resource and
415
+ # its attributes according to the schema. For example, a particular Compute
416
+ # Engine VM instance could be represented by the following object, because the
417
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
418
+ # `"instance_id"` and `"zone"`:
419
+ # ` "type": "gce_instance",
420
+ # "labels": ` "instance_id": "12345678901234",
421
+ # "zone": "us-central1-a" ``
422
+ class MonitoredResource
345
423
  include Google::Apis::Core::Hashable
346
424
 
347
- # Required. An arbitrary operation identifier. Log entries with the same
348
- # identifier are assumed to be part of the same operation.
349
- # Corresponds to the JSON property `id`
350
- # @return [String]
351
- attr_accessor :id
425
+ # Required. Values for all of the labels listed in the associated monitored
426
+ # resource descriptor. For example, Cloud SQL databases use the labels
427
+ # `"database_id"` and `"zone"`.
428
+ # Corresponds to the JSON property `labels`
429
+ # @return [Hash<String,String>]
430
+ attr_accessor :labels
352
431
 
353
- # Required. An arbitrary producer identifier. The combination of `id` and `
354
- # producer` must be globally unique. Examples for `producer`: `"MyDivision.
355
- # MyBigCompany.com"`, "github.com/MyProject/MyApplication"`.
356
- # Corresponds to the JSON property `producer`
432
+ # Required. The monitored resource type. This field must match
433
+ # the `type` field of a MonitoredResourceDescriptor object. For
434
+ # example, the type of a Cloud SQL database is `"cloudsql_database"`.
435
+ # Corresponds to the JSON property `type`
357
436
  # @return [String]
358
- attr_accessor :producer
359
-
360
- # Optional. Set this to True if this is the first log entry in the operation.
361
- # Corresponds to the JSON property `first`
362
- # @return [Boolean]
363
- attr_accessor :first
364
- alias_method :first?, :first
365
-
366
- # Optional. Set this to True if this is the last log entry in the operation.
367
- # Corresponds to the JSON property `last`
368
- # @return [Boolean]
369
- attr_accessor :last
370
- alias_method :last?, :last
371
-
372
- def initialize(**args)
373
- update!(**args)
374
- end
375
-
376
- # Update properties of this object
377
- def update!(**args)
378
- @id = args[:id] if args.key?(:id)
379
- @producer = args[:producer] if args.key?(:producer)
380
- @first = args[:first] if args.key?(:first)
381
- @last = args[:last] if args.key?(:last)
382
- end
383
- end
384
-
385
- # Result returned from WriteLogEntries. empty
386
- class WriteLogEntriesResponse
387
- include Google::Apis::Core::Hashable
437
+ attr_accessor :type
388
438
 
389
439
  def initialize(**args)
390
440
  update!(**args)
@@ -392,97 +442,68 @@ module Google
392
442
 
393
443
  # Update properties of this object
394
444
  def update!(**args)
445
+ @labels = args[:labels] if args.key?(:labels)
446
+ @type = args[:type] if args.key?(:type)
395
447
  end
396
448
  end
397
449
 
398
- # The parameters to `ListLogEntries`.
399
- class ListLogEntriesRequest
450
+ # The parameters to WriteLogEntries.
451
+ class WriteLogEntriesRequest
400
452
  include Google::Apis::Core::Hashable
401
453
 
402
- # Required. One or more project IDs or project numbers from which to retrieve
403
- # log entries. Examples of a project ID: `"my-project-1A"`, `"1234567890"`.
404
- # Corresponds to the JSON property `projectIds`
405
- # @return [Array<String>]
406
- attr_accessor :project_ids
407
-
408
- # Optional. An [advanced logs filter](/logging/docs/view/advanced_filters). The
409
- # filter is compared against all log entries in the projects specified by `
410
- # projectIds`. Only entries that match the filter are retrieved. An empty filter
411
- # matches all log entries.
412
- # Corresponds to the JSON property `filter`
413
- # @return [String]
414
- attr_accessor :filter
415
-
416
- # Optional. How the results should be sorted. Presently, the only permitted
417
- # values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
418
- # option returns entries in order of increasing values of `LogEntry.timestamp` (
419
- # oldest first), and the second option returns entries in order of decreasing
420
- # timestamps (newest first). Entries with equal timestamps are returned in order
421
- # of `LogEntry.insertId`.
422
- # Corresponds to the JSON property `orderBy`
423
- # @return [String]
424
- attr_accessor :order_by
454
+ # Optional. Default labels that are added to the `labels` field of all log
455
+ # entries in `entries`. If a log entry already has a label with the same key
456
+ # as a label in this parameter, then the log entry's label is not changed.
457
+ # See LogEntry.
458
+ # Corresponds to the JSON property `labels`
459
+ # @return [Hash<String,String>]
460
+ attr_accessor :labels
425
461
 
426
- # Optional. The maximum number of results to return from this request. You must
427
- # check for presence of `nextPageToken` to determine if additional results are
428
- # available, which you can retrieve by passing the `nextPageToken` value as the `
429
- # pageToken` parameter in the next request.
430
- # Corresponds to the JSON property `pageSize`
431
- # @return [Fixnum]
432
- attr_accessor :page_size
462
+ # Required. The log entries to write. Values supplied for the fields
463
+ # `log_name`, `resource`, and `labels` in this `entries.write` request are
464
+ # added to those log entries that do not provide their own values for the
465
+ # fields.
466
+ # To improve throughput and to avoid exceeding the
467
+ # [quota limit](/logging/quota-policy) for calls to `entries.write`,
468
+ # you should write multiple log entries at once rather than
469
+ # calling this method for each individual log entry.
470
+ # Corresponds to the JSON property `entries`
471
+ # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
472
+ attr_accessor :entries
433
473
 
434
- # Optional. If the `pageToken` parameter is supplied, then the next page of
435
- # results is retrieved. The `pageToken` parameter must be set to the value of
436
- # the `nextPageToken` from the previous response. The values of `projectIds`, `
437
- # filter`, and `orderBy` must be the same as in the previous request.
438
- # Corresponds to the JSON property `pageToken`
474
+ # Optional. A default log resource name that is assigned to all log entries
475
+ # in `entries` that do not specify a value for `log_name`. Example:
476
+ # `"projects/my-project/logs/syslog"`. See
477
+ # LogEntry.
478
+ # Corresponds to the JSON property `logName`
439
479
  # @return [String]
440
- attr_accessor :page_token
480
+ attr_accessor :log_name
441
481
 
442
- # Optional. If true, read access to all projects is not required and results
443
- # will be returned for the subset of projects for which read access is permitted
444
- # (empty subset is permitted).
482
+ # Optional. Whether valid entries should be written even if some other
483
+ # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
484
+ # entry is not written, the response status will be the error associated
485
+ # with one of the failed entries and include error details in the form of
486
+ # WriteLogEntriesPartialErrors.
445
487
  # Corresponds to the JSON property `partialSuccess`
446
488
  # @return [Boolean]
447
489
  attr_accessor :partial_success
448
490
  alias_method :partial_success?, :partial_success
449
491
 
450
- def initialize(**args)
451
- update!(**args)
452
- end
453
-
454
- # Update properties of this object
455
- def update!(**args)
456
- @project_ids = args[:project_ids] if args.key?(:project_ids)
457
- @filter = args[:filter] if args.key?(:filter)
458
- @order_by = args[:order_by] if args.key?(:order_by)
459
- @page_size = args[:page_size] if args.key?(:page_size)
460
- @page_token = args[:page_token] if args.key?(:page_token)
461
- @partial_success = args[:partial_success] if args.key?(:partial_success)
462
- end
463
- end
464
-
465
- # Result returned from `ListLogEntries`.
466
- class ListLogEntriesResponse
467
- include Google::Apis::Core::Hashable
468
-
469
- # A list of log entries.
470
- # Corresponds to the JSON property `entries`
471
- # @return [Array<Google::Apis::LoggingV2beta1::LogEntry>]
472
- attr_accessor :entries
473
-
474
- # If there are more results than were returned, then `nextPageToken` is included
475
- # in the response. To get the next set of results, call this method again using
476
- # the value of `nextPageToken` as `pageToken`.
477
- # Corresponds to the JSON property `nextPageToken`
478
- # @return [String]
479
- attr_accessor :next_page_token
480
-
481
- # If partial_success is true, contains the project ids that had errors and the
482
- # associated errors.
483
- # Corresponds to the JSON property `projectIdErrors`
484
- # @return [Hash<String,Google::Apis::LoggingV2beta1::Status>]
485
- attr_accessor :project_id_errors
492
+ # An object representing a resource that can be used for monitoring, logging,
493
+ # billing, or other purposes. Examples include virtual machine instances,
494
+ # databases, and storage devices such as disks. The `type` field identifies a
495
+ # MonitoredResourceDescriptor object that describes the resource's
496
+ # schema. Information in the `labels` field identifies the actual resource and
497
+ # its attributes according to the schema. For example, a particular Compute
498
+ # Engine VM instance could be represented by the following object, because the
499
+ # MonitoredResourceDescriptor for `"gce_instance"` has labels
500
+ # `"instance_id"` and `"zone"`:
501
+ # ` "type": "gce_instance",
502
+ # "labels": ` "instance_id": "12345678901234",
503
+ # "zone": "us-central1-a" ``
504
+ # Corresponds to the JSON property `resource`
505
+ # @return [Google::Apis::LoggingV2beta1::MonitoredResource]
506
+ attr_accessor :resource
486
507
 
487
508
  def initialize(**args)
488
509
  update!(**args)
@@ -490,64 +511,32 @@ module Google
490
511
 
491
512
  # Update properties of this object
492
513
  def update!(**args)
514
+ @labels = args[:labels] if args.key?(:labels)
493
515
  @entries = args[:entries] if args.key?(:entries)
494
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
495
- @project_id_errors = args[:project_id_errors] if args.key?(:project_id_errors)
516
+ @log_name = args[:log_name] if args.key?(:log_name)
517
+ @partial_success = args[:partial_success] if args.key?(:partial_success)
518
+ @resource = args[:resource] if args.key?(:resource)
496
519
  end
497
520
  end
498
521
 
499
- # The `Status` type defines a logical error model that is suitable for different
500
- # programming environments, including REST APIs and RPC APIs. It is used by [
501
- # gRPC](https://github.com/grpc). The error model is designed to be: - Simple to
502
- # use and understand for most users - Flexible enough to meet unexpected needs #
503
- # Overview The `Status` message contains three pieces of data: error code, error
504
- # message, and error details. The error code should be an enum value of google.
505
- # rpc.Code, but it may accept additional error codes if needed. The error
506
- # message should be a developer-facing English message that helps developers *
507
- # understand* and *resolve* the error. If a localized user-facing error message
508
- # is needed, put the localized message in the error details or localize it in
509
- # the client. The optional error details may contain arbitrary information about
510
- # the error. There is a predefined set of error detail types in the package `
511
- # google.rpc` which can be used for common error conditions. # Language mapping
512
- # The `Status` message is the logical representation of the error model, but it
513
- # is not necessarily the actual wire format. When the `Status` message is
514
- # exposed in different client libraries and different wire protocols, it can be
515
- # mapped differently. For example, it will likely be mapped to some exceptions
516
- # in Java, but more likely mapped to some error codes in C. # Other uses The
517
- # error model and the `Status` message can be used in a variety of environments,
518
- # either with or without APIs, to provide a consistent developer experience
519
- # across different environments. Example uses of this error model include: -
520
- # Partial errors. If a service needs to return partial errors to the client, it
521
- # may embed the `Status` in the normal response to indicate the partial errors. -
522
- # Workflow errors. A typical workflow has multiple steps. Each step may have a `
523
- # Status` message for error reporting purpose. - Batch operations. If a client
524
- # uses batch request and batch response, the `Status` message should be used
525
- # directly inside batch response, one for each error sub-response. -
526
- # Asynchronous operations. If an API call embeds asynchronous operation results
527
- # in its response, the status of those operations should be represented directly
528
- # using the `Status` message. - Logging. If some API errors are stored in logs,
529
- # the message `Status` could be used directly after any stripping needed for
530
- # security/privacy reasons.
531
- class Status
522
+ # A description of a label.
523
+ class LabelDescriptor
532
524
  include Google::Apis::Core::Hashable
533
525
 
534
- # The status code, which should be an enum value of google.rpc.Code.
535
- # Corresponds to the JSON property `code`
536
- # @return [Fixnum]
537
- attr_accessor :code
526
+ # A human-readable description for the label.
527
+ # Corresponds to the JSON property `description`
528
+ # @return [String]
529
+ attr_accessor :description
538
530
 
539
- # A developer-facing error message, which should be in English. Any user-facing
540
- # error message should be localized and sent in the google.rpc.Status.details
541
- # field, or localized by the client.
542
- # Corresponds to the JSON property `message`
531
+ # The type of data that can be assigned to the label.
532
+ # Corresponds to the JSON property `valueType`
543
533
  # @return [String]
544
- attr_accessor :message
534
+ attr_accessor :value_type
545
535
 
546
- # A list of messages that carry the error details. There will be a common set of
547
- # message types for APIs to use.
548
- # Corresponds to the JSON property `details`
549
- # @return [Array<Hash<String,Object>>]
550
- attr_accessor :details
536
+ # The label key.
537
+ # Corresponds to the JSON property `key`
538
+ # @return [String]
539
+ attr_accessor :key
551
540
 
552
541
  def initialize(**args)
553
542
  update!(**args)
@@ -555,24 +544,24 @@ module Google
555
544
 
556
545
  # Update properties of this object
557
546
  def update!(**args)
558
- @code = args[:code] if args.key?(:code)
559
- @message = args[:message] if args.key?(:message)
560
- @details = args[:details] if args.key?(:details)
547
+ @description = args[:description] if args.key?(:description)
548
+ @value_type = args[:value_type] if args.key?(:value_type)
549
+ @key = args[:key] if args.key?(:key)
561
550
  end
562
551
  end
563
552
 
564
- # Result returned from ListMonitoredResourceDescriptors.
565
- class ListMonitoredResourceDescriptorsResponse
553
+ # Result returned from ListLogMetrics.
554
+ class ListLogMetricsResponse
566
555
  include Google::Apis::Core::Hashable
567
556
 
568
- # A list of resource descriptors.
569
- # Corresponds to the JSON property `resourceDescriptors`
570
- # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
571
- attr_accessor :resource_descriptors
557
+ # A list of logs-based metrics.
558
+ # Corresponds to the JSON property `metrics`
559
+ # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
560
+ attr_accessor :metrics
572
561
 
573
- # If there are more results than were returned, then `nextPageToken` is included
574
- # in the response. To get the next set of results, call this method again using
575
- # the value of `nextPageToken` as `pageToken`.
562
+ # If there might be more results than appear in this response, then
563
+ # `nextPageToken` is included. To get the next set of results, call this
564
+ # method again using the value of `nextPageToken` as `pageToken`.
576
565
  # Corresponds to the JSON property `nextPageToken`
577
566
  # @return [String]
578
567
  attr_accessor :next_page_token
@@ -583,45 +572,32 @@ module Google
583
572
 
584
573
  # Update properties of this object
585
574
  def update!(**args)
586
- @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
575
+ @metrics = args[:metrics] if args.key?(:metrics)
587
576
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
588
577
  end
589
578
  end
590
579
 
591
- # An object that describes the schema of a MonitoredResource object using a type
592
- # name and a set of labels. For example, the monitored resource descriptor for
593
- # Google Compute Engine VM instances has a type of `"gce_instance"` and
594
- # specifies the use of the labels `"instance_id"` and `"zone"` to identify
595
- # particular VM instances. Different APIs can support different monitored
596
- # resource types. APIs generally provide a `list` method that returns the
597
- # monitored resource descriptors used by the API.
580
+ # An object that describes the schema of a MonitoredResource object using a
581
+ # type name and a set of labels. For example, the monitored resource
582
+ # descriptor for Google Compute Engine VM instances has a type of
583
+ # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
584
+ # `"zone"` to identify particular VM instances.
585
+ # Different APIs can support different monitored resource types. APIs generally
586
+ # provide a `list` method that returns the monitored resource descriptors used
587
+ # by the API.
598
588
  class MonitoredResourceDescriptor
599
589
  include Google::Apis::Core::Hashable
600
590
 
601
- # Optional. The resource name of the monitored resource descriptor: `"projects/`
602
- # project_id`/monitoredResourceDescriptors/`type`"` where `type` is the value of
603
- # the `type` field in this object and `project_id` is a project ID that provides
604
- # API-specific context for accessing the type. APIs that do not use project
605
- # information can use the resource name format `"monitoredResourceDescriptors/`
606
- # type`"`.
607
- # Corresponds to the JSON property `name`
608
- # @return [String]
609
- attr_accessor :name
610
-
611
- # Required. The monitored resource type. For example, the type `"
612
- # cloudsql_database"` represents databases in Google Cloud SQL.
613
- # Corresponds to the JSON property `type`
614
- # @return [String]
615
- attr_accessor :type
616
-
617
591
  # Optional. A concise name for the monitored resource type that might be
618
- # displayed in user interfaces. For example, `"Google Cloud SQL Database"`.
592
+ # displayed in user interfaces. It should be a Title Cased Noun Phrase,
593
+ # without any article or other determiners. For example,
594
+ # `"Google Cloud SQL Database"`.
619
595
  # Corresponds to the JSON property `displayName`
620
596
  # @return [String]
621
597
  attr_accessor :display_name
622
598
 
623
- # Optional. A detailed description of the monitored resource type that might be
624
- # used in documentation.
599
+ # Optional. A detailed description of the monitored resource type that might
600
+ # be used in documentation.
625
601
  # Corresponds to the JSON property `description`
626
602
  # @return [String]
627
603
  attr_accessor :description
@@ -633,38 +609,52 @@ module Google
633
609
  # @return [Array<Google::Apis::LoggingV2beta1::LabelDescriptor>]
634
610
  attr_accessor :labels
635
611
 
612
+ # Required. The monitored resource type. For example, the type
613
+ # `"cloudsql_database"` represents databases in Google Cloud SQL.
614
+ # The maximum length of this value is 256 characters.
615
+ # Corresponds to the JSON property `type`
616
+ # @return [String]
617
+ attr_accessor :type
618
+
619
+ # Optional. The resource name of the monitored resource descriptor:
620
+ # `"projects/`project_id`/monitoredResourceDescriptors/`type`"` where
621
+ # `type` is the value of the `type` field in this object and
622
+ # `project_id` is a project ID that provides API-specific context for
623
+ # accessing the type. APIs that do not use project information can use the
624
+ # resource name format `"monitoredResourceDescriptors/`type`"`.
625
+ # Corresponds to the JSON property `name`
626
+ # @return [String]
627
+ attr_accessor :name
628
+
636
629
  def initialize(**args)
637
630
  update!(**args)
638
631
  end
639
632
 
640
633
  # Update properties of this object
641
634
  def update!(**args)
642
- @name = args[:name] if args.key?(:name)
643
- @type = args[:type] if args.key?(:type)
644
635
  @display_name = args[:display_name] if args.key?(:display_name)
645
636
  @description = args[:description] if args.key?(:description)
646
637
  @labels = args[:labels] if args.key?(:labels)
638
+ @type = args[:type] if args.key?(:type)
639
+ @name = args[:name] if args.key?(:name)
647
640
  end
648
641
  end
649
642
 
650
- # A description of a label.
651
- class LabelDescriptor
643
+ # Result returned from ListMonitoredResourceDescriptors.
644
+ class ListMonitoredResourceDescriptorsResponse
652
645
  include Google::Apis::Core::Hashable
653
646
 
654
- # The label key.
655
- # Corresponds to the JSON property `key`
656
- # @return [String]
657
- attr_accessor :key
658
-
659
- # The type of data that can be assigned to the label.
660
- # Corresponds to the JSON property `valueType`
647
+ # If there might be more results than appear in this response, then
648
+ # `nextPageToken` is included. To get the next set of results, call this
649
+ # method again using the value of `nextPageToken` as `pageToken`.
650
+ # Corresponds to the JSON property `nextPageToken`
661
651
  # @return [String]
662
- attr_accessor :value_type
652
+ attr_accessor :next_page_token
663
653
 
664
- # A human-readable description for the label.
665
- # Corresponds to the JSON property `description`
666
- # @return [String]
667
- attr_accessor :description
654
+ # A list of resource descriptors.
655
+ # Corresponds to the JSON property `resourceDescriptors`
656
+ # @return [Array<Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor>]
657
+ attr_accessor :resource_descriptors
668
658
 
669
659
  def initialize(**args)
670
660
  update!(**args)
@@ -672,27 +662,40 @@ module Google
672
662
 
673
663
  # Update properties of this object
674
664
  def update!(**args)
675
- @key = args[:key] if args.key?(:key)
676
- @value_type = args[:value_type] if args.key?(:value_type)
677
- @description = args[:description] if args.key?(:description)
665
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
666
+ @resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
678
667
  end
679
668
  end
680
669
 
681
- # Result returned from `ListSinks`.
682
- class ListSinksResponse
670
+ # Additional information about a potentially long-running operation with which
671
+ # a log entry is associated.
672
+ class LogEntryOperation
683
673
  include Google::Apis::Core::Hashable
684
674
 
685
- # A list of sinks.
686
- # Corresponds to the JSON property `sinks`
687
- # @return [Array<Google::Apis::LoggingV2beta1::LogSink>]
688
- attr_accessor :sinks
675
+ # Optional. An arbitrary producer identifier. The combination of
676
+ # `id` and `producer` must be globally unique. Examples for `producer`:
677
+ # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
678
+ # Corresponds to the JSON property `producer`
679
+ # @return [String]
680
+ attr_accessor :producer
689
681
 
690
- # If there are more results than were returned, then `nextPageToken` is included
691
- # in the response. To get the next set of results, call this method again using
692
- # the value of `nextPageToken` as `pageToken`.
693
- # Corresponds to the JSON property `nextPageToken`
682
+ # Optional. Set this to True if this is the last log entry in the operation.
683
+ # Corresponds to the JSON property `last`
684
+ # @return [Boolean]
685
+ attr_accessor :last
686
+ alias_method :last?, :last
687
+
688
+ # Optional. Set this to True if this is the first log entry in the operation.
689
+ # Corresponds to the JSON property `first`
690
+ # @return [Boolean]
691
+ attr_accessor :first
692
+ alias_method :first?, :first
693
+
694
+ # Optional. An arbitrary operation identifier. Log entries with the
695
+ # same identifier are assumed to be part of the same operation.
696
+ # Corresponds to the JSON property `id`
694
697
  # @return [String]
695
- attr_accessor :next_page_token
698
+ attr_accessor :id
696
699
 
697
700
  def initialize(**args)
698
701
  update!(**args)
@@ -700,111 +703,125 @@ module Google
700
703
 
701
704
  # Update properties of this object
702
705
  def update!(**args)
703
- @sinks = args[:sinks] if args.key?(:sinks)
704
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
706
+ @producer = args[:producer] if args.key?(:producer)
707
+ @last = args[:last] if args.key?(:last)
708
+ @first = args[:first] if args.key?(:first)
709
+ @id = args[:id] if args.key?(:id)
705
710
  end
706
711
  end
707
712
 
708
- # Describes a sink used to export log entries outside Cloud Logging.
709
- class LogSink
713
+ # A generic empty message that you can re-use to avoid defining duplicated
714
+ # empty messages in your APIs. A typical example is to use it as the request
715
+ # or the response type of an API method. For instance:
716
+ # service Foo `
717
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
718
+ # `
719
+ # The JSON representation for `Empty` is empty JSON object ````.
720
+ class Empty
710
721
  include Google::Apis::Core::Hashable
711
722
 
712
- # Required. The client-assigned sink identifier. Example: `"my-severe-errors-to-
713
- # pubsub"`. Sink identifiers are limited to 1000 characters and can include only
714
- # the following characters: `A-Z`, `a-z`, `0-9`, and the special characters `_-.`
715
- # .
716
- # Corresponds to the JSON property `name`
717
- # @return [String]
718
- attr_accessor :name
719
-
720
- # The export destination. See [Exporting Logs With Sinks](/logging/docs/api/
721
- # tasks/exporting-logs). Examples: `"storage.googleapis.com/a-bucket"`, `"
722
- # bigquery.googleapis.com/projects/a-project-id/datasets/a-dataset"`.
723
- # Corresponds to the JSON property `destination`
724
- # @return [String]
725
- attr_accessor :destination
726
-
727
- # An [advanced logs filter](/logging/docs/view/advanced_filters). Only log
728
- # entries matching that filter are exported. The filter must be consistent with
729
- # the log entry format specified by the `outputVersionFormat` parameter,
730
- # regardless of the format of the log entry that was originally written to Cloud
731
- # Logging. Example (V2 format): `"logName=projects/my-projectid/logs/syslog AND
732
- # severity>=ERROR"`.
733
- # Corresponds to the JSON property `filter`
734
- # @return [String]
735
- attr_accessor :filter
736
-
737
- # The log entry version to use for this sink's exported log entries. This
738
- # version does not have to correspond to the version of the log entry when it
739
- # was written to Cloud Logging.
740
- # Corresponds to the JSON property `outputVersionFormat`
741
- # @return [String]
742
- attr_accessor :output_version_format
743
-
744
723
  def initialize(**args)
745
724
  update!(**args)
746
725
  end
747
726
 
748
727
  # Update properties of this object
749
728
  def update!(**args)
750
- @name = args[:name] if args.key?(:name)
751
- @destination = args[:destination] if args.key?(:destination)
752
- @filter = args[:filter] if args.key?(:filter)
753
- @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
754
729
  end
755
730
  end
756
731
 
757
- # Result returned from ListLogMetrics.
758
- class ListLogMetricsResponse
732
+ # A common proto for logging HTTP requests. Only contains semantics
733
+ # defined by the HTTP specification. Product-specific logging
734
+ # information MUST be defined in a separate message.
735
+ class HttpRequest
759
736
  include Google::Apis::Core::Hashable
760
737
 
761
- # A list of logs-based metrics.
762
- # Corresponds to the JSON property `metrics`
763
- # @return [Array<Google::Apis::LoggingV2beta1::LogMetric>]
764
- attr_accessor :metrics
738
+ # Whether or not a cache lookup was attempted.
739
+ # Corresponds to the JSON property `cacheLookup`
740
+ # @return [Boolean]
741
+ attr_accessor :cache_lookup
742
+ alias_method :cache_lookup?, :cache_lookup
765
743
 
766
- # If there are more results than were returned, then `nextPageToken` is included
767
- # in the response. To get the next set of results, call this method again using
768
- # the value of `nextPageToken` as `pageToken`.
769
- # Corresponds to the JSON property `nextPageToken`
744
+ # The size of the HTTP response message sent back to the client, in bytes,
745
+ # including the response headers and the response body.
746
+ # Corresponds to the JSON property `responseSize`
770
747
  # @return [String]
771
- attr_accessor :next_page_token
748
+ attr_accessor :response_size
772
749
 
773
- def initialize(**args)
774
- update!(**args)
775
- end
750
+ # The response code indicating the status of response.
751
+ # Examples: 200, 404.
752
+ # Corresponds to the JSON property `status`
753
+ # @return [Fixnum]
754
+ attr_accessor :status
776
755
 
777
- # Update properties of this object
778
- def update!(**args)
779
- @metrics = args[:metrics] if args.key?(:metrics)
780
- @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
781
- end
782
- end
756
+ # Whether or not the response was validated with the origin server before
757
+ # being served from cache. This field is only meaningful if `cache_hit` is
758
+ # True.
759
+ # Corresponds to the JSON property `cacheValidatedWithOriginServer`
760
+ # @return [Boolean]
761
+ attr_accessor :cache_validated_with_origin_server
762
+ alias_method :cache_validated_with_origin_server?, :cache_validated_with_origin_server
783
763
 
784
- # Describes a logs-based metric. The value of the metric is the number of log
785
- # entries that match a logs filter.
786
- class LogMetric
787
- include Google::Apis::Core::Hashable
764
+ # The referer URL of the request, as defined in
765
+ # [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/
766
+ # rfc2616-sec14.html).
767
+ # Corresponds to the JSON property `referer`
768
+ # @return [String]
769
+ attr_accessor :referer
788
770
 
789
- # Required. The client-assigned metric identifier. Example: `"severe_errors"`.
790
- # Metric identifiers are limited to 1000 characters and can include only the
791
- # following characters: `A-Z`, `a-z`, `0-9`, and the special characters `_-.,+!*'
792
- # ,()%/\`. The forward-slash character (`/`) denotes a hierarchy of name pieces,
793
- # and it cannot be the first character of the name.
794
- # Corresponds to the JSON property `name`
771
+ # Whether or not an entity was served from cache
772
+ # (with or without validation).
773
+ # Corresponds to the JSON property `cacheHit`
774
+ # @return [Boolean]
775
+ attr_accessor :cache_hit
776
+ alias_method :cache_hit?, :cache_hit
777
+
778
+ # The scheme (http, https), the host name, the path and the query
779
+ # portion of the URL that was requested.
780
+ # Example: `"http://example.com/some/info?color=red"`.
781
+ # Corresponds to the JSON property `requestUrl`
795
782
  # @return [String]
796
- attr_accessor :name
783
+ attr_accessor :request_url
797
784
 
798
- # A description of this metric, which is used in documentation.
799
- # Corresponds to the JSON property `description`
785
+ # The request processing latency on the server, from the time the request was
786
+ # received until the response was sent.
787
+ # Corresponds to the JSON property `latency`
800
788
  # @return [String]
801
- attr_accessor :description
789
+ attr_accessor :latency
802
790
 
803
- # An [advanced logs filter](/logging/docs/view/advanced_filters). Example: `"
804
- # logName:syslog AND severity>=ERROR"`.
805
- # Corresponds to the JSON property `filter`
791
+ # The number of HTTP response bytes inserted into cache. Set only when a
792
+ # cache fill was attempted.
793
+ # Corresponds to the JSON property `cacheFillBytes`
806
794
  # @return [String]
807
- attr_accessor :filter
795
+ attr_accessor :cache_fill_bytes
796
+
797
+ # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
798
+ # Corresponds to the JSON property `requestMethod`
799
+ # @return [String]
800
+ attr_accessor :request_method
801
+
802
+ # The IP address (IPv4 or IPv6) of the client that issued the HTTP
803
+ # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
804
+ # Corresponds to the JSON property `remoteIp`
805
+ # @return [String]
806
+ attr_accessor :remote_ip
807
+
808
+ # The IP address (IPv4 or IPv6) of the origin server that the request was
809
+ # sent to.
810
+ # Corresponds to the JSON property `serverIp`
811
+ # @return [String]
812
+ attr_accessor :server_ip
813
+
814
+ # The user agent sent by the client. Example:
815
+ # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
816
+ # Corresponds to the JSON property `userAgent`
817
+ # @return [String]
818
+ attr_accessor :user_agent
819
+
820
+ # The size of the HTTP request message in bytes, including the request
821
+ # headers and the request body.
822
+ # Corresponds to the JSON property `requestSize`
823
+ # @return [String]
824
+ attr_accessor :request_size
808
825
 
809
826
  def initialize(**args)
810
827
  update!(**args)
@@ -812,9 +829,20 @@ module Google
812
829
 
813
830
  # Update properties of this object
814
831
  def update!(**args)
815
- @name = args[:name] if args.key?(:name)
816
- @description = args[:description] if args.key?(:description)
817
- @filter = args[:filter] if args.key?(:filter)
832
+ @cache_lookup = args[:cache_lookup] if args.key?(:cache_lookup)
833
+ @response_size = args[:response_size] if args.key?(:response_size)
834
+ @status = args[:status] if args.key?(:status)
835
+ @cache_validated_with_origin_server = args[:cache_validated_with_origin_server] if args.key?(:cache_validated_with_origin_server)
836
+ @referer = args[:referer] if args.key?(:referer)
837
+ @cache_hit = args[:cache_hit] if args.key?(:cache_hit)
838
+ @request_url = args[:request_url] if args.key?(:request_url)
839
+ @latency = args[:latency] if args.key?(:latency)
840
+ @cache_fill_bytes = args[:cache_fill_bytes] if args.key?(:cache_fill_bytes)
841
+ @request_method = args[:request_method] if args.key?(:request_method)
842
+ @remote_ip = args[:remote_ip] if args.key?(:remote_ip)
843
+ @server_ip = args[:server_ip] if args.key?(:server_ip)
844
+ @user_agent = args[:user_agent] if args.key?(:user_agent)
845
+ @request_size = args[:request_size] if args.key?(:request_size)
818
846
  end
819
847
  end
820
848
 
@@ -823,182 +851,184 @@ module Google
823
851
  class RequestLog
824
852
  include Google::Apis::Core::Hashable
825
853
 
826
- # Application that handled this request.
827
- # Corresponds to the JSON property `appId`
854
+ # Size in bytes sent back to client by request.
855
+ # Corresponds to the JSON property `responseSize`
828
856
  # @return [String]
829
- attr_accessor :app_id
857
+ attr_accessor :response_size
830
858
 
831
- # Module of the application that handled this request.
832
- # Corresponds to the JSON property `moduleId`
859
+ # Globally unique identifier for a request, which is based on the request
860
+ # start time. Request IDs for requests which started later will compare
861
+ # greater as strings than those for requests which started earlier.
862
+ # Corresponds to the JSON property `requestId`
833
863
  # @return [String]
834
- attr_accessor :module_id
864
+ attr_accessor :request_id
865
+
866
+ # Whether this is the first RequestLog entry for this request. If an active
867
+ # request has several RequestLog entries written to Cloud Logging, this field
868
+ # will be set for one of them.
869
+ # Corresponds to the JSON property `first`
870
+ # @return [Boolean]
871
+ attr_accessor :first
872
+ alias_method :first?, :first
873
+
874
+ # Request method. Example: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`, `"DELETE"`.
875
+ # Corresponds to the JSON property `method`
876
+ # @return [String]
877
+ attr_accessor :method_prop
835
878
 
836
879
  # Version of the application that handled this request.
837
880
  # Corresponds to the JSON property `versionId`
838
881
  # @return [String]
839
882
  attr_accessor :version_id
840
883
 
841
- # Globally unique identifier for a request, which is based on the request start
842
- # time. Request IDs for requests which started later will compare greater as
843
- # strings than those for requests which started earlier.
844
- # Corresponds to the JSON property `requestId`
845
- # @return [String]
846
- attr_accessor :request_id
884
+ # HTTP response status code. Example: 200, 404.
885
+ # Corresponds to the JSON property `status`
886
+ # @return [Fixnum]
887
+ attr_accessor :status
888
+
889
+ # Whether this was a loading request for the instance.
890
+ # Corresponds to the JSON property `wasLoadingRequest`
891
+ # @return [Boolean]
892
+ attr_accessor :was_loading_request
893
+ alias_method :was_loading_request?, :was_loading_request
847
894
 
848
895
  # Origin IP address.
849
896
  # Corresponds to the JSON property `ip`
850
897
  # @return [String]
851
898
  attr_accessor :ip
852
899
 
853
- # Time when the request started.
854
- # Corresponds to the JSON property `startTime`
855
- # @return [String]
856
- attr_accessor :start_time
857
-
858
- # Time when the request finished.
859
- # Corresponds to the JSON property `endTime`
860
- # @return [String]
861
- attr_accessor :end_time
862
-
863
- # Latency of the request.
864
- # Corresponds to the JSON property `latency`
865
- # @return [String]
866
- attr_accessor :latency
867
-
868
- # Number of CPU megacycles used to process request.
869
- # Corresponds to the JSON property `megaCycles`
870
- # @return [String]
871
- attr_accessor :mega_cycles
872
-
873
- # Request method. Example: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`, `"DELETE"`.
874
- # Corresponds to the JSON property `method`
900
+ # The logged-in user who made the request.
901
+ # Most likely, this is the part of the user's email before the `@` sign. The
902
+ # field value is the same for different requests from the same user, but
903
+ # different users can have similar names. This information is also
904
+ # available to the application via the App Engine Users API.
905
+ # This field will be populated starting with App Engine 1.9.21.
906
+ # Corresponds to the JSON property `nickname`
875
907
  # @return [String]
876
- attr_accessor :method_prop
908
+ attr_accessor :nickname
877
909
 
878
- # Contains the path and query portion of the URL that was requested. For example,
879
- # if the URL was "http://example.com/app?name=val", the resource would be "/app?
880
- # name=val". The fragment identifier, which is identified by the `#` character,
881
- # is not included.
882
- # Corresponds to the JSON property `resource`
910
+ # Queue name of the request, in the case of an offline request.
911
+ # Corresponds to the JSON property `taskQueueName`
883
912
  # @return [String]
884
- attr_accessor :resource
913
+ attr_accessor :task_queue_name
885
914
 
886
- # HTTP version of request. Example: `"HTTP/1.1"`.
887
- # Corresponds to the JSON property `httpVersion`
915
+ # Time this request spent in the pending request queue.
916
+ # Corresponds to the JSON property `pendingTime`
888
917
  # @return [String]
889
- attr_accessor :http_version
918
+ attr_accessor :pending_time
890
919
 
891
- # HTTP response status code. Example: 200, 404.
892
- # Corresponds to the JSON property `status`
920
+ # If the instance processing this request belongs to a manually scaled
921
+ # module, then this is the 0-based index of the instance. Otherwise, this
922
+ # value is -1.
923
+ # Corresponds to the JSON property `instanceIndex`
893
924
  # @return [Fixnum]
894
- attr_accessor :status
925
+ attr_accessor :instance_index
895
926
 
896
- # Size in bytes sent back to client by request.
897
- # Corresponds to the JSON property `responseSize`
898
- # @return [String]
899
- attr_accessor :response_size
927
+ # Source code for the application that handled this request. There can be
928
+ # more than one source reference per deployed application if source code is
929
+ # distributed among multiple repositories.
930
+ # Corresponds to the JSON property `sourceReference`
931
+ # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
932
+ attr_accessor :source_reference
900
933
 
901
- # Referrer URL of request.
902
- # Corresponds to the JSON property `referrer`
934
+ # Module of the application that handled this request.
935
+ # Corresponds to the JSON property `moduleId`
903
936
  # @return [String]
904
- attr_accessor :referrer
937
+ attr_accessor :module_id
905
938
 
906
- # User agent that made the request.
907
- # Corresponds to the JSON property `userAgent`
939
+ # Internet host and port number of the resource being requested.
940
+ # Corresponds to the JSON property `host`
908
941
  # @return [String]
909
- attr_accessor :user_agent
942
+ attr_accessor :host
910
943
 
911
- # The logged-in user who made the request. Most likely, this is the part of the
912
- # user's email before the `@` sign. The field value is the same for different
913
- # requests from the same user, but different users can have similar names. This
914
- # information is also available to the application via the App Engine Users API.
915
- # This field will be populated starting with App Engine 1.9.21.
916
- # Corresponds to the JSON property `nickname`
944
+ # Latency of the request.
945
+ # Corresponds to the JSON property `latency`
917
946
  # @return [String]
918
- attr_accessor :nickname
947
+ attr_accessor :latency
919
948
 
920
949
  # File or class that handled the request.
921
950
  # Corresponds to the JSON property `urlMapEntry`
922
951
  # @return [String]
923
952
  attr_accessor :url_map_entry
924
953
 
925
- # Internet host and port number of the resource being requested.
926
- # Corresponds to the JSON property `host`
954
+ # Time when the request finished.
955
+ # Corresponds to the JSON property `endTime`
927
956
  # @return [String]
928
- attr_accessor :host
957
+ attr_accessor :end_time
929
958
 
930
- # An indication of the relative cost of serving this request.
931
- # Corresponds to the JSON property `cost`
932
- # @return [Float]
933
- attr_accessor :cost
959
+ # A list of log lines emitted by the application while serving this request.
960
+ # Corresponds to the JSON property `line`
961
+ # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
962
+ attr_accessor :line
934
963
 
935
- # Queue name of the request, in the case of an offline request.
936
- # Corresponds to the JSON property `taskQueueName`
964
+ # Number of CPU megacycles used to process request.
965
+ # Corresponds to the JSON property `megaCycles`
937
966
  # @return [String]
938
- attr_accessor :task_queue_name
967
+ attr_accessor :mega_cycles
939
968
 
940
- # Task name of the request, in the case of an offline request.
941
- # Corresponds to the JSON property `taskName`
969
+ # Application that handled this request.
970
+ # Corresponds to the JSON property `appId`
942
971
  # @return [String]
943
- attr_accessor :task_name
944
-
945
- # Whether this was a loading request for the instance.
946
- # Corresponds to the JSON property `wasLoadingRequest`
947
- # @return [Boolean]
948
- attr_accessor :was_loading_request
949
- alias_method :was_loading_request?, :was_loading_request
972
+ attr_accessor :app_id
950
973
 
951
- # Time this request spent in the pending request queue.
952
- # Corresponds to the JSON property `pendingTime`
974
+ # Cloud Trace identifier for this request.
975
+ # Corresponds to the JSON property `traceId`
953
976
  # @return [String]
954
- attr_accessor :pending_time
955
-
956
- # If the instance processing this request belongs to a manually scaled module,
957
- # then this is the 0-based index of the instance. Otherwise, this value is -1.
958
- # Corresponds to the JSON property `instanceIndex`
959
- # @return [Fixnum]
960
- attr_accessor :instance_index
977
+ attr_accessor :trace_id
961
978
 
962
- # Whether this request is finished or active.
963
- # Corresponds to the JSON property `finished`
964
- # @return [Boolean]
965
- attr_accessor :finished
966
- alias_method :finished?, :finished
979
+ # Task name of the request, in the case of an offline request.
980
+ # Corresponds to the JSON property `taskName`
981
+ # @return [String]
982
+ attr_accessor :task_name
967
983
 
968
- # Whether this is the first RequestLog entry for this request. If an active
969
- # request has several RequestLog entries written to Cloud Logging, this field
970
- # will be set for one of them.
971
- # Corresponds to the JSON property `first`
972
- # @return [Boolean]
973
- attr_accessor :first
974
- alias_method :first?, :first
984
+ # An indication of the relative cost of serving this request.
985
+ # Corresponds to the JSON property `cost`
986
+ # @return [Float]
987
+ attr_accessor :cost
975
988
 
976
989
  # An identifier for the instance that handled the request.
977
990
  # Corresponds to the JSON property `instanceId`
978
991
  # @return [String]
979
992
  attr_accessor :instance_id
980
993
 
981
- # A list of log lines emitted by the application while serving this request.
982
- # Corresponds to the JSON property `line`
983
- # @return [Array<Google::Apis::LoggingV2beta1::LogLine>]
984
- attr_accessor :line
994
+ # Time when the request started.
995
+ # Corresponds to the JSON property `startTime`
996
+ # @return [String]
997
+ attr_accessor :start_time
985
998
 
986
999
  # App Engine release version.
987
1000
  # Corresponds to the JSON property `appEngineRelease`
988
1001
  # @return [String]
989
1002
  attr_accessor :app_engine_release
990
1003
 
991
- # Cloud Trace identifier for this request.
992
- # Corresponds to the JSON property `traceId`
1004
+ # Contains the path and query portion of the URL that was requested. For
1005
+ # example, if the URL was "http://example.com/app?name=val", the resource
1006
+ # would be "/app?name=val". The fragment identifier, which is identified by
1007
+ # the `#` character, is not included.
1008
+ # Corresponds to the JSON property `resource`
993
1009
  # @return [String]
994
- attr_accessor :trace_id
1010
+ attr_accessor :resource
995
1011
 
996
- # Source code for the application that handled this request. There can be more
997
- # than one source reference per deployed application if source code is
998
- # distributed among multiple repositories.
999
- # Corresponds to the JSON property `sourceReference`
1000
- # @return [Array<Google::Apis::LoggingV2beta1::SourceReference>]
1001
- attr_accessor :source_reference
1012
+ # HTTP version of request. Example: `"HTTP/1.1"`.
1013
+ # Corresponds to the JSON property `httpVersion`
1014
+ # @return [String]
1015
+ attr_accessor :http_version
1016
+
1017
+ # Referrer URL of request.
1018
+ # Corresponds to the JSON property `referrer`
1019
+ # @return [String]
1020
+ attr_accessor :referrer
1021
+
1022
+ # User agent that made the request.
1023
+ # Corresponds to the JSON property `userAgent`
1024
+ # @return [String]
1025
+ attr_accessor :user_agent
1026
+
1027
+ # Whether this request is finished or active.
1028
+ # Corresponds to the JSON property `finished`
1029
+ # @return [Boolean]
1030
+ attr_accessor :finished
1031
+ alias_method :finished?, :finished
1002
1032
 
1003
1033
  def initialize(**args)
1004
1034
  update!(**args)
@@ -1006,130 +1036,106 @@ module Google
1006
1036
 
1007
1037
  # Update properties of this object
1008
1038
  def update!(**args)
1009
- @app_id = args[:app_id] if args.key?(:app_id)
1010
- @module_id = args[:module_id] if args.key?(:module_id)
1011
- @version_id = args[:version_id] if args.key?(:version_id)
1039
+ @response_size = args[:response_size] if args.key?(:response_size)
1012
1040
  @request_id = args[:request_id] if args.key?(:request_id)
1013
- @ip = args[:ip] if args.key?(:ip)
1014
- @start_time = args[:start_time] if args.key?(:start_time)
1015
- @end_time = args[:end_time] if args.key?(:end_time)
1016
- @latency = args[:latency] if args.key?(:latency)
1017
- @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
1041
+ @first = args[:first] if args.key?(:first)
1018
1042
  @method_prop = args[:method_prop] if args.key?(:method_prop)
1019
- @resource = args[:resource] if args.key?(:resource)
1020
- @http_version = args[:http_version] if args.key?(:http_version)
1043
+ @version_id = args[:version_id] if args.key?(:version_id)
1021
1044
  @status = args[:status] if args.key?(:status)
1022
- @response_size = args[:response_size] if args.key?(:response_size)
1023
- @referrer = args[:referrer] if args.key?(:referrer)
1024
- @user_agent = args[:user_agent] if args.key?(:user_agent)
1045
+ @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
1046
+ @ip = args[:ip] if args.key?(:ip)
1025
1047
  @nickname = args[:nickname] if args.key?(:nickname)
1026
- @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
1027
- @host = args[:host] if args.key?(:host)
1028
- @cost = args[:cost] if args.key?(:cost)
1029
1048
  @task_queue_name = args[:task_queue_name] if args.key?(:task_queue_name)
1030
- @task_name = args[:task_name] if args.key?(:task_name)
1031
- @was_loading_request = args[:was_loading_request] if args.key?(:was_loading_request)
1032
1049
  @pending_time = args[:pending_time] if args.key?(:pending_time)
1033
1050
  @instance_index = args[:instance_index] if args.key?(:instance_index)
1034
- @finished = args[:finished] if args.key?(:finished)
1035
- @first = args[:first] if args.key?(:first)
1036
- @instance_id = args[:instance_id] if args.key?(:instance_id)
1051
+ @source_reference = args[:source_reference] if args.key?(:source_reference)
1052
+ @module_id = args[:module_id] if args.key?(:module_id)
1053
+ @host = args[:host] if args.key?(:host)
1054
+ @latency = args[:latency] if args.key?(:latency)
1055
+ @url_map_entry = args[:url_map_entry] if args.key?(:url_map_entry)
1056
+ @end_time = args[:end_time] if args.key?(:end_time)
1037
1057
  @line = args[:line] if args.key?(:line)
1038
- @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
1058
+ @mega_cycles = args[:mega_cycles] if args.key?(:mega_cycles)
1059
+ @app_id = args[:app_id] if args.key?(:app_id)
1039
1060
  @trace_id = args[:trace_id] if args.key?(:trace_id)
1040
- @source_reference = args[:source_reference] if args.key?(:source_reference)
1061
+ @task_name = args[:task_name] if args.key?(:task_name)
1062
+ @cost = args[:cost] if args.key?(:cost)
1063
+ @instance_id = args[:instance_id] if args.key?(:instance_id)
1064
+ @start_time = args[:start_time] if args.key?(:start_time)
1065
+ @app_engine_release = args[:app_engine_release] if args.key?(:app_engine_release)
1066
+ @resource = args[:resource] if args.key?(:resource)
1067
+ @http_version = args[:http_version] if args.key?(:http_version)
1068
+ @referrer = args[:referrer] if args.key?(:referrer)
1069
+ @user_agent = args[:user_agent] if args.key?(:user_agent)
1070
+ @finished = args[:finished] if args.key?(:finished)
1041
1071
  end
1042
1072
  end
1043
1073
 
1044
- # Application log line emitted while processing a request.
1045
- class LogLine
1074
+ # Result returned from WriteLogEntries.
1075
+ # empty
1076
+ class WriteLogEntriesResponse
1046
1077
  include Google::Apis::Core::Hashable
1047
1078
 
1048
- # Approximate time when this log entry was made.
1049
- # Corresponds to the JSON property `time`
1050
- # @return [String]
1051
- attr_accessor :time
1052
-
1053
- # Severity of this log entry.
1054
- # Corresponds to the JSON property `severity`
1055
- # @return [String]
1056
- attr_accessor :severity
1057
-
1058
- # App-provided log message.
1059
- # Corresponds to the JSON property `logMessage`
1060
- # @return [String]
1061
- attr_accessor :log_message
1062
-
1063
- # Specifies a location in a source code file.
1064
- # Corresponds to the JSON property `sourceLocation`
1065
- # @return [Google::Apis::LoggingV2beta1::SourceLocation]
1066
- attr_accessor :source_location
1067
-
1068
1079
  def initialize(**args)
1069
1080
  update!(**args)
1070
1081
  end
1071
1082
 
1072
1083
  # Update properties of this object
1073
1084
  def update!(**args)
1074
- @time = args[:time] if args.key?(:time)
1075
- @severity = args[:severity] if args.key?(:severity)
1076
- @log_message = args[:log_message] if args.key?(:log_message)
1077
- @source_location = args[:source_location] if args.key?(:source_location)
1078
1085
  end
1079
1086
  end
1080
1087
 
1081
- # Specifies a location in a source code file.
1082
- class SourceLocation
1088
+ # The parameters to `ListLogEntries`.
1089
+ class ListLogEntriesRequest
1083
1090
  include Google::Apis::Core::Hashable
1084
1091
 
1085
- # Source file name. Depending on the runtime environment, this might be a simple
1086
- # name or a fully-qualified name.
1087
- # Corresponds to the JSON property `file`
1088
- # @return [String]
1089
- attr_accessor :file
1090
-
1091
- # Line within the source file.
1092
- # Corresponds to the JSON property `line`
1093
- # @return [String]
1094
- attr_accessor :line
1095
-
1096
- # Human-readable name of the function or method being invoked, with optional
1097
- # context such as the class or package name. This information is used in
1098
- # contexts such as the logs viewer, where a file and line number are less
1099
- # meaningful. The format can vary by language. For example: `qual.if.ied.Class.
1100
- # method` (Java), `dir/package.func` (Go), `function` (Python).
1101
- # Corresponds to the JSON property `functionName`
1092
+ # Optional. A filter that chooses which log entries to return. See [Advanced
1093
+ # Logs Filters](/logging/docs/view/advanced_filters). Only log entries that
1094
+ # match the filter are returned. An empty filter matches all log entries.
1095
+ # Corresponds to the JSON property `filter`
1102
1096
  # @return [String]
1103
- attr_accessor :function_name
1097
+ attr_accessor :filter
1104
1098
 
1105
- def initialize(**args)
1106
- update!(**args)
1107
- end
1099
+ # Deprecated. One or more project identifiers or project numbers from which
1100
+ # to retrieve log entries. Examples: `"my-project-1A"`, `"1234567890"`. If
1101
+ # present, these project identifiers are converted to resource format and
1102
+ # added to the list of resources in `resourceNames`. Callers should use
1103
+ # `resourceNames` rather than this parameter.
1104
+ # Corresponds to the JSON property `projectIds`
1105
+ # @return [Array<String>]
1106
+ attr_accessor :project_ids
1108
1107
 
1109
- # Update properties of this object
1110
- def update!(**args)
1111
- @file = args[:file] if args.key?(:file)
1112
- @line = args[:line] if args.key?(:line)
1113
- @function_name = args[:function_name] if args.key?(:function_name)
1114
- end
1115
- end
1108
+ # Optional. One or more cloud resources from which to retrieve log entries.
1109
+ # Example: `"projects/my-project-1A"`, `"projects/1234567890"`. Projects
1110
+ # listed in `projectIds` are added to this list.
1111
+ # Corresponds to the JSON property `resourceNames`
1112
+ # @return [Array<String>]
1113
+ attr_accessor :resource_names
1116
1114
 
1117
- # A reference to a particular snapshot of the source tree used to build and
1118
- # deploy an application.
1119
- class SourceReference
1120
- include Google::Apis::Core::Hashable
1115
+ # Optional. The maximum number of results to return from this request.
1116
+ # Non-positive values are ignored. The presence of `nextPageToken` in the
1117
+ # response indicates that more results might be available.
1118
+ # Corresponds to the JSON property `pageSize`
1119
+ # @return [Fixnum]
1120
+ attr_accessor :page_size
1121
1121
 
1122
- # Optional. A URI string identifying the repository. Example: "https://github.
1123
- # com/GoogleCloudPlatform/kubernetes.git"
1124
- # Corresponds to the JSON property `repository`
1122
+ # Optional. How the results should be sorted. Presently, the only permitted
1123
+ # values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
1124
+ # option returns entries in order of increasing values of
1125
+ # `LogEntry.timestamp` (oldest first), and the second option returns entries
1126
+ # in order of decreasing timestamps (newest first). Entries with equal
1127
+ # timestamps are returned in order of `LogEntry.insertId`.
1128
+ # Corresponds to the JSON property `orderBy`
1125
1129
  # @return [String]
1126
- attr_accessor :repository
1130
+ attr_accessor :order_by
1127
1131
 
1128
- # The canonical and persistent identifier of the deployed revision. Example (git)
1129
- # : "0035781c50ec7aa23385dc841529ce8a4b70db1b"
1130
- # Corresponds to the JSON property `revisionId`
1132
+ # Optional. If present, then retrieve the next batch of results from the
1133
+ # preceding call to this method. `pageToken` must be the value of
1134
+ # `nextPageToken` from the previous response. The values of other method
1135
+ # parameters should be identical to those in the previous call.
1136
+ # Corresponds to the JSON property `pageToken`
1131
1137
  # @return [String]
1132
- attr_accessor :revision_id
1138
+ attr_accessor :page_token
1133
1139
 
1134
1140
  def initialize(**args)
1135
1141
  update!(**args)
@@ -1137,8 +1143,12 @@ module Google
1137
1143
 
1138
1144
  # Update properties of this object
1139
1145
  def update!(**args)
1140
- @repository = args[:repository] if args.key?(:repository)
1141
- @revision_id = args[:revision_id] if args.key?(:revision_id)
1146
+ @filter = args[:filter] if args.key?(:filter)
1147
+ @project_ids = args[:project_ids] if args.key?(:project_ids)
1148
+ @resource_names = args[:resource_names] if args.key?(:resource_names)
1149
+ @page_size = args[:page_size] if args.key?(:page_size)
1150
+ @order_by = args[:order_by] if args.key?(:order_by)
1151
+ @page_token = args[:page_token] if args.key?(:page_token)
1142
1152
  end
1143
1153
  end
1144
1154
  end