google-cloud-logging 1.5.1 → 1.5.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +2 -1
  3. data/README.md +8 -8
  4. data/lib/google/cloud/logging/credentials.rb +2 -15
  5. data/lib/google/cloud/logging/v2/config_service_v2_client.rb +126 -65
  6. data/lib/google/cloud/logging/v2/config_service_v2_client_config.json +13 -13
  7. data/lib/google/cloud/logging/v2/credentials.rb +38 -0
  8. data/lib/google/cloud/logging/v2/doc/google/api/distribution.rb +1 -1
  9. data/lib/google/cloud/logging/v2/doc/google/api/label.rb +1 -1
  10. data/lib/google/cloud/logging/v2/doc/google/api/metric.rb +8 -12
  11. data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb +28 -4
  12. data/lib/google/cloud/logging/v2/doc/google/logging/type/http_request.rb +1 -1
  13. data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb +18 -10
  14. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb +11 -19
  15. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb +3 -18
  16. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_metrics.rb +1 -16
  17. data/lib/google/cloud/logging/v2/doc/google/protobuf/any.rb +1 -1
  18. data/lib/google/cloud/logging/v2/doc/google/protobuf/duration.rb +1 -1
  19. data/lib/google/cloud/logging/v2/doc/google/protobuf/empty.rb +28 -0
  20. data/lib/google/cloud/logging/v2/doc/google/protobuf/field_mask.rb +1 -1
  21. data/lib/google/cloud/logging/v2/doc/google/protobuf/struct.rb +73 -0
  22. data/lib/google/cloud/logging/v2/doc/google/protobuf/timestamp.rb +1 -1
  23. data/lib/google/cloud/logging/v2/logging_service_v2_client.rb +106 -67
  24. data/lib/google/cloud/logging/v2/logging_service_v2_client_config.json +12 -12
  25. data/lib/google/cloud/logging/v2/metrics_service_v2_client.rb +75 -45
  26. data/lib/google/cloud/logging/v2/metrics_service_v2_client_config.json +6 -6
  27. data/lib/google/cloud/logging/version.rb +1 -1
  28. data/lib/google/logging/v2/log_entry_pb.rb +1 -0
  29. data/lib/google/logging/v2/logging_config_services_pb.rb +2 -2
  30. data/lib/google/logging/v2/logging_metrics_services_pb.rb +2 -2
  31. data/lib/google/logging/v2/logging_pb.rb +1 -0
  32. data/lib/google/logging/v2/logging_services_pb.rb +5 -4
  33. metadata +35 -5
  34. data/lib/google/cloud/logging/v2/doc/overview.rb +0 -66
@@ -12,21 +12,21 @@
12
12
  "retry_params": {
13
13
  "default": {
14
14
  "initial_retry_delay_millis": 100,
15
- "retry_delay_multiplier": 1.2,
16
- "max_retry_delay_millis": 1000,
17
- "initial_rpc_timeout_millis": 30000,
18
- "rpc_timeout_multiplier": 1.5,
19
- "max_rpc_timeout_millis": 60000,
20
- "total_timeout_millis": 90000
15
+ "retry_delay_multiplier": 1.3,
16
+ "max_retry_delay_millis": 60000,
17
+ "initial_rpc_timeout_millis": 20000,
18
+ "rpc_timeout_multiplier": 1.0,
19
+ "max_rpc_timeout_millis": 20000,
20
+ "total_timeout_millis": 600000
21
21
  },
22
22
  "write_sink": {
23
23
  "initial_retry_delay_millis": 100,
24
- "retry_delay_multiplier": 1.2,
25
- "max_retry_delay_millis": 1000,
26
- "initial_rpc_timeout_millis": 30000,
27
- "rpc_timeout_multiplier": 1.5,
28
- "max_rpc_timeout_millis": 60000,
29
- "total_timeout_millis": 120000
24
+ "retry_delay_multiplier": 1.3,
25
+ "max_retry_delay_millis": 60000,
26
+ "initial_rpc_timeout_millis": 20000,
27
+ "rpc_timeout_multiplier": 1.0,
28
+ "max_rpc_timeout_millis": 20000,
29
+ "total_timeout_millis": 600000
30
30
  }
31
31
  },
32
32
  "methods": {
@@ -47,7 +47,7 @@
47
47
  },
48
48
  "UpdateSink": {
49
49
  "timeout_millis": 120000,
50
- "retry_codes_name": "non_idempotent",
50
+ "retry_codes_name": "idempotent",
51
51
  "retry_params_name": "default"
52
52
  },
53
53
  "DeleteSink": {
@@ -0,0 +1,38 @@
1
+ # Copyright 2018 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require "googleauth"
16
+
17
+ module Google
18
+ module Cloud
19
+ module Logging
20
+ module V2
21
+ class Credentials < Google::Auth::Credentials
22
+ SCOPE = ["https://www.googleapis.com/auth/logging.admin"].freeze
23
+ PATH_ENV_VARS = %w(LOGGING_CREDENTIALS
24
+ LOGGING_KEYFILE
25
+ GOOGLE_CLOUD_CREDENTIALS
26
+ GOOGLE_CLOUD_KEYFILE
27
+ GCLOUD_KEYFILE)
28
+ JSON_ENV_VARS = %w(LOGGING_CREDENTIALS_JSON
29
+ LOGGING_KEYFILE_JSON
30
+ GOOGLE_CLOUD_CREDENTIALS_JSON
31
+ GOOGLE_CLOUD_KEYFILE_JSON
32
+ GCLOUD_KEYFILE_JSON)
33
+ DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
34
+ end
35
+ end
36
+ end
37
+ end
38
+ end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -19,14 +19,7 @@ module Google
19
19
  # existing data unusable.
20
20
  # @!attribute [rw] name
21
21
  # @return [String]
22
- # The resource name of the metric descriptor. Depending on the
23
- # implementation, the name typically includes: (1) the parent resource name
24
- # that defines the scope of the metric type or of its data; and (2) the
25
- # metric's URL-encoded type, which also appears in the +type+ field of this
26
- # descriptor. For example, following is the resource name of a custom
27
- # metric within the GCP project +my-project-id+:
28
- #
29
- # "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
22
+ # The resource name of the metric descriptor.
30
23
  # @!attribute [rw] type
31
24
  # @return [String]
32
25
  # The metric type, including its DNS name prefix. The type is not
@@ -93,8 +86,6 @@ module Google
93
86
  #
94
87
  # **Grammar**
95
88
  #
96
- # The grammar includes the dimensionless unit +1+, such as +1/s+.
97
- #
98
89
  # The grammar also includes these connectors:
99
90
  #
100
91
  # * +/+ division (as an infix operator, e.g. +1/s+).
@@ -104,7 +95,7 @@ module Google
104
95
  #
105
96
  # Expression = Component { "." Component } { "/" Component } ;
106
97
  #
107
- # Component = [ PREFIX ] UNIT [ Annotation ]
98
+ # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
108
99
  # | Annotation
109
100
  # | "1"
110
101
  # ;
@@ -118,6 +109,9 @@ module Google
118
109
  # +{requests}/s == 1/s+, +By{transmitted}/s == By/s+.
119
110
  # * +NAME+ is a sequence of non-blank printable ASCII characters not
120
111
  # containing '{' or '}'.
112
+ # * +1+ represents dimensionless value 1, such as in +1/s+.
113
+ # * +%+ represents dimensionless value 1/100, and annotates values giving
114
+ # a percentage.
121
115
  # @!attribute [rw] description
122
116
  # @return [String]
123
117
  # A detailed description of the metric, which can be used in documentation.
@@ -125,6 +119,8 @@ module Google
125
119
  # @return [String]
126
120
  # A concise name for the metric, which can be displayed in user interfaces.
127
121
  # Use sentence case without an ending period, for example "Request count".
122
+ # This field is optional but it is recommended to be set for any metrics
123
+ # associated with user-visible concepts, such as Quota.
128
124
  class MetricDescriptor
129
125
  # The kind of measurement. It describes how the data is reported.
130
126
  module MetricKind
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -70,12 +70,36 @@ module Google
70
70
  # @return [String]
71
71
  # Required. The monitored resource type. This field must match
72
72
  # the +type+ field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
73
- # example, the type of a Cloud SQL database is +"cloudsql_database"+.
73
+ # example, the type of a Compute Engine VM instance is +gce_instance+.
74
74
  # @!attribute [rw] labels
75
75
  # @return [Hash{String => String}]
76
76
  # Required. Values for all of the labels listed in the associated monitored
77
- # resource descriptor. For example, Cloud SQL databases use the labels
78
- # +"database_id"+ and +"zone"+.
77
+ # resource descriptor. For example, Compute Engine VM instances use the
78
+ # labels +"project_id"+, +"instance_id"+, and +"zone"+.
79
79
  class MonitoredResource; end
80
+
81
+ # Auxiliary metadata for a {Google::Api::MonitoredResource MonitoredResource} object.
82
+ # {Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
83
+ # uniquely identify a monitored resource instance. There is some other useful
84
+ # auxiliary metadata. Google Stackdriver Monitoring & Logging uses an ingestion
85
+ # pipeline to extract metadata for cloud resources of all types , and stores
86
+ # the metadata in this message.
87
+ # @!attribute [rw] system_labels
88
+ # @return [Google::Protobuf::Struct]
89
+ # Output only. Values for predefined system metadata labels.
90
+ # System labels are a kind of metadata extracted by Google Stackdriver.
91
+ # Stackdriver determines what system labels are useful and how to obtain
92
+ # their values. Some examples: "machine_image", "vpc", "subnet_id",
93
+ # "security_group", "name", etc.
94
+ # System label values can be only strings, Boolean values, or a list of
95
+ # strings. For example:
96
+ #
97
+ # { "name": "my-test-instance",
98
+ # "security_group": ["a", "b", "c"],
99
+ # "spot_instance": false }
100
+ # @!attribute [rw] user_labels
101
+ # @return [Hash{String => String}]
102
+ # Output only. A map of user-defined metadata labels.
103
+ class MonitoredResourceMetadata; end
80
104
  end
81
105
  end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -42,7 +42,7 @@ module Google
42
42
  # any results.
43
43
  # @!attribute [rw] resource
44
44
  # @return [Google::Api::MonitoredResource]
45
- # Required. The monitored resource associated with this log entry.
45
+ # Required. The primary monitored resource associated with this log entry.
46
46
  # Example: a log entry that reports a database error would be
47
47
  # associated with the monitored resource designating the particular
48
48
  # database that reported the error.
@@ -64,11 +64,15 @@ module Google
64
64
  # This time is used to compute the log entry's age and to enforce
65
65
  # the logs retention period. If this field is omitted in a new log
66
66
  # entry, then Stackdriver Logging assigns it the current time.
67
+ # Timestamps have nanosecond accuracy, but trailing zeros in the fractional
68
+ # seconds might be omitted when the timestamp is displayed.
67
69
  #
68
70
  # Incoming log entries should have timestamps that are no more than
69
- # the [logs retention period](https://cloud.google.com/logging/quota-policy) in the past,
70
- # and no more than 24 hours in the future.
71
- # See the +entries.write+ API method for more information.
71
+ # the [logs retention period](https://cloud.google.com/logging/quotas) in the past,
72
+ # and no more than 24 hours in the future. Log entries outside those time
73
+ # boundaries will not be available when calling +entries.list+, but
74
+ # those log entries can still be exported with
75
+ # [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
72
76
  # @!attribute [rw] receive_timestamp
73
77
  # @return [Google::Protobuf::Timestamp]
74
78
  # Output only. The time the log entry was received by Stackdriver Logging.
@@ -92,6 +96,11 @@ module Google
92
96
  # @return [Hash{String => String}]
93
97
  # Optional. A set of user-defined (key, value) data that provides additional
94
98
  # information about the log entry.
99
+ # @!attribute [rw] metadata
100
+ # @return [Google::Api::MonitoredResourceMetadata]
101
+ # Output only. Additional metadata about the monitored resource.
102
+ # Only +k8s_container+, +k8s_pod+, and +k8s_node+ MonitoredResources have
103
+ # this field populated.
95
104
  # @!attribute [rw] operation
96
105
  # @return [Google::Logging::V2::LogEntryOperation]
97
106
  # Optional. Information about an operation associated with the log entry, if
@@ -104,11 +113,10 @@ module Google
104
113
  # +projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824+
105
114
  # @!attribute [rw] span_id
106
115
  # @return [String]
107
- # Optional. Id of the span within the trace associated with the log entry.
108
- # e.g. "0000000000000042"
109
- # For Stackdriver trace spans, this is the same format that the Stackdriver
110
- # trace API uses.
111
- # The ID is a 16-character hexadecimal encoding of an 8-byte array.
116
+ # Optional. The span ID within the trace associated with the log entry. For
117
+ # Stackdriver Trace spans, this is the same format that the Stackdriver Trace
118
+ # API v2 uses: a 16-character hexadecimal encoding of an 8-byte array, such
119
+ # as <code>"000000000000004a"</code>.
112
120
  # @!attribute [rw] source_location
113
121
  # @return [Google::Logging::V2::LogEntrySourceLocation]
114
122
  # Optional. Source code location information associated with the log entry,
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
14
14
 
15
15
  module Google
16
16
  module Logging
17
- ##
18
- # # Stackdriver Logging API Contents
19
- #
20
- # | Class | Description |
21
- # | ----- | ----------- |
22
- # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
23
- # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
24
- # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
25
- # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
26
- #
27
- # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
28
- # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
29
- # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
30
- # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
31
- #
32
17
  module V2
33
18
  # The parameters to DeleteLog.
34
19
  # @!attribute [rw] log_name
@@ -85,7 +70,8 @@ module Google
85
70
  # entries in this list does not matter. Values supplied in this method's
86
71
  # +log_name+, +resource+, and +labels+ fields are copied into those log
87
72
  # entries in this list that do not include values for their corresponding
88
- # fields. For more information, see the {Google::Logging::V2::LogEntry LogEntry} type.
73
+ # fields. For more information, see the
74
+ # {Google::Logging::V2::LogEntry LogEntry} type.
89
75
  #
90
76
  # If the +timestamp+ or +insert_id+ fields are missing in log entries, then
91
77
  # this method supplies the current time or a unique identifier, respectively.
@@ -95,8 +81,9 @@ module Google
95
81
  #
96
82
  # Log entries with timestamps that are more than the
97
83
  # [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
98
- # 24 hours in the future might be discarded. Discarding does not return
99
- # an error.
84
+ # 24 hours in the future will not be available when calling +entries.list+.
85
+ # However, those log entries can still be exported with
86
+ # [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
100
87
  #
101
88
  # To improve throughput and to avoid exceeding the
102
89
  # [quota limit](https://cloud.google.com/logging/quota-policy) for calls to +entries.write+,
@@ -109,6 +96,11 @@ module Google
109
96
  # entry is not written, then the response status is the error associated
110
97
  # with one of the failed entries and the response includes error details
111
98
  # keyed by the entries' zero-based index in the +entries.write+ method.
99
+ # @!attribute [rw] dry_run
100
+ # @return [true, false]
101
+ # Optional. If true, the request should expect normal response, but the
102
+ # entries won't be persisted nor exported. Useful for checking whether the
103
+ # logging API endpoints are working properly before sending valuable data.
112
104
  class WriteLogEntriesRequest; end
113
105
 
114
106
  # Result returned from WriteLogEntries.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
14
14
 
15
15
  module Google
16
16
  module Logging
17
- ##
18
- # # Stackdriver Logging API Contents
19
- #
20
- # | Class | Description |
21
- # | ----- | ----------- |
22
- # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
23
- # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
24
- # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
25
- # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
26
- #
27
- # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
28
- # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
29
- # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
30
- # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
31
- #
32
17
  module V2
33
18
  # Describes a sink used to export log entries to one of the following
34
19
  # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
@@ -281,12 +266,12 @@ module Google
281
266
  # For example, the following filter matches 99% of low-severity log
282
267
  # entries from load balancers:
283
268
  #
284
- # "resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"
269
+ # +"resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"+
285
270
  # @!attribute [rw] disabled
286
271
  # @return [true, false]
287
272
  # Optional. If set to True, then this exclusion is disabled and it does not
288
273
  # exclude any log entries. You can use
289
- # [exclusions.patch](https://cloud.google.com/logging/docs/alpha-exclusion/docs/reference/v2/rest/v2/projects.exclusions/patch)
274
+ # [exclusions.patch](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.exclusions/patch)
290
275
  # to change the value of this field.
291
276
  class LogExclusion; end
292
277
 
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -14,21 +14,6 @@
14
14
 
15
15
  module Google
16
16
  module Logging
17
- ##
18
- # # Stackdriver Logging API Contents
19
- #
20
- # | Class | Description |
21
- # | ----- | ----------- |
22
- # | [LoggingServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
23
- # | [ConfigServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
24
- # | [MetricsServiceV2Client][] | Writes log entries and manages your Stackdriver Logging configuration. |
25
- # | [Data Types][] | Data types for Google::Cloud::Logging::V2 |
26
- #
27
- # [LoggingServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/loggingservicev2client
28
- # [ConfigServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/configservicev2client
29
- # [MetricsServiceV2Client]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/metricsservicev2client
30
- # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/logging/v2/datatypes
31
- #
32
17
  module V2
33
18
  # Describes a logs-based metric. The value of the metric is the
34
19
  # number of log entries that match a logs filter in a given time interval.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -0,0 +1,28 @@
1
+ # Copyright 2018 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ module Google
16
+ module Protobuf
17
+ # A generic empty message that you can re-use to avoid defining duplicated
18
+ # empty messages in your APIs. A typical example is to use it as the request
19
+ # or the response type of an API method. For instance:
20
+ #
21
+ # service Foo {
22
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
23
+ # }
24
+ #
25
+ # The JSON representation for +Empty+ is empty JSON object +{}+.
26
+ class Empty; end
27
+ end
28
+ end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.