google-apis-run_v1 0.34.0 → 0.37.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.
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module RunV1
18
18
  # Version of the google-apis-run_v1 gem
19
- GEM_VERSION = "0.34.0"
19
+ GEM_VERSION = "0.37.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.9.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20220731"
25
+ REVISION = "20220821"
26
26
  end
27
27
  end
28
28
  end
@@ -52,6 +52,12 @@ module Google
52
52
  include Google::Apis::Core::JsonObjectSupport
53
53
  end
54
54
 
55
+ class CancelExecutionRequest
56
+ class Representation < Google::Apis::Core::JsonRepresentation; end
57
+
58
+ include Google::Apis::Core::JsonObjectSupport
59
+ end
60
+
55
61
  class ConfigMapEnvSource
56
62
  class Representation < Google::Apis::Core::JsonRepresentation; end
57
63
 
@@ -568,6 +574,12 @@ module Google
568
574
  end
569
575
  end
570
576
 
577
+ class CancelExecutionRequest
578
+ # @private
579
+ class Representation < Google::Apis::Core::JsonRepresentation
580
+ end
581
+ end
582
+
571
583
  class ConfigMapEnvSource
572
584
  # @private
573
585
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -90,8 +90,8 @@ module Google
90
90
 
91
91
  # Get information about a configuration.
92
92
  # @param [String] name
93
- # The name of the configuration to retrieve. For Cloud Run (fully managed),
94
- # replace `namespace_id` with the project ID or number.
93
+ # The name of the configuration to retrieve. For Cloud Run, replace `
94
+ # namespace_id` with the project ID or number.
95
95
  # @param [String] fields
96
96
  # Selector specifying which fields to include in a partial response.
97
97
  # @param [String] quota_user
@@ -121,27 +121,23 @@ module Google
121
121
 
122
122
  # List configurations.
123
123
  # @param [String] parent
124
- # The namespace from which the configurations should be listed. For Cloud Run (
125
- # fully managed), replace `namespace_id` with the project ID or number.
124
+ # The namespace from which the configurations should be listed. For Cloud Run,
125
+ # replace `namespace_id` with the project ID or number.
126
126
  # @param [String] continue
127
127
  # Optional. Encoded string to continue paging.
128
128
  # @param [String] field_selector
129
- # Allows to filter resources based on a specific value for a field name. Send
130
- # this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently
131
- # used by Cloud Run.
129
+ # Not supported by Cloud Run.
132
130
  # @param [Boolean] include_uninitialized
133
- # Not currently used by Cloud Run.
131
+ # Not supported by Cloud Run.
134
132
  # @param [String] label_selector
135
133
  # Allows to filter resources based on a label. Supported operations are =, !=,
136
134
  # exists, in, and notIn.
137
135
  # @param [Fixnum] limit
138
- # Optional. The maximum number of records that should be returned.
136
+ # Optional. The maximum number of the records that should be returned.
139
137
  # @param [String] resource_version
140
- # The baseline resource version from which the list or watch operation should
141
- # start. Not currently used by Cloud Run.
138
+ # Not supported by Cloud Run.
142
139
  # @param [Boolean] watch
143
- # Flag that indicates that the client expects to watch this resource as well.
144
- # Not currently used by Cloud Run.
140
+ # Not supported by Cloud Run.
145
141
  # @param [String] fields
146
142
  # Selector specifying which fields to include in a partial response.
147
143
  # @param [String] quota_user
@@ -230,7 +226,7 @@ module Google
230
226
  # @param [String] propagation_policy
231
227
  # Specifies the propagation policy of delete. Cloud Run currently ignores this
232
228
  # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
233
- # workloads/controllers/garbage-collection/ for more information.
229
+ # architecture/garbage-collection/ for more information.
234
230
  # @param [String] fields
235
231
  # Selector specifying which fields to include in a partial response.
236
232
  # @param [String] quota_user
@@ -294,7 +290,7 @@ module Google
294
290
  execute_or_queue_command(command, &block)
295
291
  end
296
292
 
297
- # List domain mappings.
293
+ # List all domain mappings.
298
294
  # @param [String] parent
299
295
  # The namespace from which the domain mappings should be listed. For Cloud Run (
300
296
  # fully managed), replace `namespace` with the project ID or number. It takes
@@ -352,6 +348,41 @@ module Google
352
348
  execute_or_queue_command(command, &block)
353
349
  end
354
350
 
351
+ # Cancel an execution.
352
+ # @param [String] name
353
+ # Required. The name of the execution to cancel. Replace `namespace` with the
354
+ # project ID or number. It takes the form namespaces/`namespace`. For example:
355
+ # namespaces/PROJECT_ID
356
+ # @param [Google::Apis::RunV1::CancelExecutionRequest] cancel_execution_request_object
357
+ # @param [String] fields
358
+ # Selector specifying which fields to include in a partial response.
359
+ # @param [String] quota_user
360
+ # Available to use for quota purposes for server-side applications. Can be any
361
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
362
+ # @param [Google::Apis::RequestOptions] options
363
+ # Request-specific options
364
+ #
365
+ # @yield [result, err] Result & error if block supplied
366
+ # @yieldparam result [Google::Apis::RunV1::Execution] parsed result object
367
+ # @yieldparam err [StandardError] error object if request failed
368
+ #
369
+ # @return [Google::Apis::RunV1::Execution]
370
+ #
371
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
372
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
373
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
374
+ def cancel_execution(name, cancel_execution_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
375
+ command = make_simple_command(:post, 'apis/run.googleapis.com/v1/{+name}:cancel', options)
376
+ command.request_representation = Google::Apis::RunV1::CancelExecutionRequest::Representation
377
+ command.request_object = cancel_execution_request_object
378
+ command.response_representation = Google::Apis::RunV1::Execution::Representation
379
+ command.response_class = Google::Apis::RunV1::Execution
380
+ command.params['name'] = name unless name.nil?
381
+ command.query['fields'] = fields unless fields.nil?
382
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
383
+ execute_or_queue_command(command, &block)
384
+ end
385
+
355
386
  # Delete an execution.
356
387
  # @param [String] name
357
388
  # Required. The name of the execution to delete. Replace `namespace` with the
@@ -363,8 +394,9 @@ module Google
363
394
  # Optional. Cloud Run currently ignores this parameter.
364
395
  # @param [String] propagation_policy
365
396
  # Optional. Specifies the propagation policy of delete. Cloud Run currently
366
- # ignores this setting, and deletes in the background. Please see kubernetes.io/
367
- # docs/concepts/workloads/controllers/garbage-collection/ for more information.
397
+ # ignores this setting, and deletes in the background. Please see https://
398
+ # kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more
399
+ # information.
368
400
  # @param [String] fields
369
401
  # Selector specifying which fields to include in a partial response.
370
402
  # @param [String] quota_user
@@ -435,22 +467,18 @@ module Google
435
467
  # @param [String] continue
436
468
  # Optional. Optional encoded string to continue paging.
437
469
  # @param [String] field_selector
438
- # Optional. Allows to filter resources based on a specific value for a field
439
- # name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
440
- # currently used by Cloud Run.
470
+ # Optional. Not supported by Cloud Run.
441
471
  # @param [Boolean] include_uninitialized
442
- # Optional. Not currently used by Cloud Run.
472
+ # Optional. Not supported by Cloud Run.
443
473
  # @param [String] label_selector
444
474
  # Optional. Allows to filter resources based on a label. Supported operations
445
475
  # are =, !=, exists, in, and notIn.
446
476
  # @param [Fixnum] limit
447
- # Optional. The maximum number of records that should be returned.
477
+ # Optional. The maximum number of the records that should be returned.
448
478
  # @param [String] resource_version
449
- # Optional. The baseline resource version from which the list or watch operation
450
- # should start. Not currently used by Cloud Run.
479
+ # Optional. Not supported by Cloud Run.
451
480
  # @param [Boolean] watch
452
- # Optional. Flag that indicates that the client expects to watch this resource
453
- # as well. Not currently used by Cloud Run.
481
+ # Optional. Not supported by Cloud Run.
454
482
  # @param [String] fields
455
483
  # Selector specifying which fields to include in a partial response.
456
484
  # @param [String] quota_user
@@ -603,22 +631,18 @@ module Google
603
631
  # @param [String] continue
604
632
  # Optional. Optional encoded string to continue paging.
605
633
  # @param [String] field_selector
606
- # Optional. Allows to filter resources based on a specific value for a field
607
- # name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
608
- # currently used by Cloud Run.
634
+ # Optional. Not supported by Cloud Run.
609
635
  # @param [Boolean] include_uninitialized
610
- # Optional. Not currently used by Cloud Run.
636
+ # Optional. Not supported by Cloud Run.
611
637
  # @param [String] label_selector
612
638
  # Optional. Allows to filter resources based on a label. Supported operations
613
639
  # are =, !=, exists, in, and notIn.
614
640
  # @param [Fixnum] limit
615
641
  # Optional. The maximum number of records that should be returned.
616
642
  # @param [String] resource_version
617
- # Optional. The baseline resource version from which the list or watch operation
618
- # should start. Not currently used by Cloud Run.
643
+ # Optional. Not supported by Cloud Run.
619
644
  # @param [Boolean] watch
620
- # Optional. Flag that indicates that the client expects to watch this resource
621
- # as well. Not currently used by Cloud Run.
645
+ # Optional. Not supported by Cloud Run.
622
646
  # @param [String] fields
623
647
  # Selector specifying which fields to include in a partial response.
624
648
  # @param [String] quota_user
@@ -658,7 +682,7 @@ module Google
658
682
  # match the requested 'spec'. May provide metadata.resourceVersion to enforce
659
683
  # update from last read for optimistic concurrency control.
660
684
  # @param [String] name
661
- # Required. The name of the service being replaced. Replace `namespace` with the
685
+ # Required. The name of the job being replaced. Replace `namespace` with the
662
686
  # project ID or number. It takes the form namespaces/`namespace`. For example:
663
687
  # namespaces/PROJECT_ID
664
688
  # @param [Google::Apis::RunV1::Job] job_object
@@ -740,8 +764,8 @@ module Google
740
764
  # Cloud Run currently ignores this parameter.
741
765
  # @param [String] propagation_policy
742
766
  # Specifies the propagation policy of delete. Cloud Run currently ignores this
743
- # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
744
- # workloads/controllers/garbage-collection/ for more information.
767
+ # setting, and deletes in the background. Please see https://kubernetes.io/docs/
768
+ # concepts/architecture/garbage-collection/ for more information.
745
769
  # @param [String] fields
746
770
  # Selector specifying which fields to include in a partial response.
747
771
  # @param [String] quota_user
@@ -953,11 +977,12 @@ module Google
953
977
  execute_or_queue_command(command, &block)
954
978
  end
955
979
 
956
- # Create a service.
980
+ # Creates a new Service. Service creation will trigger a new deployment. Use
981
+ # GetService, and check service.status to determine if the Service is ready.
957
982
  # @param [String] parent
958
- # The namespace in which the service should be created. For Cloud Run (fully
959
- # managed), replace `namespace` with the project ID or number. It takes the form
960
- # namespaces/`namespace`. For example: namespaces/PROJECT_ID
983
+ # The resource's parent. In Cloud Run, it may be one of the following: * `
984
+ # namespaces/`project_id_or_number`` * `projects/`project_id_or_number`/
985
+ # locations/`region`` * `projects/`project_id_or_number`/regions/`region``
961
986
  # @param [Google::Apis::RunV1::Service] service_object
962
987
  # @param [String] dry_run
963
988
  # Indicates that the server should validate the request and populate default
@@ -992,23 +1017,22 @@ module Google
992
1017
  execute_or_queue_command(command, &block)
993
1018
  end
994
1019
 
995
- # Delete a service. This will cause the Service to stop serving traffic and will
996
- # delete the child entities like Routes, Configurations and Revisions.
1020
+ # Deletes the provided service. This will cause the Service to stop serving
1021
+ # traffic and will delete all associated Revisions.
997
1022
  # @param [String] name
998
- # The name of the service to delete. For Cloud Run (fully managed), replace `
999
- # namespace` with the project ID or number. It takes the form namespaces/`
1000
- # namespace`. For example: namespaces/PROJECT_ID
1023
+ # The fully qualified name of the service to delete. It can be any of the
1024
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
1025
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
1026
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
1001
1027
  # @param [String] api_version
1002
- # Cloud Run currently ignores this parameter.
1028
+ # Not supported, and ignored by Cloud Run.
1003
1029
  # @param [String] dry_run
1004
1030
  # Indicates that the server should validate the request and populate default
1005
1031
  # values without persisting the request. Supported values: `all`
1006
1032
  # @param [String] kind
1007
- # Cloud Run currently ignores this parameter.
1033
+ # Not supported, and ignored by Cloud Run.
1008
1034
  # @param [String] propagation_policy
1009
- # Specifies the propagation policy of delete. Cloud Run currently ignores this
1010
- # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
1011
- # workloads/controllers/garbage-collection/ for more information.
1035
+ # Not supported, and ignored by Cloud Run.
1012
1036
  # @param [String] fields
1013
1037
  # Selector specifying which fields to include in a partial response.
1014
1038
  # @param [String] quota_user
@@ -1040,11 +1064,12 @@ module Google
1040
1064
  execute_or_queue_command(command, &block)
1041
1065
  end
1042
1066
 
1043
- # Get information about a service.
1067
+ # Gets information about a service.
1044
1068
  # @param [String] name
1045
- # The name of the service to retrieve. For Cloud Run (fully managed), replace `
1046
- # namespace` with the project ID or number. It takes the form namespaces/`
1047
- # namespace`. For example: namespaces/PROJECT_ID
1069
+ # The fully qualified name of the service to retrieve. It can be any of the
1070
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
1071
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
1072
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
1048
1073
  # @param [String] fields
1049
1074
  # Selector specifying which fields to include in a partial response.
1050
1075
  # @param [String] quota_user
@@ -1072,30 +1097,27 @@ module Google
1072
1097
  execute_or_queue_command(command, &block)
1073
1098
  end
1074
1099
 
1075
- # List services.
1100
+ # Lists services for the given project and region.
1076
1101
  # @param [String] parent
1077
- # The namespace from which the services should be listed. For Cloud Run (fully
1078
- # managed), replace `namespace` with the project ID or number. It takes the form
1079
- # namespaces/`namespace`. For example: namespaces/PROJECT_ID
1102
+ # The parent from where the resources should be listed. In Cloud Run, it may be
1103
+ # one of the following: * `namespaces/`project_id_or_number`` * `projects/`
1104
+ # project_id_or_number`/locations/`region`` * `projects/`project_id_or_number`/
1105
+ # regions/`region``
1080
1106
  # @param [String] continue
1081
1107
  # Optional. Encoded string to continue paging.
1082
1108
  # @param [String] field_selector
1083
- # Allows to filter resources based on a specific value for a field name. Send
1084
- # this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently
1085
- # used by Cloud Run.
1109
+ # Not supported, and ignored by Cloud Run.
1086
1110
  # @param [Boolean] include_uninitialized
1087
- # Not currently used by Cloud Run.
1111
+ # Not supported, and ignored by Cloud Run.
1088
1112
  # @param [String] label_selector
1089
1113
  # Allows to filter resources based on a label. Supported operations are =, !=,
1090
1114
  # exists, in, and notIn.
1091
1115
  # @param [Fixnum] limit
1092
1116
  # Optional. The maximum number of records that should be returned.
1093
1117
  # @param [String] resource_version
1094
- # The baseline resource version from which the list or watch operation should
1095
- # start. Not currently used by Cloud Run.
1118
+ # Not supported, and ignored by Cloud Run.
1096
1119
  # @param [Boolean] watch
1097
- # Flag that indicates that the client expects to watch this resource as well.
1098
- # Not currently used by Cloud Run.
1120
+ # Not supported, and ignored by Cloud Run.
1099
1121
  # @param [String] fields
1100
1122
  # Selector specifying which fields to include in a partial response.
1101
1123
  # @param [String] quota_user
@@ -1130,14 +1152,15 @@ module Google
1130
1152
  execute_or_queue_command(command, &block)
1131
1153
  end
1132
1154
 
1133
- # Replace a service. Only the spec and metadata labels and annotations are
1155
+ # Replaces a service. Only the spec and metadata labels and annotations are
1134
1156
  # modifiable. After the Update request, Cloud Run will work to make the 'status'
1135
1157
  # match the requested 'spec'. May provide metadata.resourceVersion to enforce
1136
1158
  # update from last read for optimistic concurrency control.
1137
1159
  # @param [String] name
1138
- # The name of the service being replaced. For Cloud Run (fully managed), replace
1139
- # `namespace` with the project ID or number. It takes the form namespaces/`
1140
- # namespace`. For example: namespaces/PROJECT_ID
1160
+ # The fully qualified name of the service to replace. It can be any of the
1161
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
1162
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
1163
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
1141
1164
  # @param [Google::Apis::RunV1::Service] service_object
1142
1165
  # @param [String] dry_run
1143
1166
  # Indicates that the server should validate the request and populate default
@@ -1212,22 +1235,28 @@ module Google
1212
1235
  # @param [String] continue
1213
1236
  # Optional. Optional encoded string to continue paging.
1214
1237
  # @param [String] field_selector
1215
- # Optional. Allows to filter resources based on a specific value for a field
1216
- # name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
1217
- # currently used by Cloud Run.
1238
+ # Optional. Not supported by Cloud Run.
1218
1239
  # @param [Boolean] include_uninitialized
1219
- # Optional. Not currently used by Cloud Run.
1240
+ # Optional. Not supported by Cloud Run.
1220
1241
  # @param [String] label_selector
1221
1242
  # Optional. Allows to filter resources based on a label. Supported operations
1222
- # are =, !=, exists, in, and notIn.
1243
+ # are =, !=, exists, in, and notIn. For example, to list all tasks of execution "
1244
+ # foo" in succeeded state: `run.googleapis.com/execution=foo,run.googleapis.com/
1245
+ # runningState=Succeeded`. Supported states are: * `Pending`: Initial state of
1246
+ # all tasks. The task has not yet started but eventually will. * `Running`:
1247
+ # Container instances for this task are running or will be running shortly. * `
1248
+ # Succeeded`: No more container instances to run for the task, and the last
1249
+ # attempt succeeded. * `Failed`: No more container instances to run for the task,
1250
+ # and the last attempt failed. This task has run out of retry attempts. * `
1251
+ # Cancelled`: Task was running but got stopped because its parent execution has
1252
+ # been aborted. * `Abandoned`: The task has not yet started and never will
1253
+ # because its parent execution has been aborted.
1223
1254
  # @param [Fixnum] limit
1224
1255
  # Optional. The maximum number of records that should be returned.
1225
1256
  # @param [String] resource_version
1226
- # Optional. The baseline resource version from which the list or watch operation
1227
- # should start. Not currently used by Cloud Run.
1257
+ # Optional. Not supported by Cloud Run.
1228
1258
  # @param [Boolean] watch
1229
- # Optional. Flag that indicates that the client expects to watch this resource
1230
- # as well. Not currently used by Cloud Run.
1259
+ # Optional. Not supported by Cloud Run.
1231
1260
  # @param [String] fields
1232
1261
  # Selector specifying which fields to include in a partial response.
1233
1262
  # @param [String] quota_user
@@ -1379,8 +1408,8 @@ module Google
1379
1408
 
1380
1409
  # Get information about a configuration.
1381
1410
  # @param [String] name
1382
- # The name of the configuration to retrieve. For Cloud Run (fully managed),
1383
- # replace `namespace_id` with the project ID or number.
1411
+ # The name of the configuration to retrieve. For Cloud Run, replace `
1412
+ # namespace_id` with the project ID or number.
1384
1413
  # @param [String] fields
1385
1414
  # Selector specifying which fields to include in a partial response.
1386
1415
  # @param [String] quota_user
@@ -1410,27 +1439,23 @@ module Google
1410
1439
 
1411
1440
  # List configurations.
1412
1441
  # @param [String] parent
1413
- # The namespace from which the configurations should be listed. For Cloud Run (
1414
- # fully managed), replace `namespace_id` with the project ID or number.
1442
+ # The namespace from which the configurations should be listed. For Cloud Run,
1443
+ # replace `namespace_id` with the project ID or number.
1415
1444
  # @param [String] continue
1416
1445
  # Optional. Encoded string to continue paging.
1417
1446
  # @param [String] field_selector
1418
- # Allows to filter resources based on a specific value for a field name. Send
1419
- # this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently
1420
- # used by Cloud Run.
1447
+ # Not supported by Cloud Run.
1421
1448
  # @param [Boolean] include_uninitialized
1422
- # Not currently used by Cloud Run.
1449
+ # Not supported by Cloud Run.
1423
1450
  # @param [String] label_selector
1424
1451
  # Allows to filter resources based on a label. Supported operations are =, !=,
1425
1452
  # exists, in, and notIn.
1426
1453
  # @param [Fixnum] limit
1427
- # Optional. The maximum number of records that should be returned.
1454
+ # Optional. The maximum number of the records that should be returned.
1428
1455
  # @param [String] resource_version
1429
- # The baseline resource version from which the list or watch operation should
1430
- # start. Not currently used by Cloud Run.
1456
+ # Not supported by Cloud Run.
1431
1457
  # @param [Boolean] watch
1432
- # Flag that indicates that the client expects to watch this resource as well.
1433
- # Not currently used by Cloud Run.
1458
+ # Not supported by Cloud Run.
1434
1459
  # @param [String] fields
1435
1460
  # Selector specifying which fields to include in a partial response.
1436
1461
  # @param [String] quota_user
@@ -1519,7 +1544,7 @@ module Google
1519
1544
  # @param [String] propagation_policy
1520
1545
  # Specifies the propagation policy of delete. Cloud Run currently ignores this
1521
1546
  # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
1522
- # workloads/controllers/garbage-collection/ for more information.
1547
+ # architecture/garbage-collection/ for more information.
1523
1548
  # @param [String] fields
1524
1549
  # Selector specifying which fields to include in a partial response.
1525
1550
  # @param [String] quota_user
@@ -1583,7 +1608,7 @@ module Google
1583
1608
  execute_or_queue_command(command, &block)
1584
1609
  end
1585
1610
 
1586
- # List domain mappings.
1611
+ # List all domain mappings.
1587
1612
  # @param [String] parent
1588
1613
  # The namespace from which the domain mappings should be listed. For Cloud Run (
1589
1614
  # fully managed), replace `namespace` with the project ID or number. It takes
@@ -1772,8 +1797,8 @@ module Google
1772
1797
  # Cloud Run currently ignores this parameter.
1773
1798
  # @param [String] propagation_policy
1774
1799
  # Specifies the propagation policy of delete. Cloud Run currently ignores this
1775
- # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
1776
- # workloads/controllers/garbage-collection/ for more information.
1800
+ # setting, and deletes in the background. Please see https://kubernetes.io/docs/
1801
+ # concepts/architecture/garbage-collection/ for more information.
1777
1802
  # @param [String] fields
1778
1803
  # Selector specifying which fields to include in a partial response.
1779
1804
  # @param [String] quota_user
@@ -1985,11 +2010,12 @@ module Google
1985
2010
  execute_or_queue_command(command, &block)
1986
2011
  end
1987
2012
 
1988
- # Create a service.
2013
+ # Creates a new Service. Service creation will trigger a new deployment. Use
2014
+ # GetService, and check service.status to determine if the Service is ready.
1989
2015
  # @param [String] parent
1990
- # The namespace in which the service should be created. For Cloud Run (fully
1991
- # managed), replace `namespace` with the project ID or number. It takes the form
1992
- # namespaces/`namespace`. For example: namespaces/PROJECT_ID
2016
+ # The resource's parent. In Cloud Run, it may be one of the following: * `
2017
+ # namespaces/`project_id_or_number`` * `projects/`project_id_or_number`/
2018
+ # locations/`region`` * `projects/`project_id_or_number`/regions/`region``
1993
2019
  # @param [Google::Apis::RunV1::Service] service_object
1994
2020
  # @param [String] dry_run
1995
2021
  # Indicates that the server should validate the request and populate default
@@ -2024,23 +2050,22 @@ module Google
2024
2050
  execute_or_queue_command(command, &block)
2025
2051
  end
2026
2052
 
2027
- # Delete a service. This will cause the Service to stop serving traffic and will
2028
- # delete the child entities like Routes, Configurations and Revisions.
2053
+ # Deletes the provided service. This will cause the Service to stop serving
2054
+ # traffic and will delete all associated Revisions.
2029
2055
  # @param [String] name
2030
- # The name of the service to delete. For Cloud Run (fully managed), replace `
2031
- # namespace` with the project ID or number. It takes the form namespaces/`
2032
- # namespace`. For example: namespaces/PROJECT_ID
2056
+ # The fully qualified name of the service to delete. It can be any of the
2057
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
2058
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
2059
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
2033
2060
  # @param [String] api_version
2034
- # Cloud Run currently ignores this parameter.
2061
+ # Not supported, and ignored by Cloud Run.
2035
2062
  # @param [String] dry_run
2036
2063
  # Indicates that the server should validate the request and populate default
2037
2064
  # values without persisting the request. Supported values: `all`
2038
2065
  # @param [String] kind
2039
- # Cloud Run currently ignores this parameter.
2066
+ # Not supported, and ignored by Cloud Run.
2040
2067
  # @param [String] propagation_policy
2041
- # Specifies the propagation policy of delete. Cloud Run currently ignores this
2042
- # setting, and deletes in the background. Please see kubernetes.io/docs/concepts/
2043
- # workloads/controllers/garbage-collection/ for more information.
2068
+ # Not supported, and ignored by Cloud Run.
2044
2069
  # @param [String] fields
2045
2070
  # Selector specifying which fields to include in a partial response.
2046
2071
  # @param [String] quota_user
@@ -2072,11 +2097,12 @@ module Google
2072
2097
  execute_or_queue_command(command, &block)
2073
2098
  end
2074
2099
 
2075
- # Get information about a service.
2100
+ # Gets information about a service.
2076
2101
  # @param [String] name
2077
- # The name of the service to retrieve. For Cloud Run (fully managed), replace `
2078
- # namespace` with the project ID or number. It takes the form namespaces/`
2079
- # namespace`. For example: namespaces/PROJECT_ID
2102
+ # The fully qualified name of the service to retrieve. It can be any of the
2103
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
2104
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
2105
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
2080
2106
  # @param [String] fields
2081
2107
  # Selector specifying which fields to include in a partial response.
2082
2108
  # @param [String] quota_user
@@ -2104,7 +2130,7 @@ module Google
2104
2130
  execute_or_queue_command(command, &block)
2105
2131
  end
2106
2132
 
2107
- # Get the IAM Access Control policy currently in effect for the given Cloud Run
2133
+ # Gets the IAM Access Control policy currently in effect for the given Cloud Run
2108
2134
  # service. This result does not include any inherited policies.
2109
2135
  # @param [String] resource
2110
2136
  # REQUIRED: The resource for which the policy is being requested. See [Resource
@@ -2149,30 +2175,27 @@ module Google
2149
2175
  execute_or_queue_command(command, &block)
2150
2176
  end
2151
2177
 
2152
- # List services.
2178
+ # Lists services for the given project and region.
2153
2179
  # @param [String] parent
2154
- # The namespace from which the services should be listed. For Cloud Run (fully
2155
- # managed), replace `namespace` with the project ID or number. It takes the form
2156
- # namespaces/`namespace`. For example: namespaces/PROJECT_ID
2180
+ # The parent from where the resources should be listed. In Cloud Run, it may be
2181
+ # one of the following: * `namespaces/`project_id_or_number`` * `projects/`
2182
+ # project_id_or_number`/locations/`region`` * `projects/`project_id_or_number`/
2183
+ # regions/`region``
2157
2184
  # @param [String] continue
2158
2185
  # Optional. Encoded string to continue paging.
2159
2186
  # @param [String] field_selector
2160
- # Allows to filter resources based on a specific value for a field name. Send
2161
- # this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently
2162
- # used by Cloud Run.
2187
+ # Not supported, and ignored by Cloud Run.
2163
2188
  # @param [Boolean] include_uninitialized
2164
- # Not currently used by Cloud Run.
2189
+ # Not supported, and ignored by Cloud Run.
2165
2190
  # @param [String] label_selector
2166
2191
  # Allows to filter resources based on a label. Supported operations are =, !=,
2167
2192
  # exists, in, and notIn.
2168
2193
  # @param [Fixnum] limit
2169
2194
  # Optional. The maximum number of records that should be returned.
2170
2195
  # @param [String] resource_version
2171
- # The baseline resource version from which the list or watch operation should
2172
- # start. Not currently used by Cloud Run.
2196
+ # Not supported, and ignored by Cloud Run.
2173
2197
  # @param [Boolean] watch
2174
- # Flag that indicates that the client expects to watch this resource as well.
2175
- # Not currently used by Cloud Run.
2198
+ # Not supported, and ignored by Cloud Run.
2176
2199
  # @param [String] fields
2177
2200
  # Selector specifying which fields to include in a partial response.
2178
2201
  # @param [String] quota_user
@@ -2207,14 +2230,15 @@ module Google
2207
2230
  execute_or_queue_command(command, &block)
2208
2231
  end
2209
2232
 
2210
- # Replace a service. Only the spec and metadata labels and annotations are
2233
+ # Replaces a service. Only the spec and metadata labels and annotations are
2211
2234
  # modifiable. After the Update request, Cloud Run will work to make the 'status'
2212
2235
  # match the requested 'spec'. May provide metadata.resourceVersion to enforce
2213
2236
  # update from last read for optimistic concurrency control.
2214
2237
  # @param [String] name
2215
- # The name of the service being replaced. For Cloud Run (fully managed), replace
2216
- # `namespace` with the project ID or number. It takes the form namespaces/`
2217
- # namespace`. For example: namespaces/PROJECT_ID
2238
+ # The fully qualified name of the service to replace. It can be any of the
2239
+ # following forms: * `namespaces/`project_id_or_number`/services/`service_name``
2240
+ # * `projects/`project_id_or_number`/locations/`region`/services/`service_name``
2241
+ # * `projects/`project_id_or_number`/regions/`region`/services/`service_name``
2218
2242
  # @param [Google::Apis::RunV1::Service] service_object
2219
2243
  # @param [String] dry_run
2220
2244
  # Indicates that the server should validate the request and populate default
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-run_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.34.0
4
+ version: 0.37.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-08-08 00:00:00.000000000 Z
11
+ date: 2022-08-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-run_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-run_v1/v0.34.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-run_v1/v0.37.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-run_v1
63
63
  post_install_message:
64
64
  rdoc_options: []