@aws-sdk/client-mwaa 3.816.0 → 3.820.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist-cjs/index.js CHANGED
@@ -57,6 +57,7 @@ __export(index_exports, {
57
57
  UpdateStatus: () => UpdateStatus,
58
58
  ValidationException: () => ValidationException,
59
59
  WebserverAccessMode: () => WebserverAccessMode,
60
+ WorkerReplacementStrategy: () => WorkerReplacementStrategy,
60
61
  __Client: () => import_smithy_client.Client,
61
62
  paginateListEnvironments: () => paginateListEnvironments
62
63
  });
@@ -324,6 +325,10 @@ var UpdateStatus = {
324
325
  PENDING: "PENDING",
325
326
  SUCCESS: "SUCCESS"
326
327
  };
328
+ var WorkerReplacementStrategy = {
329
+ FORCED: "FORCED",
330
+ GRACEFUL: "GRACEFUL"
331
+ };
327
332
  var EnvironmentStatus = {
328
333
  AVAILABLE: "AVAILABLE",
329
334
  CREATE_FAILED: "CREATE_FAILED",
@@ -751,7 +756,8 @@ var se_UpdateEnvironmentCommand = /* @__PURE__ */ __name(async (input, context)
751
756
  StartupScriptS3ObjectVersion: [],
752
757
  StartupScriptS3Path: [],
753
758
  WebserverAccessMode: [],
754
- WeeklyMaintenanceWindowStart: []
759
+ WeeklyMaintenanceWindowStart: [],
760
+ WorkerReplacementStrategy: []
755
761
  })
756
762
  );
757
763
  let { hostname: resolvedHostname } = await context.endpoint();
@@ -1110,7 +1116,8 @@ var de_LastUpdate = /* @__PURE__ */ __name((output, context) => {
1110
1116
  CreatedAt: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "CreatedAt"),
1111
1117
  Error: import_smithy_client._json,
1112
1118
  Source: import_smithy_client.expectString,
1113
- Status: import_smithy_client.expectString
1119
+ Status: import_smithy_client.expectString,
1120
+ WorkerReplacementStrategy: import_smithy_client.expectString
1114
1121
  });
1115
1122
  }, "de_LastUpdate");
1116
1123
  var de_RestApiResponse = /* @__PURE__ */ __name((output, context) => {
@@ -1357,6 +1364,7 @@ var paginateListEnvironments = (0, import_core.createPaginator)(MWAAClient, List
1357
1364
  InternalServerException,
1358
1365
  ValidationException,
1359
1366
  UpdateStatus,
1367
+ WorkerReplacementStrategy,
1360
1368
  EnvironmentStatus,
1361
1369
  RestApiMethod,
1362
1370
  RestApiClientException,
@@ -23,7 +23,10 @@ const getRuntimeConfig = (config) => {
23
23
  const defaultConfigProvider = () => defaultsMode().then(smithy_client_1.loadConfigsForDefaultMode);
24
24
  const clientSharedValues = (0, runtimeConfig_shared_1.getRuntimeConfig)(config);
25
25
  (0, core_1.emitWarningIfUnsupportedVersion)(process.version);
26
- const loaderConfig = { profile: config?.profile, logger: clientSharedValues.logger };
26
+ const loaderConfig = {
27
+ profile: config?.profile,
28
+ logger: clientSharedValues.logger,
29
+ };
27
30
  return {
28
31
  ...clientSharedValues,
29
32
  ...config,
@@ -70,6 +70,10 @@ export const UpdateStatus = {
70
70
  PENDING: "PENDING",
71
71
  SUCCESS: "SUCCESS",
72
72
  };
73
+ export const WorkerReplacementStrategy = {
74
+ FORCED: "FORCED",
75
+ GRACEFUL: "GRACEFUL",
76
+ };
73
77
  export const EnvironmentStatus = {
74
78
  AVAILABLE: "AVAILABLE",
75
79
  CREATE_FAILED: "CREATE_FAILED",
@@ -273,6 +273,7 @@ export const se_UpdateEnvironmentCommand = async (input, context) => {
273
273
  StartupScriptS3Path: [],
274
274
  WebserverAccessMode: [],
275
275
  WeeklyMaintenanceWindowStart: [],
276
+ WorkerReplacementStrategy: [],
276
277
  }));
277
278
  let { hostname: resolvedHostname } = await context.endpoint();
278
279
  if (context.disableHostPrefix !== true) {
@@ -633,6 +634,7 @@ const de_LastUpdate = (output, context) => {
633
634
  Error: _json,
634
635
  Source: __expectString,
635
636
  Status: __expectString,
637
+ WorkerReplacementStrategy: __expectString,
636
638
  });
637
639
  };
638
640
  const de_RestApiResponse = (output, context) => {
@@ -19,7 +19,10 @@ export const getRuntimeConfig = (config) => {
19
19
  const defaultConfigProvider = () => defaultsMode().then(loadConfigsForDefaultMode);
20
20
  const clientSharedValues = getSharedRuntimeConfig(config);
21
21
  awsCheckVersion(process.version);
22
- const loaderConfig = { profile: config?.profile, logger: clientSharedValues.logger };
22
+ const loaderConfig = {
23
+ profile: config?.profile,
24
+ logger: clientSharedValues.logger,
25
+ };
23
26
  return {
24
27
  ...clientSharedValues,
25
28
  ...config,
@@ -106,6 +106,7 @@ declare const GetEnvironmentCommand_base: {
106
106
  * // ErrorMessage: "STRING_VALUE",
107
107
  * // },
108
108
  * // Source: "STRING_VALUE",
109
+ * // WorkerReplacementStrategy: "STRING_VALUE",
109
110
  * // },
110
111
  * // WeeklyMaintenanceWindowStart: "STRING_VALUE",
111
112
  * // Tags: { // TagMap
@@ -37,25 +37,12 @@ declare const UpdateEnvironmentCommand_base: {
37
37
  * const input = { // UpdateEnvironmentInput
38
38
  * Name: "STRING_VALUE", // required
39
39
  * ExecutionRoleArn: "STRING_VALUE",
40
- * AirflowVersion: "STRING_VALUE",
41
- * SourceBucketArn: "STRING_VALUE",
42
- * DagS3Path: "STRING_VALUE",
43
- * PluginsS3Path: "STRING_VALUE",
44
- * PluginsS3ObjectVersion: "STRING_VALUE",
45
- * RequirementsS3Path: "STRING_VALUE",
46
- * RequirementsS3ObjectVersion: "STRING_VALUE",
47
- * StartupScriptS3Path: "STRING_VALUE",
48
- * StartupScriptS3ObjectVersion: "STRING_VALUE",
49
40
  * AirflowConfigurationOptions: { // AirflowConfigurationOptions
50
41
  * "<keys>": "STRING_VALUE",
51
42
  * },
43
+ * AirflowVersion: "STRING_VALUE",
44
+ * DagS3Path: "STRING_VALUE",
52
45
  * EnvironmentClass: "STRING_VALUE",
53
- * MaxWorkers: Number("int"),
54
- * NetworkConfiguration: { // UpdateNetworkConfigurationInput
55
- * SecurityGroupIds: [ // SecurityGroupList // required
56
- * "STRING_VALUE",
57
- * ],
58
- * },
59
46
  * LoggingConfiguration: { // LoggingConfigurationInput
60
47
  * DagProcessingLogs: { // ModuleLoggingConfigurationInput
61
48
  * Enabled: true || false, // required
@@ -78,12 +65,26 @@ declare const UpdateEnvironmentCommand_base: {
78
65
  * LogLevel: "STRING_VALUE", // required
79
66
  * },
80
67
  * },
81
- * WeeklyMaintenanceWindowStart: "STRING_VALUE",
82
- * WebserverAccessMode: "STRING_VALUE",
68
+ * MaxWorkers: Number("int"),
83
69
  * MinWorkers: Number("int"),
84
- * Schedulers: Number("int"),
85
- * MinWebservers: Number("int"),
86
70
  * MaxWebservers: Number("int"),
71
+ * MinWebservers: Number("int"),
72
+ * WorkerReplacementStrategy: "STRING_VALUE",
73
+ * NetworkConfiguration: { // UpdateNetworkConfigurationInput
74
+ * SecurityGroupIds: [ // SecurityGroupList // required
75
+ * "STRING_VALUE",
76
+ * ],
77
+ * },
78
+ * PluginsS3Path: "STRING_VALUE",
79
+ * PluginsS3ObjectVersion: "STRING_VALUE",
80
+ * RequirementsS3Path: "STRING_VALUE",
81
+ * RequirementsS3ObjectVersion: "STRING_VALUE",
82
+ * Schedulers: Number("int"),
83
+ * SourceBucketArn: "STRING_VALUE",
84
+ * StartupScriptS3Path: "STRING_VALUE",
85
+ * StartupScriptS3ObjectVersion: "STRING_VALUE",
86
+ * WebserverAccessMode: "STRING_VALUE",
87
+ * WeeklyMaintenanceWindowStart: "STRING_VALUE",
87
88
  * };
88
89
  * const command = new UpdateEnvironmentCommand(input);
89
90
  * const response = await client.send(command);
@@ -459,6 +459,18 @@ export declare const UpdateStatus: {
459
459
  * @public
460
460
  */
461
461
  export type UpdateStatus = (typeof UpdateStatus)[keyof typeof UpdateStatus];
462
+ /**
463
+ * @public
464
+ * @enum
465
+ */
466
+ export declare const WorkerReplacementStrategy: {
467
+ readonly FORCED: "FORCED";
468
+ readonly GRACEFUL: "GRACEFUL";
469
+ };
470
+ /**
471
+ * @public
472
+ */
473
+ export type WorkerReplacementStrategy = (typeof WorkerReplacementStrategy)[keyof typeof WorkerReplacementStrategy];
462
474
  /**
463
475
  * <p>Describes the status of the last update on the environment, and any errors that were encountered.</p>
464
476
  * @public
@@ -484,6 +496,11 @@ export interface LastUpdate {
484
496
  * @public
485
497
  */
486
498
  Source?: string | undefined;
499
+ /**
500
+ * <p>The worker replacement strategy used in the last update of the environment.</p>
501
+ * @public
502
+ */
503
+ WorkerReplacementStrategy?: WorkerReplacementStrategy | undefined;
487
504
  }
488
505
  /**
489
506
  * <p>Describes the Apache Airflow log details for the log type (e.g. <code>DagProcessingLogs</code>).</p>
@@ -1250,6 +1267,11 @@ export interface UpdateEnvironmentInput {
1250
1267
  * @public
1251
1268
  */
1252
1269
  ExecutionRoleArn?: string | undefined;
1270
+ /**
1271
+ * <p>A list of key-value pairs containing the Apache Airflow configuration options you want to attach to your environment. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-env-variables.html">Apache Airflow configuration options</a>.</p>
1272
+ * @public
1273
+ */
1274
+ AirflowConfigurationOptions?: Record<string, string> | undefined;
1253
1275
  /**
1254
1276
  * <p>The Apache Airflow version for your environment. To upgrade your environment, specify a newer version of Apache Airflow supported by Amazon MWAA.</p>
1255
1277
  * <p>Before you upgrade an environment, make sure your requirements, DAGs, plugins, and other resources used in your workflows are compatible with the new Apache Airflow version. For more information about updating
@@ -1260,140 +1282,153 @@ export interface UpdateEnvironmentInput {
1260
1282
  * @public
1261
1283
  */
1262
1284
  AirflowVersion?: string | undefined;
1263
- /**
1264
- * <p>The Amazon Resource Name (ARN) of the Amazon S3 bucket where your DAG code and supporting files are stored. For example, <code>arn:aws:s3:::my-airflow-bucket-unique-name</code>. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-s3-bucket.html">Create an Amazon S3 bucket for Amazon MWAA</a>.</p>
1265
- * @public
1266
- */
1267
- SourceBucketArn?: string | undefined;
1268
1285
  /**
1269
1286
  * <p>The relative path to the DAGs folder on your Amazon S3 bucket. For example, <code>dags</code>. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-folder.html">Adding or updating DAGs</a>.</p>
1270
1287
  * @public
1271
1288
  */
1272
1289
  DagS3Path?: string | undefined;
1273
1290
  /**
1274
- * <p>The relative path to the <code>plugins.zip</code> file on your Amazon S3 bucket. For example, <code>plugins.zip</code>. If specified, then the plugins.zip version is required. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html">Installing custom plugins</a>.</p>
1291
+ * <p>The environment class type. Valid values: <code>mw1.micro</code>,
1292
+ * <code>mw1.small</code>, <code>mw1.medium</code>, <code>mw1.large</code>,
1293
+ * <code>mw1.xlarge</code>, and <code>mw1.2xlarge</code>. For more information, see
1294
+ * <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/environment-class.html">Amazon MWAA environment class</a>. </p>
1275
1295
  * @public
1276
1296
  */
1277
- PluginsS3Path?: string | undefined;
1297
+ EnvironmentClass?: string | undefined;
1278
1298
  /**
1279
- * <p>The version of the plugins.zip file on your Amazon S3 bucket. You must specify a version each time a <code>plugins.zip</code> file is updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">How S3 Versioning works</a>.</p>
1299
+ * <p>The Apache Airflow log types to send to CloudWatch Logs.</p>
1280
1300
  * @public
1281
1301
  */
1282
- PluginsS3ObjectVersion?: string | undefined;
1302
+ LoggingConfiguration?: LoggingConfigurationInput | undefined;
1283
1303
  /**
1284
- * <p>The relative path to the <code>requirements.txt</code> file on your Amazon S3 bucket. For example, <code>requirements.txt</code>. If specified, then a file version is required. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html">Installing Python dependencies</a>.</p>
1304
+ * <p>The maximum number of workers that you want to run in your environment. MWAA scales the number of Apache Airflow workers up to the number you specify in the <code>MaxWorkers</code> field. For example, <code>20</code>. When there are no more tasks running, and no more in the queue, MWAA disposes of the extra workers leaving the one worker that is included with your environment, or the number you specify in <code>MinWorkers</code>.</p>
1285
1305
  * @public
1286
1306
  */
1287
- RequirementsS3Path?: string | undefined;
1307
+ MaxWorkers?: number | undefined;
1288
1308
  /**
1289
- * <p>The version of the requirements.txt file on your Amazon S3 bucket. You must specify a version each time a <code>requirements.txt</code> file is updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">How S3 Versioning works</a>.</p>
1309
+ * <p>The minimum number of workers that you want to run in your environment. MWAA scales the number of Apache Airflow workers up to the number you specify in the <code>MaxWorkers</code> field. When there are no more tasks running, and no more in the queue, MWAA disposes of the extra workers leaving the worker count you specify in the <code>MinWorkers</code> field. For example, <code>2</code>.</p>
1290
1310
  * @public
1291
1311
  */
1292
- RequirementsS3ObjectVersion?: string | undefined;
1312
+ MinWorkers?: number | undefined;
1293
1313
  /**
1294
- * <p>The relative path to the startup shell script in your Amazon S3 bucket. For example, <code>s3://mwaa-environment/startup.sh</code>.</p>
1295
- * <p>
1296
- * Amazon MWAA runs the script as your environment starts, and before running the Apache Airflow process.
1297
- * You can use this script to install dependencies, modify Apache Airflow configuration options, and set environment variables. For more information, see
1298
- * <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/using-startup-script.html">Using a startup script</a>.
1314
+ * <p>
1315
+ * The maximum number of web servers that you want to run in your environment.
1316
+ * Amazon MWAA scales the number of Apache Airflow web servers up to the number you specify for <code>MaxWebservers</code>
1317
+ * when you interact with your Apache Airflow environment using Apache Airflow REST API, or
1318
+ * the Apache Airflow CLI. For example, in scenarios where your workload requires network calls to the Apache Airflow REST API with a high transaction-per-second (TPS)
1319
+ * rate, Amazon MWAA will increase the number of web servers up to the number set in <code>MaxWebserers</code>. As TPS rates decrease
1320
+ * Amazon MWAA disposes of the additional web servers, and scales down to the number set in <code>MinxWebserers</code>.
1299
1321
  * </p>
1322
+ * <p>Valid values: For environments larger than mw1.micro, accepts values from
1323
+ * <code>2</code> to <code>5</code>. Defaults to <code>2</code> for all environment
1324
+ * sizes except mw1.micro, which defaults to <code>1</code>.</p>
1300
1325
  * @public
1301
1326
  */
1302
- StartupScriptS3Path?: string | undefined;
1327
+ MaxWebservers?: number | undefined;
1303
1328
  /**
1304
1329
  * <p>
1305
- * The version of the startup shell script in your Amazon S3 bucket. You must specify the <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">version ID</a> that Amazon S3 assigns to the file
1306
- * every time you update the script.
1307
- * </p>
1308
- * <p>
1309
- * Version IDs are Unicode, UTF-8 encoded, URL-ready, opaque strings that are no more than 1,024 bytes long. The following is an example:
1310
- * </p>
1311
- * <p>
1312
- * <code>3sL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo</code>
1313
- * </p>
1314
- * <p>
1315
- * For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/using-startup-script.html">Using a startup script</a>.
1330
+ * The minimum number of web servers that you want to run in your environment.
1331
+ * Amazon MWAA scales the number of Apache Airflow web servers up to the number you specify for <code>MaxWebservers</code>
1332
+ * when you interact with your Apache Airflow environment using Apache Airflow REST API, or
1333
+ * the Apache Airflow CLI. As the transaction-per-second rate, and the network load, decrease,
1334
+ * Amazon MWAA disposes of the additional web servers, and scales down to the number set in <code>MinxWebserers</code>.
1316
1335
  * </p>
1336
+ * <p>Valid values: For environments larger than mw1.micro, accepts values from
1337
+ * <code>2</code> to <code>5</code>. Defaults to <code>2</code> for all environment
1338
+ * sizes except mw1.micro, which defaults to <code>1</code>.</p>
1317
1339
  * @public
1318
1340
  */
1319
- StartupScriptS3ObjectVersion?: string | undefined;
1341
+ MinWebservers?: number | undefined;
1320
1342
  /**
1321
- * <p>A list of key-value pairs containing the Apache Airflow configuration options you want to attach to your environment. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-env-variables.html">Apache Airflow configuration options</a>.</p>
1343
+ * <p>The worker replacement strategy to use when updating the environment.</p>
1344
+ * <p>You can select one of the following strategies:</p>
1345
+ * <ul>
1346
+ * <li>
1347
+ * <p>
1348
+ * <b>Forced -</b> Stops and replaces Apache Airflow workers without waiting for tasks to
1349
+ * complete before an update.</p>
1350
+ * </li>
1351
+ * <li>
1352
+ * <p>
1353
+ * <b>Graceful -</b> Allows Apache Airflow workers to complete running tasks for up to 12 hours during an update before
1354
+ * they're stopped and replaced.</p>
1355
+ * </li>
1356
+ * </ul>
1322
1357
  * @public
1323
1358
  */
1324
- AirflowConfigurationOptions?: Record<string, string> | undefined;
1359
+ WorkerReplacementStrategy?: WorkerReplacementStrategy | undefined;
1325
1360
  /**
1326
- * <p>The environment class type. Valid values: <code>mw1.micro</code>,
1327
- * <code>mw1.small</code>, <code>mw1.medium</code>, <code>mw1.large</code>,
1328
- * <code>mw1.xlarge</code>, and <code>mw1.2xlarge</code>. For more information, see
1329
- * <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/environment-class.html">Amazon MWAA environment class</a>. </p>
1361
+ * <p>The VPC networking components used to secure and enable network traffic between the Amazon Web Services resources for your environment. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html">About networking on Amazon MWAA</a>.</p>
1330
1362
  * @public
1331
1363
  */
1332
- EnvironmentClass?: string | undefined;
1364
+ NetworkConfiguration?: UpdateNetworkConfigurationInput | undefined;
1333
1365
  /**
1334
- * <p>The maximum number of workers that you want to run in your environment. MWAA scales the number of Apache Airflow workers up to the number you specify in the <code>MaxWorkers</code> field. For example, <code>20</code>. When there are no more tasks running, and no more in the queue, MWAA disposes of the extra workers leaving the one worker that is included with your environment, or the number you specify in <code>MinWorkers</code>.</p>
1366
+ * <p>The relative path to the <code>plugins.zip</code> file on your Amazon S3 bucket. For example, <code>plugins.zip</code>. If specified, then the plugins.zip version is required. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-dag-import-plugins.html">Installing custom plugins</a>.</p>
1335
1367
  * @public
1336
1368
  */
1337
- MaxWorkers?: number | undefined;
1369
+ PluginsS3Path?: string | undefined;
1338
1370
  /**
1339
- * <p>The VPC networking components used to secure and enable network traffic between the Amazon Web Services resources for your environment. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/networking-about.html">About networking on Amazon MWAA</a>.</p>
1371
+ * <p>The version of the plugins.zip file on your Amazon S3 bucket. You must specify a version each time a <code>plugins.zip</code> file is updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">How S3 Versioning works</a>.</p>
1340
1372
  * @public
1341
1373
  */
1342
- NetworkConfiguration?: UpdateNetworkConfigurationInput | undefined;
1374
+ PluginsS3ObjectVersion?: string | undefined;
1343
1375
  /**
1344
- * <p>The Apache Airflow log types to send to CloudWatch Logs.</p>
1376
+ * <p>The relative path to the <code>requirements.txt</code> file on your Amazon S3 bucket. For example, <code>requirements.txt</code>. If specified, then a file version is required. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html">Installing Python dependencies</a>.</p>
1345
1377
  * @public
1346
1378
  */
1347
- LoggingConfiguration?: LoggingConfigurationInput | undefined;
1379
+ RequirementsS3Path?: string | undefined;
1348
1380
  /**
1349
- * <p>The day and time of the week in Coordinated Universal Time (UTC) 24-hour standard time to start weekly maintenance updates of your environment in the following format: <code>DAY:HH:MM</code>. For example: <code>TUE:03:30</code>. You can specify a start time in 30 minute increments only.</p>
1381
+ * <p>The version of the requirements.txt file on your Amazon S3 bucket. You must specify a version each time a <code>requirements.txt</code> file is updated. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">How S3 Versioning works</a>.</p>
1350
1382
  * @public
1351
1383
  */
1352
- WeeklyMaintenanceWindowStart?: string | undefined;
1384
+ RequirementsS3ObjectVersion?: string | undefined;
1353
1385
  /**
1354
- * <p>The Apache Airflow <i>Web server</i> access mode. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-networking.html">Apache Airflow access modes</a>.</p>
1386
+ * <p>The number of Apache Airflow schedulers to run in your Amazon MWAA environment.</p>
1355
1387
  * @public
1356
1388
  */
1357
- WebserverAccessMode?: WebserverAccessMode | undefined;
1389
+ Schedulers?: number | undefined;
1358
1390
  /**
1359
- * <p>The minimum number of workers that you want to run in your environment. MWAA scales the number of Apache Airflow workers up to the number you specify in the <code>MaxWorkers</code> field. When there are no more tasks running, and no more in the queue, MWAA disposes of the extra workers leaving the worker count you specify in the <code>MinWorkers</code> field. For example, <code>2</code>.</p>
1391
+ * <p>The Amazon Resource Name (ARN) of the Amazon S3 bucket where your DAG code and supporting files are stored. For example, <code>arn:aws:s3:::my-airflow-bucket-unique-name</code>. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/mwaa-s3-bucket.html">Create an Amazon S3 bucket for Amazon MWAA</a>.</p>
1360
1392
  * @public
1361
1393
  */
1362
- MinWorkers?: number | undefined;
1394
+ SourceBucketArn?: string | undefined;
1363
1395
  /**
1364
- * <p>The number of Apache Airflow schedulers to run in your Amazon MWAA environment.</p>
1396
+ * <p>The relative path to the startup shell script in your Amazon S3 bucket. For example, <code>s3://mwaa-environment/startup.sh</code>.</p>
1397
+ * <p>
1398
+ * Amazon MWAA runs the script as your environment starts, and before running the Apache Airflow process.
1399
+ * You can use this script to install dependencies, modify Apache Airflow configuration options, and set environment variables. For more information, see
1400
+ * <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/using-startup-script.html">Using a startup script</a>.
1401
+ * </p>
1365
1402
  * @public
1366
1403
  */
1367
- Schedulers?: number | undefined;
1404
+ StartupScriptS3Path?: string | undefined;
1368
1405
  /**
1369
1406
  * <p>
1370
- * The minimum number of web servers that you want to run in your environment.
1371
- * Amazon MWAA scales the number of Apache Airflow web servers up to the number you specify for <code>MaxWebservers</code>
1372
- * when you interact with your Apache Airflow environment using Apache Airflow REST API, or
1373
- * the Apache Airflow CLI. As the transaction-per-second rate, and the network load, decrease,
1374
- * Amazon MWAA disposes of the additional web servers, and scales down to the number set in <code>MinxWebserers</code>.
1407
+ * The version of the startup shell script in your Amazon S3 bucket. You must specify the <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/versioning-workflows.html">version ID</a> that Amazon S3 assigns to the file
1408
+ * every time you update the script.
1409
+ * </p>
1410
+ * <p>
1411
+ * Version IDs are Unicode, UTF-8 encoded, URL-ready, opaque strings that are no more than 1,024 bytes long. The following is an example:
1412
+ * </p>
1413
+ * <p>
1414
+ * <code>3sL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo</code>
1415
+ * </p>
1416
+ * <p>
1417
+ * For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/using-startup-script.html">Using a startup script</a>.
1375
1418
  * </p>
1376
- * <p>Valid values: For environments larger than mw1.micro, accepts values from
1377
- * <code>2</code> to <code>5</code>. Defaults to <code>2</code> for all environment
1378
- * sizes except mw1.micro, which defaults to <code>1</code>.</p>
1379
1419
  * @public
1380
1420
  */
1381
- MinWebservers?: number | undefined;
1421
+ StartupScriptS3ObjectVersion?: string | undefined;
1382
1422
  /**
1383
- * <p>
1384
- * The maximum number of web servers that you want to run in your environment.
1385
- * Amazon MWAA scales the number of Apache Airflow web servers up to the number you specify for <code>MaxWebservers</code>
1386
- * when you interact with your Apache Airflow environment using Apache Airflow REST API, or
1387
- * the Apache Airflow CLI. For example, in scenarios where your workload requires network calls to the Apache Airflow REST API with a high transaction-per-second (TPS)
1388
- * rate, Amazon MWAA will increase the number of web servers up to the number set in <code>MaxWebserers</code>. As TPS rates decrease
1389
- * Amazon MWAA disposes of the additional web servers, and scales down to the number set in <code>MinxWebserers</code>.
1390
- * </p>
1391
- * <p>Valid values: For environments larger than mw1.micro, accepts values from
1392
- * <code>2</code> to <code>5</code>. Defaults to <code>2</code> for all environment
1393
- * sizes except mw1.micro, which defaults to <code>1</code>.</p>
1423
+ * <p>The Apache Airflow <i>Web server</i> access mode. For more information, see <a href="https://docs.aws.amazon.com/mwaa/latest/userguide/configuring-networking.html">Apache Airflow access modes</a>.</p>
1394
1424
  * @public
1395
1425
  */
1396
- MaxWebservers?: number | undefined;
1426
+ WebserverAccessMode?: WebserverAccessMode | undefined;
1427
+ /**
1428
+ * <p>The day and time of the week in Coordinated Universal Time (UTC) 24-hour standard time to start weekly maintenance updates of your environment in the following format: <code>DAY:HH:MM</code>. For example: <code>TUE:03:30</code>. You can specify a start time in 30 minute increments only.</p>
1429
+ * @public
1430
+ */
1431
+ WeeklyMaintenanceWindowStart?: string | undefined;
1397
1432
  }
1398
1433
  /**
1399
1434
  * @public
@@ -128,11 +128,18 @@ export declare const UpdateStatus: {
128
128
  readonly SUCCESS: "SUCCESS";
129
129
  };
130
130
  export type UpdateStatus = (typeof UpdateStatus)[keyof typeof UpdateStatus];
131
+ export declare const WorkerReplacementStrategy: {
132
+ readonly FORCED: "FORCED";
133
+ readonly GRACEFUL: "GRACEFUL";
134
+ };
135
+ export type WorkerReplacementStrategy =
136
+ (typeof WorkerReplacementStrategy)[keyof typeof WorkerReplacementStrategy];
131
137
  export interface LastUpdate {
132
138
  Status?: UpdateStatus | undefined;
133
139
  CreatedAt?: Date | undefined;
134
140
  Error?: UpdateError | undefined;
135
141
  Source?: string | undefined;
142
+ WorkerReplacementStrategy?: WorkerReplacementStrategy | undefined;
136
143
  }
137
144
  export interface ModuleLoggingConfiguration {
138
145
  Enabled?: boolean | undefined;
@@ -321,26 +328,27 @@ export interface UpdateNetworkConfigurationInput {
321
328
  export interface UpdateEnvironmentInput {
322
329
  Name: string | undefined;
323
330
  ExecutionRoleArn?: string | undefined;
331
+ AirflowConfigurationOptions?: Record<string, string> | undefined;
324
332
  AirflowVersion?: string | undefined;
325
- SourceBucketArn?: string | undefined;
326
333
  DagS3Path?: string | undefined;
334
+ EnvironmentClass?: string | undefined;
335
+ LoggingConfiguration?: LoggingConfigurationInput | undefined;
336
+ MaxWorkers?: number | undefined;
337
+ MinWorkers?: number | undefined;
338
+ MaxWebservers?: number | undefined;
339
+ MinWebservers?: number | undefined;
340
+ WorkerReplacementStrategy?: WorkerReplacementStrategy | undefined;
341
+ NetworkConfiguration?: UpdateNetworkConfigurationInput | undefined;
327
342
  PluginsS3Path?: string | undefined;
328
343
  PluginsS3ObjectVersion?: string | undefined;
329
344
  RequirementsS3Path?: string | undefined;
330
345
  RequirementsS3ObjectVersion?: string | undefined;
346
+ Schedulers?: number | undefined;
347
+ SourceBucketArn?: string | undefined;
331
348
  StartupScriptS3Path?: string | undefined;
332
349
  StartupScriptS3ObjectVersion?: string | undefined;
333
- AirflowConfigurationOptions?: Record<string, string> | undefined;
334
- EnvironmentClass?: string | undefined;
335
- MaxWorkers?: number | undefined;
336
- NetworkConfiguration?: UpdateNetworkConfigurationInput | undefined;
337
- LoggingConfiguration?: LoggingConfigurationInput | undefined;
338
- WeeklyMaintenanceWindowStart?: string | undefined;
339
350
  WebserverAccessMode?: WebserverAccessMode | undefined;
340
- MinWorkers?: number | undefined;
341
- Schedulers?: number | undefined;
342
- MinWebservers?: number | undefined;
343
- MaxWebservers?: number | undefined;
351
+ WeeklyMaintenanceWindowStart?: string | undefined;
344
352
  }
345
353
  export interface UpdateEnvironmentOutput {
346
354
  Arn?: string | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-mwaa",
3
3
  "description": "AWS SDK for JavaScript Mwaa Client for Node.js, Browser and React Native",
4
- "version": "3.816.0",
4
+ "version": "3.820.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-mwaa",
@@ -21,7 +21,7 @@
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
23
  "@aws-sdk/core": "3.816.0",
24
- "@aws-sdk/credential-provider-node": "3.816.0",
24
+ "@aws-sdk/credential-provider-node": "3.817.0",
25
25
  "@aws-sdk/middleware-host-header": "3.804.0",
26
26
  "@aws-sdk/middleware-logger": "3.804.0",
27
27
  "@aws-sdk/middleware-recursion-detection": "3.804.0",