google-apis-composer_v1beta1 0.18.0 → 0.21.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9914cdee7eb0cb0291f65235e430ace7ddf7257398e5a2bac4ccd0e811da5111
4
- data.tar.gz: a654459ff197584f0fe9d9f8a6e6cbd4993d005edf73ec77bc1d943ff52ca926
3
+ metadata.gz: eaa19746fb6d53f34472f683e3188bc891d9399596ac8cf71422fb3af546b19e
4
+ data.tar.gz: a2a2465d4b1842f1b94746750b114d8cb23d21968ef586ea026c39f32504787d
5
5
  SHA512:
6
- metadata.gz: 26f1590403ae47db72d331d990f3b318700a3f064c18aeadfee8cae306f1bd3726fc47a2f734a57ce3afb32d4b53def75633d4ab35d4c47c9a9d6bc883e0d11e
7
- data.tar.gz: 3247f629bcacec407fae55a275ce3de796f9c1123c69794ef16fc55c310e6f7a285dbc516346e94f088d9db379e3c12ef6d9cc86bc30b0ac1d8de8eacbaa2c51
6
+ metadata.gz: 5b0b3ca38458eeb374839bf0278a144def1eaf44e874439f23778fd591e461172547072bce4e6dc1d46894d79bc1c5007989aaff5728672b4949f1a2f613d9c5
7
+ data.tar.gz: b883391a5c9d312e92dd795880b37c49fc6623fa37e82115394365720d47543cdc7beec193853485b8875f0f09ab7d0eb14e4e7154336c8370f1288026250d96
data/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Release history for google-apis-composer_v1beta1
2
2
 
3
+ ### v0.21.0 (2022-04-01)
4
+
5
+ * Regenerated from discovery document revision 20220326
6
+
7
+ ### v0.20.0 (2022-03-12)
8
+
9
+ * Regenerated from discovery document revision 20220307
10
+
11
+ ### v0.19.0 (2022-03-04)
12
+
13
+ * Regenerated from discovery document revision 20220224
14
+
3
15
  ### v0.18.0 (2022-02-10)
4
16
 
5
17
  * Regenerated from discovery document revision 20220202
@@ -57,18 +57,22 @@ module Google
57
57
 
58
58
  # The version of the software running in the environment. This encapsulates both
59
59
  # the version of Cloud Composer functionality and the version of Apache Airflow.
60
- # It must match the regular expression `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-
61
- # airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. When used as input, the server also
62
- # checks if the provided version is supported and denies the request for an
63
- # unsupported version. The Cloud Composer portion of the version is a [semantic
64
- # version](https://semver.org) or `latest`. When the patch version is omitted,
65
- # the current Cloud Composer patch version is selected. When `latest` is
66
- # provided instead of an explicit version number, the server replaces `latest`
67
- # with the current Cloud Composer version and stores that version number in the
68
- # same field. The portion of the image version that follows `airflow-` is an
69
- # official Apache Airflow repository [release name](https://github.com/apache/
70
- # incubator-airflow/releases). See also [Version List] (/composer/docs/concepts/
71
- # versioning/composer-versions).
60
+ # It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-
61
+ # preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used
62
+ # as input, the server also checks if the provided version is supported and
63
+ # denies the request for an unsupported version. The Cloud Composer portion of
64
+ # the image version is a full [semantic version](https://semver.org), or an
65
+ # alias in the form of major version number or `latest`. When an alias is
66
+ # provided, the server replaces it with the current Cloud Composer version that
67
+ # satisfies the alias. The Apache Airflow portion of the image version is a full
68
+ # semantic version that points to one of the supported Apache Airflow versions,
69
+ # or an alias in the form of only major or major.minor versions specified. When
70
+ # an alias is provided, the server replaces it with the latest Apache Airflow
71
+ # version that satisfies the alias and is supported in the given Cloud Composer
72
+ # version. In all cases, the resolved image version is stored in the same field.
73
+ # See also [version list](/composer/docs/concepts/versioning/composer-versions)
74
+ # and [versioning overview](/composer/docs/concepts/versioning/composer-
75
+ # versioning-overview).
72
76
  # Corresponds to the JSON property `imageVersion`
73
77
  # @return [String]
74
78
  attr_accessor :image_version
@@ -154,14 +158,14 @@ module Google
154
158
  end
155
159
 
156
160
  # The configuration of Cloud SQL instance that is used by the Apache Airflow
157
- # software. Supported for Cloud Composer environments in versions composer-1.*.*-
158
- # airflow-*.*.*.
161
+ # software.
159
162
  class DatabaseConfig
160
163
  include Google::Apis::Core::Hashable
161
164
 
162
165
  # Optional. Cloud SQL machine type used by Airflow database. It has to be one of:
163
166
  # db-n1-standard-2, db-n1-standard-4, db-n1-standard-8 or db-n1-standard-16. If
164
- # not specified, db-n1-standard-2 will be used.
167
+ # not specified, db-n1-standard-2 will be used. Supported for Cloud Composer
168
+ # environments in versions composer-1.*.*-airflow-*.*.*.
165
169
  # Corresponds to the JSON property `machineType`
166
170
  # @return [String]
167
171
  attr_accessor :machine_type
@@ -179,11 +183,11 @@ module Google
179
183
  # Represents a whole or partial calendar date, such as a birthday. The time of
180
184
  # day and time zone are either specified elsewhere or are insignificant. The
181
185
  # date is relative to the Gregorian Calendar. This can represent one of the
182
- # following: * A full date, with non-zero year, month, and day values * A month
183
- # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
184
- # zero month and a zero day * A year and month, with a zero day (e.g., a credit
185
- # card expiration date) Related types: * google.type.TimeOfDay * google.type.
186
- # DateTime * google.protobuf.Timestamp
186
+ # following: * A full date, with non-zero year, month, and day values. * A month
187
+ # and day, with a zero year (for example, an anniversary). * A year on its own,
188
+ # with a zero month and a zero day. * A year and month, with a zero day (for
189
+ # example, a credit card expiration date). Related types: * google.type.
190
+ # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
187
191
  class Date
188
192
  include Google::Apis::Core::Hashable
189
193
 
@@ -220,8 +224,7 @@ module Google
220
224
  # A generic empty message that you can re-use to avoid defining duplicated empty
221
225
  # messages in your APIs. A typical example is to use it as the request or the
222
226
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
223
- # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
224
- # `Empty` is empty JSON object ````.
227
+ # protobuf.Empty) returns (google.protobuf.Empty); `
225
228
  class Empty
226
229
  include Google::Apis::Core::Hashable
227
230
 
@@ -340,8 +343,7 @@ module Google
340
343
  attr_accessor :dag_gcs_prefix
341
344
 
342
345
  # The configuration of Cloud SQL instance that is used by the Apache Airflow
343
- # software. Supported for Cloud Composer environments in versions composer-1.*.*-
344
- # airflow-*.*.*.
346
+ # software.
345
347
  # Corresponds to the JSON property `databaseConfig`
346
348
  # @return [Google::Apis::ComposerV1beta1::DatabaseConfig]
347
349
  attr_accessor :database_config
@@ -531,7 +533,7 @@ module Google
531
533
  alias_method :creation_disabled?, :creation_disabled
532
534
 
533
535
  # The string identifier of the ImageVersion, in the form: "composer-x.y.z-
534
- # airflow-a.b(.c)"
536
+ # airflow-a.b.c"
535
537
  # Corresponds to the JSON property `imageVersionId`
536
538
  # @return [String]
537
539
  attr_accessor :image_version_id
@@ -546,11 +548,11 @@ module Google
546
548
  # Represents a whole or partial calendar date, such as a birthday. The time of
547
549
  # day and time zone are either specified elsewhere or are insignificant. The
548
550
  # date is relative to the Gregorian Calendar. This can represent one of the
549
- # following: * A full date, with non-zero year, month, and day values * A month
550
- # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
551
- # zero month and a zero day * A year and month, with a zero day (e.g., a credit
552
- # card expiration date) Related types: * google.type.TimeOfDay * google.type.
553
- # DateTime * google.protobuf.Timestamp
551
+ # following: * A full date, with non-zero year, month, and day values. * A month
552
+ # and day, with a zero year (for example, an anniversary). * A year on its own,
553
+ # with a zero month and a zero day. * A year and month, with a zero day (for
554
+ # example, a credit card expiration date). Related types: * google.type.
555
+ # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
554
556
  # Corresponds to the JSON property `releaseDate`
555
557
  # @return [Google::Apis::ComposerV1beta1::Date]
556
558
  attr_accessor :release_date
@@ -657,8 +659,36 @@ module Google
657
659
  end
658
660
  end
659
661
 
660
- # Load environment state response.
661
- class LoadEnvironmentStateResponse
662
+ # Request to load a snapshot into a Cloud Composer environment.
663
+ class LoadSnapshotRequest
664
+ include Google::Apis::Core::Hashable
665
+
666
+ # Whether or not to skip installing Pypi packages when loading the environment's
667
+ # state.
668
+ # Corresponds to the JSON property `skipPypiPackagesInstallation`
669
+ # @return [Boolean]
670
+ attr_accessor :skip_pypi_packages_installation
671
+ alias_method :skip_pypi_packages_installation?, :skip_pypi_packages_installation
672
+
673
+ # A Cloud Storage path to a snapshot to load, e.g.: "gs://my-bucket/snapshots/
674
+ # project_location_environment_timestamp".
675
+ # Corresponds to the JSON property `snapshotPath`
676
+ # @return [String]
677
+ attr_accessor :snapshot_path
678
+
679
+ def initialize(**args)
680
+ update!(**args)
681
+ end
682
+
683
+ # Update properties of this object
684
+ def update!(**args)
685
+ @skip_pypi_packages_installation = args[:skip_pypi_packages_installation] if args.key?(:skip_pypi_packages_installation)
686
+ @snapshot_path = args[:snapshot_path] if args.key?(:snapshot_path)
687
+ end
688
+ end
689
+
690
+ # Response to LoadSnapshotRequest.
691
+ class LoadSnapshotResponse
662
692
  include Google::Apis::Core::Hashable
663
693
 
664
694
  def initialize(**args)
@@ -745,7 +775,7 @@ module Google
745
775
  class NodeConfig
746
776
  include Google::Apis::Core::Hashable
747
777
 
748
- # Optional. The disk size in GB used for node VMs. Minimum size is 20GB. If
778
+ # Optional. The disk size in GB used for node VMs. Minimum size is 30GB. If
749
779
  # unspecified, defaults to 100GB. Cannot be updated. This field is supported for
750
780
  # Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*.
751
781
  # Corresponds to the JSON property `diskSizeGb`
@@ -1136,6 +1166,47 @@ module Google
1136
1166
  end
1137
1167
  end
1138
1168
 
1169
+ # Request to create a snapshot of a Cloud Composer environment.
1170
+ class SaveSnapshotRequest
1171
+ include Google::Apis::Core::Hashable
1172
+
1173
+ # Location in a Cloud Storage where the snapshot is going to be stored, e.g.: "
1174
+ # gs://my-bucket/snapshots".
1175
+ # Corresponds to the JSON property `snapshotLocation`
1176
+ # @return [String]
1177
+ attr_accessor :snapshot_location
1178
+
1179
+ def initialize(**args)
1180
+ update!(**args)
1181
+ end
1182
+
1183
+ # Update properties of this object
1184
+ def update!(**args)
1185
+ @snapshot_location = args[:snapshot_location] if args.key?(:snapshot_location)
1186
+ end
1187
+ end
1188
+
1189
+ # Response to SaveSnapshotRequest.
1190
+ class SaveSnapshotResponse
1191
+ include Google::Apis::Core::Hashable
1192
+
1193
+ # The fully-resolved Cloud Storage path of the created snapshot, e.g.: "gs://my-
1194
+ # bucket/snapshots/project_location_environment_timestamp". This field is
1195
+ # populated only if the snapshot creation was successful.
1196
+ # Corresponds to the JSON property `snapshotPath`
1197
+ # @return [String]
1198
+ attr_accessor :snapshot_path
1199
+
1200
+ def initialize(**args)
1201
+ update!(**args)
1202
+ end
1203
+
1204
+ # Update properties of this object
1205
+ def update!(**args)
1206
+ @snapshot_path = args[:snapshot_path] if args.key?(:snapshot_path)
1207
+ end
1208
+ end
1209
+
1139
1210
  # Configuration for resources used by Airflow schedulers.
1140
1211
  class SchedulerResource
1141
1212
  include Google::Apis::Core::Hashable
@@ -1208,18 +1279,22 @@ module Google
1208
1279
 
1209
1280
  # The version of the software running in the environment. This encapsulates both
1210
1281
  # the version of Cloud Composer functionality and the version of Apache Airflow.
1211
- # It must match the regular expression `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-
1212
- # airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. When used as input, the server also
1213
- # checks if the provided version is supported and denies the request for an
1214
- # unsupported version. The Cloud Composer portion of the version is a [semantic
1215
- # version](https://semver.org) or `latest`. When the patch version is omitted,
1216
- # the current Cloud Composer patch version is selected. When `latest` is
1217
- # provided instead of an explicit version number, the server replaces `latest`
1218
- # with the current Cloud Composer version and stores that version number in the
1219
- # same field. The portion of the image version that follows *airflow-* is an
1220
- # official Apache Airflow repository [release name](https://github.com/apache/
1221
- # incubator-airflow/releases). See also [Version List](/composer/docs/concepts/
1222
- # versioning/composer-versions).
1282
+ # It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-
1283
+ # preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used
1284
+ # as input, the server also checks if the provided version is supported and
1285
+ # denies the request for an unsupported version. The Cloud Composer portion of
1286
+ # the image version is a full [semantic version](https://semver.org), or an
1287
+ # alias in the form of major version number or `latest`. When an alias is
1288
+ # provided, the server replaces it with the current Cloud Composer version that
1289
+ # satisfies the alias. The Apache Airflow portion of the image version is a full
1290
+ # semantic version that points to one of the supported Apache Airflow versions,
1291
+ # or an alias in the form of only major or major.minor versions specified. When
1292
+ # an alias is provided, the server replaces it with the latest Apache Airflow
1293
+ # version that satisfies the alias and is supported in the given Cloud Composer
1294
+ # version. In all cases, the resolved image version is stored in the same field.
1295
+ # See also [version list](/composer/docs/concepts/versioning/composer-versions)
1296
+ # and [versioning overview](/composer/docs/concepts/versioning/composer-
1297
+ # versioning-overview).
1223
1298
  # Corresponds to the JSON property `imageVersion`
1224
1299
  # @return [String]
1225
1300
  attr_accessor :image_version
@@ -1302,27 +1377,6 @@ module Google
1302
1377
  end
1303
1378
  end
1304
1379
 
1305
- # Store environment state response.
1306
- class StoreEnvironmentStateResponse
1307
- include Google::Apis::Core::Hashable
1308
-
1309
- # The fully-resolved Cloud Storage path of the created snapshot, e.g.: "gs://my-
1310
- # bucket/snapshots/project_location_environment_timestamp". This field is
1311
- # populated only if the snapshot creation was successful.
1312
- # Corresponds to the JSON property `snapshotPath`
1313
- # @return [String]
1314
- attr_accessor :snapshot_path
1315
-
1316
- def initialize(**args)
1317
- update!(**args)
1318
- end
1319
-
1320
- # Update properties of this object
1321
- def update!(**args)
1322
- @snapshot_path = args[:snapshot_path] if args.key?(:snapshot_path)
1323
- end
1324
- end
1325
-
1326
1380
  # The configuration settings for the Airflow web server App Engine instance.
1327
1381
  # Supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.
1328
1382
  # *.*.
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module ComposerV1beta1
18
18
  # Version of the google-apis-composer_v1beta1 gem
19
- GEM_VERSION = "0.18.0"
19
+ GEM_VERSION = "0.21.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20220202"
25
+ REVISION = "20220326"
26
26
  end
27
27
  end
28
28
  end
@@ -112,7 +112,13 @@ module Google
112
112
  include Google::Apis::Core::JsonObjectSupport
113
113
  end
114
114
 
115
- class LoadEnvironmentStateResponse
115
+ class LoadSnapshotRequest
116
+ class Representation < Google::Apis::Core::JsonRepresentation; end
117
+
118
+ include Google::Apis::Core::JsonObjectSupport
119
+ end
120
+
121
+ class LoadSnapshotResponse
116
122
  class Representation < Google::Apis::Core::JsonRepresentation; end
117
123
 
118
124
  include Google::Apis::Core::JsonObjectSupport
@@ -166,25 +172,31 @@ module Google
166
172
  include Google::Apis::Core::JsonObjectSupport
167
173
  end
168
174
 
169
- class SchedulerResource
175
+ class SaveSnapshotRequest
170
176
  class Representation < Google::Apis::Core::JsonRepresentation; end
171
177
 
172
178
  include Google::Apis::Core::JsonObjectSupport
173
179
  end
174
180
 
175
- class SoftwareConfig
181
+ class SaveSnapshotResponse
176
182
  class Representation < Google::Apis::Core::JsonRepresentation; end
177
183
 
178
184
  include Google::Apis::Core::JsonObjectSupport
179
185
  end
180
186
 
181
- class Status
187
+ class SchedulerResource
188
+ class Representation < Google::Apis::Core::JsonRepresentation; end
189
+
190
+ include Google::Apis::Core::JsonObjectSupport
191
+ end
192
+
193
+ class SoftwareConfig
182
194
  class Representation < Google::Apis::Core::JsonRepresentation; end
183
195
 
184
196
  include Google::Apis::Core::JsonObjectSupport
185
197
  end
186
198
 
187
- class StoreEnvironmentStateResponse
199
+ class Status
188
200
  class Representation < Google::Apis::Core::JsonRepresentation; end
189
201
 
190
202
  include Google::Apis::Core::JsonObjectSupport
@@ -379,7 +391,15 @@ module Google
379
391
  end
380
392
  end
381
393
 
382
- class LoadEnvironmentStateResponse
394
+ class LoadSnapshotRequest
395
+ # @private
396
+ class Representation < Google::Apis::Core::JsonRepresentation
397
+ property :skip_pypi_packages_installation, as: 'skipPypiPackagesInstallation'
398
+ property :snapshot_path, as: 'snapshotPath'
399
+ end
400
+ end
401
+
402
+ class LoadSnapshotResponse
383
403
  # @private
384
404
  class Representation < Google::Apis::Core::JsonRepresentation
385
405
  end
@@ -476,6 +496,20 @@ module Google
476
496
  end
477
497
  end
478
498
 
499
+ class SaveSnapshotRequest
500
+ # @private
501
+ class Representation < Google::Apis::Core::JsonRepresentation
502
+ property :snapshot_location, as: 'snapshotLocation'
503
+ end
504
+ end
505
+
506
+ class SaveSnapshotResponse
507
+ # @private
508
+ class Representation < Google::Apis::Core::JsonRepresentation
509
+ property :snapshot_path, as: 'snapshotPath'
510
+ end
511
+ end
512
+
479
513
  class SchedulerResource
480
514
  # @private
481
515
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -507,13 +541,6 @@ module Google
507
541
  end
508
542
  end
509
543
 
510
- class StoreEnvironmentStateResponse
511
- # @private
512
- class Representation < Google::Apis::Core::JsonRepresentation
513
- property :snapshot_path, as: 'snapshotPath'
514
- end
515
- end
516
-
517
544
  class WebServerConfig
518
545
  # @private
519
546
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -216,6 +216,42 @@ module Google
216
216
  execute_or_queue_command(command, &block)
217
217
  end
218
218
 
219
+ # Loads a snapshot of a Cloud Composer environment. As a result of this
220
+ # operation, a snapshot of environment's specified in LoadSnapshotRequest is
221
+ # loaded into the environment.
222
+ # @param [String] environment
223
+ # The resource name of the target environment in the form: "projects/`projectId`/
224
+ # locations/`locationId`/environments/`environmentId`"
225
+ # @param [Google::Apis::ComposerV1beta1::LoadSnapshotRequest] load_snapshot_request_object
226
+ # @param [String] fields
227
+ # Selector specifying which fields to include in a partial response.
228
+ # @param [String] quota_user
229
+ # Available to use for quota purposes for server-side applications. Can be any
230
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
231
+ # @param [Google::Apis::RequestOptions] options
232
+ # Request-specific options
233
+ #
234
+ # @yield [result, err] Result & error if block supplied
235
+ # @yieldparam result [Google::Apis::ComposerV1beta1::Operation] parsed result object
236
+ # @yieldparam err [StandardError] error object if request failed
237
+ #
238
+ # @return [Google::Apis::ComposerV1beta1::Operation]
239
+ #
240
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
241
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
242
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
243
+ def load_environment_snapshot(environment, load_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
244
+ command = make_simple_command(:post, 'v1beta1/{+environment}:loadSnapshot', options)
245
+ command.request_representation = Google::Apis::ComposerV1beta1::LoadSnapshotRequest::Representation
246
+ command.request_object = load_snapshot_request_object
247
+ command.response_representation = Google::Apis::ComposerV1beta1::Operation::Representation
248
+ command.response_class = Google::Apis::ComposerV1beta1::Operation
249
+ command.params['environment'] = environment unless environment.nil?
250
+ command.query['fields'] = fields unless fields.nil?
251
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
252
+ execute_or_queue_command(command, &block)
253
+ end
254
+
219
255
  # Update an environment.
220
256
  # @param [String] name
221
257
  # The relative resource name of the environment to update, in the form: "
@@ -284,28 +320,28 @@ module Google
284
320
  # individual environment variables. * `config.softwareConfig.imageVersion` *
285
321
  # Upgrade the version of the environment in-place. Refer to `SoftwareConfig.
286
322
  # image_version` for information on how to format the new image version.
287
- # Additionally, the new image version cannot effect a version downgrade and must
288
- # match the current image version's Composer major version and Airflow major and
289
- # minor versions. Consult the [Cloud Composer Version List](https://cloud.google.
290
- # com/composer/docs/concepts/versioning/composer-versions) for valid values. * `
291
- # config.softwareConfig.schedulerCount` * Horizontally scale the number of
292
- # schedulers in Airflow. A positive integer not greater than the number of nodes
293
- # must be provided in the `config.softwareConfig.schedulerCount` field.
294
- # Supported for Cloud Composer environments in versions composer-1.*.*-airflow-2.
295
- # *.*. * `config.databaseConfig.machineType` * Cloud SQL machine type used by
296
- # Airflow database. It has to be one of: db-n1-standard-2, db-n1-standard-4, db-
297
- # n1-standard-8 or db-n1-standard-16. Supported for Cloud Composer environments
298
- # in versions composer-1.*.*-airflow-*.*.*. * `config.webServerConfig.
299
- # machineType` * Machine type on which Airflow web server is running. It has to
300
- # be one of: composer-n1-webserver-2, composer-n1-webserver-4 or composer-n1-
301
- # webserver-8. Supported for Cloud Composer environments in versions composer-1.*
302
- # .*-airflow-*.*.*. * `config.maintenanceWindow` * Maintenance window during
303
- # which Cloud Composer components may be under maintenance. * `config.
304
- # workloadsConfig` * The workloads configuration settings for the GKE cluster
305
- # associated with the Cloud Composer environment. Supported for Cloud Composer
306
- # environments in versions composer-2.*.*-airflow-*.*.* and newer. * `config.
307
- # environmentSize` * The size of the Cloud Composer environment. Supported for
308
- # Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer.
323
+ # Additionally, the new image version cannot effect a version downgrade, and
324
+ # must match the current image version's Composer and Airflow major versions.
325
+ # Consult the [Cloud Composer version list](/composer/docs/concepts/versioning/
326
+ # composer-versions) for valid values. * `config.softwareConfig.schedulerCount` *
327
+ # Horizontally scale the number of schedulers in Airflow. A positive integer
328
+ # not greater than the number of nodes must be provided in the `config.
329
+ # softwareConfig.schedulerCount` field. Supported for Cloud Composer
330
+ # environments in versions composer-1.*.*-airflow-2.*.*. * `config.
331
+ # databaseConfig.machineType` * Cloud SQL machine type used by Airflow database.
332
+ # It has to be one of: db-n1-standard-2, db-n1-standard-4, db-n1-standard-8 or
333
+ # db-n1-standard-16. Supported for Cloud Composer environments in versions
334
+ # composer-1.*.*-airflow-*.*.*. * `config.webServerConfig.machineType` * Machine
335
+ # type on which Airflow web server is running. It has to be one of: composer-n1-
336
+ # webserver-2, composer-n1-webserver-4 or composer-n1-webserver-8. Supported for
337
+ # Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. * `
338
+ # config.maintenanceWindow` * Maintenance window during which Cloud Composer
339
+ # components may be under maintenance. * `config.workloadsConfig` * The
340
+ # workloads configuration settings for the GKE cluster associated with the Cloud
341
+ # Composer environment. Supported for Cloud Composer environments in versions
342
+ # composer-2.*.*-airflow-*.*.* and newer. * `config.environmentSize` * The size
343
+ # of the Cloud Composer environment. Supported for Cloud Composer environments
344
+ # in versions composer-2.*.*-airflow-*.*.* and newer.
309
345
  # @param [String] fields
310
346
  # Selector specifying which fields to include in a partial response.
311
347
  # @param [String] quota_user
@@ -371,6 +407,42 @@ module Google
371
407
  execute_or_queue_command(command, &block)
372
408
  end
373
409
 
410
+ # Creates a snapshots of a Cloud Composer environment. As a result of this
411
+ # operation, snapshot of environment's state is stored in a location specified
412
+ # in the SaveSnapshotRequest.
413
+ # @param [String] environment
414
+ # The resource name of the source environment in the form: "projects/`projectId`/
415
+ # locations/`locationId`/environments/`environmentId`"
416
+ # @param [Google::Apis::ComposerV1beta1::SaveSnapshotRequest] save_snapshot_request_object
417
+ # @param [String] fields
418
+ # Selector specifying which fields to include in a partial response.
419
+ # @param [String] quota_user
420
+ # Available to use for quota purposes for server-side applications. Can be any
421
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
422
+ # @param [Google::Apis::RequestOptions] options
423
+ # Request-specific options
424
+ #
425
+ # @yield [result, err] Result & error if block supplied
426
+ # @yieldparam result [Google::Apis::ComposerV1beta1::Operation] parsed result object
427
+ # @yieldparam err [StandardError] error object if request failed
428
+ #
429
+ # @return [Google::Apis::ComposerV1beta1::Operation]
430
+ #
431
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
432
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
433
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
434
+ def save_environment_snapshot(environment, save_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
435
+ command = make_simple_command(:post, 'v1beta1/{+environment}:saveSnapshot', options)
436
+ command.request_representation = Google::Apis::ComposerV1beta1::SaveSnapshotRequest::Representation
437
+ command.request_object = save_snapshot_request_object
438
+ command.response_representation = Google::Apis::ComposerV1beta1::Operation::Representation
439
+ command.response_class = Google::Apis::ComposerV1beta1::Operation
440
+ command.params['environment'] = environment unless environment.nil?
441
+ command.query['fields'] = fields unless fields.nil?
442
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
443
+ execute_or_queue_command(command, &block)
444
+ end
445
+
374
446
  # List ImageVersions for provided location.
375
447
  # @param [String] parent
376
448
  # List ImageVersions in the given project and location, in the form: "projects/`
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-composer_v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.18.0
4
+ version: 0.21.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-02-14 00:00:00.000000000 Z
11
+ date: 2022-04-04 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-composer_v1beta1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-composer_v1beta1/v0.18.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-composer_v1beta1/v0.21.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-composer_v1beta1
63
63
  post_install_message:
64
64
  rdoc_options: []