aws-sdk-mwaa 1.0.0 → 1.5.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -59,6 +59,7 @@ module Aws::MWAA
59
59
  MaxWorkers = Shapes::IntegerShape.new(name: 'MaxWorkers')
60
60
  MetricData = Shapes::ListShape.new(name: 'MetricData')
61
61
  MetricDatum = Shapes::StructureShape.new(name: 'MetricDatum')
62
+ MinWorkers = Shapes::IntegerShape.new(name: 'MinWorkers')
62
63
  ModuleLoggingConfiguration = Shapes::StructureShape.new(name: 'ModuleLoggingConfiguration')
63
64
  ModuleLoggingConfigurationInput = Shapes::StructureShape.new(name: 'ModuleLoggingConfigurationInput')
64
65
  NetworkConfiguration = Shapes::StructureShape.new(name: 'NetworkConfiguration')
@@ -69,6 +70,7 @@ module Aws::MWAA
69
70
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
70
71
  S3BucketArn = Shapes::StringShape.new(name: 'S3BucketArn')
71
72
  S3ObjectVersion = Shapes::StringShape.new(name: 'S3ObjectVersion')
73
+ Schedulers = Shapes::IntegerShape.new(name: 'Schedulers')
72
74
  SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
73
75
  SecurityGroupList = Shapes::ListShape.new(name: 'SecurityGroupList')
74
76
  StatisticSet = Shapes::StructureShape.new(name: 'StatisticSet')
@@ -121,12 +123,14 @@ module Aws::MWAA
121
123
  CreateEnvironmentInput.add_member(:kms_key, Shapes::ShapeRef.new(shape: KmsKey, location_name: "KmsKey"))
122
124
  CreateEnvironmentInput.add_member(:logging_configuration, Shapes::ShapeRef.new(shape: LoggingConfigurationInput, location_name: "LoggingConfiguration"))
123
125
  CreateEnvironmentInput.add_member(:max_workers, Shapes::ShapeRef.new(shape: MaxWorkers, location_name: "MaxWorkers"))
126
+ CreateEnvironmentInput.add_member(:min_workers, Shapes::ShapeRef.new(shape: MinWorkers, location_name: "MinWorkers"))
124
127
  CreateEnvironmentInput.add_member(:name, Shapes::ShapeRef.new(shape: EnvironmentName, required: true, location: "uri", location_name: "Name"))
125
128
  CreateEnvironmentInput.add_member(:network_configuration, Shapes::ShapeRef.new(shape: NetworkConfiguration, required: true, location_name: "NetworkConfiguration"))
126
129
  CreateEnvironmentInput.add_member(:plugins_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "PluginsS3ObjectVersion"))
127
130
  CreateEnvironmentInput.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
128
131
  CreateEnvironmentInput.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
129
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"))
130
134
  CreateEnvironmentInput.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "SourceBucketArn"))
131
135
  CreateEnvironmentInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
132
136
  CreateEnvironmentInput.add_member(:webserver_access_mode, Shapes::ShapeRef.new(shape: WebserverAccessMode, location_name: "WebserverAccessMode"))
@@ -165,12 +169,14 @@ module Aws::MWAA
165
169
  Environment.add_member(:last_update, Shapes::ShapeRef.new(shape: LastUpdate, location_name: "LastUpdate"))
166
170
  Environment.add_member(:logging_configuration, Shapes::ShapeRef.new(shape: LoggingConfiguration, location_name: "LoggingConfiguration"))
167
171
  Environment.add_member(:max_workers, Shapes::ShapeRef.new(shape: MaxWorkers, location_name: "MaxWorkers"))
172
+ Environment.add_member(:min_workers, Shapes::ShapeRef.new(shape: MinWorkers, location_name: "MinWorkers"))
168
173
  Environment.add_member(:name, Shapes::ShapeRef.new(shape: EnvironmentName, location_name: "Name"))
169
174
  Environment.add_member(:network_configuration, Shapes::ShapeRef.new(shape: NetworkConfiguration, location_name: "NetworkConfiguration"))
170
175
  Environment.add_member(:plugins_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "PluginsS3ObjectVersion"))
171
176
  Environment.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
172
177
  Environment.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
173
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"))
174
180
  Environment.add_member(:service_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "ServiceRoleArn"))
175
181
  Environment.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, location_name: "SourceBucketArn"))
176
182
  Environment.add_member(:status, Shapes::ShapeRef.new(shape: EnvironmentStatus, location_name: "Status"))
@@ -296,12 +302,14 @@ module Aws::MWAA
296
302
  UpdateEnvironmentInput.add_member(:execution_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "ExecutionRoleArn"))
297
303
  UpdateEnvironmentInput.add_member(:logging_configuration, Shapes::ShapeRef.new(shape: LoggingConfigurationInput, location_name: "LoggingConfiguration"))
298
304
  UpdateEnvironmentInput.add_member(:max_workers, Shapes::ShapeRef.new(shape: MaxWorkers, location_name: "MaxWorkers"))
305
+ UpdateEnvironmentInput.add_member(:min_workers, Shapes::ShapeRef.new(shape: MinWorkers, location_name: "MinWorkers"))
299
306
  UpdateEnvironmentInput.add_member(:name, Shapes::ShapeRef.new(shape: EnvironmentName, required: true, location: "uri", location_name: "Name"))
300
307
  UpdateEnvironmentInput.add_member(:network_configuration, Shapes::ShapeRef.new(shape: UpdateNetworkConfigurationInput, location_name: "NetworkConfiguration"))
301
308
  UpdateEnvironmentInput.add_member(:plugins_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "PluginsS3ObjectVersion"))
302
309
  UpdateEnvironmentInput.add_member(:plugins_s3_path, Shapes::ShapeRef.new(shape: RelativePath, location_name: "PluginsS3Path"))
303
310
  UpdateEnvironmentInput.add_member(:requirements_s3_object_version, Shapes::ShapeRef.new(shape: S3ObjectVersion, location_name: "RequirementsS3ObjectVersion"))
304
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"))
305
313
  UpdateEnvironmentInput.add_member(:source_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, location_name: "SourceBucketArn"))
306
314
  UpdateEnvironmentInput.add_member(:webserver_access_mode, Shapes::ShapeRef.new(shape: WebserverAccessMode, location_name: "WebserverAccessMode"))
307
315
  UpdateEnvironmentInput.add_member(:weekly_maintenance_window_start, Shapes::ShapeRef.new(shape: WeeklyMaintenanceWindowStart, location_name: "WeeklyMaintenanceWindowStart"))
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -107,6 +107,7 @@ module Aws::MWAA
107
107
  # },
108
108
  # },
109
109
  # max_workers: 1,
110
+ # min_workers: 1,
110
111
  # name: "EnvironmentName", # required
111
112
  # network_configuration: { # required
112
113
  # security_group_ids: ["SecurityGroupId"],
@@ -116,6 +117,7 @@ module Aws::MWAA
116
117
  # plugins_s3_path: "RelativePath",
117
118
  # requirements_s3_object_version: "S3ObjectVersion",
118
119
  # requirements_s3_path: "RelativePath",
120
+ # schedulers: 1,
119
121
  # source_bucket_arn: "S3BucketArn", # required
120
122
  # tags: {
121
123
  # "TagKey" => "TagValue",
@@ -125,9 +127,9 @@ module Aws::MWAA
125
127
  # }
126
128
  #
127
129
  # @!attribute [rw] airflow_configuration_options
128
- # The Apache Airflow configuration setting you want to override in
129
- # your environment. For more information, see [Environment
130
- # 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].
131
133
  #
132
134
  #
133
135
  #
@@ -135,23 +137,27 @@ module Aws::MWAA
135
137
  # @return [Hash<String,String>]
136
138
  #
137
139
  # @!attribute [rw] airflow_version
138
- # 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`.
139
143
  # @return [String]
140
144
  #
141
145
  # @!attribute [rw] dag_s3_path
142
- # The relative path to the DAG folder on your Amazon S3 storage
143
- # bucket. For example, `dags`. For more information, see [Importing
144
- # 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].
145
148
  #
146
149
  #
147
150
  #
148
- # [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
149
152
  # @return [String]
150
153
  #
151
154
  # @!attribute [rw] environment_class
152
- # The environment class you want to use for your environment. The
153
- # environment class determines the size of the containers and database
154
- # 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
155
161
  # @return [String]
156
162
  #
157
163
  # @!attribute [rw] execution_role_arn
@@ -159,94 +165,126 @@ module Aws::MWAA
159
165
  # environment. An execution role is an AWS Identity and Access
160
166
  # Management (IAM) role that grants MWAA permission to access AWS
161
167
  # services and resources used by your environment. For example,
162
- # `arn:aws:iam::123456789:role/my-execution-role`. For more
163
- # information, see [Managing access to Amazon Managed Workflows for
164
- # Apache Airflow][1].
168
+ # `arn:aws:iam::123456789:role/my-execution-role`. To learn more, see
169
+ # [Amazon MWAA Execution role][1].
165
170
  #
166
171
  #
167
172
  #
168
- # [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
169
174
  # @return [String]
170
175
  #
171
176
  # @!attribute [rw] kms_key
172
- # The AWS Key Management Service (KMS) key to encrypt and decrypt the
173
- # data in your environment. You can use an AWS KMS key managed by
174
- # MWAA, or a custom KMS key (advanced). For more information, see
175
- # [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].
176
181
  #
177
182
  #
178
183
  #
179
- # [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
180
185
  # @return [String]
181
186
  #
182
187
  # @!attribute [rw] logging_configuration
183
- # 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`.
184
191
  # @return [Types::LoggingConfigurationInput]
185
192
  #
186
193
  # @!attribute [rw] max_workers
187
194
  # The maximum number of workers that you want to run in your
188
- # environment. MWAA scales the number of Apache Airflow workers and
189
- # the Fargate containers that run your tasks up to the number you
190
- # specify in this field. When there are no more tasks running, and no
191
- # more in the queue, MWAA disposes of the extra containers leaving the
192
- # 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`.
201
+ # @return [Integer]
202
+ #
203
+ # @!attribute [rw] min_workers
204
+ # The minimum number of workers that you want to run in your
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`.
193
210
  # @return [Integer]
194
211
  #
195
212
  # @!attribute [rw] name
196
- # The name of your MWAA environment.
213
+ # The name of the Amazon MWAA environment. For example,
214
+ # `MyMWAAEnvironment`.
197
215
  # @return [String]
198
216
  #
199
217
  # @!attribute [rw] network_configuration
200
- # The VPC networking components you want to use for your environment.
201
- # At least two private subnet identifiers and one VPC security group
202
- # identifier are required to create an environment. For more
203
- # information, see [Creating the VPC network for a MWAA
204
- # 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].
205
221
  #
206
222
  #
207
223
  #
208
- # [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
209
225
  # @return [Types::NetworkConfiguration]
210
226
  #
211
227
  # @!attribute [rw] plugins_s3_object_version
212
- # 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
213
235
  # @return [String]
214
236
  #
215
237
  # @!attribute [rw] plugins_s3_path
216
238
  # The relative path to the `plugins.zip` file on your Amazon S3
217
- # storage bucket. For example, `plugins.zip`. If a relative path is
218
- # provided in the request, then `PluginsS3ObjectVersion` is required.
219
- # 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].
220
242
  #
221
243
  #
222
244
  #
223
- # [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
224
246
  # @return [String]
225
247
  #
226
248
  # @!attribute [rw] requirements_s3_object_version
227
- # 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
228
256
  # @return [String]
229
257
  #
230
258
  # @!attribute [rw] requirements_s3_path
231
259
  # The relative path to the `requirements.txt` file on your Amazon S3
232
- # storage bucket. For example, `requirements.txt`. If a relative path
233
- # is provided in the request, then `RequirementsS3ObjectVersion` is
234
- # required. For more information, see [Importing DAGs on Amazon
235
- # 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].
236
263
  #
237
264
  #
238
265
  #
239
- # [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
240
267
  # @return [String]
241
268
  #
269
+ # @!attribute [rw] schedulers
270
+ # The number of Apache Airflow schedulers to run in your environment.
271
+ # @return [Integer]
272
+ #
242
273
  # @!attribute [rw] source_bucket_arn
243
- # The Amazon Resource Name (ARN) of your Amazon S3 storage bucket. For
244
- # 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
245
282
  # @return [String]
246
283
  #
247
284
  # @!attribute [rw] tags
248
- # The metadata tags you want to attach to your environment. For more
249
- # 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].
250
288
  #
251
289
  #
252
290
  #
@@ -254,21 +292,23 @@ module Aws::MWAA
254
292
  # @return [Hash<String,String>]
255
293
  #
256
294
  # @!attribute [rw] webserver_access_mode
257
- # The networking access of your Apache Airflow web server. A public
258
- # network allows your Airflow UI to be accessed over the Internet by
259
- # users granted access in your IAM policy. A private network limits
260
- # access of your Airflow UI to users within your VPC. For more
261
- # information, see [Creating the VPC network for a MWAA
262
- # environment][1].
295
+ # The Apache Airflow *Web server* access mode. To learn more, see
296
+ # [Apache Airflow access modes][1].
263
297
  #
264
298
  #
265
299
  #
266
- # [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
267
301
  # @return [String]
268
302
  #
269
303
  # @!attribute [rw] weekly_maintenance_window_start
270
- # The day and time you want MWAA to start weekly maintenance updates
271
- # 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
+ # ^
272
312
  # @return [String]
273
313
  #
274
314
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/CreateEnvironmentInput AWS API Documentation
@@ -282,12 +322,14 @@ module Aws::MWAA
282
322
  :kms_key,
283
323
  :logging_configuration,
284
324
  :max_workers,
325
+ :min_workers,
285
326
  :name,
286
327
  :network_configuration,
287
328
  :plugins_s3_object_version,
288
329
  :plugins_s3_path,
289
330
  :requirements_s3_object_version,
290
331
  :requirements_s3_path,
332
+ :schedulers,
291
333
  :source_bucket_arn,
292
334
  :tags,
293
335
  :webserver_access_mode,
@@ -297,7 +339,8 @@ module Aws::MWAA
297
339
  end
298
340
 
299
341
  # @!attribute [rw] arn
300
- # The resulting Amazon MWAA envirnonment ARN.
342
+ # The Amazon Resource Name (ARN) returned in the response for the
343
+ # environment.
301
344
  # @return [String]
302
345
  #
303
346
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/CreateEnvironmentOutput AWS API Documentation
@@ -354,7 +397,8 @@ module Aws::MWAA
354
397
  # }
355
398
  #
356
399
  # @!attribute [rw] name
357
- # The name of the environment to delete.
400
+ # The name of the Amazon MWAA environment. For example,
401
+ # `MyMWAAEnvironment`.
358
402
  # @return [String]
359
403
  #
360
404
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/DeleteEnvironmentInput AWS API Documentation
@@ -396,105 +440,234 @@ module Aws::MWAA
396
440
  include Aws::Structure
397
441
  end
398
442
 
399
- # An Amazon MWAA environment.
443
+ # The Amazon Managed Workflows for Apache Airflow (MWAA) environment.
400
444
  #
401
445
  # @!attribute [rw] airflow_configuration_options
402
- # 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
403
453
  # @return [Hash<String,String>]
404
454
  #
405
455
  # @!attribute [rw] airflow_version
406
- # The AirflowV ersion of the Amazon MWAA Environment.
456
+ # The Apache Airflow version on your environment. For example,
457
+ # `v1.10.12`.
407
458
  # @return [String]
408
459
  #
409
460
  # @!attribute [rw] arn
410
- # The ARN of the Amazon MWAA Environment.
461
+ # The Amazon Resource Name (ARN) of the Amazon MWAA environment.
411
462
  # @return [String]
412
463
  #
413
464
  # @!attribute [rw] created_at
414
- # The Created At date of the Amazon MWAA Environment.
465
+ # The day and time the environment was created.
415
466
  # @return [Time]
416
467
  #
417
468
  # @!attribute [rw] dag_s3_path
418
- # 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
419
475
  # @return [String]
420
476
  #
421
477
  # @!attribute [rw] environment_class
422
- # 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
423
484
  # @return [String]
424
485
  #
425
486
  # @!attribute [rw] execution_role_arn
426
- # 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
427
495
  # @return [String]
428
496
  #
429
497
  # @!attribute [rw] kms_key
430
- # 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.
431
500
  # @return [String]
432
501
  #
433
502
  # @!attribute [rw] last_update
434
- # Last update information for the environment.
503
+ # The status of the last update on the environment, and any errors
504
+ # that were encountered.
435
505
  # @return [Types::LastUpdate]
436
506
  #
437
507
  # @!attribute [rw] logging_configuration
438
- # 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`.
439
511
  # @return [Types::LoggingConfiguration]
440
512
  #
441
513
  # @!attribute [rw] max_workers
442
- # The Maximum Workers of the Amazon MWAA Environment.
514
+ # The maximum number of workers that run in your environment. For
515
+ # example, `20`.
516
+ # @return [Integer]
517
+ #
518
+ # @!attribute [rw] min_workers
519
+ # The minimum number of workers that run in your environment. For
520
+ # example, `2`.
443
521
  # @return [Integer]
444
522
  #
445
523
  # @!attribute [rw] name
446
- # The name of the Amazon MWAA Environment.
524
+ # The name of the Amazon MWAA environment. For example,
525
+ # `MyMWAAEnvironment`.
447
526
  # @return [String]
448
527
  #
449
528
  # @!attribute [rw] network_configuration
450
- # Provide the security group and subnet IDs for the workers and
451
- # 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
452
536
  # @return [Types::NetworkConfiguration]
453
537
  #
454
538
  # @!attribute [rw] plugins_s3_object_version
455
- # 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
456
545
  # @return [String]
457
546
  #
458
547
  # @!attribute [rw] plugins_s3_path
459
- # 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
460
555
  # @return [String]
461
556
  #
462
557
  # @!attribute [rw] requirements_s3_object_version
463
- # The Requirements.txt file S3 Object Version of the Amazon MWAA
464
- # 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
465
564
  # @return [String]
466
565
  #
467
566
  # @!attribute [rw] requirements_s3_path
468
- # 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
469
574
  # @return [String]
470
575
  #
576
+ # @!attribute [rw] schedulers
577
+ # The number of Apache Airflow schedulers that run in your Amazon MWAA
578
+ # environment.
579
+ # @return [Integer]
580
+ #
471
581
  # @!attribute [rw] service_role_arn
472
- # 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
473
589
  # @return [String]
474
590
  #
475
591
  # @!attribute [rw] source_bucket_arn
476
- # 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
477
600
  # @return [String]
478
601
  #
479
602
  # @!attribute [rw] status
480
- # 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
481
637
  # @return [String]
482
638
  #
483
639
  # @!attribute [rw] tags
484
- # 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
485
647
  # @return [Hash<String,String>]
486
648
  #
487
649
  # @!attribute [rw] webserver_access_mode
488
- # The Webserver Access Mode of the Amazon MWAA Environment (public or
489
- # 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
490
656
  # @return [String]
491
657
  #
492
658
  # @!attribute [rw] webserver_url
493
- # 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
494
666
  # @return [String]
495
667
  #
496
668
  # @!attribute [rw] weekly_maintenance_window_start
497
- # 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`.
498
671
  # @return [String]
499
672
  #
500
673
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/Environment AWS API Documentation
@@ -511,12 +684,14 @@ module Aws::MWAA
511
684
  :last_update,
512
685
  :logging_configuration,
513
686
  :max_workers,
687
+ :min_workers,
514
688
  :name,
515
689
  :network_configuration,
516
690
  :plugins_s3_object_version,
517
691
  :plugins_s3_path,
518
692
  :requirements_s3_object_version,
519
693
  :requirements_s3_path,
694
+ :schedulers,
520
695
  :service_role_arn,
521
696
  :source_bucket_arn,
522
697
  :status,
@@ -536,7 +711,8 @@ module Aws::MWAA
536
711
  # }
537
712
  #
538
713
  # @!attribute [rw] name
539
- # The name of the environment to retrieve.
714
+ # The name of the Amazon MWAA environment. For example,
715
+ # `MyMWAAEnvironment`.
540
716
  # @return [String]
541
717
  #
542
718
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/GetEnvironmentInput AWS API Documentation
@@ -548,7 +724,7 @@ module Aws::MWAA
548
724
  end
549
725
 
550
726
  # @!attribute [rw] environment
551
- # A JSON blob with environment details.
727
+ # An object containing all available details about the environment.
552
728
  # @return [Types::Environment]
553
729
  #
554
730
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/GetEnvironmentOutput AWS API Documentation
@@ -572,18 +748,21 @@ module Aws::MWAA
572
748
  include Aws::Structure
573
749
  end
574
750
 
575
- # Last update information for the environment.
751
+ # The status of the last update on the environment, and any errors that
752
+ # were encountered.
576
753
  #
577
754
  # @!attribute [rw] created_at
578
- # Time that last update occurred.
755
+ # The day and time of the last update on the environment.
579
756
  # @return [Time]
580
757
  #
581
758
  # @!attribute [rw] error
582
- # Error string of last update, if applicable.
759
+ # The error that was encountered during the last update of the
760
+ # environment.
583
761
  # @return [Types::UpdateError]
584
762
  #
585
763
  # @!attribute [rw] status
586
- # 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`.
587
766
  # @return [String]
588
767
  #
589
768
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LastUpdate AWS API Documentation
@@ -605,11 +784,12 @@ module Aws::MWAA
605
784
  # }
606
785
  #
607
786
  # @!attribute [rw] max_results
608
- # The maximum results when listing MWAA environments.
787
+ # The maximum number of results to retrieve per page. For example, `5`
788
+ # environments per page.
609
789
  # @return [Integer]
610
790
  #
611
791
  # @!attribute [rw] next_token
612
- # The Next Token when listing MWAA environments.
792
+ # Retrieves the next page of the results.
613
793
  # @return [String]
614
794
  #
615
795
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListEnvironmentsInput AWS API Documentation
@@ -622,11 +802,11 @@ module Aws::MWAA
622
802
  end
623
803
 
624
804
  # @!attribute [rw] environments
625
- # The list of Amazon MWAA Environments.
805
+ # Returns the list of Amazon MWAA environments.
626
806
  # @return [Array<String>]
627
807
  #
628
808
  # @!attribute [rw] next_token
629
- # The Next Token when listing MWAA environments.
809
+ # Retrieves the next page of the results.
630
810
  # @return [String]
631
811
  #
632
812
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListEnvironmentsOutput AWS API Documentation
@@ -646,7 +826,9 @@ module Aws::MWAA
646
826
  # }
647
827
  #
648
828
  # @!attribute [rw] resource_arn
649
- # 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`.
650
832
  # @return [String]
651
833
  #
652
834
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListTagsForResourceInput AWS API Documentation
@@ -658,7 +840,12 @@ module Aws::MWAA
658
840
  end
659
841
 
660
842
  # @!attribute [rw] tags
661
- # 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
662
849
  # @return [Hash<String,String>]
663
850
  #
664
851
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ListTagsForResourceOutput AWS API Documentation
@@ -669,36 +856,38 @@ module Aws::MWAA
669
856
  include Aws::Structure
670
857
  end
671
858
 
672
- # 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`.
673
862
  #
674
863
  # @!attribute [rw] dag_processing_logs
675
- # A JSON blob that provides configuration to use for logging with
676
- # respect to the various Apache Airflow services: DagProcessingLogs,
677
- # 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`.
678
867
  # @return [Types::ModuleLoggingConfiguration]
679
868
  #
680
869
  # @!attribute [rw] scheduler_logs
681
- # A JSON blob that provides configuration to use for logging with
682
- # respect to the various Apache Airflow services: DagProcessingLogs,
683
- # 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`.
684
873
  # @return [Types::ModuleLoggingConfiguration]
685
874
  #
686
875
  # @!attribute [rw] task_logs
687
- # A JSON blob that provides configuration to use for logging with
688
- # respect to the various Apache Airflow services: DagProcessingLogs,
689
- # 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`.
690
879
  # @return [Types::ModuleLoggingConfiguration]
691
880
  #
692
881
  # @!attribute [rw] webserver_logs
693
- # A JSON blob that provides configuration to use for logging with
694
- # respect to the various Apache Airflow services: DagProcessingLogs,
695
- # 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`.
696
885
  # @return [Types::ModuleLoggingConfiguration]
697
886
  #
698
887
  # @!attribute [rw] worker_logs
699
- # A JSON blob that provides configuration to use for logging with
700
- # respect to the various Apache Airflow services: DagProcessingLogs,
701
- # 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`.
702
891
  # @return [Types::ModuleLoggingConfiguration]
703
892
  #
704
893
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LoggingConfiguration AWS API Documentation
@@ -713,7 +902,9 @@ module Aws::MWAA
713
902
  include Aws::Structure
714
903
  end
715
904
 
716
- # 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`.
717
908
  #
718
909
  # @note When making an API call, you may pass LoggingConfigurationInput
719
910
  # data as a hash:
@@ -742,33 +933,33 @@ module Aws::MWAA
742
933
  # }
743
934
  #
744
935
  # @!attribute [rw] dag_processing_logs
745
- # A JSON blob that provides configuration to use for logging with
746
- # respect to the various Apache Airflow services: DagProcessingLogs,
747
- # 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`.
748
939
  # @return [Types::ModuleLoggingConfigurationInput]
749
940
  #
750
941
  # @!attribute [rw] scheduler_logs
751
- # A JSON blob that provides configuration to use for logging with
752
- # respect to the various Apache Airflow services: DagProcessingLogs,
753
- # 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`.
754
945
  # @return [Types::ModuleLoggingConfigurationInput]
755
946
  #
756
947
  # @!attribute [rw] task_logs
757
- # A JSON blob that provides configuration to use for logging with
758
- # respect to the various Apache Airflow services: DagProcessingLogs,
759
- # 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`.
760
951
  # @return [Types::ModuleLoggingConfigurationInput]
761
952
  #
762
953
  # @!attribute [rw] webserver_logs
763
- # A JSON blob that provides configuration to use for logging with
764
- # respect to the various Apache Airflow services: DagProcessingLogs,
765
- # 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`.
766
957
  # @return [Types::ModuleLoggingConfigurationInput]
767
958
  #
768
959
  # @!attribute [rw] worker_logs
769
- # A JSON blob that provides configuration to use for logging with
770
- # respect to the various Apache Airflow services: DagProcessingLogs,
771
- # 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`.
772
963
  # @return [Types::ModuleLoggingConfigurationInput]
773
964
  #
774
965
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/LoggingConfigurationInput AWS API Documentation
@@ -844,22 +1035,26 @@ module Aws::MWAA
844
1035
  include Aws::Structure
845
1036
  end
846
1037
 
847
- # A JSON blob that provides configuration to use for logging with
848
- # respect to the various Apache Airflow services: DagProcessingLogs,
849
- # 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`.
850
1041
  #
851
1042
  # @!attribute [rw] cloud_watch_log_group_arn
852
- # Provides the ARN for the CloudWatch group where the logs will be
853
- # 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:*`.
854
1047
  # @return [String]
855
1048
  #
856
1049
  # @!attribute [rw] enabled
857
- # Defines that the logging module is enabled.
1050
+ # Indicates whether to enable the Apache Airflow log type (e.g.
1051
+ # `DagProcessingLogs`) in CloudWatch Logs.
858
1052
  # @return [Boolean]
859
1053
  #
860
1054
  # @!attribute [rw] log_level
861
- # Defines the log level, which can be CRITICAL, ERROR, WARNING, or
862
- # 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`.
863
1058
  # @return [String]
864
1059
  #
865
1060
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ModuleLoggingConfiguration AWS API Documentation
@@ -872,9 +1067,9 @@ module Aws::MWAA
872
1067
  include Aws::Structure
873
1068
  end
874
1069
 
875
- # A JSON blob that provides configuration to use for logging with
876
- # respect to the various Apache Airflow services: DagProcessingLogs,
877
- # 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`.
878
1073
  #
879
1074
  # @note When making an API call, you may pass ModuleLoggingConfigurationInput
880
1075
  # data as a hash:
@@ -885,12 +1080,14 @@ module Aws::MWAA
885
1080
  # }
886
1081
  #
887
1082
  # @!attribute [rw] enabled
888
- # Defines that the logging module is enabled.
1083
+ # Indicates whether to enable the Apache Airflow log type (e.g.
1084
+ # `DagProcessingLogs`) in CloudWatch Logs.
889
1085
  # @return [Boolean]
890
1086
  #
891
1087
  # @!attribute [rw] log_level
892
- # Defines the log level, which can be CRITICAL, ERROR, WARNING, or
893
- # 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`.
894
1091
  # @return [String]
895
1092
  #
896
1093
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/ModuleLoggingConfigurationInput AWS API Documentation
@@ -902,8 +1099,13 @@ module Aws::MWAA
902
1099
  include Aws::Structure
903
1100
  end
904
1101
 
905
- # Provide the security group and subnet IDs for the workers and
906
- # 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
907
1109
  #
908
1110
  # @note When making an API call, you may pass NetworkConfiguration
909
1111
  # data as a hash:
@@ -914,13 +1116,20 @@ module Aws::MWAA
914
1116
  # }
915
1117
  #
916
1118
  # @!attribute [rw] security_group_ids
917
- # A JSON list of 1 or more security groups IDs by name, in the same
918
- # 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
919
1127
  # @return [Array<String>]
920
1128
  #
921
1129
  # @!attribute [rw] subnet_ids
922
- # Provide a JSON list of 2 subnet IDs by name. These must be private
923
- # 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.
924
1133
  # @return [Array<String>]
925
1134
  #
926
1135
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/NetworkConfiguration AWS API Documentation
@@ -1044,11 +1253,19 @@ module Aws::MWAA
1044
1253
  # }
1045
1254
  #
1046
1255
  # @!attribute [rw] resource_arn
1047
- # 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`.
1048
1259
  # @return [String]
1049
1260
  #
1050
1261
  # @!attribute [rw] tags
1051
- # 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
1052
1269
  # @return [Hash<String,String>]
1053
1270
  #
1054
1271
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/TagResourceInput AWS API Documentation
@@ -1073,11 +1290,14 @@ module Aws::MWAA
1073
1290
  # }
1074
1291
  #
1075
1292
  # @!attribute [rw] resource_arn
1076
- # 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`.
1077
1296
  # @return [String]
1078
1297
  #
1079
1298
  # @!attribute [rw] tag_keys
1080
- # The tag resource key of the MWAA environments.
1299
+ # The key-value tag pair you want to remove. For example,
1300
+ # `"Environment": "Staging"`.
1081
1301
  # @return [Array<String>]
1082
1302
  #
1083
1303
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UntagResourceInput AWS API Documentation
@@ -1127,6 +1347,7 @@ module Aws::MWAA
1127
1347
  # },
1128
1348
  # },
1129
1349
  # max_workers: 1,
1350
+ # min_workers: 1,
1130
1351
  # name: "EnvironmentName", # required
1131
1352
  # network_configuration: {
1132
1353
  # security_group_ids: ["SecurityGroupId"], # required
@@ -1135,78 +1356,173 @@ module Aws::MWAA
1135
1356
  # plugins_s3_path: "RelativePath",
1136
1357
  # requirements_s3_object_version: "S3ObjectVersion",
1137
1358
  # requirements_s3_path: "RelativePath",
1359
+ # schedulers: 1,
1138
1360
  # source_bucket_arn: "S3BucketArn",
1139
1361
  # webserver_access_mode: "PRIVATE_ONLY", # accepts PRIVATE_ONLY, PUBLIC_ONLY
1140
1362
  # weekly_maintenance_window_start: "WeeklyMaintenanceWindowStart",
1141
1363
  # }
1142
1364
  #
1143
1365
  # @!attribute [rw] airflow_configuration_options
1144
- # The Airflow Configuration Options to update of your Amazon MWAA
1145
- # 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
1146
1373
  # @return [Hash<String,String>]
1147
1374
  #
1148
1375
  # @!attribute [rw] airflow_version
1149
- # 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`.
1150
1379
  # @return [String]
1151
1380
  #
1152
1381
  # @!attribute [rw] dag_s3_path
1153
- # 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
1154
1388
  # @return [String]
1155
1389
  #
1156
1390
  # @!attribute [rw] environment_class
1157
- # 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
1158
1397
  # @return [String]
1159
1398
  #
1160
1399
  # @!attribute [rw] execution_role_arn
1161
- # 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
1162
1408
  # @return [String]
1163
1409
  #
1164
1410
  # @!attribute [rw] logging_configuration
1165
- # 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`.
1166
1414
  # @return [Types::LoggingConfigurationInput]
1167
1415
  #
1168
1416
  # @!attribute [rw] max_workers
1169
- # The Maximum Workers to update of your Amazon MWAA 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`.
1424
+ # @return [Integer]
1425
+ #
1426
+ # @!attribute [rw] min_workers
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`.
1170
1433
  # @return [Integer]
1171
1434
  #
1172
1435
  # @!attribute [rw] name
1173
- # The name of your Amazon MWAA environment that you wish to update.
1436
+ # The name of your Amazon MWAA environment. For example,
1437
+ # `MyMWAAEnvironment`.
1174
1438
  # @return [String]
1175
1439
  #
1176
1440
  # @!attribute [rw] network_configuration
1177
- # 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
1178
1448
  # @return [Types::UpdateNetworkConfigurationInput]
1179
1449
  #
1180
1450
  # @!attribute [rw] plugins_s3_object_version
1181
- # The Plugins.zip S3 Object Version to update of your Amazon MWAA
1182
- # 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
1183
1458
  # @return [String]
1184
1459
  #
1185
1460
  # @!attribute [rw] plugins_s3_path
1186
- # 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
1187
1469
  # @return [String]
1188
1470
  #
1189
1471
  # @!attribute [rw] requirements_s3_object_version
1190
- # The Requirements.txt S3 ObjectV ersion to update of your Amazon MWAA
1191
- # 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
1192
1479
  # @return [String]
1193
1480
  #
1194
1481
  # @!attribute [rw] requirements_s3_path
1195
- # The Requirements.txt S3 Path to update of your Amazon MWAA
1196
- # 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
1197
1490
  # @return [String]
1198
1491
  #
1492
+ # @!attribute [rw] schedulers
1493
+ # The number of Apache Airflow schedulers to run in your Amazon MWAA
1494
+ # environment.
1495
+ # @return [Integer]
1496
+ #
1199
1497
  # @!attribute [rw] source_bucket_arn
1200
- # 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
1201
1506
  # @return [String]
1202
1507
  #
1203
1508
  # @!attribute [rw] webserver_access_mode
1204
- # 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
1205
1515
  # @return [String]
1206
1516
  #
1207
1517
  # @!attribute [rw] weekly_maintenance_window_start
1208
- # The Weekly Maintenance Window Start to update of your Amazon MWAA
1209
- # 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
+ # ^
1210
1526
  # @return [String]
1211
1527
  #
1212
1528
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateEnvironmentInput AWS API Documentation
@@ -1219,12 +1535,14 @@ module Aws::MWAA
1219
1535
  :execution_role_arn,
1220
1536
  :logging_configuration,
1221
1537
  :max_workers,
1538
+ :min_workers,
1222
1539
  :name,
1223
1540
  :network_configuration,
1224
1541
  :plugins_s3_object_version,
1225
1542
  :plugins_s3_path,
1226
1543
  :requirements_s3_object_version,
1227
1544
  :requirements_s3_path,
1545
+ :schedulers,
1228
1546
  :source_bucket_arn,
1229
1547
  :webserver_access_mode,
1230
1548
  :weekly_maintenance_window_start)
@@ -1233,7 +1551,9 @@ module Aws::MWAA
1233
1551
  end
1234
1552
 
1235
1553
  # @!attribute [rw] arn
1236
- # 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`.
1237
1557
  # @return [String]
1238
1558
  #
1239
1559
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateEnvironmentOutput AWS API Documentation
@@ -1244,14 +1564,15 @@ module Aws::MWAA
1244
1564
  include Aws::Structure
1245
1565
  end
1246
1566
 
1247
- # Error information of update, if applicable.
1567
+ # An object containing the error encountered with the last update:
1568
+ # `ErrorCode`, `ErrorMessage`.
1248
1569
  #
1249
1570
  # @!attribute [rw] error_code
1250
- # Error code of update.
1571
+ # The error code that corresponds to the error with the last update.
1251
1572
  # @return [String]
1252
1573
  #
1253
1574
  # @!attribute [rw] error_message
1254
- # Error message of update.
1575
+ # The error message that corresponds to the error code.
1255
1576
  # @return [String]
1256
1577
  #
1257
1578
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateError AWS API Documentation
@@ -1263,8 +1584,13 @@ module Aws::MWAA
1263
1584
  include Aws::Structure
1264
1585
  end
1265
1586
 
1266
- # Provide the security group and subnet IDs for the workers and
1267
- # 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
1268
1594
  #
1269
1595
  # @note When making an API call, you may pass UpdateNetworkConfigurationInput
1270
1596
  # data as a hash:
@@ -1274,8 +1600,14 @@ module Aws::MWAA
1274
1600
  # }
1275
1601
  #
1276
1602
  # @!attribute [rw] security_group_ids
1277
- # Provide a JSON list of 1 or more security groups IDs by name, in the
1278
- # 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
1279
1611
  # @return [Array<String>]
1280
1612
  #
1281
1613
  # @see http://docs.aws.amazon.com/goto/WebAPI/mwaa-2020-07-01/UpdateNetworkConfigurationInput AWS API Documentation