aws-sdk-mwaa 1.3.0 → 1.7.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -70,6 +70,7 @@ module Aws::MWAA
70
70
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
71
71
  S3BucketArn = Shapes::StringShape.new(name: 'S3BucketArn')
72
72
  S3ObjectVersion = Shapes::StringShape.new(name: 'S3ObjectVersion')
73
+ Schedulers = Shapes::IntegerShape.new(name: 'Schedulers')
73
74
  SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
74
75
  SecurityGroupList = Shapes::ListShape.new(name: 'SecurityGroupList')
75
76
  StatisticSet = Shapes::StructureShape.new(name: 'StatisticSet')
@@ -129,6 +130,7 @@ module Aws::MWAA
129
130
  CreateEnvironmentInput.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
130
131
  CreateEnvironmentInput.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
131
132
  CreateEnvironmentInput.add_member(:requirements_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "RequirementsS3Path"))
133
+ CreateEnvironmentInput.add_member(:schedulers, Shapes::ShapeRef.new(shape: Schedulers, location_name: "Schedulers"))
132
134
  CreateEnvironmentInput.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "SourceBucketArn"))
133
135
  CreateEnvironmentInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
134
136
  CreateEnvironmentInput.add_member(:webserver_access_mode, Shapes::ShapeRef.new(shape: WebserverAccessMode, location_name: "WebserverAccessMode"))
@@ -174,6 +176,7 @@ module Aws::MWAA
174
176
  Environment.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
175
177
  Environment.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
176
178
  Environment.add_member(:requirements_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "RequirementsS3Path"))
179
+ Environment.add_member(:schedulers, Shapes::ShapeRef.new(shape: Schedulers, location_name: "Schedulers"))
177
180
  Environment.add_member(:service_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "ServiceRoleArn"))
178
181
  Environment.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, location_name: "SourceBucketArn"))
179
182
  Environment.add_member(:status, Shapes::ShapeRef.new(shape: EnvironmentStatus, location_name: "Status"))
@@ -306,6 +309,7 @@ module Aws::MWAA
306
309
  UpdateEnvironmentInput.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
307
310
  UpdateEnvironmentInput.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
308
311
  UpdateEnvironmentInput.add_member(:requirements_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "RequirementsS3Path"))
312
+ UpdateEnvironmentInput.add_member(:schedulers, Shapes::ShapeRef.new(shape: Schedulers, location_name: "Schedulers"))
309
313
  UpdateEnvironmentInput.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, location_name: "SourceBucketArn"))
310
314
  UpdateEnvironmentInput.add_member(:webserver_access_mode, Shapes::ShapeRef.new(shape: WebserverAccessMode, location_name: "WebserverAccessMode"))
311
315
  UpdateEnvironmentInput.add_member(:weekly_maintenance_window_start, Shapes::ShapeRef.new(shape: WeeklyMaintenanceWindowStart, location_name: "WeeklyMaintenanceWindowStart"))
@@ -117,6 +117,7 @@ module Aws::MWAA
117
117
  # plugins_s3_path: "RelativePath",
118
118
  # requirements_s3_object_version: "S3ObjectVersion",
119
119
  # requirements_s3_path: "RelativePath",
120
+ # schedulers: 1,
120
121
  # source_bucket_arn: "S3BucketArn", # required
121
122
  # tags: {
122
123
  # "TagKey" => "TagValue",
@@ -126,9 +127,9 @@ module Aws::MWAA
126
127
  # }
127
128
  #
128
129
  # @!attribute [rw] airflow_configuration_options
129
- # The Apache Airflow configuration setting you want to override in
130
- # your environment. For more information, see [Environment
131
- # configuration][1].
130
+ # A list of key-value pairs containing the Apache Airflow
131
+ # configuration options you want to attach to your environment. To
132
+ # learn more, see [Apache Airflow configuration options][1].
132
133
  #
133
134
  #
134
135
  #
@@ -136,23 +137,27 @@ module Aws::MWAA
136
137
  # @return [Hash<String,String>]
137
138
  #
138
139
  # @!attribute [rw] airflow_version
139
- # The Apache Airflow version you want to use for your environment.
140
+ # The Apache Airflow version for your environment. For example,
141
+ # `v1.10.12`. If no value is specified, defaults to the latest
142
+ # version. Valid values: `v1.10.12`.
140
143
  # @return [String]
141
144
  #
142
145
  # @!attribute [rw] dag_s3_path
143
- # The relative path to the DAG folder on your Amazon S3 storage
144
- # bucket. For example, `dags`. For more information, see [Importing
145
- # DAGs on Amazon MWAA][1].
146
+ # The relative path to the DAGs folder on your Amazon S3 bucket. For
147
+ # example, `dags`. To learn more, see [Adding or updating DAGs][1].
146
148
  #
147
149
  #
148
150
  #
149
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import.html
151
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-folder.html
150
152
  # @return [String]
151
153
  #
152
154
  # @!attribute [rw] environment_class
153
- # The environment class you want to use for your environment. The
154
- # environment class determines the size of the containers and database
155
- # used for your Apache Airflow services.
155
+ # The environment class type. Valid values: `mw1.small`, `mw1.medium`,
156
+ # `mw1.large`. To learn more, see [Amazon MWAA environment class][1].
157
+ #
158
+ #
159
+ #
160
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/environment-class.html
156
161
  # @return [String]
157
162
  #
158
163
  # @!attribute [rw] execution_role_arn
@@ -160,104 +165,126 @@ module Aws::MWAA
160
165
  # environment. An execution role is an AWS Identity and Access
161
166
  # Management (IAM) role that grants MWAA permission to access AWS
162
167
  # services and resources used by your environment. For example,
163
- # `arn:aws:iam::123456789:role/my-execution-role`. For more
164
- # information, see [Managing access to Amazon Managed Workflows for
165
- # Apache Airflow][1].
168
+ # `arn:aws:iam::123456789:role/my-execution-role`. To learn more, see
169
+ # [Amazon MWAA Execution role][1].
166
170
  #
167
171
  #
168
172
  #
169
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/manage-access.html
173
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-create-role.html
170
174
  # @return [String]
171
175
  #
172
176
  # @!attribute [rw] kms_key
173
- # The AWS Key Management Service (KMS) key to encrypt and decrypt the
174
- # data in your environment. You can use an AWS KMS key managed by
175
- # MWAA, or a custom KMS key (advanced). For more information, see
176
- # [Customer master keys (CMKs)][1] in the AWS KMS developer guide.
177
+ # The AWS Key Management Service (KMS) key to encrypt the data in your
178
+ # environment. You can use an AWS owned CMK, or a Customer managed CMK
179
+ # (advanced). To learn more, see [Get started with Amazon Managed
180
+ # Workflows for Apache Airflow][1].
177
181
  #
178
182
  #
179
183
  #
180
- # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html?icmpid=docs_console_unmapped#master_keys
184
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/get-started.html
181
185
  # @return [String]
182
186
  #
183
187
  # @!attribute [rw] logging_configuration
184
- # The Apache Airflow logs you want to send to Amazon CloudWatch Logs.
188
+ # Defines the Apache Airflow logs to send to CloudWatch Logs:
189
+ # `DagProcessingLogs`, `SchedulerLogs`, `TaskLogs`, `WebserverLogs`,
190
+ # `WorkerLogs`.
185
191
  # @return [Types::LoggingConfigurationInput]
186
192
  #
187
193
  # @!attribute [rw] max_workers
188
194
  # The maximum number of workers that you want to run in your
189
- # environment. MWAA scales the number of Apache Airflow workers and
190
- # the Fargate containers that run your tasks up to the number you
191
- # specify in this field. When there are no more tasks running, and no
192
- # more in the queue, MWAA disposes of the extra containers leaving the
193
- # one worker that is included with your environment.
195
+ # environment. MWAA scales the number of Apache Airflow workers up to
196
+ # the number you specify in the `MaxWorkers` field. For example, `20`.
197
+ # When there are no more tasks running, and no more in the queue, MWAA
198
+ # disposes of the extra workers leaving the one worker that is
199
+ # included with your environment, or the number you specify in
200
+ # `MinWorkers`.
194
201
  # @return [Integer]
195
202
  #
196
203
  # @!attribute [rw] min_workers
197
204
  # The minimum number of workers that you want to run in your
198
- # environment. MWAA scales the number of Apache Airflow workers and
199
- # the Fargate containers that run your tasks up to the number you
200
- # specify in the `MaxWorkers` field. When there are no more tasks
201
- # running, and no more in the queue, MWAA disposes of the extra
202
- # containers leaving the worker count you specify in the `MinWorkers`
203
- # field.
205
+ # environment. MWAA scales the number of Apache Airflow workers up to
206
+ # the number you specify in the `MaxWorkers` field. When there are no
207
+ # more tasks running, and no more in the queue, MWAA disposes of the
208
+ # extra workers leaving the worker count you specify in the
209
+ # `MinWorkers` field. For example, `2`.
204
210
  # @return [Integer]
205
211
  #
206
212
  # @!attribute [rw] name
207
- # The name of your MWAA environment.
213
+ # The name of the Amazon MWAA environment. For example,
214
+ # `MyMWAAEnvironment`.
208
215
  # @return [String]
209
216
  #
210
217
  # @!attribute [rw] network_configuration
211
- # The VPC networking components you want to use for your environment.
212
- # At least two private subnet identifiers and one VPC security group
213
- # identifier are required to create an environment. For more
214
- # information, see [Creating the VPC network for a MWAA
215
- # environment][1].
218
+ # The VPC networking components used to secure and enable network
219
+ # traffic between the AWS resources for your environment. To learn
220
+ # more, see [About networking on Amazon MWAA][1].
216
221
  #
217
222
  #
218
223
  #
219
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/vpc-mwaa.html
224
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html
220
225
  # @return [Types::NetworkConfiguration]
221
226
  #
222
227
  # @!attribute [rw] plugins_s3_object_version
223
- # The `plugins.zip` file version you want to use.
228
+ # The version of the plugins.zip file on your Amazon S3 bucket. A
229
+ # version must be specified each time a plugins.zip file is updated.
230
+ # To learn more, see [How S3 Versioning works][1].
231
+ #
232
+ #
233
+ #
234
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html
224
235
  # @return [String]
225
236
  #
226
237
  # @!attribute [rw] plugins_s3_path
227
238
  # The relative path to the `plugins.zip` file on your Amazon S3
228
- # storage bucket. For example, `plugins.zip`. If a relative path is
229
- # provided in the request, then `PluginsS3ObjectVersion` is required.
230
- # For more information, see [Importing DAGs on Amazon MWAA][1].
239
+ # bucket. For example, `plugins.zip`. If specified, then the
240
+ # plugins.zip version is required. To learn more, see [Installing
241
+ # custom plugins][1].
231
242
  #
232
243
  #
233
244
  #
234
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import.html
245
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html
235
246
  # @return [String]
236
247
  #
237
248
  # @!attribute [rw] requirements_s3_object_version
238
- # The `requirements.txt` file version you want to use.
249
+ # The version of the requirements.txt file on your Amazon S3 bucket. A
250
+ # version must be specified each time a requirements.txt file is
251
+ # updated. To learn more, see [How S3 Versioning works][1].
252
+ #
253
+ #
254
+ #
255
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html
239
256
  # @return [String]
240
257
  #
241
258
  # @!attribute [rw] requirements_s3_path
242
259
  # The relative path to the `requirements.txt` file on your Amazon S3
243
- # storage bucket. For example, `requirements.txt`. If a relative path
244
- # is provided in the request, then `RequirementsS3ObjectVersion` is
245
- # required. For more information, see [Importing DAGs on Amazon
246
- # MWAA][1].
260
+ # bucket. For example, `requirements.txt`. If specified, then a file
261
+ # version is required. To learn more, see [Installing Python
262
+ # dependencies][1].
247
263
  #
248
264
  #
249
265
  #
250
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import.html
266
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html
251
267
  # @return [String]
252
268
  #
269
+ # @!attribute [rw] schedulers
270
+ # The number of Apache Airflow schedulers to run in your environment.
271
+ # @return [Integer]
272
+ #
253
273
  # @!attribute [rw] source_bucket_arn
254
- # The Amazon Resource Name (ARN) of your Amazon S3 storage bucket. For
255
- # example, `arn:aws:s3:::airflow-mybucketname`.
274
+ # The Amazon Resource Name (ARN) of the Amazon S3 bucket where your
275
+ # DAG code and supporting files are stored. For example,
276
+ # `arn:aws:s3:::my-airflow-bucket-unique-name`. To learn more, see
277
+ # [Create an Amazon S3 bucket for Amazon MWAA][1].
278
+ #
279
+ #
280
+ #
281
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-s3-bucket.html
256
282
  # @return [String]
257
283
  #
258
284
  # @!attribute [rw] tags
259
- # The metadata tags you want to attach to your environment. For more
260
- # information, see [Tagging AWS resources][1].
285
+ # The key-value tag pairs you want to associate to your environment.
286
+ # For example, `"Environment": "Staging"`. To learn more, see [Tagging
287
+ # AWS resources][1].
261
288
  #
262
289
  #
263
290
  #
@@ -265,21 +292,23 @@ module Aws::MWAA
265
292
  # @return [Hash<String,String>]
266
293
  #
267
294
  # @!attribute [rw] webserver_access_mode
268
- # The networking access of your Apache Airflow web server. A public
269
- # network allows your Airflow UI to be accessed over the Internet by
270
- # users granted access in your IAM policy. A private network limits
271
- # access of your Airflow UI to users within your VPC. For more
272
- # information, see [Creating the VPC network for a MWAA
273
- # environment][1].
295
+ # The Apache Airflow *Web server* access mode. To learn more, see
296
+ # [Apache Airflow access modes][1].
274
297
  #
275
298
  #
276
299
  #
277
- # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/vpc-mwaa.html
300
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-networking.html
278
301
  # @return [String]
279
302
  #
280
303
  # @!attribute [rw] weekly_maintenance_window_start
281
- # The day and time you want MWAA to start weekly maintenance updates
282
- # on your environment.
304
+ # The day and time of the week to start weekly maintenance updates of
305
+ # your environment in the following format: `DAY:HH:MM`. For example:
306
+ # `TUE:03:30`. You can specify a start time in 30 minute increments
307
+ # only. Supported input includes the following:
308
+ #
309
+ # * MON\|TUE\|WED\|THU\|FRI\|SAT\|SUN:(\[01\]\\\\d\|2\[0-3\]):(00\|30)
310
+ #
311
+ # ^
283
312
  # @return [String]
284
313
  #
285
314
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/CreateEnvironmentInput AWS API Documentation
@@ -300,6 +329,7 @@ module Aws::MWAA
300
329
  :plugins_s3_path,
301
330
  :requirements_s3_object_version,
302
331
  :requirements_s3_path,
332
+ :schedulers,
303
333
  :source_bucket_arn,
304
334
  :tags,
305
335
  :webserver_access_mode,
@@ -309,7 +339,8 @@ module Aws::MWAA
309
339
  end
310
340
 
311
341
  # @!attribute [rw] arn
312
- # The resulting Amazon MWAA envirnonment ARN.
342
+ # The Amazon Resource Name (ARN) returned in the response for the
343
+ # environment.
313
344
  # @return [String]
314
345
  #
315
346
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/CreateEnvironmentOutput AWS API Documentation
@@ -366,7 +397,8 @@ module Aws::MWAA
366
397
  # }
367
398
  #
368
399
  # @!attribute [rw] name
369
- # The name of the environment to delete.
400
+ # The name of the Amazon MWAA environment. For example,
401
+ # `MyMWAAEnvironment`.
370
402
  # @return [String]
371
403
  #
372
404
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/DeleteEnvironmentInput AWS API Documentation
@@ -408,111 +440,234 @@ module Aws::MWAA
408
440
  include Aws::Structure
409
441
  end
410
442
 
411
- # An Amazon MWAA environment.
443
+ # The Amazon Managed Workflows for Apache Airflow (MWAA) environment.
412
444
  #
413
445
  # @!attribute [rw] airflow_configuration_options
414
- # The Airflow Configuration Options of the Amazon MWAA Environment.
446
+ # A list of key-value pairs containing the Apache Airflow
447
+ # configuration options attached to your environment. To learn more,
448
+ # see [Apache Airflow configuration options][1].
449
+ #
450
+ #
451
+ #
452
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-env-variables.html
415
453
  # @return [Hash<String,String>]
416
454
  #
417
455
  # @!attribute [rw] airflow_version
418
- # The AirflowV ersion of the Amazon MWAA Environment.
456
+ # The Apache Airflow version on your environment. For example,
457
+ # `v1.10.12`.
419
458
  # @return [String]
420
459
  #
421
460
  # @!attribute [rw] arn
422
- # The ARN of the Amazon MWAA Environment.
461
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment.
423
462
  # @return [String]
424
463
  #
425
464
  # @!attribute [rw] created_at
426
- # The Created At date of the Amazon MWAA Environment.
465
+ # The day and time the environment was created.
427
466
  # @return [Time]
428
467
  #
429
468
  # @!attribute [rw] dag_s3_path
430
- # The Dags S3 Path of the Amazon MWAA Environment.
469
+ # The relative path to the DAGs folder on your Amazon S3 bucket. For
470
+ # example, `dags`. To learn more, see [Adding or updating DAGs][1].
471
+ #
472
+ #
473
+ #
474
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-folder.html
431
475
  # @return [String]
432
476
  #
433
477
  # @!attribute [rw] environment_class
434
- # The Environment Class (size) of the Amazon MWAA Environment.
478
+ # The environment class type. Valid values: `mw1.small`, `mw1.medium`,
479
+ # `mw1.large`. To learn more, see [Amazon MWAA environment class][1].
480
+ #
481
+ #
482
+ #
483
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/environment-class.html
435
484
  # @return [String]
436
485
  #
437
486
  # @!attribute [rw] execution_role_arn
438
- # The Execution Role ARN of the Amazon MWAA Environment.
487
+ # The Amazon Resource Name (ARN) of the execution role in IAM that
488
+ # allows MWAA to access AWS resources in your environment. For
489
+ # example, `arn:aws:iam::123456789:role/my-execution-role`. To learn
490
+ # more, see [Amazon MWAA Execution role][1].
491
+ #
492
+ #
493
+ #
494
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-create-role.html
439
495
  # @return [String]
440
496
  #
441
497
  # @!attribute [rw] kms_key
442
- # The Kms Key of the Amazon MWAA Environment.
498
+ # The Key Management Service (KMS) encryption key used to encrypt the
499
+ # data in your environment.
443
500
  # @return [String]
444
501
  #
445
502
  # @!attribute [rw] last_update
446
- # Last update information for the environment.
503
+ # The status of the last update on the environment, and any errors
504
+ # that were encountered.
447
505
  # @return [Types::LastUpdate]
448
506
  #
449
507
  # @!attribute [rw] logging_configuration
450
- # The Logging Configuration of the Amazon MWAA Environment.
508
+ # The Apache Airflow logs being sent to CloudWatch Logs:
509
+ # `DagProcessingLogs`, `SchedulerLogs`, `TaskLogs`, `WebserverLogs`,
510
+ # `WorkerLogs`.
451
511
  # @return [Types::LoggingConfiguration]
452
512
  #
453
513
  # @!attribute [rw] max_workers
454
- # The maximum number of workers to run in your Amazon MWAA
455
- # Environment.
514
+ # The maximum number of workers that run in your environment. For
515
+ # example, `20`.
456
516
  # @return [Integer]
457
517
  #
458
518
  # @!attribute [rw] min_workers
459
- # The minimum number of workers to run in your Amazon MWAA
460
- # Environment.
519
+ # The minimum number of workers that run in your environment. For
520
+ # example, `2`.
461
521
  # @return [Integer]
462
522
  #
463
523
  # @!attribute [rw] name
464
- # The name of the Amazon MWAA Environment.
524
+ # The name of the Amazon MWAA environment. For example,
525
+ # `MyMWAAEnvironment`.
465
526
  # @return [String]
466
527
  #
467
528
  # @!attribute [rw] network_configuration
468
- # Provide the security group and subnet IDs for the workers and
469
- # scheduler.
529
+ # The VPC networking components used to secure and enable network
530
+ # traffic between the AWS resources for your environment. To learn
531
+ # more, see [About networking on Amazon MWAA][1].
532
+ #
533
+ #
534
+ #
535
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html
470
536
  # @return [Types::NetworkConfiguration]
471
537
  #
472
538
  # @!attribute [rw] plugins_s3_object_version
473
- # The Plugins.zip S3 Object Version of the Amazon MWAA Environment.
539
+ # The version of the plugins.zip file on your Amazon S3 bucket. To
540
+ # learn more, see [Installing custom plugins][1].
541
+ #
542
+ #
543
+ #
544
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html
474
545
  # @return [String]
475
546
  #
476
547
  # @!attribute [rw] plugins_s3_path
477
- # The Plugins.zip S3 Path of the Amazon MWAA Environment.
548
+ # The relative path to the `plugins.zip` file on your Amazon S3
549
+ # bucket. For example, `plugins.zip`. To learn more, see [Installing
550
+ # custom plugins][1].
551
+ #
552
+ #
553
+ #
554
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html
478
555
  # @return [String]
479
556
  #
480
557
  # @!attribute [rw] requirements_s3_object_version
481
- # The Requirements.txt file S3 Object Version of the Amazon MWAA
482
- # Environment.
558
+ # The version of the requirements.txt file on your Amazon S3 bucket.
559
+ # To learn more, see [Installing Python dependencies][1].
560
+ #
561
+ #
562
+ #
563
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html
483
564
  # @return [String]
484
565
  #
485
566
  # @!attribute [rw] requirements_s3_path
486
- # The Requirement.txt S3 Path of the Amazon MWAA Environment.
567
+ # The relative path to the `requirements.txt` file on your Amazon S3
568
+ # bucket. For example, `requirements.txt`. To learn more, see
569
+ # [Installing Python dependencies][1].
570
+ #
571
+ #
572
+ #
573
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html
487
574
  # @return [String]
488
575
  #
576
+ # @!attribute [rw] schedulers
577
+ # The number of Apache Airflow schedulers that run in your Amazon MWAA
578
+ # environment.
579
+ # @return [Integer]
580
+ #
489
581
  # @!attribute [rw] service_role_arn
490
- # The Service Role ARN of the Amazon MWAA Environment.
582
+ # The Amazon Resource Name (ARN) for the service-linked role of the
583
+ # environment. To learn more, see [Amazon MWAA Service-linked
584
+ # role][1].
585
+ #
586
+ #
587
+ #
588
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-slr.html
491
589
  # @return [String]
492
590
  #
493
591
  # @!attribute [rw] source_bucket_arn
494
- # The Source S3 Bucket ARN of the Amazon MWAA Environment.
592
+ # The Amazon Resource Name (ARN) of the Amazon S3 bucket where your
593
+ # DAG code and supporting files are stored. For example,
594
+ # `arn:aws:s3:::my-airflow-bucket-unique-name`. To learn more, see
595
+ # [Create an Amazon S3 bucket for Amazon MWAA][1].
596
+ #
597
+ #
598
+ #
599
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-s3-bucket.html
495
600
  # @return [String]
496
601
  #
497
602
  # @!attribute [rw] status
498
- # The status of the Amazon MWAA Environment.
603
+ # The status of the Amazon MWAA environment. Valid values:
604
+ #
605
+ # * `CREATING` - Indicates the request to create the environment is in
606
+ # progress.
607
+ #
608
+ # * `CREATE_FAILED` - Indicates the request to create the environment
609
+ # failed, and the environment could not be created.
610
+ #
611
+ # * `AVAILABLE` - Indicates the request was successful and the
612
+ # environment is ready to use.
613
+ #
614
+ # * `UPDATING` - Indicates the request to update the environment is in
615
+ # progress.
616
+ #
617
+ # * `DELETING` - Indicates the request to delete the environment is in
618
+ # progress.
619
+ #
620
+ # * `DELETED` - Indicates the request to delete the environment is
621
+ # complete, and the environment has been deleted.
622
+ #
623
+ # * `UNAVAILABLE` - Indicates the request failed, but the environment
624
+ # was unable to rollback and is not in a stable state.
625
+ #
626
+ # * `UPDATE_FAILED` - Indicates the request to update the environment
627
+ # failed, and the environment has rolled back successfully and is
628
+ # ready to use.
629
+ #
630
+ # We recommend reviewing our troubleshooting guide for a list of
631
+ # common errors and their solutions. To learn more, see [Amazon MWAA
632
+ # troubleshooting][1].
633
+ #
634
+ #
635
+ #
636
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/troubleshooting.html
499
637
  # @return [String]
500
638
  #
501
639
  # @!attribute [rw] tags
502
- # The Tags of the Amazon MWAA Environment.
640
+ # The key-value tag pairs associated to your environment. For example,
641
+ # `"Environment": "Staging"`. To learn more, see [Tagging AWS
642
+ # resources][1].
643
+ #
644
+ #
645
+ #
646
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
503
647
  # @return [Hash<String,String>]
504
648
  #
505
649
  # @!attribute [rw] webserver_access_mode
506
- # The Webserver Access Mode of the Amazon MWAA Environment (public or
507
- # private only).
650
+ # The Apache Airflow *Web server* access mode. To learn more, see
651
+ # [Apache Airflow access modes][1].
652
+ #
653
+ #
654
+ #
655
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-networking.html
508
656
  # @return [String]
509
657
  #
510
658
  # @!attribute [rw] webserver_url
511
- # The Webserver URL of the Amazon MWAA Environment.
659
+ # The Apache Airflow *Web server* host name for the Amazon MWAA
660
+ # environment. To learn more, see [Accessing the Apache Airflow
661
+ # UI][1].
662
+ #
663
+ #
664
+ #
665
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/access-airflow-ui.html
512
666
  # @return [String]
513
667
  #
514
668
  # @!attribute [rw] weekly_maintenance_window_start
515
- # The Weekly Maintenance Window Start of the Amazon MWAA Environment.
669
+ # The day and time of the week that weekly maintenance updates are
670
+ # scheduled. For example: `TUE:03:30`.
516
671
  # @return [String]
517
672
  #
518
673
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/Environment AWS API Documentation
@@ -536,6 +691,7 @@ module Aws::MWAA
536
691
  :plugins_s3_path,
537
692
  :requirements_s3_object_version,
538
693
  :requirements_s3_path,
694
+ :schedulers,
539
695
  :service_role_arn,
540
696
  :source_bucket_arn,
541
697
  :status,
@@ -555,7 +711,8 @@ module Aws::MWAA
555
711
  # }
556
712
  #
557
713
  # @!attribute [rw] name
558
- # The name of the environment to retrieve.
714
+ # The name of the Amazon MWAA environment. For example,
715
+ # `MyMWAAEnvironment`.
559
716
  # @return [String]
560
717
  #
561
718
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/GetEnvironmentInput AWS API Documentation
@@ -567,7 +724,7 @@ module Aws::MWAA
567
724
  end
568
725
 
569
726
  # @!attribute [rw] environment
570
- # A JSON blob with environment details.
727
+ # An object containing all available details about the environment.
571
728
  # @return [Types::Environment]
572
729
  #
573
730
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/GetEnvironmentOutput AWS API Documentation
@@ -591,18 +748,21 @@ module Aws::MWAA
591
748
  include Aws::Structure
592
749
  end
593
750
 
594
- # Last update information for the environment.
751
+ # The status of the last update on the environment, and any errors that
752
+ # were encountered.
595
753
  #
596
754
  # @!attribute [rw] created_at
597
- # Time that last update occurred.
755
+ # The day and time of the last update on the environment.
598
756
  # @return [Time]
599
757
  #
600
758
  # @!attribute [rw] error
601
- # Error string of last update, if applicable.
759
+ # The error that was encountered during the last update of the
760
+ # environment.
602
761
  # @return [Types::UpdateError]
603
762
  #
604
763
  # @!attribute [rw] status
605
- # Status of last update of SUCCESS, FAILED, CREATING, DELETING.
764
+ # The status of the last update on the environment. Valid values:
765
+ # `SUCCESS`, `PENDING`, `FAILED`.
606
766
  # @return [String]
607
767
  #
608
768
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LastUpdate AWS API Documentation
@@ -624,11 +784,12 @@ module Aws::MWAA
624
784
  # }
625
785
  #
626
786
  # @!attribute [rw] max_results
627
- # The maximum results when listing MWAA environments.
787
+ # The maximum number of results to retrieve per page. For example, `5`
788
+ # environments per page.
628
789
  # @return [Integer]
629
790
  #
630
791
  # @!attribute [rw] next_token
631
- # The Next Token when listing MWAA environments.
792
+ # Retrieves the next page of the results.
632
793
  # @return [String]
633
794
  #
634
795
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListEnvironmentsInput AWS API Documentation
@@ -641,11 +802,11 @@ module Aws::MWAA
641
802
  end
642
803
 
643
804
  # @!attribute [rw] environments
644
- # The list of Amazon MWAA Environments.
805
+ # Returns the list of Amazon MWAA environments.
645
806
  # @return [Array<String>]
646
807
  #
647
808
  # @!attribute [rw] next_token
648
- # The Next Token when listing MWAA environments.
809
+ # Retrieves the next page of the results.
649
810
  # @return [String]
650
811
  #
651
812
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListEnvironmentsOutput AWS API Documentation
@@ -665,7 +826,9 @@ module Aws::MWAA
665
826
  # }
666
827
  #
667
828
  # @!attribute [rw] resource_arn
668
- # The ARN of the MWAA environment.
829
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment. For
830
+ # example,
831
+ # `arn:aws:airflow:us-east-1:123456789012:environment/MyMWAAEnvironment`.
669
832
  # @return [String]
670
833
  #
671
834
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListTagsForResourceInput AWS API Documentation
@@ -677,7 +840,12 @@ module Aws::MWAA
677
840
  end
678
841
 
679
842
  # @!attribute [rw] tags
680
- # The tags of the MWAA environments.
843
+ # The key-value tag pairs associated to your environment. To learn
844
+ # more, see [Tagging AWS resources][1].
845
+ #
846
+ #
847
+ #
848
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
681
849
  # @return [Hash<String,String>]
682
850
  #
683
851
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListTagsForResourceOutput AWS API Documentation
@@ -688,36 +856,38 @@ module Aws::MWAA
688
856
  include Aws::Structure
689
857
  end
690
858
 
691
- # The Logging Configuration of your Amazon MWAA environment.
859
+ # Defines the Apache Airflow logs to send to CloudWatch Logs:
860
+ # `DagProcessingLogs`, `SchedulerLogs`, `TaskLogs`, `WebserverLogs`,
861
+ # `WorkerLogs`.
692
862
  #
693
863
  # @!attribute [rw] dag_processing_logs
694
- # A JSON blob that provides configuration to use for logging with
695
- # respect to the various Apache Airflow services: DagProcessingLogs,
696
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
864
+ # Defines the type of logs to send for the Apache Airflow log type
865
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
866
+ # `Enabled`, `LogLevel`.
697
867
  # @return [Types::ModuleLoggingConfiguration]
698
868
  #
699
869
  # @!attribute [rw] scheduler_logs
700
- # A JSON blob that provides configuration to use for logging with
701
- # respect to the various Apache Airflow services: DagProcessingLogs,
702
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
870
+ # Defines the type of logs to send for the Apache Airflow log type
871
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
872
+ # `Enabled`, `LogLevel`.
703
873
  # @return [Types::ModuleLoggingConfiguration]
704
874
  #
705
875
  # @!attribute [rw] task_logs
706
- # A JSON blob that provides configuration to use for logging with
707
- # respect to the various Apache Airflow services: DagProcessingLogs,
708
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
876
+ # Defines the type of logs to send for the Apache Airflow log type
877
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
878
+ # `Enabled`, `LogLevel`.
709
879
  # @return [Types::ModuleLoggingConfiguration]
710
880
  #
711
881
  # @!attribute [rw] webserver_logs
712
- # A JSON blob that provides configuration to use for logging with
713
- # respect to the various Apache Airflow services: DagProcessingLogs,
714
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
882
+ # Defines the type of logs to send for the Apache Airflow log type
883
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
884
+ # `Enabled`, `LogLevel`.
715
885
  # @return [Types::ModuleLoggingConfiguration]
716
886
  #
717
887
  # @!attribute [rw] worker_logs
718
- # A JSON blob that provides configuration to use for logging with
719
- # respect to the various Apache Airflow services: DagProcessingLogs,
720
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
888
+ # Defines the type of logs to send for the Apache Airflow log type
889
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
890
+ # `Enabled`, `LogLevel`.
721
891
  # @return [Types::ModuleLoggingConfiguration]
722
892
  #
723
893
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LoggingConfiguration AWS API Documentation
@@ -732,7 +902,9 @@ module Aws::MWAA
732
902
  include Aws::Structure
733
903
  end
734
904
 
735
- # The Logging Configuration of your Amazon MWAA environment.
905
+ # Defines the Apache Airflow logs to send to CloudWatch Logs:
906
+ # `DagProcessingLogs`, `SchedulerLogs`, `TaskLogs`, `WebserverLogs`,
907
+ # `WorkerLogs`.
736
908
  #
737
909
  # @note When making an API call, you may pass LoggingConfigurationInput
738
910
  # data as a hash:
@@ -761,33 +933,33 @@ module Aws::MWAA
761
933
  # }
762
934
  #
763
935
  # @!attribute [rw] dag_processing_logs
764
- # A JSON blob that provides configuration to use for logging with
765
- # respect to the various Apache Airflow services: DagProcessingLogs,
766
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
936
+ # Defines the type of logs to send for the Apache Airflow log type
937
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
938
+ # `Enabled`, `LogLevel`.
767
939
  # @return [Types::ModuleLoggingConfigurationInput]
768
940
  #
769
941
  # @!attribute [rw] scheduler_logs
770
- # A JSON blob that provides configuration to use for logging with
771
- # respect to the various Apache Airflow services: DagProcessingLogs,
772
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
942
+ # Defines the type of logs to send for the Apache Airflow log type
943
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
944
+ # `Enabled`, `LogLevel`.
773
945
  # @return [Types::ModuleLoggingConfigurationInput]
774
946
  #
775
947
  # @!attribute [rw] task_logs
776
- # A JSON blob that provides configuration to use for logging with
777
- # respect to the various Apache Airflow services: DagProcessingLogs,
778
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
948
+ # Defines the type of logs to send for the Apache Airflow log type
949
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
950
+ # `Enabled`, `LogLevel`.
779
951
  # @return [Types::ModuleLoggingConfigurationInput]
780
952
  #
781
953
  # @!attribute [rw] webserver_logs
782
- # A JSON blob that provides configuration to use for logging with
783
- # respect to the various Apache Airflow services: DagProcessingLogs,
784
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
954
+ # Defines the type of logs to send for the Apache Airflow log type
955
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
956
+ # `Enabled`, `LogLevel`.
785
957
  # @return [Types::ModuleLoggingConfigurationInput]
786
958
  #
787
959
  # @!attribute [rw] worker_logs
788
- # A JSON blob that provides configuration to use for logging with
789
- # respect to the various Apache Airflow services: DagProcessingLogs,
790
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
960
+ # Defines the type of logs to send for the Apache Airflow log type
961
+ # (e.g. `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
962
+ # `Enabled`, `LogLevel`.
791
963
  # @return [Types::ModuleLoggingConfigurationInput]
792
964
  #
793
965
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LoggingConfigurationInput AWS API Documentation
@@ -863,22 +1035,26 @@ module Aws::MWAA
863
1035
  include Aws::Structure
864
1036
  end
865
1037
 
866
- # A JSON blob that provides configuration to use for logging with
867
- # respect to the various Apache Airflow services: DagProcessingLogs,
868
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
1038
+ # Defines the type of logs to send for the Apache Airflow log type (e.g.
1039
+ # `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
1040
+ # `Enabled`, `LogLevel`.
869
1041
  #
870
1042
  # @!attribute [rw] cloud_watch_log_group_arn
871
- # Provides the ARN for the CloudWatch group where the logs will be
872
- # published.
1043
+ # The Amazon Resource Name (ARN) for the CloudWatch Logs group where
1044
+ # the Apache Airflow log type (e.g. `DagProcessingLogs`) is published.
1045
+ # For example,
1046
+ # `arn:aws:logs:us-east-1:123456789012:log-group:airflow-MyMWAAEnvironment-MwaaEnvironment-DAGProcessing:*`.
873
1047
  # @return [String]
874
1048
  #
875
1049
  # @!attribute [rw] enabled
876
- # Defines that the logging module is enabled.
1050
+ # Indicates whether to enable the Apache Airflow log type (e.g.
1051
+ # `DagProcessingLogs`) in CloudWatch Logs.
877
1052
  # @return [Boolean]
878
1053
  #
879
1054
  # @!attribute [rw] log_level
880
- # Defines the log level, which can be CRITICAL, ERROR, WARNING, or
881
- # INFO.
1055
+ # Defines the Apache Airflow logs to send for the log type (e.g.
1056
+ # `DagProcessingLogs`) to CloudWatch Logs. Valid values: `CRITICAL`,
1057
+ # `ERROR`, `WARNING`, `INFO`.
882
1058
  # @return [String]
883
1059
  #
884
1060
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ModuleLoggingConfiguration AWS API Documentation
@@ -891,9 +1067,9 @@ module Aws::MWAA
891
1067
  include Aws::Structure
892
1068
  end
893
1069
 
894
- # A JSON blob that provides configuration to use for logging with
895
- # respect to the various Apache Airflow services: DagProcessingLogs,
896
- # SchedulerLogs, TaskLogs, WebserverLogs, and WorkerLogs.
1070
+ # Defines the type of logs to send for the Apache Airflow log type (e.g.
1071
+ # `DagProcessingLogs`). Valid values: `CloudWatchLogGroupArn`,
1072
+ # `Enabled`, `LogLevel`.
897
1073
  #
898
1074
  # @note When making an API call, you may pass ModuleLoggingConfigurationInput
899
1075
  # data as a hash:
@@ -904,12 +1080,14 @@ module Aws::MWAA
904
1080
  # }
905
1081
  #
906
1082
  # @!attribute [rw] enabled
907
- # Defines that the logging module is enabled.
1083
+ # Indicates whether to enable the Apache Airflow log type (e.g.
1084
+ # `DagProcessingLogs`) in CloudWatch Logs.
908
1085
  # @return [Boolean]
909
1086
  #
910
1087
  # @!attribute [rw] log_level
911
- # Defines the log level, which can be CRITICAL, ERROR, WARNING, or
912
- # INFO.
1088
+ # Defines the Apache Airflow logs to send for the log type (e.g.
1089
+ # `DagProcessingLogs`) to CloudWatch Logs. Valid values: `CRITICAL`,
1090
+ # `ERROR`, `WARNING`, `INFO`.
913
1091
  # @return [String]
914
1092
  #
915
1093
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ModuleLoggingConfigurationInput AWS API Documentation
@@ -921,8 +1099,13 @@ module Aws::MWAA
921
1099
  include Aws::Structure
922
1100
  end
923
1101
 
924
- # Provide the security group and subnet IDs for the workers and
925
- # scheduler.
1102
+ # The VPC networking components used to secure and enable network
1103
+ # traffic between the AWS resources for your environment. To learn more,
1104
+ # see [About networking on Amazon MWAA][1].
1105
+ #
1106
+ #
1107
+ #
1108
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html
926
1109
  #
927
1110
  # @note When making an API call, you may pass NetworkConfiguration
928
1111
  # data as a hash:
@@ -933,13 +1116,20 @@ module Aws::MWAA
933
1116
  # }
934
1117
  #
935
1118
  # @!attribute [rw] security_group_ids
936
- # A JSON list of 1 or more security groups IDs by name, in the same
937
- # VPC as the subnets.
1119
+ # A list of 1 or more security group IDs. Accepts up to 5 security
1120
+ # group IDs. A security group must be attached to the same VPC as the
1121
+ # subnets. To learn more, see [Security in your VPC on Amazon
1122
+ # MWAA][1].
1123
+ #
1124
+ #
1125
+ #
1126
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/vpc-security.html
938
1127
  # @return [Array<String>]
939
1128
  #
940
1129
  # @!attribute [rw] subnet_ids
941
- # Provide a JSON list of 2 subnet IDs by name. These must be private
942
- # subnets, in the same VPC, in two different availability zones.
1130
+ # A list of 2 subnet IDs. **Required** to create an environment. Must
1131
+ # be private subnets in two different availability zones. A subnet
1132
+ # must be attached to the same VPC as the security group.
943
1133
  # @return [Array<String>]
944
1134
  #
945
1135
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/NetworkConfiguration AWS API Documentation
@@ -1063,11 +1253,19 @@ module Aws::MWAA
1063
1253
  # }
1064
1254
  #
1065
1255
  # @!attribute [rw] resource_arn
1066
- # The tag resource ARN of the MWAA environments.
1256
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment. For
1257
+ # example,
1258
+ # `arn:aws:airflow:us-east-1:123456789012:environment/MyMWAAEnvironment`.
1067
1259
  # @return [String]
1068
1260
  #
1069
1261
  # @!attribute [rw] tags
1070
- # The tag resource tag of the MWAA environments.
1262
+ # The key-value tag pairs you want to associate to your environment.
1263
+ # For example, `"Environment": "Staging"`. To learn more, see [Tagging
1264
+ # AWS resources][1].
1265
+ #
1266
+ #
1267
+ #
1268
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1071
1269
  # @return [Hash<String,String>]
1072
1270
  #
1073
1271
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/TagResourceInput AWS API Documentation
@@ -1092,11 +1290,14 @@ module Aws::MWAA
1092
1290
  # }
1093
1291
  #
1094
1292
  # @!attribute [rw] resource_arn
1095
- # The tag resource ARN of the MWAA environments.
1293
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment. For
1294
+ # example,
1295
+ # `arn:aws:airflow:us-east-1:123456789012:environment/MyMWAAEnvironment`.
1096
1296
  # @return [String]
1097
1297
  #
1098
1298
  # @!attribute [rw] tag_keys
1099
- # The tag resource key of the MWAA environments.
1299
+ # The key-value tag pair you want to remove. For example,
1300
+ # `"Environment": "Staging"`.
1100
1301
  # @return [Array<String>]
1101
1302
  #
1102
1303
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UntagResourceInput AWS API Documentation
@@ -1155,84 +1356,173 @@ module Aws::MWAA
1155
1356
  # plugins_s3_path: "RelativePath",
1156
1357
  # requirements_s3_object_version: "S3ObjectVersion",
1157
1358
  # requirements_s3_path: "RelativePath",
1359
+ # schedulers: 1,
1158
1360
  # source_bucket_arn: "S3BucketArn",
1159
1361
  # webserver_access_mode: "PRIVATE_ONLY", # accepts PRIVATE_ONLY, PUBLIC_ONLY
1160
1362
  # weekly_maintenance_window_start: "WeeklyMaintenanceWindowStart",
1161
1363
  # }
1162
1364
  #
1163
1365
  # @!attribute [rw] airflow_configuration_options
1164
- # The Airflow Configuration Options to update of your Amazon MWAA
1165
- # environment.
1366
+ # A list of key-value pairs containing the Apache Airflow
1367
+ # configuration options you want to attach to your environment. To
1368
+ # learn more, see [Apache Airflow configuration options][1].
1369
+ #
1370
+ #
1371
+ #
1372
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-env-variables.html
1166
1373
  # @return [Hash<String,String>]
1167
1374
  #
1168
1375
  # @!attribute [rw] airflow_version
1169
- # The Airflow Version to update of your Amazon MWAA environment.
1376
+ # The Apache Airflow version for your environment. For example,
1377
+ # `v1.10.12`. If no value is specified, defaults to the latest
1378
+ # version. Valid values: `v1.10.12`.
1170
1379
  # @return [String]
1171
1380
  #
1172
1381
  # @!attribute [rw] dag_s3_path
1173
- # The Dags folder S3 Path to update of your Amazon MWAA environment.
1382
+ # The relative path to the DAGs folder on your Amazon S3 bucket. For
1383
+ # example, `dags`. To learn more, see [Adding or updating DAGs][1].
1384
+ #
1385
+ #
1386
+ #
1387
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-folder.html
1174
1388
  # @return [String]
1175
1389
  #
1176
1390
  # @!attribute [rw] environment_class
1177
- # The Environment Class to update of your Amazon MWAA environment.
1391
+ # The environment class type. Valid values: `mw1.small`, `mw1.medium`,
1392
+ # `mw1.large`. To learn more, see [Amazon MWAA environment class][1].
1393
+ #
1394
+ #
1395
+ #
1396
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/environment-class.html
1178
1397
  # @return [String]
1179
1398
  #
1180
1399
  # @!attribute [rw] execution_role_arn
1181
- # The Executio Role ARN to update of your Amazon MWAA environment.
1400
+ # The Amazon Resource Name (ARN) of the execution role in IAM that
1401
+ # allows MWAA to access AWS resources in your environment. For
1402
+ # example, `arn:aws:iam::123456789:role/my-execution-role`. To learn
1403
+ # more, see [Amazon MWAA Execution role][1].
1404
+ #
1405
+ #
1406
+ #
1407
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-create-role.html
1182
1408
  # @return [String]
1183
1409
  #
1184
1410
  # @!attribute [rw] logging_configuration
1185
- # The Logging Configuration to update of your Amazon MWAA environment.
1411
+ # Defines the Apache Airflow logs to send to CloudWatch Logs:
1412
+ # `DagProcessingLogs`, `SchedulerLogs`, `TaskLogs`, `WebserverLogs`,
1413
+ # `WorkerLogs`.
1186
1414
  # @return [Types::LoggingConfigurationInput]
1187
1415
  #
1188
1416
  # @!attribute [rw] max_workers
1189
- # The maximum number of workers to update of your Amazon MWAA
1190
- # environment.
1417
+ # The maximum number of workers that you want to run in your
1418
+ # environment. MWAA scales the number of Apache Airflow workers up to
1419
+ # the number you specify in the `MaxWorkers` field. For example, `20`.
1420
+ # When there are no more tasks running, and no more in the queue, MWAA
1421
+ # disposes of the extra workers leaving the one worker that is
1422
+ # included with your environment, or the number you specify in
1423
+ # `MinWorkers`.
1191
1424
  # @return [Integer]
1192
1425
  #
1193
1426
  # @!attribute [rw] min_workers
1194
- # The minimum number of workers to update of your Amazon MWAA
1195
- # environment.
1427
+ # The minimum number of workers that you want to run in your
1428
+ # environment. MWAA scales the number of Apache Airflow workers up to
1429
+ # the number you specify in the `MaxWorkers` field. When there are no
1430
+ # more tasks running, and no more in the queue, MWAA disposes of the
1431
+ # extra workers leaving the worker count you specify in the
1432
+ # `MinWorkers` field. For example, `2`.
1196
1433
  # @return [Integer]
1197
1434
  #
1198
1435
  # @!attribute [rw] name
1199
- # The name of your Amazon MWAA environment that you wish to update.
1436
+ # The name of your Amazon MWAA environment. For example,
1437
+ # `MyMWAAEnvironment`.
1200
1438
  # @return [String]
1201
1439
  #
1202
1440
  # @!attribute [rw] network_configuration
1203
- # The Network Configuration to update of your Amazon MWAA environment.
1441
+ # The VPC networking components used to secure and enable network
1442
+ # traffic between the AWS resources for your environment. To learn
1443
+ # more, see [About networking on Amazon MWAA][1].
1444
+ #
1445
+ #
1446
+ #
1447
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html
1204
1448
  # @return [Types::UpdateNetworkConfigurationInput]
1205
1449
  #
1206
1450
  # @!attribute [rw] plugins_s3_object_version
1207
- # The Plugins.zip S3 Object Version to update of your Amazon MWAA
1208
- # environment.
1451
+ # The version of the plugins.zip file on your Amazon S3 bucket. A
1452
+ # version must be specified each time a plugins.zip file is updated.
1453
+ # To learn more, see [How S3 Versioning works][1].
1454
+ #
1455
+ #
1456
+ #
1457
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html
1209
1458
  # @return [String]
1210
1459
  #
1211
1460
  # @!attribute [rw] plugins_s3_path
1212
- # The Plugins.zip S3 Path to update of your Amazon MWAA environment.
1461
+ # The relative path to the `plugins.zip` file on your Amazon S3
1462
+ # bucket. For example, `plugins.zip`. If specified, then the
1463
+ # plugins.zip version is required. To learn more, see [Installing
1464
+ # custom plugins][1].
1465
+ #
1466
+ #
1467
+ #
1468
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html
1213
1469
  # @return [String]
1214
1470
  #
1215
1471
  # @!attribute [rw] requirements_s3_object_version
1216
- # The Requirements.txt S3 ObjectV ersion to update of your Amazon MWAA
1217
- # environment.
1472
+ # The version of the requirements.txt file on your Amazon S3 bucket. A
1473
+ # version must be specified each time a requirements.txt file is
1474
+ # updated. To learn more, see [How S3 Versioning works][1].
1475
+ #
1476
+ #
1477
+ #
1478
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html
1218
1479
  # @return [String]
1219
1480
  #
1220
1481
  # @!attribute [rw] requirements_s3_path
1221
- # The Requirements.txt S3 Path to update of your Amazon MWAA
1222
- # environment.
1482
+ # The relative path to the `requirements.txt` file on your Amazon S3
1483
+ # bucket. For example, `requirements.txt`. If specified, then a file
1484
+ # version is required. To learn more, see [Installing Python
1485
+ # dependencies][1].
1486
+ #
1487
+ #
1488
+ #
1489
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html
1223
1490
  # @return [String]
1224
1491
  #
1492
+ # @!attribute [rw] schedulers
1493
+ # The number of Apache Airflow schedulers to run in your Amazon MWAA
1494
+ # environment.
1495
+ # @return [Integer]
1496
+ #
1225
1497
  # @!attribute [rw] source_bucket_arn
1226
- # The S3 Source Bucket ARN to update of your Amazon MWAA environment.
1498
+ # The Amazon Resource Name (ARN) of the Amazon S3 bucket where your
1499
+ # DAG code and supporting files are stored. For example,
1500
+ # `arn:aws:s3:::my-airflow-bucket-unique-name`. To learn more, see
1501
+ # [Create an Amazon S3 bucket for Amazon MWAA][1].
1502
+ #
1503
+ #
1504
+ #
1505
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-s3-bucket.html
1227
1506
  # @return [String]
1228
1507
  #
1229
1508
  # @!attribute [rw] webserver_access_mode
1230
- # The Webserver Access Mode to update of your Amazon MWAA environment.
1509
+ # The Apache Airflow *Web server* access mode. To learn more, see
1510
+ # [Apache Airflow access modes][1].
1511
+ #
1512
+ #
1513
+ #
1514
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-networking.html
1231
1515
  # @return [String]
1232
1516
  #
1233
1517
  # @!attribute [rw] weekly_maintenance_window_start
1234
- # The Weekly Maintenance Window Start to update of your Amazon MWAA
1235
- # environment.
1518
+ # The day and time of the week to start weekly maintenance updates of
1519
+ # your environment in the following format: `DAY:HH:MM`. For example:
1520
+ # `TUE:03:30`. You can specify a start time in 30 minute increments
1521
+ # only. Supported input includes the following:
1522
+ #
1523
+ # * MON\|TUE\|WED\|THU\|FRI\|SAT\|SUN:(\[01\]\\\\d\|2\[0-3\]):(00\|30)
1524
+ #
1525
+ # ^
1236
1526
  # @return [String]
1237
1527
  #
1238
1528
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateEnvironmentInput AWS API Documentation
@@ -1252,6 +1542,7 @@ module Aws::MWAA
1252
1542
  :plugins_s3_path,
1253
1543
  :requirements_s3_object_version,
1254
1544
  :requirements_s3_path,
1545
+ :schedulers,
1255
1546
  :source_bucket_arn,
1256
1547
  :webserver_access_mode,
1257
1548
  :weekly_maintenance_window_start)
@@ -1260,7 +1551,9 @@ module Aws::MWAA
1260
1551
  end
1261
1552
 
1262
1553
  # @!attribute [rw] arn
1263
- # The ARN to update of your Amazon MWAA environment.
1554
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment. For
1555
+ # example,
1556
+ # `arn:aws:airflow:us-east-1:123456789012:environment/MyMWAAEnvironment`.
1264
1557
  # @return [String]
1265
1558
  #
1266
1559
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateEnvironmentOutput AWS API Documentation
@@ -1271,14 +1564,15 @@ module Aws::MWAA
1271
1564
  include Aws::Structure
1272
1565
  end
1273
1566
 
1274
- # Error information of update, if applicable.
1567
+ # An object containing the error encountered with the last update:
1568
+ # `ErrorCode`, `ErrorMessage`.
1275
1569
  #
1276
1570
  # @!attribute [rw] error_code
1277
- # Error code of update.
1571
+ # The error code that corresponds to the error with the last update.
1278
1572
  # @return [String]
1279
1573
  #
1280
1574
  # @!attribute [rw] error_message
1281
- # Error message of update.
1575
+ # The error message that corresponds to the error code.
1282
1576
  # @return [String]
1283
1577
  #
1284
1578
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateError AWS API Documentation
@@ -1290,8 +1584,13 @@ module Aws::MWAA
1290
1584
  include Aws::Structure
1291
1585
  end
1292
1586
 
1293
- # Provide the security group and subnet IDs for the workers and
1294
- # scheduler.
1587
+ # The VPC networking components used to secure and enable network
1588
+ # traffic between the AWS resources for your environment. To learn more,
1589
+ # see [About networking on Amazon MWAA][1].
1590
+ #
1591
+ #
1592
+ #
1593
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html
1295
1594
  #
1296
1595
  # @note When making an API call, you may pass UpdateNetworkConfigurationInput
1297
1596
  # data as a hash:
@@ -1301,8 +1600,14 @@ module Aws::MWAA
1301
1600
  # }
1302
1601
  #
1303
1602
  # @!attribute [rw] security_group_ids
1304
- # Provide a JSON list of 1 or more security groups IDs by name, in the
1305
- # same VPC as the subnets.
1603
+ # A list of 1 or more security group IDs. Accepts up to 5 security
1604
+ # group IDs. A security group must be attached to the same VPC as the
1605
+ # subnets. To learn more, see [Security in your VPC on Amazon
1606
+ # MWAA][1].
1607
+ #
1608
+ #
1609
+ #
1610
+ # [1]: https://docs.aws.amazon.com/mwaa/latest/userguide/vpc-security.html
1306
1611
  # @return [Array<String>]
1307
1612
  #
1308
1613
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateNetworkConfigurationInput AWS API Documentation