google-cloud-logging 1.9.5 → 1.10.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +24 -0
- data/lib/google/cloud/logging/sink.rb +1 -4
- data/lib/google/cloud/logging/v2/config_service_v2_client.rb +266 -168
- data/lib/google/cloud/logging/v2/config_service_v2_client_config.json +22 -21
- data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb +0 -23
- data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb +18 -32
- data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb +4 -10
- data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb +154 -35
- data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_metrics.rb +2 -2
- data/lib/google/cloud/logging/v2/logging_service_v2_client.rb +16 -98
- data/lib/google/cloud/logging/v2/logging_service_v2_client_config.json +4 -19
- data/lib/google/cloud/logging/v2/metrics_service_v2_client.rb +11 -53
- data/lib/google/cloud/logging/v2/metrics_service_v2_client_config.json +2 -3
- data/lib/google/cloud/logging/version.rb +1 -1
- data/lib/google/logging/v2/log_entry_pb.rb +1 -1
- data/lib/google/logging/v2/logging_config_pb.rb +36 -2
- data/lib/google/logging/v2/logging_config_services_pb.rb +16 -0
- data/lib/google/logging/v2/logging_pb.rb +1 -2
- metadata +2 -2
@@ -4,14 +4,9 @@
|
|
4
4
|
"retry_codes": {
|
5
5
|
"idempotent": [
|
6
6
|
"DEADLINE_EXCEEDED",
|
7
|
-
"INTERNAL",
|
8
7
|
"UNAVAILABLE"
|
9
8
|
],
|
10
|
-
"non_idempotent": []
|
11
|
-
"idempotent2": [
|
12
|
-
"DEADLINE_EXCEEDED",
|
13
|
-
"UNAVAILABLE"
|
14
|
-
]
|
9
|
+
"non_idempotent": []
|
15
10
|
},
|
16
11
|
"retry_params": {
|
17
12
|
"default": {
|
@@ -22,18 +17,24 @@
|
|
22
17
|
"rpc_timeout_multiplier": 1.0,
|
23
18
|
"max_rpc_timeout_millis": 20000,
|
24
19
|
"total_timeout_millis": 600000
|
25
|
-
},
|
26
|
-
"write_sink": {
|
27
|
-
"initial_retry_delay_millis": 100,
|
28
|
-
"retry_delay_multiplier": 1.3,
|
29
|
-
"max_retry_delay_millis": 60000,
|
30
|
-
"initial_rpc_timeout_millis": 20000,
|
31
|
-
"rpc_timeout_multiplier": 1.0,
|
32
|
-
"max_rpc_timeout_millis": 20000,
|
33
|
-
"total_timeout_millis": 600000
|
34
20
|
}
|
35
21
|
},
|
36
22
|
"methods": {
|
23
|
+
"ListBuckets": {
|
24
|
+
"timeout_millis": 60000,
|
25
|
+
"retry_codes_name": "idempotent",
|
26
|
+
"retry_params_name": "default"
|
27
|
+
},
|
28
|
+
"GetBucket": {
|
29
|
+
"timeout_millis": 60000,
|
30
|
+
"retry_codes_name": "idempotent",
|
31
|
+
"retry_params_name": "default"
|
32
|
+
},
|
33
|
+
"UpdateBucket": {
|
34
|
+
"timeout_millis": 60000,
|
35
|
+
"retry_codes_name": "non_idempotent",
|
36
|
+
"retry_params_name": "default"
|
37
|
+
},
|
37
38
|
"ListSinks": {
|
38
39
|
"timeout_millis": 60000,
|
39
40
|
"retry_codes_name": "idempotent",
|
@@ -45,18 +46,18 @@
|
|
45
46
|
"retry_params_name": "default"
|
46
47
|
},
|
47
48
|
"CreateSink": {
|
48
|
-
"timeout_millis":
|
49
|
+
"timeout_millis": 60000,
|
49
50
|
"retry_codes_name": "non_idempotent",
|
50
51
|
"retry_params_name": "default"
|
51
52
|
},
|
52
53
|
"UpdateSink": {
|
53
|
-
"timeout_millis":
|
54
|
-
"retry_codes_name": "
|
54
|
+
"timeout_millis": 60000,
|
55
|
+
"retry_codes_name": "non_idempotent",
|
55
56
|
"retry_params_name": "default"
|
56
57
|
},
|
57
58
|
"DeleteSink": {
|
58
59
|
"timeout_millis": 60000,
|
59
|
-
"retry_codes_name": "
|
60
|
+
"retry_codes_name": "non_idempotent",
|
60
61
|
"retry_params_name": "default"
|
61
62
|
},
|
62
63
|
"ListExclusions": {
|
@@ -81,12 +82,12 @@
|
|
81
82
|
},
|
82
83
|
"DeleteExclusion": {
|
83
84
|
"timeout_millis": 60000,
|
84
|
-
"retry_codes_name": "
|
85
|
+
"retry_codes_name": "non_idempotent",
|
85
86
|
"retry_params_name": "default"
|
86
87
|
},
|
87
88
|
"GetCmekSettings": {
|
88
89
|
"timeout_millis": 60000,
|
89
|
-
"retry_codes_name": "
|
90
|
+
"retry_codes_name": "idempotent",
|
90
91
|
"retry_params_name": "default"
|
91
92
|
},
|
92
93
|
"UpdateCmekSettings": {
|
@@ -81,28 +81,5 @@ module Google
|
|
81
81
|
# resource descriptor. For example, Compute Engine VM instances use the
|
82
82
|
# labels `"project_id"`, `"instance_id"`, and `"zone"`.
|
83
83
|
class MonitoredResource; end
|
84
|
-
|
85
|
-
# Auxiliary metadata for a {Google::Api::MonitoredResource MonitoredResource} object.
|
86
|
-
# {Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
|
87
|
-
# uniquely identify a monitored resource instance. There is some other useful
|
88
|
-
# auxiliary metadata. Monitoring and Logging use an ingestion
|
89
|
-
# pipeline to extract metadata for cloud resources of all types, and store
|
90
|
-
# the metadata in this message.
|
91
|
-
# @!attribute [rw] system_labels
|
92
|
-
# @return [Google::Protobuf::Struct]
|
93
|
-
# Output only. Values for predefined system metadata labels.
|
94
|
-
# System labels are a kind of metadata extracted by Google, including
|
95
|
-
# "machine_image", "vpc", "subnet_id",
|
96
|
-
# "security_group", "name", etc.
|
97
|
-
# System label values can be only strings, Boolean values, or a list of
|
98
|
-
# strings. For example:
|
99
|
-
#
|
100
|
-
# { "name": "my-test-instance",
|
101
|
-
# "security_group": ["a", "b", "c"],
|
102
|
-
# "spot_instance": false }
|
103
|
-
# @!attribute [rw] user_labels
|
104
|
-
# @return [Hash{String => String}]
|
105
|
-
# Output only. A map of user-defined metadata labels.
|
106
|
-
class MonitoredResourceMetadata; end
|
107
84
|
end
|
108
85
|
end
|
@@ -26,9 +26,9 @@ module Google
|
|
26
26
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
|
27
27
|
# "folders/[FOLDER_ID]/logs/[LOG_ID]"
|
28
28
|
#
|
29
|
-
# A project number may
|
30
|
-
#
|
31
|
-
#
|
29
|
+
# A project number may be used in place of PROJECT_ID. The project number is
|
30
|
+
# translated to its corresponding PROJECT_ID internally and the `log_name`
|
31
|
+
# field will contain PROJECT_ID in queries and exports.
|
32
32
|
#
|
33
33
|
# `[LOG_ID]` must be URL-encoded within `log_name`. Example:
|
34
34
|
# `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
|
@@ -67,12 +67,11 @@ module Google
|
|
67
67
|
# expressed as a JSON object.
|
68
68
|
# @!attribute [rw] timestamp
|
69
69
|
# @return [Google::Protobuf::Timestamp]
|
70
|
-
# Optional. The time the event described by the log entry occurred.
|
71
|
-
#
|
72
|
-
#
|
73
|
-
#
|
74
|
-
#
|
75
|
-
# timestamp is displayed.
|
70
|
+
# Optional. The time the event described by the log entry occurred. This time is used
|
71
|
+
# to compute the log entry's age and to enforce the logs retention period.
|
72
|
+
# If this field is omitted in a new log entry, then Logging assigns it the
|
73
|
+
# current time. Timestamps have nanosecond accuracy, but trailing zeros in
|
74
|
+
# the fractional seconds might be omitted when the timestamp is displayed.
|
76
75
|
#
|
77
76
|
# Incoming log entries should have timestamps that are no more than the [logs
|
78
77
|
# retention period](/logging/quotas) in the past, and no more than 24 hours
|
@@ -84,12 +83,11 @@ module Google
|
|
84
83
|
# Output only. The time the log entry was received by Logging.
|
85
84
|
# @!attribute [rw] severity
|
86
85
|
# @return [Google::Logging::Type::LogSeverity]
|
87
|
-
# Optional. The severity of the log entry. The default value is
|
88
|
-
# `LogSeverity.DEFAULT`.
|
86
|
+
# Optional. The severity of the log entry. The default value is `LogSeverity.DEFAULT`.
|
89
87
|
# @!attribute [rw] insert_id
|
90
88
|
# @return [String]
|
91
|
-
# Optional. A unique identifier for the log entry. If you provide a value,
|
92
|
-
#
|
89
|
+
# Optional. A unique identifier for the log entry. If you provide a value, then
|
90
|
+
# Logging considers other log entries in the same project, with the same
|
93
91
|
# `timestamp`, and with the same `insert_id` to be duplicates which are
|
94
92
|
# removed in a single query result. However, there are no guarantees of
|
95
93
|
# de-duplication in the export of logs.
|
@@ -101,32 +99,21 @@ module Google
|
|
101
99
|
# the same `log_name` and `timestamp` values.
|
102
100
|
# @!attribute [rw] http_request
|
103
101
|
# @return [Google::Logging::Type::HttpRequest]
|
104
|
-
# Optional. Information about the HTTP request associated with this log
|
105
|
-
#
|
102
|
+
# Optional. Information about the HTTP request associated with this log entry, if
|
103
|
+
# applicable.
|
106
104
|
# @!attribute [rw] labels
|
107
105
|
# @return [Hash{String => String}]
|
108
106
|
# Optional. A set of user-defined (key, value) data that provides additional
|
109
107
|
# information about the log entry.
|
110
|
-
# @!attribute [rw] metadata
|
111
|
-
# @return [Google::Api::MonitoredResourceMetadata]
|
112
|
-
# Deprecated. Output only. Additional metadata about the monitored resource.
|
113
|
-
#
|
114
|
-
# Only `k8s_container`, `k8s_pod`, and `k8s_node` MonitoredResources have
|
115
|
-
# this field populated for GKE versions older than 1.12.6. For GKE versions
|
116
|
-
# 1.12.6 and above, the `metadata` field has been deprecated. The Kubernetes
|
117
|
-
# pod labels that used to be in `metadata.userLabels` will now be present in
|
118
|
-
# the `labels` field with a key prefix of `k8s-pod/`. The Stackdriver system
|
119
|
-
# labels that were present in the `metadata.systemLabels` field will no
|
120
|
-
# longer be available in the LogEntry.
|
121
108
|
# @!attribute [rw] operation
|
122
109
|
# @return [Google::Logging::V2::LogEntryOperation]
|
123
110
|
# Optional. Information about an operation associated with the log entry, if
|
124
111
|
# applicable.
|
125
112
|
# @!attribute [rw] trace
|
126
113
|
# @return [String]
|
127
|
-
# Optional. Resource name of the trace associated with the log entry, if any.
|
128
|
-
#
|
129
|
-
#
|
114
|
+
# Optional. Resource name of the trace associated with the log entry, if any. If it
|
115
|
+
# contains a relative resource name, the name is assumed to be relative to
|
116
|
+
# `//tracing.googleapis.com`. Example:
|
130
117
|
# `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
|
131
118
|
# @!attribute [rw] span_id
|
132
119
|
# @return [String]
|
@@ -134,7 +121,7 @@ module Google
|
|
134
121
|
#
|
135
122
|
# For Trace spans, this is the same format that the Trace API v2 uses: a
|
136
123
|
# 16-character hexadecimal encoding of an 8-byte array, such as
|
137
|
-
#
|
124
|
+
# `000000000000004a`.
|
138
125
|
# @!attribute [rw] trace_sampled
|
139
126
|
# @return [true, false]
|
140
127
|
# Optional. The sampling decision of the trace associated with the log entry.
|
@@ -146,8 +133,7 @@ module Google
|
|
146
133
|
# request correlation identifier. The default is False.
|
147
134
|
# @!attribute [rw] source_location
|
148
135
|
# @return [Google::Logging::V2::LogEntrySourceLocation]
|
149
|
-
# Optional. Source code location information associated with the log entry,
|
150
|
-
# if any.
|
136
|
+
# Optional. Source code location information associated with the log entry, if any.
|
151
137
|
class LogEntry; end
|
152
138
|
|
153
139
|
# Additional information about a potentially long-running operation with which
|
@@ -49,10 +49,10 @@ module Google
|
|
49
49
|
# "projects/my-project-id/logs/syslog"
|
50
50
|
# "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
|
51
51
|
#
|
52
|
-
# The permission
|
53
|
-
#
|
54
|
-
#
|
55
|
-
#
|
52
|
+
# The permission `logging.logEntries.create` is needed on each project,
|
53
|
+
# organization, billing account, or folder that is receiving new log
|
54
|
+
# entries, whether the resource is specified in `logName` or in an
|
55
|
+
# individual log entry.
|
56
56
|
# @!attribute [rw] resource
|
57
57
|
# @return [Google::Api::MonitoredResource]
|
58
58
|
# Optional. A default monitored resource object that is assigned to all log
|
@@ -109,15 +109,9 @@ module Google
|
|
109
109
|
class WriteLogEntriesRequest; end
|
110
110
|
|
111
111
|
# Result returned from WriteLogEntries.
|
112
|
-
# empty
|
113
112
|
class WriteLogEntriesResponse; end
|
114
113
|
|
115
114
|
# The parameters to `ListLogEntries`.
|
116
|
-
# @!attribute [rw] project_ids
|
117
|
-
# @return [Array<String>]
|
118
|
-
# Deprecated. Use `resource_names` instead. One or more project identifiers
|
119
|
-
# or project numbers from which to retrieve log entries. Example:
|
120
|
-
# `"my-project-1A"`.
|
121
115
|
# @!attribute [rw] resource_names
|
122
116
|
# @return [Array<String>]
|
123
117
|
# Required. Names of one or more parent resources from which to
|
@@ -16,6 +16,40 @@
|
|
16
16
|
module Google
|
17
17
|
module Logging
|
18
18
|
module V2
|
19
|
+
# Describes a repository of logs (Beta).
|
20
|
+
# @!attribute [rw] name
|
21
|
+
# @return [String]
|
22
|
+
# The resource name of the bucket.
|
23
|
+
# For example:
|
24
|
+
# "projects/my-project-id/locations/my-location/buckets/my-bucket-id The
|
25
|
+
# supported locations are:
|
26
|
+
# "global"
|
27
|
+
# "us-central1"
|
28
|
+
#
|
29
|
+
# For the location of `global` it is unspecified where logs are actually
|
30
|
+
# stored.
|
31
|
+
# Once a bucket has been created, the location can not be changed.
|
32
|
+
# @!attribute [rw] description
|
33
|
+
# @return [String]
|
34
|
+
# Describes this bucket.
|
35
|
+
# @!attribute [rw] create_time
|
36
|
+
# @return [Google::Protobuf::Timestamp]
|
37
|
+
# Output only. The creation timestamp of the bucket. This is not set for any of the
|
38
|
+
# default buckets.
|
39
|
+
# @!attribute [rw] update_time
|
40
|
+
# @return [Google::Protobuf::Timestamp]
|
41
|
+
# Output only. The last update timestamp of the bucket.
|
42
|
+
# @!attribute [rw] retention_days
|
43
|
+
# @return [Integer]
|
44
|
+
# Logs will be retained by default for this amount of time, after which they
|
45
|
+
# will automatically be deleted. The minimum retention period is 1 day.
|
46
|
+
# If this value is set to zero at bucket creation time, the default time of
|
47
|
+
# 30 days will be used.
|
48
|
+
# @!attribute [rw] lifecycle_state
|
49
|
+
# @return [Google::Logging::V2::LifecycleState]
|
50
|
+
# Output only. The bucket lifecycle state.
|
51
|
+
class LogBucket; end
|
52
|
+
|
19
53
|
# Describes a sink used to export log entries to one of the following
|
20
54
|
# destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
|
21
55
|
# Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
|
@@ -23,11 +57,11 @@ module Google
|
|
23
57
|
# folder.
|
24
58
|
# @!attribute [rw] name
|
25
59
|
# @return [String]
|
26
|
-
# Required. The client-assigned sink identifier, unique within the
|
27
|
-
#
|
28
|
-
#
|
29
|
-
#
|
30
|
-
#
|
60
|
+
# Required. The client-assigned sink identifier, unique within the project. Example:
|
61
|
+
# `"my-syslog-errors-to-pubsub"`. Sink identifiers are limited to 100
|
62
|
+
# characters and can include only the following characters: upper and
|
63
|
+
# lower-case alphanumeric characters, underscores, hyphens, and periods.
|
64
|
+
# First character has to be alphanumeric.
|
31
65
|
# @!attribute [rw] destination
|
32
66
|
# @return [String]
|
33
67
|
# Required. The export destination:
|
@@ -61,13 +95,11 @@ module Google
|
|
61
95
|
# entries. The v2 format is used by default and cannot be changed.
|
62
96
|
# @!attribute [rw] writer_identity
|
63
97
|
# @return [String]
|
64
|
-
# Output only. An IAM identity
|
65
|
-
#
|
66
|
-
#
|
67
|
-
# {Google::Logging::V2::ConfigServiceV2#
|
68
|
-
#
|
69
|
-
# {Google::Logging::V2::ConfigServiceV2#update_sink}
|
70
|
-
# based on the value of `unique_writer_identity` in those methods.
|
98
|
+
# Output only. An IAM identity–a service account or group—under which Logging
|
99
|
+
# writes the exported log entries to the sink's destination. This field is
|
100
|
+
# set by {Google::Logging::V2::ConfigServiceV2#create_sink} and
|
101
|
+
# {Google::Logging::V2::ConfigServiceV2#update_sink} based on the
|
102
|
+
# value of `unique_writer_identity` in those methods.
|
71
103
|
#
|
72
104
|
# Until you grant this identity write-access to the destination, log entry
|
73
105
|
# exports from this sink will fail. For more information,
|
@@ -103,12 +135,6 @@ module Google
|
|
103
135
|
# Output only. The last update timestamp of the sink.
|
104
136
|
#
|
105
137
|
# This field may not be present for older sinks.
|
106
|
-
# @!attribute [rw] start_time
|
107
|
-
# @return [Google::Protobuf::Timestamp]
|
108
|
-
# Do not use. This field is ignored.
|
109
|
-
# @!attribute [rw] end_time
|
110
|
-
# @return [Google::Protobuf::Timestamp]
|
111
|
-
# Do not use. This field is ignored.
|
112
138
|
class LogSink
|
113
139
|
# Available log entry formats. Log entries can be written to
|
114
140
|
# Logging in either format and can be exported in either format.
|
@@ -145,6 +171,86 @@ module Google
|
|
145
171
|
# this field set to false.
|
146
172
|
class BigQueryOptions; end
|
147
173
|
|
174
|
+
# The parameters to `ListBuckets` (Beta).
|
175
|
+
# @!attribute [rw] parent
|
176
|
+
# @return [String]
|
177
|
+
# Required. The parent resource whose buckets are to be listed:
|
178
|
+
#
|
179
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
|
180
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]"
|
181
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]"
|
182
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]"
|
183
|
+
#
|
184
|
+
# Note: The locations portion of the resource must be specified, but
|
185
|
+
# supplying the character `-` in place of [LOCATION_ID] will return all
|
186
|
+
# buckets.
|
187
|
+
# @!attribute [rw] page_token
|
188
|
+
# @return [String]
|
189
|
+
# Optional. If present, then retrieve the next batch of results from the
|
190
|
+
# preceding call to this method. `pageToken` must be the value of
|
191
|
+
# `nextPageToken` from the previous response. The values of other method
|
192
|
+
# parameters should be identical to those in the previous call.
|
193
|
+
# @!attribute [rw] page_size
|
194
|
+
# @return [Integer]
|
195
|
+
# Optional. The maximum number of results to return from this request.
|
196
|
+
# Non-positive values are ignored. The presence of `nextPageToken` in the
|
197
|
+
# response indicates that more results might be available.
|
198
|
+
class ListBucketsRequest; end
|
199
|
+
|
200
|
+
# The response from ListBuckets (Beta).
|
201
|
+
# @!attribute [rw] buckets
|
202
|
+
# @return [Array<Google::Logging::V2::LogBucket>]
|
203
|
+
# A list of buckets.
|
204
|
+
# @!attribute [rw] next_page_token
|
205
|
+
# @return [String]
|
206
|
+
# If there might be more results than appear in this response, then
|
207
|
+
# `nextPageToken` is included. To get the next set of results, call the same
|
208
|
+
# method again using the value of `nextPageToken` as `pageToken`.
|
209
|
+
class ListBucketsResponse; end
|
210
|
+
|
211
|
+
# The parameters to `UpdateBucket` (Beta).
|
212
|
+
# @!attribute [rw] name
|
213
|
+
# @return [String]
|
214
|
+
# Required. The full resource name of the bucket to update.
|
215
|
+
#
|
216
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
217
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
218
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
219
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
220
|
+
#
|
221
|
+
# Example:
|
222
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`. Also
|
223
|
+
# requires permission "resourcemanager.projects.updateLiens" to set the
|
224
|
+
# locked property
|
225
|
+
# @!attribute [rw] bucket
|
226
|
+
# @return [Google::Logging::V2::LogBucket]
|
227
|
+
# Required. The updated bucket.
|
228
|
+
# @!attribute [rw] update_mask
|
229
|
+
# @return [Google::Protobuf::FieldMask]
|
230
|
+
# Required. Field mask that specifies the fields in `bucket` that need an update. A
|
231
|
+
# bucket field will be overwritten if, and only if, it is in the update
|
232
|
+
# mask. `name` and output only fields cannot be updated.
|
233
|
+
#
|
234
|
+
# For a detailed `FieldMask` definition, see
|
235
|
+
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
236
|
+
#
|
237
|
+
# Example: `updateMask=retention_days`.
|
238
|
+
class UpdateBucketRequest; end
|
239
|
+
|
240
|
+
# The parameters to `GetBucket` (Beta).
|
241
|
+
# @!attribute [rw] name
|
242
|
+
# @return [String]
|
243
|
+
# Required. The resource name of the bucket:
|
244
|
+
#
|
245
|
+
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
246
|
+
# "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
247
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
248
|
+
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
249
|
+
#
|
250
|
+
# Example:
|
251
|
+
# `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
|
252
|
+
class GetBucketRequest; end
|
253
|
+
|
148
254
|
# The parameters to `ListSinks`.
|
149
255
|
# @!attribute [rw] parent
|
150
256
|
# @return [String]
|
@@ -224,8 +330,8 @@ module Google
|
|
224
330
|
# The parameters to `UpdateSink`.
|
225
331
|
# @!attribute [rw] sink_name
|
226
332
|
# @return [String]
|
227
|
-
# Required. The full resource name of the sink to update, including the
|
228
|
-
#
|
333
|
+
# Required. The full resource name of the sink to update, including the parent
|
334
|
+
# resource and the sink identifier:
|
229
335
|
#
|
230
336
|
# "projects/[PROJECT_ID]/sinks/[SINK_ID]"
|
231
337
|
# "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
|
@@ -235,8 +341,8 @@ module Google
|
|
235
341
|
# Example: `"projects/my-project-id/sinks/my-sink-id"`.
|
236
342
|
# @!attribute [rw] sink
|
237
343
|
# @return [Google::Logging::V2::LogSink]
|
238
|
-
# Required. The updated sink, whose name is the same identifier that appears
|
239
|
-
#
|
344
|
+
# Required. The updated sink, whose name is the same identifier that appears as part
|
345
|
+
# of `sink_name`.
|
240
346
|
# @!attribute [rw] unique_writer_identity
|
241
347
|
# @return [true, false]
|
242
348
|
# Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
|
@@ -271,8 +377,8 @@ module Google
|
|
271
377
|
# The parameters to `DeleteSink`.
|
272
378
|
# @!attribute [rw] sink_name
|
273
379
|
# @return [String]
|
274
|
-
# Required. The full resource name of the sink to delete, including the
|
275
|
-
#
|
380
|
+
# Required. The full resource name of the sink to delete, including the parent
|
381
|
+
# resource and the sink identifier:
|
276
382
|
#
|
277
383
|
# "projects/[PROJECT_ID]/sinks/[SINK_ID]"
|
278
384
|
# "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
|
@@ -290,10 +396,10 @@ module Google
|
|
290
396
|
# apply to child resources, and that you can't exclude audit log entries.
|
291
397
|
# @!attribute [rw] name
|
292
398
|
# @return [String]
|
293
|
-
# Required. A client-assigned identifier, such as
|
294
|
-
#
|
295
|
-
#
|
296
|
-
#
|
399
|
+
# Required. A client-assigned identifier, such as `"load-balancer-exclusion"`.
|
400
|
+
# Identifiers are limited to 100 characters and can include only letters,
|
401
|
+
# digits, underscores, hyphens, and periods. First character has to be
|
402
|
+
# alphanumeric.
|
297
403
|
# @!attribute [rw] description
|
298
404
|
# @return [String]
|
299
405
|
# Optional. A description of this exclusion.
|
@@ -401,12 +507,12 @@ module Google
|
|
401
507
|
# Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
|
402
508
|
# @!attribute [rw] exclusion
|
403
509
|
# @return [Google::Logging::V2::LogExclusion]
|
404
|
-
# Required. New values for the existing exclusion. Only the fields specified
|
405
|
-
#
|
510
|
+
# Required. New values for the existing exclusion. Only the fields specified in
|
511
|
+
# `update_mask` are relevant.
|
406
512
|
# @!attribute [rw] update_mask
|
407
513
|
# @return [Google::Protobuf::FieldMask]
|
408
|
-
# Required. A non-empty list of fields to change in the existing exclusion.
|
409
|
-
#
|
514
|
+
# Required. A non-empty list of fields to change in the existing exclusion. New values
|
515
|
+
# for the fields are taken from the corresponding fields in the
|
410
516
|
# {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
|
411
517
|
# `update_mask` are not changed and are ignored in the request.
|
412
518
|
#
|
@@ -495,7 +601,7 @@ module Google
|
|
495
601
|
# for more information.
|
496
602
|
# @!attribute [rw] name
|
497
603
|
# @return [String]
|
498
|
-
# Output
|
604
|
+
# Output only. The resource name of the CMEK settings.
|
499
605
|
# @!attribute [rw] kms_key_name
|
500
606
|
# @return [String]
|
501
607
|
# The resource name for the configured Cloud KMS key.
|
@@ -524,8 +630,8 @@ module Google
|
|
524
630
|
# Router](/logging/docs/routing/managed-encryption) for more information.
|
525
631
|
# @!attribute [rw] service_account_id
|
526
632
|
# @return [String]
|
527
|
-
# Output
|
528
|
-
#
|
633
|
+
# Output only. The service account that will be used by the Logs Router to access your
|
634
|
+
# Cloud KMS key.
|
529
635
|
#
|
530
636
|
# Before enabling CMEK for Logs Router, you must first assign the role
|
531
637
|
# `roles/cloudkms.cryptoKeyEncrypterDecrypter` to the service account that
|
@@ -536,6 +642,19 @@ module Google
|
|
536
642
|
# See [Enabling CMEK for Logs
|
537
643
|
# Router](/logging/docs/routing/managed-encryption) for more information.
|
538
644
|
class CmekSettings; end
|
645
|
+
|
646
|
+
# LogBucket lifecycle states (Beta).
|
647
|
+
module LifecycleState
|
648
|
+
# Unspecified state. This is only used/useful for distinguishing
|
649
|
+
# unset values.
|
650
|
+
LIFECYCLE_STATE_UNSPECIFIED = 0
|
651
|
+
|
652
|
+
# The normal and active state.
|
653
|
+
ACTIVE = 1
|
654
|
+
|
655
|
+
# The bucket has been marked for deletion by the user.
|
656
|
+
DELETE_REQUESTED = 2
|
657
|
+
end
|
539
658
|
end
|
540
659
|
end
|
541
660
|
end
|