google-cloud-run-v2 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -2
  3. data/lib/google/cloud/run/v2/condition_pb.rb +1 -0
  4. data/lib/google/cloud/run/v2/execution_pb.rb +1 -0
  5. data/lib/google/cloud/run/v2/executions/client.rb +10 -12
  6. data/lib/google/cloud/run/v2/executions/operations.rb +14 -16
  7. data/lib/google/cloud/run/v2/executions/rest/client.rb +533 -0
  8. data/lib/google/cloud/run/v2/executions/rest/operations.rb +935 -0
  9. data/lib/google/cloud/run/v2/executions/rest/service_stub.rb +225 -0
  10. data/lib/google/cloud/run/v2/executions/rest.rb +53 -0
  11. data/lib/google/cloud/run/v2/executions.rb +6 -0
  12. data/lib/google/cloud/run/v2/job_pb.rb +2 -1
  13. data/lib/google/cloud/run/v2/jobs/client.rb +22 -24
  14. data/lib/google/cloud/run/v2/jobs/operations.rb +14 -16
  15. data/lib/google/cloud/run/v2/jobs/rest/client.rb +998 -0
  16. data/lib/google/cloud/run/v2/jobs/rest/operations.rb +935 -0
  17. data/lib/google/cloud/run/v2/jobs/rest/service_stub.rb +584 -0
  18. data/lib/google/cloud/run/v2/jobs/rest.rb +53 -0
  19. data/lib/google/cloud/run/v2/jobs.rb +6 -0
  20. data/lib/google/cloud/run/v2/k8s.min_pb.rb +2 -0
  21. data/lib/google/cloud/run/v2/rest.rb +41 -0
  22. data/lib/google/cloud/run/v2/revision_pb.rb +2 -0
  23. data/lib/google/cloud/run/v2/revision_template_pb.rb +1 -0
  24. data/lib/google/cloud/run/v2/revisions/client.rb +10 -12
  25. data/lib/google/cloud/run/v2/revisions/operations.rb +14 -16
  26. data/lib/google/cloud/run/v2/revisions/rest/client.rb +531 -0
  27. data/lib/google/cloud/run/v2/revisions/rest/operations.rb +935 -0
  28. data/lib/google/cloud/run/v2/revisions/rest/service_stub.rb +225 -0
  29. data/lib/google/cloud/run/v2/revisions/rest.rb +53 -0
  30. data/lib/google/cloud/run/v2/revisions.rb +6 -0
  31. data/lib/google/cloud/run/v2/service_pb.rb +1 -0
  32. data/lib/google/cloud/run/v2/services/client.rb +20 -22
  33. data/lib/google/cloud/run/v2/services/operations.rb +14 -16
  34. data/lib/google/cloud/run/v2/services/rest/client.rb +940 -0
  35. data/lib/google/cloud/run/v2/services/rest/operations.rb +935 -0
  36. data/lib/google/cloud/run/v2/services/rest/service_stub.rb +524 -0
  37. data/lib/google/cloud/run/v2/services/rest.rb +53 -0
  38. data/lib/google/cloud/run/v2/services.rb +6 -0
  39. data/lib/google/cloud/run/v2/task_pb.rb +1 -0
  40. data/lib/google/cloud/run/v2/tasks/client.rb +6 -8
  41. data/lib/google/cloud/run/v2/tasks/rest/client.rb +440 -0
  42. data/lib/google/cloud/run/v2/tasks/rest/service_stub.rb +166 -0
  43. data/lib/google/cloud/run/v2/tasks/rest.rb +52 -0
  44. data/lib/google/cloud/run/v2/tasks.rb +6 -0
  45. data/lib/google/cloud/run/v2/version.rb +1 -1
  46. data/lib/google/cloud/run/v2.rb +5 -0
  47. data/proto_docs/google/api/client.rb +67 -4
  48. data/proto_docs/google/cloud/run/v2/condition.rb +3 -0
  49. data/proto_docs/google/cloud/run/v2/execution.rb +22 -15
  50. data/proto_docs/google/cloud/run/v2/execution_template.rb +14 -5
  51. data/proto_docs/google/cloud/run/v2/job.rb +16 -6
  52. data/proto_docs/google/cloud/run/v2/k8s.min.rb +23 -34
  53. data/proto_docs/google/cloud/run/v2/revision.rb +25 -12
  54. data/proto_docs/google/cloud/run/v2/revision_template.rb +16 -2
  55. data/proto_docs/google/cloud/run/v2/service.rb +16 -8
  56. data/proto_docs/google/cloud/run/v2/task.rb +13 -7
  57. data/proto_docs/google/cloud/run/v2/task_template.rb +2 -0
  58. data/proto_docs/google/iam/v1/policy.rb +8 -4
  59. metadata +32 -9
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Run
23
23
  module V2
24
- VERSION = "0.6.0"
24
+ VERSION = "0.8.0"
25
25
  end
26
26
  end
27
27
  end
@@ -34,6 +34,11 @@ module Google
34
34
  # require "google/cloud/run/v2"
35
35
  # client = ::Google::Cloud::Run::V2::Executions::Client.new
36
36
  #
37
+ # @example Load this package, including all its services, and instantiate a REST client
38
+ #
39
+ # require "google/cloud/run/v2"
40
+ # client = ::Google::Cloud::Run::V2::Executions::Rest::Client.new
41
+ #
37
42
  module V2
38
43
  end
39
44
  end
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
81
83
  # long-running operation pattern.
82
84
  # @!attribute [rw] new_issue_uri
83
85
  # @return [::String]
84
- # Link to a place that API users can report issues. Example:
86
+ # Link to a *public* URI where users can report issues. Example:
85
87
  # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
88
  # @!attribute [rw] documentation_uri
87
89
  # @return [::String]
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
203
209
  # @!attribute [rw] common
204
210
  # @return [::Google::Api::CommonLanguageSettings]
205
211
  # Some settings.
212
+ # @!attribute [rw] renamed_services
213
+ # @return [::Google::Protobuf::Map{::String => ::String}]
214
+ # Map from original service names to renamed versions.
215
+ # This is used when the default generated types
216
+ # would cause a naming conflict. (Neither name is
217
+ # fully-qualified.)
218
+ # Example: Subscriber to SubscriberServiceApi.
219
+ # @!attribute [rw] renamed_resources
220
+ # @return [::Google::Protobuf::Map{::String => ::String}]
221
+ # Map from full resource types to the effective short name
222
+ # for the resource. This is used when otherwise resource
223
+ # named from different services would cause naming collisions.
224
+ # Example entry:
225
+ # "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
226
+ # @!attribute [rw] ignored_resources
227
+ # @return [::Array<::String>]
228
+ # List of full resource types to ignore during generation.
229
+ # This is typically used for API-specific Location resources,
230
+ # which should be handled by the generator as if they were actually
231
+ # the common Location resources.
232
+ # Example entry: "documentai.googleapis.com/Location"
233
+ # @!attribute [rw] forced_namespace_aliases
234
+ # @return [::Array<::String>]
235
+ # Namespaces which must be aliased in snippets due to
236
+ # a known (but non-generator-predictable) naming collision
237
+ # @!attribute [rw] handwritten_signatures
238
+ # @return [::Array<::String>]
239
+ # Method signatures (in the form "service.method(signature)")
240
+ # which are provided separately, so shouldn't be generated.
241
+ # Snippets *calling* these methods are still generated, however.
206
242
  class DotnetSettings
207
243
  include ::Google::Protobuf::MessageExts
208
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
245
+
246
+ # @!attribute [rw] key
247
+ # @return [::String]
248
+ # @!attribute [rw] value
249
+ # @return [::String]
250
+ class RenamedServicesEntry
251
+ include ::Google::Protobuf::MessageExts
252
+ extend ::Google::Protobuf::MessageExts::ClassMethods
253
+ end
254
+
255
+ # @!attribute [rw] key
256
+ # @return [::String]
257
+ # @!attribute [rw] value
258
+ # @return [::String]
259
+ class RenamedResourcesEntry
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
209
263
  end
210
264
 
211
265
  # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
240
294
  # Example of a YAML configuration::
241
295
  #
242
296
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
297
+ # method_settings:
298
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
299
  # long_running:
246
300
  # initial_poll_delay:
247
301
  # seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
299
353
 
300
354
  # Street View Org.
301
355
  STREET_VIEW = 4
356
+
357
+ # Shopping Org.
358
+ SHOPPING = 5
359
+
360
+ # Geo Org.
361
+ GEO = 6
362
+
363
+ # Generative AI - https://developers.generativeai.google
364
+ GENERATIVE_AI = 7
302
365
  end
303
366
 
304
367
  # To where should client libraries be published?
@@ -198,6 +198,9 @@ module Google
198
198
 
199
199
  # The execution was cancelled by users.
200
200
  CANCELLED = 3
201
+
202
+ # The execution is in the process of being cancelled.
203
+ CANCELLING = 4
201
204
  end
202
205
  end
203
206
  end
@@ -103,17 +103,20 @@ module Google
103
103
  # @return [::Integer]
104
104
  # Output only. A number that monotonically increases every time the user
105
105
  # modifies the desired state.
106
- # @!attribute [rw] labels
106
+ # @!attribute [r] labels
107
107
  # @return [::Google::Protobuf::Map{::String => ::String}]
108
- # KRM-style labels for the resource.
109
- # User-provided labels are shared with Google's billing system, so they can
110
- # be used to filter, or break down billing charges by team, component,
111
- # environment, state, etc. For more information, visit
108
+ # Output only. Unstructured key value map that can be used to organize and
109
+ # categorize objects. User-provided labels are shared with Google's billing
110
+ # system, so they can be used to filter, or break down billing charges by
111
+ # team, component, environment, state, etc. For more information, visit
112
112
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
113
113
  # https://cloud.google.com/run/docs/configuring/labels
114
- # @!attribute [rw] annotations
114
+ # @!attribute [r] annotations
115
115
  # @return [::Google::Protobuf::Map{::String => ::String}]
116
- # KRM-style annotations for the resource.
116
+ # Output only. Unstructured key value map that may
117
+ # be set by external tools to store and arbitrary metadata.
118
+ # They are not queryable and should be preserved
119
+ # when modifying objects.
117
120
  # @!attribute [r] create_time
118
121
  # @return [::Google::Protobuf::Timestamp]
119
122
  # Output only. Represents time when the execution was acknowledged by the
@@ -142,10 +145,14 @@ module Google
142
145
  # request.
143
146
  # @!attribute [rw] launch_stage
144
147
  # @return [::Google::Api::LaunchStage]
145
- # Set the launch stage to a preview stage on write to allow use of preview
146
- # features in that stage. On read, describes whether the resource uses
147
- # preview features. Launch Stages are defined at [Google Cloud Platform
148
- # Launch Stages](https://cloud.google.com/terms/launch-stages).
148
+ # The least stable launch stage needed to create this resource, as defined by
149
+ # [Google Cloud Platform Launch
150
+ # Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports
151
+ # `ALPHA`, `BETA`, and `GA`.
152
+ # <p>Note that this value might not be what was used
153
+ # as input. For example, if ALPHA was provided as input in the parent
154
+ # resource, but only BETA and GA-level features are were, this field will be
155
+ # BETA.
149
156
  # @!attribute [r] job
150
157
  # @return [::String]
151
158
  # Output only. The name of the parent Job.
@@ -155,15 +162,12 @@ module Google
155
162
  # should run at any given time. Must be <= task_count. The actual number of
156
163
  # tasks running in steady state will be less than this number when
157
164
  # ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when
158
- # the work left to do is less than max parallelism. More info:
159
- # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
165
+ # the work left to do is less than max parallelism.
160
166
  # @!attribute [r] task_count
161
167
  # @return [::Integer]
162
168
  # Output only. Specifies the desired number of tasks the execution should
163
169
  # run. Setting to 1 means that parallelism is limited to 1 and the success of
164
170
  # that task signals the success of the execution.
165
- # More info:
166
- # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
167
171
  # @!attribute [r] template
168
172
  # @return [::Google::Cloud::Run::V2::TaskTemplate]
169
173
  # Output only. The template used to create tasks for this execution.
@@ -201,6 +205,9 @@ module Google
201
205
  # @return [::String]
202
206
  # Output only. URI where logs for this execution can be found in Cloud
203
207
  # Console.
208
+ # @!attribute [r] satisfies_pzs
209
+ # @return [::Boolean]
210
+ # Output only. Reserved for future use.
204
211
  # @!attribute [r] etag
205
212
  # @return [::String]
206
213
  # Output only. A system-generated fingerprint for this version of the
@@ -25,7 +25,13 @@ module Google
25
25
  # from a template.
26
26
  # @!attribute [rw] labels
27
27
  # @return [::Google::Protobuf::Map{::String => ::String}]
28
- # KRM-style labels for the resource.
28
+ # Unstructured key value map that can be used to organize and categorize
29
+ # objects.
30
+ # User-provided labels are shared with Google's billing system, so they can
31
+ # be used to filter, or break down billing charges by team, component,
32
+ # environment, state, etc. For more information, visit
33
+ # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
34
+ # https://cloud.google.com/run/docs/configuring/labels.
29
35
  #
30
36
  # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
31
37
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -33,12 +39,17 @@ module Google
33
39
  # corresponding field in v2 ExecutionTemplate.
34
40
  # @!attribute [rw] annotations
35
41
  # @return [::Google::Protobuf::Map{::String => ::String}]
36
- # KRM-style annotations for the resource.
42
+ # Unstructured key value map that may be set by external tools to store and
43
+ # arbitrary metadata. They are not queryable and should be preserved
44
+ # when modifying objects.
37
45
  #
38
46
  # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
39
47
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
40
48
  # namespaces, and they will be rejected. All system annotations in v1 now
41
49
  # have a corresponding field in v2 ExecutionTemplate.
50
+ #
51
+ # <p>This field follows Kubernetes annotations' namespacing, limits, and
52
+ # rules.
42
53
  # @!attribute [rw] parallelism
43
54
  # @return [::Integer]
44
55
  # Specifies the maximum desired number of tasks the execution should run at
@@ -52,9 +63,7 @@ module Google
52
63
  # @return [::Integer]
53
64
  # Specifies the desired number of tasks the execution should run.
54
65
  # Setting to 1 means that parallelism is limited to 1 and the success of
55
- # that task signals the success of the execution.
56
- # More info:
57
- # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
66
+ # that task signals the success of the execution. Defaults to 1.
58
67
  # @!attribute [rw] template
59
68
  # @return [::Google::Cloud::Run::V2::TaskTemplate]
60
69
  # Required. Describes the task(s) that will be created when executing an
@@ -163,12 +163,13 @@ module Google
163
163
  # modifies the desired state.
164
164
  # @!attribute [rw] labels
165
165
  # @return [::Google::Protobuf::Map{::String => ::String}]
166
- # KRM-style labels for the resource.
166
+ # Unstructured key value map that can be used to organize and categorize
167
+ # objects.
167
168
  # User-provided labels are shared with Google's billing system, so they can
168
169
  # be used to filter, or break down billing charges by team, component,
169
170
  # environment, state, etc. For more information, visit
170
171
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
171
- # https://cloud.google.com/run/docs/configuring/labels
172
+ # https://cloud.google.com/run/docs/configuring/labels.
172
173
  #
173
174
  # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
174
175
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -176,18 +177,18 @@ module Google
176
177
  # corresponding field in v2 Job.
177
178
  # @!attribute [rw] annotations
178
179
  # @return [::Google::Protobuf::Map{::String => ::String}]
179
- # KRM-style annotations for the resource. Unstructured key value map that may
180
+ # Unstructured key value map that may
180
181
  # be set by external tools to store and arbitrary metadata.
181
182
  # They are not queryable and should be preserved
182
183
  # when modifying objects.
183
184
  #
184
185
  # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
185
186
  # `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.
187
+ # namespaces, and they will be rejected on new resources. All system
188
+ # annotations in v1 now have a corresponding field in v2 Job.
188
189
  #
189
190
  # <p>This field follows Kubernetes annotations' namespacing, limits, and
190
- # rules. More info: https://kubernetes.io/docs/user-guide/annotations
191
+ # rules.
191
192
  # @!attribute [r] create_time
192
193
  # @return [::Google::Protobuf::Timestamp]
193
194
  # Output only. The creation time.
@@ -219,6 +220,12 @@ module Google
219
220
  # Launch Stages](https://cloud.google.com/terms/launch-stages).
220
221
  # Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
221
222
  # is assumed.
223
+ # Set the launch stage to a preview stage on input to allow use of preview
224
+ # features in that stage. On read (or output), describes whether the resource
225
+ # uses preview features.
226
+ # <p>
227
+ # For example, if ALPHA is provided as input, but only BETA and GA-level
228
+ # features are used, this field will be BETA on output.
222
229
  # @!attribute [rw] binary_authorization
223
230
  # @return [::Google::Cloud::Run::V2::BinaryAuthorization]
224
231
  # Settings for the Binary Authorization feature.
@@ -268,6 +275,9 @@ module Google
268
275
  # `latest_succeeded_execution` will have the state of the last succeeded
269
276
  # execution or empty for newly created Job. Additional information on the
270
277
  # failure can be found in `terminal_condition` and `conditions`.
278
+ # @!attribute [r] satisfies_pzs
279
+ # @return [::Boolean]
280
+ # Output only. Reserved for future use.
271
281
  # @!attribute [r] etag
272
282
  # @return [::String]
273
283
  # Output only. A system-generated fingerprint for this version of the
@@ -33,38 +33,21 @@ module Google
33
33
  # @return [::String]
34
34
  # Required. Name of the container image in Dockerhub, Google Artifact
35
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
+ # Dockerhub is assumed.
38
37
  # @!attribute [rw] command
39
38
  # @return [::Array<::String>]
40
39
  # Entrypoint array. Not executed within a shell.
41
40
  # The docker image's ENTRYPOINT is used if this is not provided.
42
- # Variable references $(VAR_NAME) are expanded using the container's
43
- # environment. If a variable cannot be resolved, the reference in the input
44
- # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
45
- # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
46
- # regardless of whether the variable exists or not.
47
- # More info:
48
- # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
49
41
  # @!attribute [rw] args
50
42
  # @return [::Array<::String>]
51
43
  # Arguments to the entrypoint.
52
44
  # The docker image's CMD is used if this is not provided.
53
- # Variable references $(VAR_NAME) are expanded using the container's
54
- # environment. If a variable cannot be resolved, the reference in the input
55
- # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
56
- # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
57
- # regardless of whether the variable exists or not.
58
- # More info:
59
- # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
60
45
  # @!attribute [rw] env
61
46
  # @return [::Array<::Google::Cloud::Run::V2::EnvVar>]
62
47
  # List of environment variables to set in the container.
63
48
  # @!attribute [rw] resources
64
49
  # @return [::Google::Cloud::Run::V2::ResourceRequirements]
65
50
  # Compute Resource requirements by this container.
66
- # More info:
67
- # https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
68
51
  # @!attribute [rw] ports
69
52
  # @return [::Array<::Google::Cloud::Run::V2::ContainerPort>]
70
53
  # List of ports to expose from the container. Only a single port can be
@@ -85,16 +68,12 @@ module Google
85
68
  # @return [::Google::Cloud::Run::V2::Probe]
86
69
  # Periodic probe of container liveness.
87
70
  # Container will be restarted if the probe fails.
88
- # More info:
89
- # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
90
71
  # @!attribute [rw] startup_probe
91
72
  # @return [::Google::Cloud::Run::V2::Probe]
92
73
  # Startup probe of application within the container.
93
74
  # All other probes are disabled if a startup probe is provided, until it
94
75
  # succeeds. Container will not be added to service endpoints if the probe
95
76
  # fails.
96
- # More info:
97
- # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
98
77
  class Container
99
78
  include ::Google::Protobuf::MessageExts
100
79
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -103,14 +82,22 @@ module Google
103
82
  # ResourceRequirements describes the compute resource requirements.
104
83
  # @!attribute [rw] limits
105
84
  # @return [::Google::Protobuf::Map{::String => ::String}]
106
- # Only memory and CPU are supported. Note: The only
107
- # supported values for CPU are '1', '2', '4', and '8'. Setting 4 CPU
108
- # requires at least 2Gi of memory. The values of the map is string form of
109
- # the 'quantity' k8s type:
110
- # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
85
+ # Only ´memory´ and 'cpu' are supported.
86
+ #
87
+ # <p>Notes:
88
+ # * The only supported values for CPU are '1', '2', '4', and '8'. Setting 4
89
+ # CPU requires at least 2Gi of memory. For more information, go to
90
+ # https://cloud.google.com/run/docs/configuring/cpu.
91
+ # * For supported 'memory' values and syntax, go to
92
+ # https://cloud.google.com/run/docs/configuring/memory-limits
111
93
  # @!attribute [rw] cpu_idle
112
94
  # @return [::Boolean]
113
95
  # Determines whether CPU should be throttled or not outside of requests.
96
+ # @!attribute [rw] startup_cpu_boost
97
+ # @return [::Boolean]
98
+ # Determines whether CPU should be boosted on startup of a new container
99
+ # instance above the requested CPU threshold, this can help reduce cold-start
100
+ # latency.
114
101
  class ResourceRequirements
115
102
  include ::Google::Protobuf::MessageExts
116
103
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,7 +198,6 @@ module Google
211
198
  # @!attribute [rw] secret
212
199
  # @return [::Google::Cloud::Run::V2::SecretVolumeSource]
213
200
  # Secret represents a secret that should populate this volume.
214
- # More info: https://kubernetes.io/docs/concepts/storage/volumes#secret
215
201
  # @!attribute [rw] cloud_sql_instance
216
202
  # @return [::Google::Cloud::Run::V2::CloudSqlInstance]
217
203
  # For Cloud SQL volumes, contains the specific instances that should be
@@ -319,15 +305,11 @@ module Google
319
305
  # initiated.
320
306
  # Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe
321
307
  # is 3600. Maximum value for startup probe is 240.
322
- # More info:
323
- # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
324
308
  # @!attribute [rw] timeout_seconds
325
309
  # @return [::Integer]
326
310
  # Number of seconds after which the probe times out.
327
311
  # Defaults to 1 second. Minimum value is 1. Maximum value is 3600.
328
312
  # Must be smaller than period_seconds.
329
- # More info:
330
- # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
331
313
  # @!attribute [rw] period_seconds
332
314
  # @return [::Integer]
333
315
  # How often (in seconds) to perform the probe.
@@ -362,6 +344,11 @@ module Google
362
344
  # @!attribute [rw] http_headers
363
345
  # @return [::Array<::Google::Cloud::Run::V2::HTTPHeader>]
364
346
  # Custom headers to set in the request. HTTP allows repeated headers.
347
+ # @!attribute [rw] port
348
+ # @return [::Integer]
349
+ # Port number to access on the container. Must be in the range 1 to 65535.
350
+ # If not specified, defaults to the exposed port of the container, which is
351
+ # the value of container.ports[0].containerPort.
365
352
  class HTTPGetAction
366
353
  include ::Google::Protobuf::MessageExts
367
354
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -383,7 +370,8 @@ module Google
383
370
  # @!attribute [rw] port
384
371
  # @return [::Integer]
385
372
  # Port number to access on the container. Must be in the range 1 to 65535.
386
- # If not specified, defaults to 8080.
373
+ # If not specified, defaults to the exposed port of the container, which is
374
+ # the value of container.ports[0].containerPort.
387
375
  class TCPSocketAction
388
376
  include ::Google::Protobuf::MessageExts
389
377
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -393,7 +381,8 @@ module Google
393
381
  # @!attribute [rw] port
394
382
  # @return [::Integer]
395
383
  # Port number of the gRPC service. Number must be in the range 1 to 65535.
396
- # If not specified, defaults to 8080.
384
+ # If not specified, defaults to the exposed port of the container, which is
385
+ # the value of container.ports[0].containerPort.
397
386
  # @!attribute [rw] service
398
387
  # @return [::String]
399
388
  # Service is the name of the service to place in the gRPC HealthCheckRequest
@@ -103,17 +103,20 @@ module Google
103
103
  # @return [::Integer]
104
104
  # Output only. A number that monotonically increases every time the user
105
105
  # modifies the desired state.
106
- # @!attribute [rw] labels
106
+ # @!attribute [r] labels
107
107
  # @return [::Google::Protobuf::Map{::String => ::String}]
108
- # KRM-style labels for the resource.
109
- # User-provided labels are shared with Google's billing system, so they can
110
- # be used to filter, or break down billing charges by team, component,
111
- # environment, state, etc. For more information, visit
108
+ # Output only. Unstructured key value map that can be used to organize and
109
+ # categorize objects. User-provided labels are shared with Google's billing
110
+ # system, so they can be used to filter, or break down billing charges by
111
+ # team, component, environment, state, etc. For more information, visit
112
112
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
113
- # https://cloud.google.com/run/docs/configuring/labels
114
- # @!attribute [rw] annotations
113
+ # https://cloud.google.com/run/docs/configuring/labels.
114
+ # @!attribute [r] annotations
115
115
  # @return [::Google::Protobuf::Map{::String => ::String}]
116
- # KRM-style annotations for the resource.
116
+ # Output only. Unstructured key value map that may
117
+ # be set by external tools to store and arbitrary metadata.
118
+ # They are not queryable and should be preserved
119
+ # when modifying objects.
117
120
  # @!attribute [r] create_time
118
121
  # @return [::Google::Protobuf::Timestamp]
119
122
  # Output only. The creation time.
@@ -131,10 +134,14 @@ module Google
131
134
  # request.
132
135
  # @!attribute [rw] launch_stage
133
136
  # @return [::Google::Api::LaunchStage]
134
- # Set the launch stage to a preview stage on write to allow use of preview
135
- # features in that stage. On read, describes whether the resource uses
136
- # preview features. Launch Stages are defined at [Google Cloud Platform
137
- # Launch Stages](https://cloud.google.com/terms/launch-stages).
137
+ # The least stable launch stage needed to create this resource, as defined by
138
+ # [Google Cloud Platform Launch
139
+ # Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports
140
+ # `ALPHA`, `BETA`, and `GA`.
141
+ # <p>Note that this value might not be what was used
142
+ # as input. For example, if ALPHA was provided as input in the parent
143
+ # resource, but only BETA and GA-level features are were, this field will be
144
+ # BETA.
138
145
  # @!attribute [r] service
139
146
  # @return [::String]
140
147
  # Output only. The name of the parent service.
@@ -196,6 +203,12 @@ module Google
196
203
  # @!attribute [r] log_uri
197
204
  # @return [::String]
198
205
  # Output only. The Google Console URI to obtain logs for the Revision.
206
+ # @!attribute [r] satisfies_pzs
207
+ # @return [::Boolean]
208
+ # Output only. Reserved for future use.
209
+ # @!attribute [rw] session_affinity
210
+ # @return [::Boolean]
211
+ # Enable session affinity.
199
212
  # @!attribute [r] etag
200
213
  # @return [::String]
201
214
  # Output only. A system-generated fingerprint for this version of the
@@ -29,7 +29,13 @@ module Google
29
29
  # automatically generated based on the Service name.
30
30
  # @!attribute [rw] labels
31
31
  # @return [::Google::Protobuf::Map{::String => ::String}]
32
- # KRM-style labels for the resource.
32
+ # Unstructured key value map that can be used to organize and categorize
33
+ # objects.
34
+ # User-provided labels are shared with Google's billing system, so they can
35
+ # be used to filter, or break down billing charges by team, component,
36
+ # environment, state, etc. For more information, visit
37
+ # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
38
+ # https://cloud.google.com/run/docs/configuring/labels.
33
39
  #
34
40
  # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
35
41
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -37,12 +43,17 @@ module Google
37
43
  # corresponding field in v2 RevisionTemplate.
38
44
  # @!attribute [rw] annotations
39
45
  # @return [::Google::Protobuf::Map{::String => ::String}]
40
- # KRM-style annotations for the resource.
46
+ # Unstructured key value map that may be set by external tools to store and
47
+ # arbitrary metadata. They are not queryable and should be preserved
48
+ # when modifying objects.
41
49
  #
42
50
  # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
43
51
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
44
52
  # namespaces, and they will be rejected. All system annotations in v1 now
45
53
  # have a corresponding field in v2 RevisionTemplate.
54
+ #
55
+ # <p>This field follows Kubernetes annotations' namespacing, limits, and
56
+ # rules.
46
57
  # @!attribute [rw] scaling
47
58
  # @return [::Google::Cloud::Run::V2::RevisionScaling]
48
59
  # Scaling settings for this Revision.
@@ -77,6 +88,9 @@ module Google
77
88
  # @!attribute [rw] max_instance_request_concurrency
78
89
  # @return [::Integer]
79
90
  # Sets the maximum number of requests that each serving instance can receive.
91
+ # @!attribute [rw] session_affinity
92
+ # @return [::Boolean]
93
+ # Enable session affinity.
80
94
  class RevisionTemplate
81
95
  include ::Google::Protobuf::MessageExts
82
96
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -55,8 +55,8 @@ module Google
55
55
  # @!attribute [rw] allow_missing
56
56
  # @return [::Boolean]
57
57
  # If set to true, and if the Service does not exist, it will create a new
58
- # one. Caller must have both create and update permissions for this call if
59
- # this is set to true.
58
+ # one. The caller must have 'run.services.create' permissions if this is set
59
+ # to true and the Service does not exist.
60
60
  class UpdateServiceRequest
61
61
  include ::Google::Protobuf::MessageExts
62
62
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -157,13 +157,13 @@ module Google
157
157
  # APIs, its JSON representation will be a `string` instead of an `integer`.
158
158
  # @!attribute [rw] labels
159
159
  # @return [::Google::Protobuf::Map{::String => ::String}]
160
- # Map of string keys and values that can be used to organize and categorize
160
+ # Unstructured key value map that can be used to organize and categorize
161
161
  # objects.
162
162
  # User-provided labels are shared with Google's billing system, so they can
163
163
  # be used to filter, or break down billing charges by team, component,
164
164
  # environment, state, etc. For more information, visit
165
165
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
166
- # https://cloud.google.com/run/docs/configuring/labels
166
+ # https://cloud.google.com/run/docs/configuring/labels.
167
167
  #
168
168
  # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
169
169
  # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -177,12 +177,11 @@ module Google
177
177
  #
178
178
  # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
179
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.
180
+ # namespaces, and they will be rejected in new resources. All system
181
+ # annotations in v1 now have a corresponding field in v2 Service.
182
182
  #
183
183
  # <p>This field follows Kubernetes
184
- # annotations' namespacing, limits, and rules. More info:
185
- # https://kubernetes.io/docs/user-guide/annotations
184
+ # annotations' namespacing, limits, and rules.
186
185
  # @!attribute [r] create_time
187
186
  # @return [::Google::Protobuf::Timestamp]
188
187
  # Output only. The creation time.
@@ -219,6 +218,12 @@ module Google
219
218
  # Launch Stages](https://cloud.google.com/terms/launch-stages).
220
219
  # Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
221
220
  # is assumed.
221
+ # Set the launch stage to a preview stage on input to allow use of preview
222
+ # features in that stage. On read (or output), describes whether the resource
223
+ # uses preview features.
224
+ # <p>
225
+ # For example, if ALPHA is provided as input, but only BETA and GA-level
226
+ # features are used, this field will be BETA on output.
222
227
  # @!attribute [rw] binary_authorization
223
228
  # @return [::Google::Cloud::Run::V2::BinaryAuthorization]
224
229
  # Settings for the Binary Authorization feature.
@@ -267,6 +272,9 @@ module Google
267
272
  # @!attribute [r] uri
268
273
  # @return [::String]
269
274
  # Output only. The main URI in which this Service is serving traffic.
275
+ # @!attribute [r] satisfies_pzs
276
+ # @return [::Boolean]
277
+ # Output only. Reserved for future use.
270
278
  # @!attribute [r] reconciling
271
279
  # @return [::Boolean]
272
280
  # Output only. Returns true if the Service is currently being acted upon by