google-cloud-run-v2 0.5.0 → 0.6.0

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/README.md +1 -1
  3. data/lib/google/cloud/run/v2/condition_pb.rb +1 -0
  4. data/lib/google/cloud/run/v2/execution_pb.rb +3 -0
  5. data/lib/google/cloud/run/v2/executions/operations.rb +8 -0
  6. data/lib/google/cloud/run/v2/executions.rb +1 -1
  7. data/lib/google/cloud/run/v2/job_pb.rb +1 -0
  8. data/lib/google/cloud/run/v2/jobs/operations.rb +8 -0
  9. data/lib/google/cloud/run/v2/jobs.rb +1 -1
  10. data/lib/google/cloud/run/v2/revision_pb.rb +2 -0
  11. data/lib/google/cloud/run/v2/revisions/operations.rb +8 -0
  12. data/lib/google/cloud/run/v2/revisions.rb +1 -1
  13. data/lib/google/cloud/run/v2/services/client.rb +3 -3
  14. data/lib/google/cloud/run/v2/services/operations.rb +8 -0
  15. data/lib/google/cloud/run/v2/services.rb +1 -1
  16. data/lib/google/cloud/run/v2/task_pb.rb +1 -0
  17. data/lib/google/cloud/run/v2/tasks.rb +1 -1
  18. data/lib/google/cloud/run/v2/vendor_settings_pb.rb +6 -0
  19. data/lib/google/cloud/run/v2/version.rb +1 -1
  20. data/lib/google/cloud/run/v2.rb +2 -2
  21. data/proto_docs/google/api/client.rb +318 -0
  22. data/proto_docs/google/api/launch_stage.rb +3 -3
  23. data/proto_docs/google/cloud/run/v2/condition.rb +4 -0
  24. data/proto_docs/google/cloud/run/v2/execution.rb +30 -20
  25. data/proto_docs/google/cloud/run/v2/execution_template.rb +12 -1
  26. data/proto_docs/google/cloud/run/v2/job.rb +29 -21
  27. data/proto_docs/google/cloud/run/v2/k8s.min.rb +13 -8
  28. data/proto_docs/google/cloud/run/v2/revision.rb +19 -13
  29. data/proto_docs/google/cloud/run/v2/revision_template.rb +10 -0
  30. data/proto_docs/google/cloud/run/v2/service.rb +44 -34
  31. data/proto_docs/google/cloud/run/v2/task.rb +21 -18
  32. data/proto_docs/google/cloud/run/v2/vendor_settings.rb +12 -0
  33. data/proto_docs/google/rpc/status.rb +4 -2
  34. metadata +8 -7
@@ -96,8 +96,9 @@ module Google
96
96
  # Output only. The unique name of this Execution.
97
97
  # @!attribute [r] uid
98
98
  # @return [::String]
99
- # Output only. Server assigned unique identifier for the Execution. The value is a UUID4
100
- # string and guaranteed to remain unchanged until the resource is deleted.
99
+ # Output only. Server assigned unique identifier for the Execution. The value
100
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
101
+ # deleted.
101
102
  # @!attribute [r] generation
102
103
  # @return [::Integer]
103
104
  # Output only. A number that monotonically increases every time the user
@@ -110,17 +111,14 @@ module Google
110
111
  # environment, state, etc. For more information, visit
111
112
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
112
113
  # https://cloud.google.com/run/docs/configuring/labels
113
- # Cloud Run will populate some labels with 'run.googleapis.com' or
114
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
115
- # changes will not be preserved.
116
114
  # @!attribute [rw] annotations
117
115
  # @return [::Google::Protobuf::Map{::String => ::String}]
118
116
  # KRM-style annotations for the resource.
119
117
  # @!attribute [r] create_time
120
118
  # @return [::Google::Protobuf::Timestamp]
121
- # Output only. Represents time when the execution was acknowledged by the execution
122
- # controller. It is not guaranteed to be set in happens-before order across
123
- # separate operations.
119
+ # Output only. Represents time when the execution was acknowledged by the
120
+ # execution controller. It is not guaranteed to be set in happens-before
121
+ # order across separate operations.
124
122
  # @!attribute [r] start_time
125
123
  # @return [::Google::Protobuf::Timestamp]
126
124
  # Output only. Represents time when the execution started to run.
@@ -128,8 +126,8 @@ module Google
128
126
  # operations.
129
127
  # @!attribute [r] completion_time
130
128
  # @return [::Google::Protobuf::Timestamp]
131
- # Output only. Represents time when the execution was completed. It is not guaranteed to
132
- # be set in happens-before order across separate operations.
129
+ # Output only. Represents time when the execution was completed. It is not
130
+ # guaranteed to be set in happens-before order across separate operations.
133
131
  # @!attribute [r] update_time
134
132
  # @return [::Google::Protobuf::Timestamp]
135
133
  # Output only. The last-modified time.
@@ -153,16 +151,16 @@ module Google
153
151
  # Output only. The name of the parent Job.
154
152
  # @!attribute [r] parallelism
155
153
  # @return [::Integer]
156
- # Output only. Specifies the maximum desired number of tasks the execution should
157
- # run at any given time. Must be <= task_count. The actual number of
154
+ # Output only. Specifies the maximum desired number of tasks the execution
155
+ # should run at any given time. Must be <= task_count. The actual number of
158
156
  # tasks running in steady state will be less than this number when
159
157
  # ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when
160
158
  # the work left to do is less than max parallelism. More info:
161
159
  # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
162
160
  # @!attribute [r] task_count
163
161
  # @return [::Integer]
164
- # Output only. Specifies the desired number of tasks the execution should run.
165
- # Setting to 1 means that parallelism is limited to 1 and the success of
162
+ # Output only. Specifies the desired number of tasks the execution should
163
+ # run. Setting to 1 means that parallelism is limited to 1 and the success of
166
164
  # that task signals the success of the execution.
167
165
  # More info:
168
166
  # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
@@ -171,17 +169,19 @@ module Google
171
169
  # Output only. The template used to create tasks for this execution.
172
170
  # @!attribute [r] reconciling
173
171
  # @return [::Boolean]
174
- # Output only. Indicates whether the resource's reconciliation is still in progress.
175
- # See comments in `Job.reconciling` for additional information on
172
+ # Output only. Indicates whether the resource's reconciliation is still in
173
+ # progress. See comments in `Job.reconciling` for additional information on
176
174
  # reconciliation process in Cloud Run.
177
175
  # @!attribute [r] conditions
178
176
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
179
- # Output only. The Condition of this Execution, containing its readiness status, and
180
- # detailed error information in case it did not reach the desired state.
177
+ # Output only. The Condition of this Execution, containing its readiness
178
+ # status, and detailed error information in case it did not reach the desired
179
+ # state.
181
180
  # @!attribute [r] observed_generation
182
181
  # @return [::Integer]
183
- # Output only. The generation of this Execution. See comments in `reconciling` for
184
- # additional information on reconciliation process in Cloud Run.
182
+ # Output only. The generation of this Execution. See comments in
183
+ # `reconciling` for additional information on reconciliation process in Cloud
184
+ # Run.
185
185
  # @!attribute [r] running_count
186
186
  # @return [::Integer]
187
187
  # Output only. The number of actively running tasks.
@@ -191,6 +191,16 @@ module Google
191
191
  # @!attribute [r] failed_count
192
192
  # @return [::Integer]
193
193
  # Output only. The number of tasks which reached phase Failed.
194
+ # @!attribute [r] cancelled_count
195
+ # @return [::Integer]
196
+ # Output only. The number of tasks which reached phase Cancelled.
197
+ # @!attribute [r] retried_count
198
+ # @return [::Integer]
199
+ # Output only. The number of tasks which have retried at least once.
200
+ # @!attribute [r] log_uri
201
+ # @return [::String]
202
+ # Output only. URI where logs for this execution can be found in Cloud
203
+ # Console.
194
204
  # @!attribute [r] etag
195
205
  # @return [::String]
196
206
  # Output only. A system-generated fingerprint for this version of the
@@ -26,9 +26,19 @@ module Google
26
26
  # @!attribute [rw] labels
27
27
  # @return [::Google::Protobuf::Map{::String => ::String}]
28
28
  # KRM-style labels for the resource.
29
+ #
30
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
31
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
32
+ # namespaces, and they will be rejected. All system labels in v1 now have a
33
+ # corresponding field in v2 ExecutionTemplate.
29
34
  # @!attribute [rw] annotations
30
35
  # @return [::Google::Protobuf::Map{::String => ::String}]
31
36
  # KRM-style annotations for the resource.
37
+ #
38
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
39
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
40
+ # namespaces, and they will be rejected. All system annotations in v1 now
41
+ # have a corresponding field in v2 ExecutionTemplate.
32
42
  # @!attribute [rw] parallelism
33
43
  # @return [::Integer]
34
44
  # Specifies the maximum desired number of tasks the execution should run at
@@ -47,7 +57,8 @@ module Google
47
57
  # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
48
58
  # @!attribute [rw] template
49
59
  # @return [::Google::Cloud::Run::V2::TaskTemplate]
50
- # Required. Describes the task(s) that will be created when executing an execution.
60
+ # Required. Describes the task(s) that will be created when executing an
61
+ # execution.
51
62
  class ExecutionTemplate
52
63
  include ::Google::Protobuf::MessageExts
53
64
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -144,8 +144,8 @@ module Google
144
144
  extend ::Google::Protobuf::MessageExts::ClassMethods
145
145
  end
146
146
 
147
- # Job represents the configuration of a single job. A job an immutable resource
148
- # that references a container image which is run to completion.
147
+ # Job represents the configuration of a single job, which references a
148
+ # container image that is run to completion.
149
149
  # @!attribute [rw] name
150
150
  # @return [::String]
151
151
  # The fully qualified name of this Job.
@@ -154,8 +154,9 @@ module Google
154
154
  # projects/\\{project}/locations/\\{location}/jobs/\\{job}
155
155
  # @!attribute [r] uid
156
156
  # @return [::String]
157
- # Output only. Server assigned unique identifier for the Execution. The value is a UUID4
158
- # string and guaranteed to remain unchanged until the resource is deleted.
157
+ # Output only. Server assigned unique identifier for the Execution. The value
158
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
159
+ # deleted.
159
160
  # @!attribute [r] generation
160
161
  # @return [::Integer]
161
162
  # Output only. A number that monotonically increases every time the user
@@ -168,18 +169,25 @@ module Google
168
169
  # environment, state, etc. For more information, visit
169
170
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
170
171
  # https://cloud.google.com/run/docs/configuring/labels
171
- # Cloud Run will populate some labels with 'run.googleapis.com' or
172
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
173
- # changes will not be preserved.
172
+ #
173
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
174
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
175
+ # namespaces, and they will be rejected. All system labels in v1 now have a
176
+ # corresponding field in v2 Job.
174
177
  # @!attribute [rw] annotations
175
178
  # @return [::Google::Protobuf::Map{::String => ::String}]
176
179
  # KRM-style annotations for the resource. Unstructured key value map that may
177
180
  # be set by external tools to store and arbitrary metadata.
178
181
  # They are not queryable and should be preserved
179
- # when modifying objects. Cloud Run will populate some annotations using
180
- # 'run.googleapis.com' or 'serving.knative.dev' namespaces. This field
181
- # follows Kubernetes annotations' namespacing, limits, and rules. More info:
182
- # https://kubernetes.io/docs/user-guide/annotations
182
+ # when modifying objects.
183
+ #
184
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
185
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
186
+ # namespaces, and they will be rejected. All system annotations in v1 now
187
+ # have a corresponding field in v2 Job.
188
+ #
189
+ # <p>This field follows Kubernetes annotations' namespacing, limits, and
190
+ # rules. More info: https://kubernetes.io/docs/user-guide/annotations
183
191
  # @!attribute [r] create_time
184
192
  # @return [::Google::Protobuf::Timestamp]
185
193
  # Output only. The creation time.
@@ -219,18 +227,18 @@ module Google
219
227
  # Required. The template used to create executions for this Job.
220
228
  # @!attribute [r] observed_generation
221
229
  # @return [::Integer]
222
- # Output only. The generation of this Job. See comments in `reconciling` for additional
223
- # information on reconciliation process in Cloud Run.
230
+ # Output only. The generation of this Job. See comments in `reconciling` for
231
+ # additional information on reconciliation process in Cloud Run.
224
232
  # @!attribute [r] terminal_condition
225
233
  # @return [::Google::Cloud::Run::V2::Condition]
226
- # Output only. The Condition of this Job, containing its readiness status, and
227
- # detailed error information in case it did not reach the desired state.
234
+ # Output only. The Condition of this Job, containing its readiness status,
235
+ # and detailed error information in case it did not reach the desired state.
228
236
  # @!attribute [r] conditions
229
237
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
230
- # Output only. The Conditions of all other associated sub-resources. They contain
231
- # additional diagnostics information in case the Job does not reach its
232
- # desired state. See comments in `reconciling` for additional information on
233
- # reconciliation process in Cloud Run.
238
+ # Output only. The Conditions of all other associated sub-resources. They
239
+ # contain additional diagnostics information in case the Job does not reach
240
+ # its desired state. See comments in `reconciling` for additional information
241
+ # on reconciliation process in Cloud Run.
234
242
  # @!attribute [r] execution_count
235
243
  # @return [::Integer]
236
244
  # Output only. Number of executions created for this job.
@@ -239,8 +247,8 @@ module Google
239
247
  # Output only. Name of the last created execution.
240
248
  # @!attribute [r] reconciling
241
249
  # @return [::Boolean]
242
- # Output only. Returns true if the Job is currently being acted upon by the system to
243
- # bring it into the desired state.
250
+ # Output only. Returns true if the Job is currently being acted upon by the
251
+ # system to bring it into the desired state.
244
252
  #
245
253
  # When a new Job is created, or an existing one is updated, Cloud Run
246
254
  # will asynchronously perform all necessary steps to bring the Job to the
@@ -28,11 +28,13 @@ module Google
28
28
  # at runtime.
29
29
  # @!attribute [rw] name
30
30
  # @return [::String]
31
- # Name of the container specified as a DNS_LABEL.
31
+ # Name of the container specified as a DNS_LABEL (RFC 1123).
32
32
  # @!attribute [rw] image
33
33
  # @return [::String]
34
- # Required. URL of the Container image in Google Container Registry or Google Artifact
35
- # Registry. More info: https://kubernetes.io/docs/concepts/containers/images
34
+ # Required. Name of the container image in Dockerhub, Google Artifact
35
+ # Registry, or Google Container Registry. If the host is not provided,
36
+ # Dockerhub is assumed. More info:
37
+ # https://kubernetes.io/docs/concepts/containers/images
36
38
  # @!attribute [rw] command
37
39
  # @return [::Array<::String>]
38
40
  # Entrypoint array. Not executed within a shell.
@@ -126,8 +128,8 @@ module Google
126
128
  # EnvVar represents an environment variable present in a Container.
127
129
  # @!attribute [rw] name
128
130
  # @return [::String]
129
- # Required. Name of the environment variable. Must be a C_IDENTIFIER, and mnay not
130
- # exceed 32768 characters.
131
+ # Required. Name of the environment variable. Must be a C_IDENTIFIER, and
132
+ # mnay not exceed 32768 characters.
131
133
  # @!attribute [rw] value
132
134
  # @return [::String]
133
135
  # Variable references $(VAR_NAME) are expanded
@@ -192,8 +194,8 @@ module Google
192
194
  # Required. This must match the Name of a Volume.
193
195
  # @!attribute [rw] mount_path
194
196
  # @return [::String]
195
- # Required. Path within the container at which the volume should be mounted. Must
196
- # not contain ':'. For Cloud SQL volumes, it can be left empty, or must
197
+ # Required. Path within the container at which the volume should be mounted.
198
+ # Must not contain ':'. For Cloud SQL volumes, it can be left empty, or must
197
199
  # otherwise be `/cloudsql`. All instances defined in the Volume will be
198
200
  # available as `/cloudsql/[instance]`. For more information on Cloud SQL
199
201
  # volumes, visit https://cloud.google.com/sql/docs/mysql/connect-run
@@ -293,7 +295,10 @@ module Google
293
295
  extend ::Google::Protobuf::MessageExts::ClassMethods
294
296
  end
295
297
 
296
- # Represents a specific Cloud SQL instance.
298
+ # Represents a set of Cloud SQL instances. Each one will be available under
299
+ # /cloudsql/[instance]. Visit
300
+ # https://cloud.google.com/sql/docs/mysql/connect-run for more information on
301
+ # how to connect Cloud SQL and Cloud Run.
297
302
  # @!attribute [rw] instances
298
303
  # @return [::Array<::String>]
299
304
  # The Cloud SQL instance connection names, as can be found in
@@ -96,8 +96,9 @@ module Google
96
96
  # Output only. The unique name of this Revision.
97
97
  # @!attribute [r] uid
98
98
  # @return [::String]
99
- # Output only. Server assigned unique identifier for the Revision. The value is a UUID4
100
- # string and guaranteed to remain unchanged until the resource is deleted.
99
+ # Output only. Server assigned unique identifier for the Revision. The value
100
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
101
+ # deleted.
101
102
  # @!attribute [r] generation
102
103
  # @return [::Integer]
103
104
  # Output only. A number that monotonically increases every time the user
@@ -110,9 +111,6 @@ module Google
110
111
  # environment, state, etc. For more information, visit
111
112
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
112
113
  # https://cloud.google.com/run/docs/configuring/labels
113
- # Cloud Run will populate some labels with 'run.googleapis.com' or
114
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
115
- # changes will not be preserved.
116
114
  # @!attribute [rw] annotations
117
115
  # @return [::Google::Protobuf::Map{::String => ::String}]
118
116
  # KRM-style annotations for the resource.
@@ -173,20 +171,28 @@ module Google
173
171
  # A reference to a customer managed encryption key (CMEK) to use to encrypt
174
172
  # this container image. For more information, go to
175
173
  # https://cloud.google.com/run/docs/securing/using-cmek
174
+ # @!attribute [rw] encryption_key_revocation_action
175
+ # @return [::Google::Cloud::Run::V2::EncryptionKeyRevocationAction]
176
+ # The action to take if the encryption key is revoked.
177
+ # @!attribute [rw] encryption_key_shutdown_duration
178
+ # @return [::Google::Protobuf::Duration]
179
+ # If encryption_key_revocation_action is SHUTDOWN, the duration before
180
+ # shutting down all instances. The minimum increment is 1 hour.
176
181
  # @!attribute [r] reconciling
177
182
  # @return [::Boolean]
178
- # Output only. Indicates whether the resource's reconciliation is still in progress.
179
- # See comments in `Service.reconciling` for additional information on
180
- # reconciliation process in Cloud Run.
183
+ # Output only. Indicates whether the resource's reconciliation is still in
184
+ # progress. See comments in `Service.reconciling` for additional information
185
+ # on reconciliation process in Cloud Run.
181
186
  # @!attribute [r] conditions
182
187
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
183
- # Output only. The Condition of this Revision, containing its readiness status, and
184
- # detailed error information in case it did not reach a serving state.
188
+ # Output only. The Condition of this Revision, containing its readiness
189
+ # status, and detailed error information in case it did not reach a serving
190
+ # state.
185
191
  # @!attribute [r] observed_generation
186
192
  # @return [::Integer]
187
- # Output only. The generation of this Revision currently serving traffic. See comments in
188
- # `reconciling` for additional information on reconciliation process in Cloud
189
- # Run.
193
+ # Output only. The generation of this Revision currently serving traffic. See
194
+ # comments in `reconciling` for additional information on reconciliation
195
+ # process in Cloud Run.
190
196
  # @!attribute [r] log_uri
191
197
  # @return [::String]
192
198
  # Output only. The Google Console URI to obtain logs for the Revision.
@@ -30,9 +30,19 @@ module Google
30
30
  # @!attribute [rw] labels
31
31
  # @return [::Google::Protobuf::Map{::String => ::String}]
32
32
  # KRM-style labels for the resource.
33
+ #
34
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
35
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
36
+ # namespaces, and they will be rejected. All system labels in v1 now have a
37
+ # corresponding field in v2 RevisionTemplate.
33
38
  # @!attribute [rw] annotations
34
39
  # @return [::Google::Protobuf::Map{::String => ::String}]
35
40
  # KRM-style annotations for the resource.
41
+ #
42
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
43
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
44
+ # namespaces, and they will be rejected. All system annotations in v1 now
45
+ # have a corresponding field in v2 RevisionTemplate.
36
46
  # @!attribute [rw] scaling
37
47
  # @return [::Google::Cloud::Run::V2::RevisionScaling]
38
48
  # Scaling settings for this Revision.
@@ -66,9 +66,9 @@ module Google
66
66
  # @!attribute [rw] parent
67
67
  # @return [::String]
68
68
  # Required. The location and project to list resources on.
69
- # Location must be a valid GCP region, and cannot be the "-" wildcard.
70
- # Format: projects/\\{project}/locations/\\{location}, where \\{project} can be
71
- # project id or number.
69
+ # Location must be a valid Google Cloud region, and cannot be the "-"
70
+ # wildcard. Format: projects/\\{project}/locations/\\{location}, where \\{project}
71
+ # can be project id or number.
72
72
  # @!attribute [rw] page_size
73
73
  # @return [::Integer]
74
74
  # Maximum number of Services to return in this call.
@@ -146,8 +146,9 @@ module Google
146
146
  # 512-character limit.
147
147
  # @!attribute [r] uid
148
148
  # @return [::String]
149
- # Output only. Server assigned unique identifier for the trigger. The value is a UUID4
150
- # string and guaranteed to remain unchanged until the resource is deleted.
149
+ # Output only. Server assigned unique identifier for the trigger. The value
150
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
151
+ # deleted.
151
152
  # @!attribute [r] generation
152
153
  # @return [::Integer]
153
154
  # Output only. A number that monotonically increases every time the user
@@ -163,16 +164,24 @@ module Google
163
164
  # environment, state, etc. For more information, visit
164
165
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
165
166
  # https://cloud.google.com/run/docs/configuring/labels
166
- # Cloud Run will populate some labels with 'run.googleapis.com' or
167
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
168
- # changes will not be preserved.
167
+ #
168
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
169
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
170
+ # namespaces, and they will be rejected. All system labels in v1 now have a
171
+ # corresponding field in v2 Service.
169
172
  # @!attribute [rw] annotations
170
173
  # @return [::Google::Protobuf::Map{::String => ::String}]
171
174
  # Unstructured key value map that may be set by external tools to store and
172
175
  # arbitrary metadata. They are not queryable and should be preserved
173
- # when modifying objects. Cloud Run will populate some annotations using
174
- # 'run.googleapis.com' or 'serving.knative.dev' namespaces. This field
175
- # follows Kubernetes annotations' namespacing, limits, and rules. More info:
176
+ # when modifying objects.
177
+ #
178
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
179
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
180
+ # namespaces, and they will be rejected. All system annotations in v1 now
181
+ # have a corresponding field in v2 Service.
182
+ #
183
+ # <p>This field follows Kubernetes
184
+ # annotations' namespacing, limits, and rules. More info:
176
185
  # https://kubernetes.io/docs/user-guide/annotations
177
186
  # @!attribute [r] create_time
178
187
  # @return [::Google::Protobuf::Timestamp]
@@ -223,44 +232,45 @@ module Google
223
232
  # 100% traffic to the latest `Ready` Revision.
224
233
  # @!attribute [r] observed_generation
225
234
  # @return [::Integer]
226
- # Output only. The generation of this Service currently serving traffic. See comments in
227
- # `reconciling` for additional information on reconciliation process in Cloud
228
- # Run.
229
- # Please note that unlike v1, this is an int64 value. As with most Google
230
- # APIs, its JSON representation will be a `string` instead of an `integer`.
235
+ # Output only. The generation of this Service currently serving traffic. See
236
+ # comments in `reconciling` for additional information on reconciliation
237
+ # process in Cloud Run. Please note that unlike v1, this is an int64 value.
238
+ # As with most Google APIs, its JSON representation will be a `string`
239
+ # instead of an `integer`.
231
240
  # @!attribute [r] terminal_condition
232
241
  # @return [::Google::Cloud::Run::V2::Condition]
233
- # Output only. The Condition of this Service, containing its readiness status, and
234
- # detailed error information in case it did not reach a serving state. See
235
- # comments in `reconciling` for additional information on reconciliation
236
- # process in Cloud Run.
242
+ # Output only. The Condition of this Service, containing its readiness
243
+ # status, and detailed error information in case it did not reach a serving
244
+ # state. See comments in `reconciling` for additional information on
245
+ # reconciliation process in Cloud Run.
237
246
  # @!attribute [r] conditions
238
247
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
239
- # Output only. The Conditions of all other associated sub-resources. They contain
240
- # additional diagnostics information in case the Service does not reach its
241
- # Serving state. See comments in `reconciling` for additional information on
242
- # reconciliation process in Cloud Run.
248
+ # Output only. The Conditions of all other associated sub-resources. They
249
+ # contain additional diagnostics information in case the Service does not
250
+ # reach its Serving state. See comments in `reconciling` for additional
251
+ # information on reconciliation process in Cloud Run.
243
252
  # @!attribute [r] latest_ready_revision
244
253
  # @return [::String]
245
- # Output only. Name of the latest revision that is serving traffic. See comments in
246
- # `reconciling` for additional information on reconciliation process in Cloud
247
- # Run.
254
+ # Output only. Name of the latest revision that is serving traffic. See
255
+ # comments in `reconciling` for additional information on reconciliation
256
+ # process in Cloud Run.
248
257
  # @!attribute [r] latest_created_revision
249
258
  # @return [::String]
250
- # Output only. Name of the last created revision. See comments in `reconciling` for
251
- # additional information on reconciliation process in Cloud Run.
259
+ # Output only. Name of the last created revision. See comments in
260
+ # `reconciling` for additional information on reconciliation process in Cloud
261
+ # Run.
252
262
  # @!attribute [r] traffic_statuses
253
263
  # @return [::Array<::Google::Cloud::Run::V2::TrafficTargetStatus>]
254
- # Output only. Detailed status information for corresponding traffic targets. See comments
255
- # in `reconciling` for additional information on reconciliation process in
256
- # Cloud Run.
264
+ # Output only. Detailed status information for corresponding traffic targets.
265
+ # See comments in `reconciling` for additional information on reconciliation
266
+ # process in Cloud Run.
257
267
  # @!attribute [r] uri
258
268
  # @return [::String]
259
269
  # Output only. The main URI in which this Service is serving traffic.
260
270
  # @!attribute [r] reconciling
261
271
  # @return [::Boolean]
262
- # Output only. Returns true if the Service is currently being acted upon by the system to
263
- # bring it into the desired state.
272
+ # Output only. Returns true if the Service is currently being acted upon by
273
+ # the system to bring it into the desired state.
264
274
  #
265
275
  # When a new Service is created, or an existing one is updated, Cloud Run
266
276
  # will asynchronously perform all necessary steps to bring the Service to the
@@ -73,8 +73,9 @@ module Google
73
73
  # Output only. The unique name of this Task.
74
74
  # @!attribute [r] uid
75
75
  # @return [::String]
76
- # Output only. Server assigned unique identifier for the Task. The value is a UUID4
77
- # string and guaranteed to remain unchanged until the resource is deleted.
76
+ # Output only. Server assigned unique identifier for the Task. The value is a
77
+ # UUID4 string and guaranteed to remain unchanged until the resource is
78
+ # deleted.
78
79
  # @!attribute [r] generation
79
80
  # @return [::Integer]
80
81
  # Output only. A number that monotonically increases every time the user
@@ -87,17 +88,14 @@ module Google
87
88
  # environment, state, etc. For more information, visit
88
89
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
89
90
  # https://cloud.google.com/run/docs/configuring/labels
90
- # Cloud Run will populate some labels with 'run.googleapis.com' or
91
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
92
- # changes will not be preserved.
93
91
  # @!attribute [rw] annotations
94
92
  # @return [::Google::Protobuf::Map{::String => ::String}]
95
93
  # KRM-style annotations for the resource.
96
94
  # @!attribute [r] create_time
97
95
  # @return [::Google::Protobuf::Timestamp]
98
- # Output only. Represents time when the task was created by the job controller.
99
- # It is not guaranteed to be set in happens-before order across separate
100
- # operations.
96
+ # Output only. Represents time when the task was created by the job
97
+ # controller. It is not guaranteed to be set in happens-before order across
98
+ # separate operations.
101
99
  # @!attribute [r] start_time
102
100
  # @return [::Google::Protobuf::Timestamp]
103
101
  # Output only. Represents time when the task started to run.
@@ -105,8 +103,8 @@ module Google
105
103
  # operations.
106
104
  # @!attribute [r] completion_time
107
105
  # @return [::Google::Protobuf::Timestamp]
108
- # Output only. Represents time when the Task was completed. It is not guaranteed to
109
- # be set in happens-before order across separate operations.
106
+ # Output only. Represents time when the Task was completed. It is not
107
+ # guaranteed to be set in happens-before order across separate operations.
110
108
  # @!attribute [r] update_time
111
109
  # @return [::Google::Protobuf::Timestamp]
112
110
  # Output only. The last-modified time.
@@ -151,13 +149,13 @@ module Google
151
149
  # The execution environment being used to host this Task.
152
150
  # @!attribute [r] reconciling
153
151
  # @return [::Boolean]
154
- # Output only. Indicates whether the resource's reconciliation is still in progress.
155
- # See comments in `Job.reconciling` for additional information on
152
+ # Output only. Indicates whether the resource's reconciliation is still in
153
+ # progress. See comments in `Job.reconciling` for additional information on
156
154
  # reconciliation process in Cloud Run.
157
155
  # @!attribute [r] conditions
158
156
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
159
- # Output only. The Condition of this Task, containing its readiness status, and
160
- # detailed error information in case it did not reach the desired state.
157
+ # Output only. The Condition of this Task, containing its readiness status,
158
+ # and detailed error information in case it did not reach the desired state.
161
159
  # @!attribute [r] observed_generation
162
160
  # @return [::Integer]
163
161
  # Output only. The generation of this Task. See comments in `Job.reconciling`
@@ -174,13 +172,18 @@ module Google
174
172
  # Output only. Result of the last attempt of this Task.
175
173
  # @!attribute [r] encryption_key
176
174
  # @return [::String]
177
- # Output only. A reference to a customer managed encryption key (CMEK) to use to encrypt
178
- # this container image. For more information, go to
175
+ # Output only. A reference to a customer managed encryption key (CMEK) to use
176
+ # to encrypt this container image. For more information, go to
179
177
  # https://cloud.google.com/run/docs/securing/using-cmek
180
178
  # @!attribute [r] vpc_access
181
179
  # @return [::Google::Cloud::Run::V2::VpcAccess]
182
- # Output only. VPC Access configuration to use for this Task. For more information,
183
- # visit https://cloud.google.com/run/docs/configuring/connecting-vpc.
180
+ # Output only. VPC Access configuration to use for this Task. For more
181
+ # information, visit
182
+ # https://cloud.google.com/run/docs/configuring/connecting-vpc.
183
+ # @!attribute [r] log_uri
184
+ # @return [::String]
185
+ # Output only. URI where logs for this execution can be found in Cloud
186
+ # Console.
184
187
  # @!attribute [r] etag
185
188
  # @return [::String]
186
189
  # Output only. A system-generated fingerprint for this version of the
@@ -104,6 +104,18 @@ module Google
104
104
  # Uses Second Generation environment.
105
105
  EXECUTION_ENVIRONMENT_GEN2 = 2
106
106
  end
107
+
108
+ # Specifies behavior if an encryption key used by a resource is revoked.
109
+ module EncryptionKeyRevocationAction
110
+ # Unspecified
111
+ ENCRYPTION_KEY_REVOCATION_ACTION_UNSPECIFIED = 0
112
+
113
+ # Prevents the creation of new instances.
114
+ PREVENT_NEW = 1
115
+
116
+ # Shuts down existing instances, and prevents creation of new ones.
117
+ SHUTDOWN = 2
118
+ end
107
119
  end
108
120
  end
109
121
  end
@@ -28,12 +28,14 @@ module Google
28
28
  # [API Design Guide](https://cloud.google.com/apis/design/errors).
29
29
  # @!attribute [rw] code
30
30
  # @return [::Integer]
31
- # The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
31
+ # The status code, which should be an enum value of
32
+ # [google.rpc.Code][google.rpc.Code].
32
33
  # @!attribute [rw] message
33
34
  # @return [::String]
34
35
  # A developer-facing error message, which should be in English. Any
35
36
  # user-facing error message should be localized and sent in the
36
- # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
37
+ # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
38
+ # by the client.
37
39
  # @!attribute [rw] details
38
40
  # @return [::Array<::Google::Protobuf::Any>]
39
41
  # A list of messages that carry the error details. There is a common set of