google-api-client 0.9.15 → 0.9.18

Sign up to get free protection for your applications and to get access to all the features.
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