@aws-sdk/client-ecs 3.917.0 → 3.919.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/endpoint/ruleset.js +1 -1
- package/dist-cjs/index.js +50 -2
- package/dist-es/endpoint/ruleset.js +1 -1
- package/dist-es/models/models_0.js +2 -0
- package/dist-es/protocols/Aws_json1_1.js +48 -2
- package/dist-types/commands/CreateServiceCommand.d.ts +56 -2
- package/dist-types/commands/DeleteServiceCommand.d.ts +9 -1
- package/dist-types/commands/DescribeServiceDeploymentsCommand.d.ts +13 -1
- package/dist-types/commands/DescribeServicesCommand.d.ts +9 -1
- package/dist-types/commands/PutAccountSettingCommand.d.ts +1 -1
- package/dist-types/commands/RunTaskCommand.d.ts +1 -1
- package/dist-types/commands/UpdateServiceCommand.d.ts +18 -2
- package/dist-types/models/models_0.d.ts +85 -188
- package/dist-types/models/models_1.d.ts +196 -2
- package/dist-types/ts3.4/commands/PutAccountSettingCommand.d.ts +1 -1
- package/dist-types/ts3.4/models/models_0.d.ts +14 -8
- package/dist-types/ts3.4/models/models_1.d.ts +8 -0
- package/package.json +3 -3
|
@@ -2,6 +2,6 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.ruleSet = void 0;
|
|
4
4
|
const s = "required", t = "fn", u = "argv", v = "ref";
|
|
5
|
-
const a = true, b = "isSet", c = "booleanEquals", d = "error", e = "endpoint", f = "tree", g = "PartitionResult", h = { [s]: false, "type": "
|
|
5
|
+
const a = true, b = "isSet", c = "booleanEquals", d = "error", e = "endpoint", f = "tree", g = "PartitionResult", h = { [s]: false, "type": "string" }, i = { [s]: true, "default": false, "type": "boolean" }, j = { [v]: "Endpoint" }, k = { [t]: c, [u]: [{ [v]: "UseFIPS" }, true] }, l = { [t]: c, [u]: [{ [v]: "UseDualStack" }, true] }, m = {}, n = { [t]: "getAttr", [u]: [{ [v]: g }, "supportsFIPS"] }, o = { [t]: c, [u]: [true, { [t]: "getAttr", [u]: [{ [v]: g }, "supportsDualStack"] }] }, p = [k], q = [l], r = [{ [v]: "Region" }];
|
|
6
6
|
const _data = { version: "1.0", parameters: { Region: h, UseDualStack: i, UseFIPS: i, Endpoint: h }, rules: [{ conditions: [{ [t]: b, [u]: [j] }], rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: d }, { conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: d }, { endpoint: { url: j, properties: m, headers: m }, type: e }], type: f }, { conditions: [{ [t]: b, [u]: r }], rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: g }], rules: [{ conditions: [k, l], rules: [{ conditions: [{ [t]: c, [u]: [a, n] }, o], rules: [{ endpoint: { url: "https://ecs-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: d }], type: f }, { conditions: p, rules: [{ conditions: [{ [t]: c, [u]: [n, a] }], rules: [{ endpoint: { url: "https://ecs-fips.{Region}.{PartitionResult#dnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "FIPS is enabled but this partition does not support FIPS", type: d }], type: f }, { conditions: q, rules: [{ conditions: [o], rules: [{ endpoint: { url: "https://ecs.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "DualStack is enabled but this partition does not support DualStack", type: d }], type: f }, { endpoint: { url: "https://ecs.{Region}.{PartitionResult#dnsSuffix}", properties: m, headers: m }, type: e }], type: f }], type: f }, { error: "Invalid Configuration: Missing Region", type: d }] };
|
|
7
7
|
exports.ruleSet = _data;
|
package/dist-cjs/index.js
CHANGED
|
@@ -355,6 +355,8 @@ const DeploymentLifecycleHookStage = {
|
|
|
355
355
|
};
|
|
356
356
|
const DeploymentStrategy = {
|
|
357
357
|
BLUE_GREEN: "BLUE_GREEN",
|
|
358
|
+
CANARY: "CANARY",
|
|
359
|
+
LINEAR: "LINEAR",
|
|
358
360
|
ROLLING: "ROLLING",
|
|
359
361
|
};
|
|
360
362
|
const DeploymentControllerType = {
|
|
@@ -2396,6 +2398,12 @@ const de_UpdateInProgressExceptionRes = async (parsedOutput, context) => {
|
|
|
2396
2398
|
});
|
|
2397
2399
|
return smithyClient.decorateServiceException(exception, body);
|
|
2398
2400
|
};
|
|
2401
|
+
const se_CanaryConfiguration = (input, context) => {
|
|
2402
|
+
return smithyClient.take(input, {
|
|
2403
|
+
canaryBakeTimeInMinutes: [],
|
|
2404
|
+
canaryPercent: smithyClient.serializeFloat,
|
|
2405
|
+
});
|
|
2406
|
+
};
|
|
2399
2407
|
const se_CreateCapacityProviderRequest = (input, context) => {
|
|
2400
2408
|
return smithyClient.take(input, {
|
|
2401
2409
|
autoScalingGroupProvider: smithyClient._json,
|
|
@@ -2469,8 +2477,10 @@ const se_DeploymentConfiguration = (input, context) => {
|
|
|
2469
2477
|
return smithyClient.take(input, {
|
|
2470
2478
|
alarms: smithyClient._json,
|
|
2471
2479
|
bakeTimeInMinutes: [],
|
|
2480
|
+
canaryConfiguration: (_) => se_CanaryConfiguration(_),
|
|
2472
2481
|
deploymentCircuitBreaker: smithyClient._json,
|
|
2473
2482
|
lifecycleHooks: (_) => se_DeploymentLifecycleHookList(_),
|
|
2483
|
+
linearConfiguration: (_) => se_LinearConfiguration(_),
|
|
2474
2484
|
maximumPercent: [],
|
|
2475
2485
|
minimumHealthyPercent: [],
|
|
2476
2486
|
strategy: [],
|
|
@@ -2540,6 +2550,12 @@ const se_InstanceRequirementsRequest = (input, context) => {
|
|
|
2540
2550
|
vCpuCount: smithyClient._json,
|
|
2541
2551
|
});
|
|
2542
2552
|
};
|
|
2553
|
+
const se_LinearConfiguration = (input, context) => {
|
|
2554
|
+
return smithyClient.take(input, {
|
|
2555
|
+
stepBakeTimeInMinutes: [],
|
|
2556
|
+
stepPercent: smithyClient.serializeFloat,
|
|
2557
|
+
});
|
|
2558
|
+
};
|
|
2543
2559
|
const se_ListServiceDeploymentsRequest = (input, context) => {
|
|
2544
2560
|
return smithyClient.take(input, {
|
|
2545
2561
|
cluster: [],
|
|
@@ -2690,6 +2706,12 @@ const se_UpdateTaskSetRequest = (input, context) => {
|
|
|
2690
2706
|
taskSet: [],
|
|
2691
2707
|
});
|
|
2692
2708
|
};
|
|
2709
|
+
const de_CanaryConfiguration = (output, context) => {
|
|
2710
|
+
return smithyClient.take(output, {
|
|
2711
|
+
canaryBakeTimeInMinutes: smithyClient.expectInt32,
|
|
2712
|
+
canaryPercent: smithyClient.limitedParseDouble,
|
|
2713
|
+
});
|
|
2714
|
+
};
|
|
2693
2715
|
const de_CapacityProvider = (output, context) => {
|
|
2694
2716
|
return smithyClient.take(output, {
|
|
2695
2717
|
autoScalingGroupProvider: smithyClient._json,
|
|
@@ -2842,8 +2864,10 @@ const de_DeploymentConfiguration = (output, context) => {
|
|
|
2842
2864
|
return smithyClient.take(output, {
|
|
2843
2865
|
alarms: smithyClient._json,
|
|
2844
2866
|
bakeTimeInMinutes: smithyClient.expectInt32,
|
|
2867
|
+
canaryConfiguration: (_) => de_CanaryConfiguration(_),
|
|
2845
2868
|
deploymentCircuitBreaker: smithyClient._json,
|
|
2846
2869
|
lifecycleHooks: (_) => de_DeploymentLifecycleHookList(_),
|
|
2870
|
+
linearConfiguration: (_) => de_LinearConfiguration(_),
|
|
2847
2871
|
maximumPercent: smithyClient.expectInt32,
|
|
2848
2872
|
minimumHealthyPercent: smithyClient.expectInt32,
|
|
2849
2873
|
strategy: smithyClient.expectString,
|
|
@@ -2994,6 +3018,12 @@ const de_InstanceRequirementsRequest = (output, context) => {
|
|
|
2994
3018
|
vCpuCount: smithyClient._json,
|
|
2995
3019
|
});
|
|
2996
3020
|
};
|
|
3021
|
+
const de_LinearConfiguration = (output, context) => {
|
|
3022
|
+
return smithyClient.take(output, {
|
|
3023
|
+
stepBakeTimeInMinutes: smithyClient.expectInt32,
|
|
3024
|
+
stepPercent: smithyClient.limitedParseDouble,
|
|
3025
|
+
});
|
|
3026
|
+
};
|
|
2997
3027
|
const de_ListServiceDeploymentsResponse = (output, context) => {
|
|
2998
3028
|
return smithyClient.take(output, {
|
|
2999
3029
|
nextToken: smithyClient.expectString,
|
|
@@ -3146,12 +3176,12 @@ const de_ServiceDeployment = (output, context) => {
|
|
|
3146
3176
|
rollback: (_) => de_Rollback(_),
|
|
3147
3177
|
serviceArn: smithyClient.expectString,
|
|
3148
3178
|
serviceDeploymentArn: smithyClient.expectString,
|
|
3149
|
-
sourceServiceRevisions:
|
|
3179
|
+
sourceServiceRevisions: (_) => de_ServiceRevisionsSummaryList(_),
|
|
3150
3180
|
startedAt: (_) => smithyClient.expectNonNull(smithyClient.parseEpochTimestamp(smithyClient.expectNumber(_))),
|
|
3151
3181
|
status: smithyClient.expectString,
|
|
3152
3182
|
statusReason: smithyClient.expectString,
|
|
3153
3183
|
stoppedAt: (_) => smithyClient.expectNonNull(smithyClient.parseEpochTimestamp(smithyClient.expectNumber(_))),
|
|
3154
|
-
targetServiceRevision:
|
|
3184
|
+
targetServiceRevision: (_) => de_ServiceRevisionSummary(_),
|
|
3155
3185
|
updatedAt: (_) => smithyClient.expectNonNull(smithyClient.parseEpochTimestamp(smithyClient.expectNumber(_))),
|
|
3156
3186
|
});
|
|
3157
3187
|
};
|
|
@@ -3230,6 +3260,24 @@ const de_ServiceRevisions = (output, context) => {
|
|
|
3230
3260
|
});
|
|
3231
3261
|
return retVal;
|
|
3232
3262
|
};
|
|
3263
|
+
const de_ServiceRevisionsSummaryList = (output, context) => {
|
|
3264
|
+
const retVal = (output || [])
|
|
3265
|
+
.filter((e) => e != null)
|
|
3266
|
+
.map((entry) => {
|
|
3267
|
+
return de_ServiceRevisionSummary(entry);
|
|
3268
|
+
});
|
|
3269
|
+
return retVal;
|
|
3270
|
+
};
|
|
3271
|
+
const de_ServiceRevisionSummary = (output, context) => {
|
|
3272
|
+
return smithyClient.take(output, {
|
|
3273
|
+
arn: smithyClient.expectString,
|
|
3274
|
+
pendingTaskCount: smithyClient.expectInt32,
|
|
3275
|
+
requestedProductionTrafficWeight: smithyClient.limitedParseDouble,
|
|
3276
|
+
requestedTaskCount: smithyClient.expectInt32,
|
|
3277
|
+
requestedTestTrafficWeight: smithyClient.limitedParseDouble,
|
|
3278
|
+
runningTaskCount: smithyClient.expectInt32,
|
|
3279
|
+
});
|
|
3280
|
+
};
|
|
3233
3281
|
const de_Services = (output, context) => {
|
|
3234
3282
|
const retVal = (output || [])
|
|
3235
3283
|
.filter((e) => e != null)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
const s = "required", t = "fn", u = "argv", v = "ref";
|
|
2
|
-
const a = true, b = "isSet", c = "booleanEquals", d = "error", e = "endpoint", f = "tree", g = "PartitionResult", h = { [s]: false, "type": "
|
|
2
|
+
const a = true, b = "isSet", c = "booleanEquals", d = "error", e = "endpoint", f = "tree", g = "PartitionResult", h = { [s]: false, "type": "string" }, i = { [s]: true, "default": false, "type": "boolean" }, j = { [v]: "Endpoint" }, k = { [t]: c, [u]: [{ [v]: "UseFIPS" }, true] }, l = { [t]: c, [u]: [{ [v]: "UseDualStack" }, true] }, m = {}, n = { [t]: "getAttr", [u]: [{ [v]: g }, "supportsFIPS"] }, o = { [t]: c, [u]: [true, { [t]: "getAttr", [u]: [{ [v]: g }, "supportsDualStack"] }] }, p = [k], q = [l], r = [{ [v]: "Region" }];
|
|
3
3
|
const _data = { version: "1.0", parameters: { Region: h, UseDualStack: i, UseFIPS: i, Endpoint: h }, rules: [{ conditions: [{ [t]: b, [u]: [j] }], rules: [{ conditions: p, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: d }, { conditions: q, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: d }, { endpoint: { url: j, properties: m, headers: m }, type: e }], type: f }, { conditions: [{ [t]: b, [u]: r }], rules: [{ conditions: [{ [t]: "aws.partition", [u]: r, assign: g }], rules: [{ conditions: [k, l], rules: [{ conditions: [{ [t]: c, [u]: [a, n] }, o], rules: [{ endpoint: { url: "https://ecs-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: d }], type: f }, { conditions: p, rules: [{ conditions: [{ [t]: c, [u]: [n, a] }], rules: [{ endpoint: { url: "https://ecs-fips.{Region}.{PartitionResult#dnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "FIPS is enabled but this partition does not support FIPS", type: d }], type: f }, { conditions: q, rules: [{ conditions: [o], rules: [{ endpoint: { url: "https://ecs.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: m, headers: m }, type: e }], type: f }, { error: "DualStack is enabled but this partition does not support DualStack", type: d }], type: f }, { endpoint: { url: "https://ecs.{Region}.{PartitionResult#dnsSuffix}", properties: m, headers: m }, type: e }], type: f }], type: f }, { error: "Invalid Configuration: Missing Region", type: d }] };
|
|
4
4
|
export const ruleSet = _data;
|
|
@@ -1497,6 +1497,12 @@ const de_UpdateInProgressExceptionRes = async (parsedOutput, context) => {
|
|
|
1497
1497
|
});
|
|
1498
1498
|
return __decorateServiceException(exception, body);
|
|
1499
1499
|
};
|
|
1500
|
+
const se_CanaryConfiguration = (input, context) => {
|
|
1501
|
+
return take(input, {
|
|
1502
|
+
canaryBakeTimeInMinutes: [],
|
|
1503
|
+
canaryPercent: __serializeFloat,
|
|
1504
|
+
});
|
|
1505
|
+
};
|
|
1500
1506
|
const se_CreateCapacityProviderRequest = (input, context) => {
|
|
1501
1507
|
return take(input, {
|
|
1502
1508
|
autoScalingGroupProvider: _json,
|
|
@@ -1570,8 +1576,10 @@ const se_DeploymentConfiguration = (input, context) => {
|
|
|
1570
1576
|
return take(input, {
|
|
1571
1577
|
alarms: _json,
|
|
1572
1578
|
bakeTimeInMinutes: [],
|
|
1579
|
+
canaryConfiguration: (_) => se_CanaryConfiguration(_, context),
|
|
1573
1580
|
deploymentCircuitBreaker: _json,
|
|
1574
1581
|
lifecycleHooks: (_) => se_DeploymentLifecycleHookList(_, context),
|
|
1582
|
+
linearConfiguration: (_) => se_LinearConfiguration(_, context),
|
|
1575
1583
|
maximumPercent: [],
|
|
1576
1584
|
minimumHealthyPercent: [],
|
|
1577
1585
|
strategy: [],
|
|
@@ -1641,6 +1649,12 @@ const se_InstanceRequirementsRequest = (input, context) => {
|
|
|
1641
1649
|
vCpuCount: _json,
|
|
1642
1650
|
});
|
|
1643
1651
|
};
|
|
1652
|
+
const se_LinearConfiguration = (input, context) => {
|
|
1653
|
+
return take(input, {
|
|
1654
|
+
stepBakeTimeInMinutes: [],
|
|
1655
|
+
stepPercent: __serializeFloat,
|
|
1656
|
+
});
|
|
1657
|
+
};
|
|
1644
1658
|
const se_ListServiceDeploymentsRequest = (input, context) => {
|
|
1645
1659
|
return take(input, {
|
|
1646
1660
|
cluster: [],
|
|
@@ -1791,6 +1805,12 @@ const se_UpdateTaskSetRequest = (input, context) => {
|
|
|
1791
1805
|
taskSet: [],
|
|
1792
1806
|
});
|
|
1793
1807
|
};
|
|
1808
|
+
const de_CanaryConfiguration = (output, context) => {
|
|
1809
|
+
return take(output, {
|
|
1810
|
+
canaryBakeTimeInMinutes: __expectInt32,
|
|
1811
|
+
canaryPercent: __limitedParseDouble,
|
|
1812
|
+
});
|
|
1813
|
+
};
|
|
1794
1814
|
const de_CapacityProvider = (output, context) => {
|
|
1795
1815
|
return take(output, {
|
|
1796
1816
|
autoScalingGroupProvider: _json,
|
|
@@ -1943,8 +1963,10 @@ const de_DeploymentConfiguration = (output, context) => {
|
|
|
1943
1963
|
return take(output, {
|
|
1944
1964
|
alarms: _json,
|
|
1945
1965
|
bakeTimeInMinutes: __expectInt32,
|
|
1966
|
+
canaryConfiguration: (_) => de_CanaryConfiguration(_, context),
|
|
1946
1967
|
deploymentCircuitBreaker: _json,
|
|
1947
1968
|
lifecycleHooks: (_) => de_DeploymentLifecycleHookList(_, context),
|
|
1969
|
+
linearConfiguration: (_) => de_LinearConfiguration(_, context),
|
|
1948
1970
|
maximumPercent: __expectInt32,
|
|
1949
1971
|
minimumHealthyPercent: __expectInt32,
|
|
1950
1972
|
strategy: __expectString,
|
|
@@ -2095,6 +2117,12 @@ const de_InstanceRequirementsRequest = (output, context) => {
|
|
|
2095
2117
|
vCpuCount: _json,
|
|
2096
2118
|
});
|
|
2097
2119
|
};
|
|
2120
|
+
const de_LinearConfiguration = (output, context) => {
|
|
2121
|
+
return take(output, {
|
|
2122
|
+
stepBakeTimeInMinutes: __expectInt32,
|
|
2123
|
+
stepPercent: __limitedParseDouble,
|
|
2124
|
+
});
|
|
2125
|
+
};
|
|
2098
2126
|
const de_ListServiceDeploymentsResponse = (output, context) => {
|
|
2099
2127
|
return take(output, {
|
|
2100
2128
|
nextToken: __expectString,
|
|
@@ -2247,12 +2275,12 @@ const de_ServiceDeployment = (output, context) => {
|
|
|
2247
2275
|
rollback: (_) => de_Rollback(_, context),
|
|
2248
2276
|
serviceArn: __expectString,
|
|
2249
2277
|
serviceDeploymentArn: __expectString,
|
|
2250
|
-
sourceServiceRevisions:
|
|
2278
|
+
sourceServiceRevisions: (_) => de_ServiceRevisionsSummaryList(_, context),
|
|
2251
2279
|
startedAt: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
|
|
2252
2280
|
status: __expectString,
|
|
2253
2281
|
statusReason: __expectString,
|
|
2254
2282
|
stoppedAt: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
|
|
2255
|
-
targetServiceRevision:
|
|
2283
|
+
targetServiceRevision: (_) => de_ServiceRevisionSummary(_, context),
|
|
2256
2284
|
updatedAt: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
|
|
2257
2285
|
});
|
|
2258
2286
|
};
|
|
@@ -2331,6 +2359,24 @@ const de_ServiceRevisions = (output, context) => {
|
|
|
2331
2359
|
});
|
|
2332
2360
|
return retVal;
|
|
2333
2361
|
};
|
|
2362
|
+
const de_ServiceRevisionsSummaryList = (output, context) => {
|
|
2363
|
+
const retVal = (output || [])
|
|
2364
|
+
.filter((e) => e != null)
|
|
2365
|
+
.map((entry) => {
|
|
2366
|
+
return de_ServiceRevisionSummary(entry, context);
|
|
2367
|
+
});
|
|
2368
|
+
return retVal;
|
|
2369
|
+
};
|
|
2370
|
+
const de_ServiceRevisionSummary = (output, context) => {
|
|
2371
|
+
return take(output, {
|
|
2372
|
+
arn: __expectString,
|
|
2373
|
+
pendingTaskCount: __expectInt32,
|
|
2374
|
+
requestedProductionTrafficWeight: __limitedParseDouble,
|
|
2375
|
+
requestedTaskCount: __expectInt32,
|
|
2376
|
+
requestedTestTrafficWeight: __limitedParseDouble,
|
|
2377
|
+
runningTaskCount: __expectInt32,
|
|
2378
|
+
});
|
|
2379
|
+
};
|
|
2334
2380
|
const de_Services = (output, context) => {
|
|
2335
2381
|
const retVal = (output || [])
|
|
2336
2382
|
.filter((e) => e != null)
|
|
@@ -162,6 +162,44 @@ declare const CreateServiceCommand_base: {
|
|
|
162
162
|
* </li>
|
|
163
163
|
* </ul>
|
|
164
164
|
* </li>
|
|
165
|
+
* <li>
|
|
166
|
+
* <p>
|
|
167
|
+
* <code>LINEAR</code>: A <i>linear</i> deployment strategy (<code>LINEAR</code>) gradually shifts traffic from the current production environment to a new environment in equal percentage increments over a specified time period. With Amazon ECS linear deployments, you can control the pace of traffic shifting and validate new service revisions with increasing amounts of production traffic.</p>
|
|
168
|
+
* <p>Linear deployments are best suited for the following scenarios:</p>
|
|
169
|
+
* <ul>
|
|
170
|
+
* <li>
|
|
171
|
+
* <p>Gradual validation: When you want to gradually validate your new service version with increasing traffic</p>
|
|
172
|
+
* </li>
|
|
173
|
+
* <li>
|
|
174
|
+
* <p>Performance monitoring: When you need time to monitor metrics and performance during the deployment</p>
|
|
175
|
+
* </li>
|
|
176
|
+
* <li>
|
|
177
|
+
* <p>Risk minimization: When you want to minimize risk by exposing the new version to production traffic incrementally</p>
|
|
178
|
+
* </li>
|
|
179
|
+
* <li>
|
|
180
|
+
* <p>Load balancer requirement: When your service uses Application Load Balancer, Network Load Balancer, or Service Connect</p>
|
|
181
|
+
* </li>
|
|
182
|
+
* </ul>
|
|
183
|
+
* </li>
|
|
184
|
+
* <li>
|
|
185
|
+
* <p>
|
|
186
|
+
* <code>CANARY</code>: A <i>canary</i> deployment strategy (<code>CANARY</code>) shifts a small percentage of traffic to the new service revision first, then shifts the remaining traffic all at once after a specified time period. This allows you to test the new version with a subset of users before full deployment.</p>
|
|
187
|
+
* <p>Canary deployments are best suited for the following scenarios:</p>
|
|
188
|
+
* <ul>
|
|
189
|
+
* <li>
|
|
190
|
+
* <p>Feature testing: When you want to test new features with a small subset of users before full rollout</p>
|
|
191
|
+
* </li>
|
|
192
|
+
* <li>
|
|
193
|
+
* <p>Production validation: When you need to validate performance and functionality with real production traffic</p>
|
|
194
|
+
* </li>
|
|
195
|
+
* <li>
|
|
196
|
+
* <p>Blast radius control: When you want to minimize blast radius if issues are discovered in the new version</p>
|
|
197
|
+
* </li>
|
|
198
|
+
* <li>
|
|
199
|
+
* <p>Load balancer requirement: When your service uses Application Load Balancer, Network Load Balancer, or Service Connect</p>
|
|
200
|
+
* </li>
|
|
201
|
+
* </ul>
|
|
202
|
+
* </li>
|
|
165
203
|
* </ul>
|
|
166
204
|
* </li>
|
|
167
205
|
* <li>
|
|
@@ -245,7 +283,7 @@ declare const CreateServiceCommand_base: {
|
|
|
245
283
|
* rollback: true || false, // required
|
|
246
284
|
* enable: true || false, // required
|
|
247
285
|
* },
|
|
248
|
-
* strategy: "ROLLING" || "BLUE_GREEN",
|
|
286
|
+
* strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
249
287
|
* bakeTimeInMinutes: Number("int"),
|
|
250
288
|
* lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
251
289
|
* { // DeploymentLifecycleHook
|
|
@@ -257,6 +295,14 @@ declare const CreateServiceCommand_base: {
|
|
|
257
295
|
* hookDetails: "DOCUMENT_VALUE",
|
|
258
296
|
* },
|
|
259
297
|
* ],
|
|
298
|
+
* linearConfiguration: { // LinearConfiguration
|
|
299
|
+
* stepPercent: Number("double"),
|
|
300
|
+
* stepBakeTimeInMinutes: Number("int"),
|
|
301
|
+
* },
|
|
302
|
+
* canaryConfiguration: { // CanaryConfiguration
|
|
303
|
+
* canaryPercent: Number("double"),
|
|
304
|
+
* canaryBakeTimeInMinutes: Number("int"),
|
|
305
|
+
* },
|
|
260
306
|
* },
|
|
261
307
|
* placementConstraints: [ // PlacementConstraints
|
|
262
308
|
* { // PlacementConstraint
|
|
@@ -438,7 +484,7 @@ declare const CreateServiceCommand_base: {
|
|
|
438
484
|
* // rollback: true || false, // required
|
|
439
485
|
* // enable: true || false, // required
|
|
440
486
|
* // },
|
|
441
|
-
* // strategy: "ROLLING" || "BLUE_GREEN",
|
|
487
|
+
* // strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
442
488
|
* // bakeTimeInMinutes: Number("int"),
|
|
443
489
|
* // lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
444
490
|
* // { // DeploymentLifecycleHook
|
|
@@ -450,6 +496,14 @@ declare const CreateServiceCommand_base: {
|
|
|
450
496
|
* // hookDetails: "DOCUMENT_VALUE",
|
|
451
497
|
* // },
|
|
452
498
|
* // ],
|
|
499
|
+
* // linearConfiguration: { // LinearConfiguration
|
|
500
|
+
* // stepPercent: Number("double"),
|
|
501
|
+
* // stepBakeTimeInMinutes: Number("int"),
|
|
502
|
+
* // },
|
|
503
|
+
* // canaryConfiguration: { // CanaryConfiguration
|
|
504
|
+
* // canaryPercent: Number("double"),
|
|
505
|
+
* // canaryBakeTimeInMinutes: Number("int"),
|
|
506
|
+
* // },
|
|
453
507
|
* // },
|
|
454
508
|
* // taskSets: [ // TaskSets
|
|
455
509
|
* // { // TaskSet
|
|
@@ -119,7 +119,7 @@ declare const DeleteServiceCommand_base: {
|
|
|
119
119
|
* // rollback: true || false, // required
|
|
120
120
|
* // enable: true || false, // required
|
|
121
121
|
* // },
|
|
122
|
-
* // strategy: "ROLLING" || "BLUE_GREEN",
|
|
122
|
+
* // strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
123
123
|
* // bakeTimeInMinutes: Number("int"),
|
|
124
124
|
* // lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
125
125
|
* // { // DeploymentLifecycleHook
|
|
@@ -131,6 +131,14 @@ declare const DeleteServiceCommand_base: {
|
|
|
131
131
|
* // hookDetails: "DOCUMENT_VALUE",
|
|
132
132
|
* // },
|
|
133
133
|
* // ],
|
|
134
|
+
* // linearConfiguration: { // LinearConfiguration
|
|
135
|
+
* // stepPercent: Number("double"),
|
|
136
|
+
* // stepBakeTimeInMinutes: Number("int"),
|
|
137
|
+
* // },
|
|
138
|
+
* // canaryConfiguration: { // CanaryConfiguration
|
|
139
|
+
* // canaryPercent: Number("double"),
|
|
140
|
+
* // canaryBakeTimeInMinutes: Number("int"),
|
|
141
|
+
* // },
|
|
134
142
|
* // },
|
|
135
143
|
* // taskSets: [ // TaskSets
|
|
136
144
|
* // { // TaskSet
|
|
@@ -62,6 +62,8 @@ declare const DescribeServiceDeploymentsCommand_base: {
|
|
|
62
62
|
* // requestedTaskCount: Number("int"),
|
|
63
63
|
* // runningTaskCount: Number("int"),
|
|
64
64
|
* // pendingTaskCount: Number("int"),
|
|
65
|
+
* // requestedTestTrafficWeight: Number("double"),
|
|
66
|
+
* // requestedProductionTrafficWeight: Number("double"),
|
|
65
67
|
* // },
|
|
66
68
|
* // ],
|
|
67
69
|
* // targetServiceRevision: {
|
|
@@ -69,6 +71,8 @@ declare const DescribeServiceDeploymentsCommand_base: {
|
|
|
69
71
|
* // requestedTaskCount: Number("int"),
|
|
70
72
|
* // runningTaskCount: Number("int"),
|
|
71
73
|
* // pendingTaskCount: Number("int"),
|
|
74
|
+
* // requestedTestTrafficWeight: Number("double"),
|
|
75
|
+
* // requestedProductionTrafficWeight: Number("double"),
|
|
72
76
|
* // },
|
|
73
77
|
* // status: "PENDING" || "SUCCESSFUL" || "STOPPED" || "STOP_REQUESTED" || "IN_PROGRESS" || "ROLLBACK_REQUESTED" || "ROLLBACK_IN_PROGRESS" || "ROLLBACK_SUCCESSFUL" || "ROLLBACK_FAILED",
|
|
74
78
|
* // statusReason: "STRING_VALUE",
|
|
@@ -87,7 +91,7 @@ declare const DescribeServiceDeploymentsCommand_base: {
|
|
|
87
91
|
* // rollback: true || false, // required
|
|
88
92
|
* // enable: true || false, // required
|
|
89
93
|
* // },
|
|
90
|
-
* // strategy: "ROLLING" || "BLUE_GREEN",
|
|
94
|
+
* // strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
91
95
|
* // bakeTimeInMinutes: Number("int"),
|
|
92
96
|
* // lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
93
97
|
* // { // DeploymentLifecycleHook
|
|
@@ -99,6 +103,14 @@ declare const DescribeServiceDeploymentsCommand_base: {
|
|
|
99
103
|
* // hookDetails: "DOCUMENT_VALUE",
|
|
100
104
|
* // },
|
|
101
105
|
* // ],
|
|
106
|
+
* // linearConfiguration: { // LinearConfiguration
|
|
107
|
+
* // stepPercent: Number("double"),
|
|
108
|
+
* // stepBakeTimeInMinutes: Number("int"),
|
|
109
|
+
* // },
|
|
110
|
+
* // canaryConfiguration: { // CanaryConfiguration
|
|
111
|
+
* // canaryPercent: Number("double"),
|
|
112
|
+
* // canaryBakeTimeInMinutes: Number("int"),
|
|
113
|
+
* // },
|
|
102
114
|
* // },
|
|
103
115
|
* // rollback: { // Rollback
|
|
104
116
|
* // reason: "STRING_VALUE",
|
|
@@ -104,7 +104,7 @@ declare const DescribeServicesCommand_base: {
|
|
|
104
104
|
* // rollback: true || false, // required
|
|
105
105
|
* // enable: true || false, // required
|
|
106
106
|
* // },
|
|
107
|
-
* // strategy: "ROLLING" || "BLUE_GREEN",
|
|
107
|
+
* // strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
108
108
|
* // bakeTimeInMinutes: Number("int"),
|
|
109
109
|
* // lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
110
110
|
* // { // DeploymentLifecycleHook
|
|
@@ -116,6 +116,14 @@ declare const DescribeServicesCommand_base: {
|
|
|
116
116
|
* // hookDetails: "DOCUMENT_VALUE",
|
|
117
117
|
* // },
|
|
118
118
|
* // ],
|
|
119
|
+
* // linearConfiguration: { // LinearConfiguration
|
|
120
|
+
* // stepPercent: Number("double"),
|
|
121
|
+
* // stepBakeTimeInMinutes: Number("int"),
|
|
122
|
+
* // },
|
|
123
|
+
* // canaryConfiguration: { // CanaryConfiguration
|
|
124
|
+
* // canaryPercent: Number("double"),
|
|
125
|
+
* // canaryBakeTimeInMinutes: Number("int"),
|
|
126
|
+
* // },
|
|
119
127
|
* // },
|
|
120
128
|
* // taskSets: [ // TaskSets
|
|
121
129
|
* // { // TaskSet
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Command as $Command } from "@smithy/smithy-client";
|
|
2
2
|
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
|
|
3
3
|
import { ECSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ECSClient";
|
|
4
|
-
import { PutAccountSettingRequest, PutAccountSettingResponse } from "../models/
|
|
4
|
+
import { PutAccountSettingRequest, PutAccountSettingResponse } from "../models/models_1";
|
|
5
5
|
/**
|
|
6
6
|
* @public
|
|
7
7
|
*/
|
|
@@ -403,7 +403,7 @@ declare const RunTaskCommand_base: {
|
|
|
403
403
|
*
|
|
404
404
|
* @throws {@link BlockedException} (client fault)
|
|
405
405
|
* <p>Your Amazon Web Services account was blocked. For more information, contact <a href="http://aws.amazon.com/contact-us/">
|
|
406
|
-
* Amazon Web
|
|
406
|
+
* Amazon Web ServicesSupport</a>.</p>
|
|
407
407
|
*
|
|
408
408
|
* @throws {@link ClientException} (client fault)
|
|
409
409
|
* <p>These errors are usually caused by a client action. This client action might be using
|
|
@@ -178,7 +178,7 @@ declare const UpdateServiceCommand_base: {
|
|
|
178
178
|
* rollback: true || false, // required
|
|
179
179
|
* enable: true || false, // required
|
|
180
180
|
* },
|
|
181
|
-
* strategy: "ROLLING" || "BLUE_GREEN",
|
|
181
|
+
* strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
182
182
|
* bakeTimeInMinutes: Number("int"),
|
|
183
183
|
* lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
184
184
|
* { // DeploymentLifecycleHook
|
|
@@ -190,6 +190,14 @@ declare const UpdateServiceCommand_base: {
|
|
|
190
190
|
* hookDetails: "DOCUMENT_VALUE",
|
|
191
191
|
* },
|
|
192
192
|
* ],
|
|
193
|
+
* linearConfiguration: { // LinearConfiguration
|
|
194
|
+
* stepPercent: Number("double"),
|
|
195
|
+
* stepBakeTimeInMinutes: Number("int"),
|
|
196
|
+
* },
|
|
197
|
+
* canaryConfiguration: { // CanaryConfiguration
|
|
198
|
+
* canaryPercent: Number("double"),
|
|
199
|
+
* canaryBakeTimeInMinutes: Number("int"),
|
|
200
|
+
* },
|
|
193
201
|
* },
|
|
194
202
|
* availabilityZoneRebalancing: "ENABLED" || "DISABLED",
|
|
195
203
|
* networkConfiguration: { // NetworkConfiguration
|
|
@@ -389,7 +397,7 @@ declare const UpdateServiceCommand_base: {
|
|
|
389
397
|
* // rollback: true || false, // required
|
|
390
398
|
* // enable: true || false, // required
|
|
391
399
|
* // },
|
|
392
|
-
* // strategy: "ROLLING" || "BLUE_GREEN",
|
|
400
|
+
* // strategy: "ROLLING" || "BLUE_GREEN" || "LINEAR" || "CANARY",
|
|
393
401
|
* // bakeTimeInMinutes: Number("int"),
|
|
394
402
|
* // lifecycleHooks: [ // DeploymentLifecycleHookList
|
|
395
403
|
* // { // DeploymentLifecycleHook
|
|
@@ -401,6 +409,14 @@ declare const UpdateServiceCommand_base: {
|
|
|
401
409
|
* // hookDetails: "DOCUMENT_VALUE",
|
|
402
410
|
* // },
|
|
403
411
|
* // ],
|
|
412
|
+
* // linearConfiguration: { // LinearConfiguration
|
|
413
|
+
* // stepPercent: Number("double"),
|
|
414
|
+
* // stepBakeTimeInMinutes: Number("int"),
|
|
415
|
+
* // },
|
|
416
|
+
* // canaryConfiguration: { // CanaryConfiguration
|
|
417
|
+
* // canaryPercent: Number("double"),
|
|
418
|
+
* // canaryBakeTimeInMinutes: Number("int"),
|
|
419
|
+
* // },
|
|
404
420
|
* // },
|
|
405
421
|
* // taskSets: [ // TaskSets
|
|
406
422
|
* // { // TaskSet
|
|
@@ -927,6 +927,7 @@ export interface CapacityProvider {
|
|
|
927
927
|
name?: string | undefined;
|
|
928
928
|
/**
|
|
929
929
|
* <p>The cluster that this capacity provider is associated with. Managed instances capacity providers are cluster-scoped, meaning they can only be used within their associated cluster.</p>
|
|
930
|
+
* <p>This is required for Managed instances.</p>
|
|
930
931
|
* @public
|
|
931
932
|
*/
|
|
932
933
|
cluster?: string | undefined;
|
|
@@ -1284,10 +1285,10 @@ export interface CapacityProviderStrategyItem {
|
|
|
1284
1285
|
* <p>Weight is considered after the base value is satisfied</p>
|
|
1285
1286
|
* </li>
|
|
1286
1287
|
* <li>
|
|
1287
|
-
* <p>
|
|
1288
|
+
* <p>The default value is <code>0</code> if not specified</p>
|
|
1288
1289
|
* </li>
|
|
1289
1290
|
* <li>
|
|
1290
|
-
* <p>
|
|
1291
|
+
* <p>The valid range is 0 to 1,000</p>
|
|
1291
1292
|
* </li>
|
|
1292
1293
|
* <li>
|
|
1293
1294
|
* <p>At least one capacity provider must have a weight greater than zero</p>
|
|
@@ -1322,10 +1323,10 @@ export interface CapacityProviderStrategyItem {
|
|
|
1322
1323
|
* <p>Only one capacity provider in a strategy can have a base defined</p>
|
|
1323
1324
|
* </li>
|
|
1324
1325
|
* <li>
|
|
1325
|
-
* <p>
|
|
1326
|
+
* <p>The default value is <code>0</code> if not specified</p>
|
|
1326
1327
|
* </li>
|
|
1327
1328
|
* <li>
|
|
1328
|
-
* <p>
|
|
1329
|
+
* <p>The valid range is 0 to 100,000</p>
|
|
1329
1330
|
* </li>
|
|
1330
1331
|
* <li>
|
|
1331
1332
|
* <p>Base requirements are satisfied first before weight distribution</p>
|
|
@@ -1883,6 +1884,28 @@ export interface DeploymentAlarms {
|
|
|
1883
1884
|
*/
|
|
1884
1885
|
enable: boolean | undefined;
|
|
1885
1886
|
}
|
|
1887
|
+
/**
|
|
1888
|
+
* <p>Configuration for canary deployment strategy that shifts a fixed percentage of traffic to
|
|
1889
|
+
* the new service revision, waits for a specified bake time, then shifts the remaining
|
|
1890
|
+
* traffic. </p>
|
|
1891
|
+
* <p>This is only valid when you run <code>CreateService</code> or
|
|
1892
|
+
* <code>UpdateService</code> with <code>deploymentController</code> set to
|
|
1893
|
+
* <code>ECS</code> and a <code>deploymentConfiguration</code> with a strategy set to
|
|
1894
|
+
* <code>CANARY</code>. </p>
|
|
1895
|
+
* @public
|
|
1896
|
+
*/
|
|
1897
|
+
export interface CanaryConfiguration {
|
|
1898
|
+
/**
|
|
1899
|
+
* <p>The percentage of production traffic to shift to the new service revision during the canary phase. Valid values are 0.1 to 100.0. The default value is 5.0.</p>
|
|
1900
|
+
* @public
|
|
1901
|
+
*/
|
|
1902
|
+
canaryPercent?: number | undefined;
|
|
1903
|
+
/**
|
|
1904
|
+
* <p>The amount of time in minutes to wait during the canary phase before shifting the remaining production traffic to the new service revision. Valid values are 0 to 1440 minutes (24 hours). The default value is 10.</p>
|
|
1905
|
+
* @public
|
|
1906
|
+
*/
|
|
1907
|
+
canaryBakeTimeInMinutes?: number | undefined;
|
|
1908
|
+
}
|
|
1886
1909
|
/**
|
|
1887
1910
|
* <note>
|
|
1888
1911
|
* <p>The deployment circuit breaker can only be used for services using the rolling
|
|
@@ -1999,12 +2022,36 @@ export interface DeploymentLifecycleHook {
|
|
|
1999
2022
|
*/
|
|
2000
2023
|
hookDetails?: __DocumentType | undefined;
|
|
2001
2024
|
}
|
|
2025
|
+
/**
|
|
2026
|
+
* <p>Configuration for linear deployment strategy that shifts production traffic in equal
|
|
2027
|
+
* percentage increments with configurable wait times between each step until 100% of
|
|
2028
|
+
* traffic is shifted to the new service revision. This is only valid when you run
|
|
2029
|
+
* <code>CreateService</code> or <code>UpdateService</code> with
|
|
2030
|
+
* <code>deploymentController</code> set to <code>ECS</code> and a
|
|
2031
|
+
* <code>deploymentConfiguration</code> with a strategy set to <code>LINEAR</code>. </p>
|
|
2032
|
+
* @public
|
|
2033
|
+
*/
|
|
2034
|
+
export interface LinearConfiguration {
|
|
2035
|
+
/**
|
|
2036
|
+
* <p>The percentage of production traffic to shift in each step during a linear deployment. Valid
|
|
2037
|
+
* values are 3.0 to 100.0. The default value is 10.0.</p>
|
|
2038
|
+
* @public
|
|
2039
|
+
*/
|
|
2040
|
+
stepPercent?: number | undefined;
|
|
2041
|
+
/**
|
|
2042
|
+
* <p>The amount of time in minutes to wait between each traffic shifting step during a linear deployment. Valid values are 0 to 1440 minutes (24 hours). The default value is 6. This bake time is not applied after reaching 100% traffic.</p>
|
|
2043
|
+
* @public
|
|
2044
|
+
*/
|
|
2045
|
+
stepBakeTimeInMinutes?: number | undefined;
|
|
2046
|
+
}
|
|
2002
2047
|
/**
|
|
2003
2048
|
* @public
|
|
2004
2049
|
* @enum
|
|
2005
2050
|
*/
|
|
2006
2051
|
export declare const DeploymentStrategy: {
|
|
2007
2052
|
readonly BLUE_GREEN: "BLUE_GREEN";
|
|
2053
|
+
readonly CANARY: "CANARY";
|
|
2054
|
+
readonly LINEAR: "LINEAR";
|
|
2008
2055
|
readonly ROLLING: "ROLLING";
|
|
2009
2056
|
};
|
|
2010
2057
|
/**
|
|
@@ -2188,6 +2235,16 @@ export interface DeploymentConfiguration {
|
|
|
2188
2235
|
* @public
|
|
2189
2236
|
*/
|
|
2190
2237
|
lifecycleHooks?: DeploymentLifecycleHook[] | undefined;
|
|
2238
|
+
/**
|
|
2239
|
+
* <p>Configuration for linear deployment strategy. Only valid when the deployment strategy is <code>LINEAR</code>. This configuration enables progressive traffic shifting in equal percentage increments with configurable bake times between each step.</p>
|
|
2240
|
+
* @public
|
|
2241
|
+
*/
|
|
2242
|
+
linearConfiguration?: LinearConfiguration | undefined;
|
|
2243
|
+
/**
|
|
2244
|
+
* <p>Configuration for canary deployment strategy. Only valid when the deployment strategy is <code>CANARY</code>. This configuration enables shifting a fixed percentage of traffic for testing, followed by shifting the remaining traffic after a bake period.</p>
|
|
2245
|
+
* @public
|
|
2246
|
+
*/
|
|
2247
|
+
canaryConfiguration?: CanaryConfiguration | undefined;
|
|
2191
2248
|
}
|
|
2192
2249
|
/**
|
|
2193
2250
|
* @public
|
|
@@ -2439,7 +2496,7 @@ export interface AwsVpcConfiguration {
|
|
|
2439
2496
|
* <ul>
|
|
2440
2497
|
* <li>
|
|
2441
2498
|
* <p>When you use <code>create-service</code> or <code>update-service</code>, the
|
|
2442
|
-
* default is <code>DISABLED</code>. </p>
|
|
2499
|
+
* The default is <code>DISABLED</code>. </p>
|
|
2443
2500
|
* </li>
|
|
2444
2501
|
* <li>
|
|
2445
2502
|
* <p>When the service <code>deploymentController</code> is <code>ECS</code>, the
|
|
@@ -3611,6 +3668,11 @@ export interface CreateServiceRequest {
|
|
|
3611
3668
|
/**
|
|
3612
3669
|
* <p>The infrastructure that you run your service on. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS
|
|
3613
3670
|
* launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
3671
|
+
* <note>
|
|
3672
|
+
* <p>If you want to use Amazon ECS Managed Instances, you must use the
|
|
3673
|
+
* <code>capacityProviderStrategy</code> request parameter and omit the
|
|
3674
|
+
* <code>launchType</code> request parameter.</p>
|
|
3675
|
+
* </note>
|
|
3614
3676
|
* <p>The <code>FARGATE</code> launch type runs your tasks on Fargate On-Demand
|
|
3615
3677
|
* infrastructure.</p>
|
|
3616
3678
|
* <note>
|
|
@@ -3630,6 +3692,11 @@ export interface CreateServiceRequest {
|
|
|
3630
3692
|
launchType?: LaunchType | undefined;
|
|
3631
3693
|
/**
|
|
3632
3694
|
* <p>The capacity provider strategy to use for the service.</p>
|
|
3695
|
+
* <note>
|
|
3696
|
+
* <p>If you want to use Amazon ECS Managed Instances, you must use the
|
|
3697
|
+
* <code>capacityProviderStrategy</code> request parameter and omit the
|
|
3698
|
+
* <code>launchType</code> request parameter.</p>
|
|
3699
|
+
* </note>
|
|
3633
3700
|
* <p>If a <code>capacityProviderStrategy</code> is specified, the <code>launchType</code>
|
|
3634
3701
|
* parameter must be omitted. If no <code>capacityProviderStrategy</code> or
|
|
3635
3702
|
* <code>launchType</code> is specified, the
|
|
@@ -7790,7 +7857,7 @@ export interface TaskDefinition {
|
|
|
7790
7857
|
*/
|
|
7791
7858
|
runtimePlatform?: RuntimePlatform | undefined;
|
|
7792
7859
|
/**
|
|
7793
|
-
* <p>The task launch types the task definition was validated against. The valid values are
|
|
7860
|
+
* <p>The task launch types the task definition was validated against. The valid values are <code>MANAGED_INSTANCES</code>,
|
|
7794
7861
|
* <code>EC2</code>, <code>FARGATE</code>, and <code>EXTERNAL</code>. For more
|
|
7795
7862
|
* information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS launch types</a>
|
|
7796
7863
|
* in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
@@ -7868,7 +7935,7 @@ export interface TaskDefinition {
|
|
|
7868
7935
|
* <p>If <code>task</code> is specified, all containers within the specified
|
|
7869
7936
|
* task share the same process namespace.</p>
|
|
7870
7937
|
* <p>If no value is specified, the
|
|
7871
|
-
* default is a private namespace for each container.</p>
|
|
7938
|
+
* The default is a private namespace for each container.</p>
|
|
7872
7939
|
* <p>If the <code>host</code> PID mode is used, there's a heightened risk
|
|
7873
7940
|
* of undesired process namespace exposure.</p>
|
|
7874
7941
|
* <note>
|
|
@@ -8742,6 +8809,16 @@ export interface ServiceRevisionSummary {
|
|
|
8742
8809
|
* @public
|
|
8743
8810
|
*/
|
|
8744
8811
|
pendingTaskCount?: number | undefined;
|
|
8812
|
+
/**
|
|
8813
|
+
* <p>The percentage of test traffic that is directed to this service revision. This value represents a snapshot of the traffic distribution and may not reflect real-time changes during active deployments. Valid values are 0.0 to 100.0.</p>
|
|
8814
|
+
* @public
|
|
8815
|
+
*/
|
|
8816
|
+
requestedTestTrafficWeight?: number | undefined;
|
|
8817
|
+
/**
|
|
8818
|
+
* <p>The percentage of production traffic that is directed to this service revision. This value represents a snapshot of the traffic distribution and may not reflect real-time changes during active deployments. Valid values are 0.0 to 100.0.</p>
|
|
8819
|
+
* @public
|
|
8820
|
+
*/
|
|
8821
|
+
requestedProductionTrafficWeight?: number | undefined;
|
|
8745
8822
|
}
|
|
8746
8823
|
/**
|
|
8747
8824
|
* @public
|
|
@@ -10633,7 +10710,7 @@ export interface ListContainerInstancesRequest {
|
|
|
10633
10710
|
* <p>Filters the container instances by status. For example, if you specify the
|
|
10634
10711
|
* <code>DRAINING</code> status, the results include only container instances that have
|
|
10635
10712
|
* been set to <code>DRAINING</code> using <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateContainerInstancesState.html">UpdateContainerInstancesState</a>. If you don't specify this parameter, the
|
|
10636
|
-
* default is to include container instances set to all states other than
|
|
10713
|
+
* The default is to include container instances set to all states other than
|
|
10637
10714
|
* <code>INACTIVE</code>.</p>
|
|
10638
10715
|
* @public
|
|
10639
10716
|
*/
|
|
@@ -11278,186 +11355,6 @@ export interface ListTasksResponse {
|
|
|
11278
11355
|
*/
|
|
11279
11356
|
nextToken?: string | undefined;
|
|
11280
11357
|
}
|
|
11281
|
-
/**
|
|
11282
|
-
* @public
|
|
11283
|
-
*/
|
|
11284
|
-
export interface PutAccountSettingRequest {
|
|
11285
|
-
/**
|
|
11286
|
-
* <p>The Amazon ECS account setting name to modify.</p>
|
|
11287
|
-
* <p>The following are the valid values for the account setting name.</p>
|
|
11288
|
-
* <ul>
|
|
11289
|
-
* <li>
|
|
11290
|
-
* <p>
|
|
11291
|
-
* <code>serviceLongArnFormat</code> - When modified, the Amazon Resource Name
|
|
11292
|
-
* (ARN) and resource ID format of the resource type for a specified user, role, or
|
|
11293
|
-
* the root user for an account is affected. The opt-in and opt-out account setting
|
|
11294
|
-
* must be set for each Amazon ECS resource separately. The ARN and resource ID format
|
|
11295
|
-
* of a resource is defined by the opt-in status of the user or role that created
|
|
11296
|
-
* the resource. You must turn on this setting to use Amazon ECS features such as
|
|
11297
|
-
* resource tagging.</p>
|
|
11298
|
-
* </li>
|
|
11299
|
-
* <li>
|
|
11300
|
-
* <p>
|
|
11301
|
-
* <code>taskLongArnFormat</code> - When modified, the Amazon Resource Name (ARN)
|
|
11302
|
-
* and resource ID format of the resource type for a specified user, role, or the
|
|
11303
|
-
* root user for an account is affected. The opt-in and opt-out account setting must
|
|
11304
|
-
* be set for each Amazon ECS resource separately. The ARN and resource ID format of a
|
|
11305
|
-
* resource is defined by the opt-in status of the user or role that created the
|
|
11306
|
-
* resource. You must turn on this setting to use Amazon ECS features such as resource
|
|
11307
|
-
* tagging.</p>
|
|
11308
|
-
* </li>
|
|
11309
|
-
* <li>
|
|
11310
|
-
* <p>
|
|
11311
|
-
* <code>containerInstanceLongArnFormat</code> - When modified, the Amazon
|
|
11312
|
-
* Resource Name (ARN) and resource ID format of the resource type for a specified
|
|
11313
|
-
* user, role, or the root user for an account is affected. The opt-in and opt-out
|
|
11314
|
-
* account setting must be set for each Amazon ECS resource separately. The ARN and
|
|
11315
|
-
* resource ID format of a resource is defined by the opt-in status of the user or
|
|
11316
|
-
* role that created the resource. You must turn on this setting to use Amazon ECS
|
|
11317
|
-
* features such as resource tagging.</p>
|
|
11318
|
-
* </li>
|
|
11319
|
-
* <li>
|
|
11320
|
-
* <p>
|
|
11321
|
-
* <code>awsvpcTrunking</code> - When modified, the elastic network interface
|
|
11322
|
-
* (ENI) limit for any new container instances that support the feature is changed.
|
|
11323
|
-
* If <code>awsvpcTrunking</code> is turned on, any new container instances that
|
|
11324
|
-
* support the feature are launched have the increased ENI limits available to
|
|
11325
|
-
* them. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-eni.html">Elastic
|
|
11326
|
-
* Network Interface Trunking</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
11327
|
-
* </li>
|
|
11328
|
-
* <li>
|
|
11329
|
-
* <p>
|
|
11330
|
-
* <code>containerInsights</code> - Container Insights with enhanced
|
|
11331
|
-
* observability provides all the Container Insights metrics, plus additional task
|
|
11332
|
-
* and container metrics. This version supports enhanced observability for Amazon ECS
|
|
11333
|
-
* clusters using the Amazon EC2 and Fargate launch types. After you configure
|
|
11334
|
-
* Container Insights with enhanced observability on Amazon ECS, Container Insights
|
|
11335
|
-
* auto-collects detailed infrastructure telemetry from the cluster level down to
|
|
11336
|
-
* the container level in your environment and displays these critical performance
|
|
11337
|
-
* data in curated dashboards removing the heavy lifting in observability set-up. </p>
|
|
11338
|
-
* <p>To use Container Insights with enhanced observability, set the
|
|
11339
|
-
* <code>containerInsights</code> account setting to
|
|
11340
|
-
* <code>enhanced</code>.</p>
|
|
11341
|
-
* <p>To use Container Insights, set the <code>containerInsights</code> account
|
|
11342
|
-
* setting to <code>enabled</code>.</p>
|
|
11343
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">Monitor Amazon ECS containers using Container Insights with enhanced
|
|
11344
|
-
* observability</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
11345
|
-
* </li>
|
|
11346
|
-
* <li>
|
|
11347
|
-
* <p>
|
|
11348
|
-
* <code>dualStackIPv6</code> - When turned on, when using a VPC in dual stack
|
|
11349
|
-
* mode, your tasks using the <code>awsvpc</code> network mode can have an IPv6
|
|
11350
|
-
* address assigned. For more information on using IPv6 with tasks launched on
|
|
11351
|
-
* Amazon EC2 instances, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking-awsvpc.html#task-networking-vpc-dual-stack">Using a VPC in dual-stack mode</a>. For more information on using IPv6
|
|
11352
|
-
* with tasks launched on Fargate, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-task-networking.html#fargate-task-networking-vpc-dual-stack">Using a VPC in dual-stack mode</a>.</p>
|
|
11353
|
-
* </li>
|
|
11354
|
-
* <li>
|
|
11355
|
-
* <p>
|
|
11356
|
-
* <code>fargateTaskRetirementWaitPeriod</code> - When Amazon Web Services determines that a
|
|
11357
|
-
* security or infrastructure update is needed for an Amazon ECS task hosted on
|
|
11358
|
-
* Fargate, the tasks need to be stopped and new tasks launched to replace them.
|
|
11359
|
-
* Use <code>fargateTaskRetirementWaitPeriod</code> to configure the wait time to
|
|
11360
|
-
* retire a Fargate task. For information about the Fargate tasks maintenance,
|
|
11361
|
-
* see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html">Amazon Web Services Fargate
|
|
11362
|
-
* task maintenance</a> in the <i>Amazon ECS Developer
|
|
11363
|
-
* Guide</i>.</p>
|
|
11364
|
-
* </li>
|
|
11365
|
-
* <li>
|
|
11366
|
-
* <p>
|
|
11367
|
-
* <code>tagResourceAuthorization</code> - Amazon ECS is introducing tagging
|
|
11368
|
-
* authorization for resource creation. Users must have permissions for actions
|
|
11369
|
-
* that create the resource, such as <code>ecsCreateCluster</code>. If tags are
|
|
11370
|
-
* specified when you create a resource, Amazon Web Services performs additional authorization to
|
|
11371
|
-
* verify if users or roles have permissions to create tags. Therefore, you must
|
|
11372
|
-
* grant explicit permissions to use the <code>ecs:TagResource</code> action. For
|
|
11373
|
-
* more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/supported-iam-actions-tagging.html">Grant permission to tag resources on creation</a> in the
|
|
11374
|
-
* <i>Amazon ECS Developer Guide</i>.</p>
|
|
11375
|
-
* </li>
|
|
11376
|
-
* <li>
|
|
11377
|
-
* <p>
|
|
11378
|
-
* <code>defaultLogDriverMode</code> - Amazon ECS supports setting a default delivery
|
|
11379
|
-
* mode of log messages from a container to the <code>logDriver</code> that you specify in the container's <code>logConfiguration</code>. The delivery mode affects
|
|
11380
|
-
* application stability when the flow of logs from the container to the log driver is
|
|
11381
|
-
* interrupted. The <code>defaultLogDriverMode</code> setting supports two values:
|
|
11382
|
-
* <code>blocking</code> and <code>non-blocking</code>. If you don't specify a
|
|
11383
|
-
* delivery mode in your container definition's <code>logConfiguration</code>, the
|
|
11384
|
-
* mode you specify using this account setting will be used as the default. For
|
|
11385
|
-
* more information about log delivery modes, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html">LogConfiguration</a>.
|
|
11386
|
-
* </p>
|
|
11387
|
-
* <note>
|
|
11388
|
-
* <p>On June 25, 2025, Amazon ECS changed the default log driver mode from <code>blocking</code> to <code>non-blocking</code> to prioritize task availability over logging. To continue using the <code>blocking</code> mode after this change, do one of the following:</p>
|
|
11389
|
-
* <ul>
|
|
11390
|
-
* <li>
|
|
11391
|
-
* <p>Set the <code>mode</code> option in your container definition's <code>logConfiguration</code> as <code>blocking</code>.</p>
|
|
11392
|
-
* </li>
|
|
11393
|
-
* <li>
|
|
11394
|
-
* <p>Set the <code>defaultLogDriverMode</code> account setting to <code>blocking</code>.</p>
|
|
11395
|
-
* </li>
|
|
11396
|
-
* </ul>
|
|
11397
|
-
* </note>
|
|
11398
|
-
* </li>
|
|
11399
|
-
* <li>
|
|
11400
|
-
* <p>
|
|
11401
|
-
* <code>guardDutyActivate</code> - The <code>guardDutyActivate</code> parameter is read-only in Amazon ECS and indicates whether
|
|
11402
|
-
* Amazon ECS Runtime Monitoring is enabled or disabled by your security administrator in your
|
|
11403
|
-
* Amazon ECS account. Amazon GuardDuty controls this account setting on your behalf. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-guard-duty-integration.html">Protecting Amazon ECS workloads with Amazon ECS Runtime Monitoring</a>.</p>
|
|
11404
|
-
* </li>
|
|
11405
|
-
* </ul>
|
|
11406
|
-
* @public
|
|
11407
|
-
*/
|
|
11408
|
-
name: SettingName | undefined;
|
|
11409
|
-
/**
|
|
11410
|
-
* <p>The account setting value for the specified principal ARN. Accepted values are
|
|
11411
|
-
* <code>enabled</code>, <code>disabled</code>, <code>enhanced</code>, <code>on</code>,
|
|
11412
|
-
* and <code>off</code>.</p>
|
|
11413
|
-
* <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the
|
|
11414
|
-
* <code>name</code>, the following are the valid values:</p>
|
|
11415
|
-
* <ul>
|
|
11416
|
-
* <li>
|
|
11417
|
-
* <p>
|
|
11418
|
-
* <code>0</code> - Amazon Web Services sends the notification, and immediately retires the
|
|
11419
|
-
* affected tasks.</p>
|
|
11420
|
-
* </li>
|
|
11421
|
-
* <li>
|
|
11422
|
-
* <p>
|
|
11423
|
-
* <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to
|
|
11424
|
-
* retire the tasks.</p>
|
|
11425
|
-
* </li>
|
|
11426
|
-
* <li>
|
|
11427
|
-
* <p>
|
|
11428
|
-
* <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to
|
|
11429
|
-
* retire the tasks.</p>
|
|
11430
|
-
* </li>
|
|
11431
|
-
* </ul>
|
|
11432
|
-
* @public
|
|
11433
|
-
*/
|
|
11434
|
-
value: string | undefined;
|
|
11435
|
-
/**
|
|
11436
|
-
* <p>The ARN of the principal, which can be a user, role, or the root user. If you specify
|
|
11437
|
-
* the root user, it modifies the account setting for all users, roles, and the root user of the
|
|
11438
|
-
* account unless a user or role explicitly overrides these settings. If this field is
|
|
11439
|
-
* omitted, the setting is changed only for the authenticated user.</p>
|
|
11440
|
-
* <p>In order to use this parameter, you must be the root user, or the principal.</p>
|
|
11441
|
-
* <note>
|
|
11442
|
-
* <p>You must use the root user when you set the Fargate wait time
|
|
11443
|
-
* (<code>fargateTaskRetirementWaitPeriod</code>). </p>
|
|
11444
|
-
* <p>Federated users assume the account setting of the root user and can't have explicit
|
|
11445
|
-
* account settings set for them.</p>
|
|
11446
|
-
* </note>
|
|
11447
|
-
* @public
|
|
11448
|
-
*/
|
|
11449
|
-
principalArn?: string | undefined;
|
|
11450
|
-
}
|
|
11451
|
-
/**
|
|
11452
|
-
* @public
|
|
11453
|
-
*/
|
|
11454
|
-
export interface PutAccountSettingResponse {
|
|
11455
|
-
/**
|
|
11456
|
-
* <p>The current account setting for a resource.</p>
|
|
11457
|
-
* @public
|
|
11458
|
-
*/
|
|
11459
|
-
setting?: Setting | undefined;
|
|
11460
|
-
}
|
|
11461
11358
|
/**
|
|
11462
11359
|
* @internal
|
|
11463
11360
|
*/
|
|
@@ -1,6 +1,186 @@
|
|
|
1
1
|
import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
|
|
2
2
|
import { ECSServiceException as __BaseException } from "./ECSServiceException";
|
|
3
3
|
import { Attribute, AvailabilityZoneRebalancing, CapacityProvider, CapacityProviderStrategyItem, Cluster, ClusterConfiguration, ClusterServiceConnectDefaultsRequest, ClusterSetting, Compatibility, ContainerDefinition, ContainerInstance, ContainerInstanceStatus, DeploymentConfiguration, DeploymentController, EBSTagSpecification, EphemeralStorage, Failure, InferenceAccelerator, InstanceRequirementsRequest, IpcMode, LaunchType, LoadBalancer, ManagedAgentName, ManagedDraining, ManagedInstancesMonitoringOptions, ManagedInstancesNetworkConfiguration, ManagedInstancesStorageConfiguration, ManagedScaling, ManagedTerminationProtection, NetworkBinding, NetworkConfiguration, NetworkMode, PidMode, PlacementConstraint, PlacementStrategy, PropagateMITags, PropagateTags, ProtectedTask, ProxyConfiguration, Resource, RuntimePlatform, Scale, Service, ServiceConnectConfiguration, ServiceRegistry, ServiceVolumeConfiguration, Setting, SettingName, Tag, Task, TaskDefinition, TaskDefinitionPlacementConstraint, TaskFilesystemType, TaskOverride, TaskSet, VersionInfo, Volume, VpcLatticeConfiguration } from "./models_0";
|
|
4
|
+
/**
|
|
5
|
+
* @public
|
|
6
|
+
*/
|
|
7
|
+
export interface PutAccountSettingRequest {
|
|
8
|
+
/**
|
|
9
|
+
* <p>The Amazon ECS account setting name to modify.</p>
|
|
10
|
+
* <p>The following are the valid values for the account setting name.</p>
|
|
11
|
+
* <ul>
|
|
12
|
+
* <li>
|
|
13
|
+
* <p>
|
|
14
|
+
* <code>serviceLongArnFormat</code> - When modified, the Amazon Resource Name
|
|
15
|
+
* (ARN) and resource ID format of the resource type for a specified user, role, or
|
|
16
|
+
* the root user for an account is affected. The opt-in and opt-out account setting
|
|
17
|
+
* must be set for each Amazon ECS resource separately. The ARN and resource ID format
|
|
18
|
+
* of a resource is defined by the opt-in status of the user or role that created
|
|
19
|
+
* the resource. You must turn on this setting to use Amazon ECS features such as
|
|
20
|
+
* resource tagging.</p>
|
|
21
|
+
* </li>
|
|
22
|
+
* <li>
|
|
23
|
+
* <p>
|
|
24
|
+
* <code>taskLongArnFormat</code> - When modified, the Amazon Resource Name (ARN)
|
|
25
|
+
* and resource ID format of the resource type for a specified user, role, or the
|
|
26
|
+
* root user for an account is affected. The opt-in and opt-out account setting must
|
|
27
|
+
* be set for each Amazon ECS resource separately. The ARN and resource ID format of a
|
|
28
|
+
* resource is defined by the opt-in status of the user or role that created the
|
|
29
|
+
* resource. You must turn on this setting to use Amazon ECS features such as resource
|
|
30
|
+
* tagging.</p>
|
|
31
|
+
* </li>
|
|
32
|
+
* <li>
|
|
33
|
+
* <p>
|
|
34
|
+
* <code>containerInstanceLongArnFormat</code> - When modified, the Amazon
|
|
35
|
+
* Resource Name (ARN) and resource ID format of the resource type for a specified
|
|
36
|
+
* user, role, or the root user for an account is affected. The opt-in and opt-out
|
|
37
|
+
* account setting must be set for each Amazon ECS resource separately. The ARN and
|
|
38
|
+
* resource ID format of a resource is defined by the opt-in status of the user or
|
|
39
|
+
* role that created the resource. You must turn on this setting to use Amazon ECS
|
|
40
|
+
* features such as resource tagging.</p>
|
|
41
|
+
* </li>
|
|
42
|
+
* <li>
|
|
43
|
+
* <p>
|
|
44
|
+
* <code>awsvpcTrunking</code> - When modified, the elastic network interface
|
|
45
|
+
* (ENI) limit for any new container instances that support the feature is changed.
|
|
46
|
+
* If <code>awsvpcTrunking</code> is turned on, any new container instances that
|
|
47
|
+
* support the feature are launched have the increased ENI limits available to
|
|
48
|
+
* them. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-eni.html">Elastic
|
|
49
|
+
* Network Interface Trunking</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
50
|
+
* </li>
|
|
51
|
+
* <li>
|
|
52
|
+
* <p>
|
|
53
|
+
* <code>containerInsights</code> - Container Insights with enhanced
|
|
54
|
+
* observability provides all the Container Insights metrics, plus additional task
|
|
55
|
+
* and container metrics. This version supports enhanced observability for Amazon ECS
|
|
56
|
+
* clusters using the Amazon EC2 and Fargate launch types. After you configure
|
|
57
|
+
* Container Insights with enhanced observability on Amazon ECS, Container Insights
|
|
58
|
+
* auto-collects detailed infrastructure telemetry from the cluster level down to
|
|
59
|
+
* the container level in your environment and displays these critical performance
|
|
60
|
+
* data in curated dashboards removing the heavy lifting in observability set-up. </p>
|
|
61
|
+
* <p>To use Container Insights with enhanced observability, set the
|
|
62
|
+
* <code>containerInsights</code> account setting to
|
|
63
|
+
* <code>enhanced</code>.</p>
|
|
64
|
+
* <p>To use Container Insights, set the <code>containerInsights</code> account
|
|
65
|
+
* setting to <code>enabled</code>.</p>
|
|
66
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html">Monitor Amazon ECS containers using Container Insights with enhanced
|
|
67
|
+
* observability</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
68
|
+
* </li>
|
|
69
|
+
* <li>
|
|
70
|
+
* <p>
|
|
71
|
+
* <code>dualStackIPv6</code> - When turned on, when using a VPC in dual stack
|
|
72
|
+
* mode, your tasks using the <code>awsvpc</code> network mode can have an IPv6
|
|
73
|
+
* address assigned. For more information on using IPv6 with tasks launched on
|
|
74
|
+
* Amazon EC2 instances, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking-awsvpc.html#task-networking-vpc-dual-stack">Using a VPC in dual-stack mode</a>. For more information on using IPv6
|
|
75
|
+
* with tasks launched on Fargate, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-task-networking.html#fargate-task-networking-vpc-dual-stack">Using a VPC in dual-stack mode</a>.</p>
|
|
76
|
+
* </li>
|
|
77
|
+
* <li>
|
|
78
|
+
* <p>
|
|
79
|
+
* <code>fargateTaskRetirementWaitPeriod</code> - When Amazon Web Services determines that a
|
|
80
|
+
* security or infrastructure update is needed for an Amazon ECS task hosted on
|
|
81
|
+
* Fargate, the tasks need to be stopped and new tasks launched to replace them.
|
|
82
|
+
* Use <code>fargateTaskRetirementWaitPeriod</code> to configure the wait time to
|
|
83
|
+
* retire a Fargate task. For information about the Fargate tasks maintenance,
|
|
84
|
+
* see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html">Amazon Web Services Fargate
|
|
85
|
+
* task maintenance</a> in the <i>Amazon ECS Developer
|
|
86
|
+
* Guide</i>.</p>
|
|
87
|
+
* </li>
|
|
88
|
+
* <li>
|
|
89
|
+
* <p>
|
|
90
|
+
* <code>tagResourceAuthorization</code> - Amazon ECS is introducing tagging
|
|
91
|
+
* authorization for resource creation. Users must have permissions for actions
|
|
92
|
+
* that create the resource, such as <code>ecsCreateCluster</code>. If tags are
|
|
93
|
+
* specified when you create a resource, Amazon Web Services performs additional authorization to
|
|
94
|
+
* verify if users or roles have permissions to create tags. Therefore, you must
|
|
95
|
+
* grant explicit permissions to use the <code>ecs:TagResource</code> action. For
|
|
96
|
+
* more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/supported-iam-actions-tagging.html">Grant permission to tag resources on creation</a> in the
|
|
97
|
+
* <i>Amazon ECS Developer Guide</i>.</p>
|
|
98
|
+
* </li>
|
|
99
|
+
* <li>
|
|
100
|
+
* <p>
|
|
101
|
+
* <code>defaultLogDriverMode</code> - Amazon ECS supports setting a default delivery
|
|
102
|
+
* mode of log messages from a container to the <code>logDriver</code> that you specify in the container's <code>logConfiguration</code>. The delivery mode affects
|
|
103
|
+
* application stability when the flow of logs from the container to the log driver is
|
|
104
|
+
* interrupted. The <code>defaultLogDriverMode</code> setting supports two values:
|
|
105
|
+
* <code>blocking</code> and <code>non-blocking</code>. If you don't specify a
|
|
106
|
+
* delivery mode in your container definition's <code>logConfiguration</code>, the
|
|
107
|
+
* mode you specify using this account setting will be used as the default. For
|
|
108
|
+
* more information about log delivery modes, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html">LogConfiguration</a>.
|
|
109
|
+
* </p>
|
|
110
|
+
* <note>
|
|
111
|
+
* <p>On June 25, 2025, Amazon ECS changed the default log driver mode from <code>blocking</code> to <code>non-blocking</code> to prioritize task availability over logging. To continue using the <code>blocking</code> mode after this change, do one of the following:</p>
|
|
112
|
+
* <ul>
|
|
113
|
+
* <li>
|
|
114
|
+
* <p>Set the <code>mode</code> option in your container definition's <code>logConfiguration</code> as <code>blocking</code>.</p>
|
|
115
|
+
* </li>
|
|
116
|
+
* <li>
|
|
117
|
+
* <p>Set the <code>defaultLogDriverMode</code> account setting to <code>blocking</code>.</p>
|
|
118
|
+
* </li>
|
|
119
|
+
* </ul>
|
|
120
|
+
* </note>
|
|
121
|
+
* </li>
|
|
122
|
+
* <li>
|
|
123
|
+
* <p>
|
|
124
|
+
* <code>guardDutyActivate</code> - The <code>guardDutyActivate</code> parameter is read-only in Amazon ECS and indicates whether
|
|
125
|
+
* Amazon ECS Runtime Monitoring is enabled or disabled by your security administrator in your
|
|
126
|
+
* Amazon ECS account. Amazon GuardDuty controls this account setting on your behalf. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-guard-duty-integration.html">Protecting Amazon ECS workloads with Amazon ECS Runtime Monitoring</a>.</p>
|
|
127
|
+
* </li>
|
|
128
|
+
* </ul>
|
|
129
|
+
* @public
|
|
130
|
+
*/
|
|
131
|
+
name: SettingName | undefined;
|
|
132
|
+
/**
|
|
133
|
+
* <p>The account setting value for the specified principal ARN. Accepted values are
|
|
134
|
+
* <code>enabled</code>, <code>disabled</code>, <code>enhanced</code>, <code>on</code>,
|
|
135
|
+
* and <code>off</code>.</p>
|
|
136
|
+
* <p>When you specify <code>fargateTaskRetirementWaitPeriod</code> for the
|
|
137
|
+
* <code>name</code>, the following are the valid values:</p>
|
|
138
|
+
* <ul>
|
|
139
|
+
* <li>
|
|
140
|
+
* <p>
|
|
141
|
+
* <code>0</code> - Amazon Web Services sends the notification, and immediately retires the
|
|
142
|
+
* affected tasks.</p>
|
|
143
|
+
* </li>
|
|
144
|
+
* <li>
|
|
145
|
+
* <p>
|
|
146
|
+
* <code>7</code> - Amazon Web Services sends the notification, and waits 7 calendar days to
|
|
147
|
+
* retire the tasks.</p>
|
|
148
|
+
* </li>
|
|
149
|
+
* <li>
|
|
150
|
+
* <p>
|
|
151
|
+
* <code>14</code> - Amazon Web Services sends the notification, and waits 14 calendar days to
|
|
152
|
+
* retire the tasks.</p>
|
|
153
|
+
* </li>
|
|
154
|
+
* </ul>
|
|
155
|
+
* @public
|
|
156
|
+
*/
|
|
157
|
+
value: string | undefined;
|
|
158
|
+
/**
|
|
159
|
+
* <p>The ARN of the principal, which can be a user, role, or the root user. If you specify
|
|
160
|
+
* the root user, it modifies the account setting for all users, roles, and the root user of the
|
|
161
|
+
* account unless a user or role explicitly overrides these settings. If this field is
|
|
162
|
+
* omitted, the setting is changed only for the authenticated user.</p>
|
|
163
|
+
* <p>In order to use this parameter, you must be the root user, or the principal.</p>
|
|
164
|
+
* <note>
|
|
165
|
+
* <p>You must use the root user when you set the Fargate wait time
|
|
166
|
+
* (<code>fargateTaskRetirementWaitPeriod</code>). </p>
|
|
167
|
+
* <p>Federated users assume the account setting of the root user and can't have explicit
|
|
168
|
+
* account settings set for them.</p>
|
|
169
|
+
* </note>
|
|
170
|
+
* @public
|
|
171
|
+
*/
|
|
172
|
+
principalArn?: string | undefined;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* @public
|
|
176
|
+
*/
|
|
177
|
+
export interface PutAccountSettingResponse {
|
|
178
|
+
/**
|
|
179
|
+
* <p>The current account setting for a resource.</p>
|
|
180
|
+
* @public
|
|
181
|
+
*/
|
|
182
|
+
setting?: Setting | undefined;
|
|
183
|
+
}
|
|
4
184
|
/**
|
|
5
185
|
* @public
|
|
6
186
|
*/
|
|
@@ -603,7 +783,7 @@ export interface RegisterTaskDefinitionRequest {
|
|
|
603
783
|
* <p>If <code>task</code> is specified, all containers within the specified
|
|
604
784
|
* task share the same process namespace.</p>
|
|
605
785
|
* <p>If no value is specified, the
|
|
606
|
-
* default is a private namespace for each container.</p>
|
|
786
|
+
* The default is a private namespace for each container.</p>
|
|
607
787
|
* <p>If the <code>host</code> PID mode is used, there's a heightened risk
|
|
608
788
|
* of undesired process namespace exposure.</p>
|
|
609
789
|
* <note>
|
|
@@ -718,7 +898,7 @@ export interface RegisterTaskDefinitionResponse {
|
|
|
718
898
|
}
|
|
719
899
|
/**
|
|
720
900
|
* <p>Your Amazon Web Services account was blocked. For more information, contact <a href="http://aws.amazon.com/contact-us/">
|
|
721
|
-
* Amazon Web
|
|
901
|
+
* Amazon Web ServicesSupport</a>.</p>
|
|
722
902
|
* @public
|
|
723
903
|
*/
|
|
724
904
|
export declare class BlockedException extends __BaseException {
|
|
@@ -973,6 +1153,11 @@ export interface TaskVolumeConfiguration {
|
|
|
973
1153
|
export interface RunTaskRequest {
|
|
974
1154
|
/**
|
|
975
1155
|
* <p>The capacity provider strategy to use for the task.</p>
|
|
1156
|
+
* <note>
|
|
1157
|
+
* <p>If you want to use Amazon ECS Managed Instances, you must use the
|
|
1158
|
+
* <code>capacityProviderStrategy</code> request parameter and omit the
|
|
1159
|
+
* <code>launchType</code> request parameter.</p>
|
|
1160
|
+
* </note>
|
|
976
1161
|
* <p>If a <code>capacityProviderStrategy</code> is specified, the <code>launchType</code>
|
|
977
1162
|
* parameter must be omitted. If no <code>capacityProviderStrategy</code> or
|
|
978
1163
|
* <code>launchType</code> is specified, the
|
|
@@ -1022,6 +1207,11 @@ export interface RunTaskRequest {
|
|
|
1022
1207
|
/**
|
|
1023
1208
|
* <p>The infrastructure to run your standalone task on. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS
|
|
1024
1209
|
* launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
1210
|
+
* <note>
|
|
1211
|
+
* <p>If you want to use Amazon ECS Managed Instances, you must use the
|
|
1212
|
+
* <code>capacityProviderStrategy</code> request parameter and omit the
|
|
1213
|
+
* <code>launchType</code> request parameter.</p>
|
|
1214
|
+
* </note>
|
|
1025
1215
|
* <p>The <code>FARGATE</code> launch type runs your tasks on Fargate On-Demand
|
|
1026
1216
|
* infrastructure.</p>
|
|
1027
1217
|
* <note>
|
|
@@ -2085,6 +2275,10 @@ export interface UpdateServiceRequest {
|
|
|
2085
2275
|
/**
|
|
2086
2276
|
* <p>The details of a capacity provider strategy. You can set a capacity provider when you
|
|
2087
2277
|
* create a cluster, run a task, or update a service.</p>
|
|
2278
|
+
* <note>
|
|
2279
|
+
* <p>If you want to use Amazon ECS Managed Instances, you must use the
|
|
2280
|
+
* <code>capacityProviderStrategy</code> request parameter.</p>
|
|
2281
|
+
* </note>
|
|
2088
2282
|
* <p>When you use Fargate, the capacity providers are <code>FARGATE</code> or
|
|
2089
2283
|
* <code>FARGATE_SPOT</code>.</p>
|
|
2090
2284
|
* <p>When you use Amazon EC2, the capacity providers are Auto Scaling groups.</p>
|
|
@@ -430,6 +430,10 @@ export interface DeploymentAlarms {
|
|
|
430
430
|
rollback: boolean | undefined;
|
|
431
431
|
enable: boolean | undefined;
|
|
432
432
|
}
|
|
433
|
+
export interface CanaryConfiguration {
|
|
434
|
+
canaryPercent?: number | undefined;
|
|
435
|
+
canaryBakeTimeInMinutes?: number | undefined;
|
|
436
|
+
}
|
|
433
437
|
export interface DeploymentCircuitBreaker {
|
|
434
438
|
enable: boolean | undefined;
|
|
435
439
|
rollback: boolean | undefined;
|
|
@@ -451,8 +455,14 @@ export interface DeploymentLifecycleHook {
|
|
|
451
455
|
lifecycleStages?: DeploymentLifecycleHookStage[] | undefined;
|
|
452
456
|
hookDetails?: __DocumentType | undefined;
|
|
453
457
|
}
|
|
458
|
+
export interface LinearConfiguration {
|
|
459
|
+
stepPercent?: number | undefined;
|
|
460
|
+
stepBakeTimeInMinutes?: number | undefined;
|
|
461
|
+
}
|
|
454
462
|
export declare const DeploymentStrategy: {
|
|
455
463
|
readonly BLUE_GREEN: "BLUE_GREEN";
|
|
464
|
+
readonly CANARY: "CANARY";
|
|
465
|
+
readonly LINEAR: "LINEAR";
|
|
456
466
|
readonly ROLLING: "ROLLING";
|
|
457
467
|
};
|
|
458
468
|
export type DeploymentStrategy =
|
|
@@ -465,6 +475,8 @@ export interface DeploymentConfiguration {
|
|
|
465
475
|
strategy?: DeploymentStrategy | undefined;
|
|
466
476
|
bakeTimeInMinutes?: number | undefined;
|
|
467
477
|
lifecycleHooks?: DeploymentLifecycleHook[] | undefined;
|
|
478
|
+
linearConfiguration?: LinearConfiguration | undefined;
|
|
479
|
+
canaryConfiguration?: CanaryConfiguration | undefined;
|
|
468
480
|
}
|
|
469
481
|
export declare const DeploymentControllerType: {
|
|
470
482
|
readonly CODE_DEPLOY: "CODE_DEPLOY";
|
|
@@ -1506,6 +1518,8 @@ export interface ServiceRevisionSummary {
|
|
|
1506
1518
|
requestedTaskCount?: number | undefined;
|
|
1507
1519
|
runningTaskCount?: number | undefined;
|
|
1508
1520
|
pendingTaskCount?: number | undefined;
|
|
1521
|
+
requestedTestTrafficWeight?: number | undefined;
|
|
1522
|
+
requestedProductionTrafficWeight?: number | undefined;
|
|
1509
1523
|
}
|
|
1510
1524
|
export declare const ServiceDeploymentStatus: {
|
|
1511
1525
|
readonly IN_PROGRESS: "IN_PROGRESS";
|
|
@@ -1980,14 +1994,6 @@ export interface ListTasksResponse {
|
|
|
1980
1994
|
taskArns?: string[] | undefined;
|
|
1981
1995
|
nextToken?: string | undefined;
|
|
1982
1996
|
}
|
|
1983
|
-
export interface PutAccountSettingRequest {
|
|
1984
|
-
name: SettingName | undefined;
|
|
1985
|
-
value: string | undefined;
|
|
1986
|
-
principalArn?: string | undefined;
|
|
1987
|
-
}
|
|
1988
|
-
export interface PutAccountSettingResponse {
|
|
1989
|
-
setting?: Setting | undefined;
|
|
1990
|
-
}
|
|
1991
1997
|
export declare const SessionFilterSensitiveLog: (obj: Session) => any;
|
|
1992
1998
|
export declare const ExecuteCommandResponseFilterSensitiveLog: (
|
|
1993
1999
|
obj: ExecuteCommandResponse
|
|
@@ -60,6 +60,14 @@ import {
|
|
|
60
60
|
Volume,
|
|
61
61
|
VpcLatticeConfiguration,
|
|
62
62
|
} from "./models_0";
|
|
63
|
+
export interface PutAccountSettingRequest {
|
|
64
|
+
name: SettingName | undefined;
|
|
65
|
+
value: string | undefined;
|
|
66
|
+
principalArn?: string | undefined;
|
|
67
|
+
}
|
|
68
|
+
export interface PutAccountSettingResponse {
|
|
69
|
+
setting?: Setting | undefined;
|
|
70
|
+
}
|
|
63
71
|
export interface PutAccountSettingDefaultRequest {
|
|
64
72
|
name: SettingName | undefined;
|
|
65
73
|
value: string | undefined;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aws-sdk/client-ecs",
|
|
3
3
|
"description": "AWS SDK for JavaScript Ecs Client for Node.js, Browser and React Native",
|
|
4
|
-
"version": "3.
|
|
4
|
+
"version": "3.919.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-ecs",
|
|
@@ -21,10 +21,10 @@
|
|
|
21
21
|
"@aws-crypto/sha256-browser": "5.2.0",
|
|
22
22
|
"@aws-crypto/sha256-js": "5.2.0",
|
|
23
23
|
"@aws-sdk/core": "3.916.0",
|
|
24
|
-
"@aws-sdk/credential-provider-node": "3.
|
|
24
|
+
"@aws-sdk/credential-provider-node": "3.919.0",
|
|
25
25
|
"@aws-sdk/middleware-host-header": "3.914.0",
|
|
26
26
|
"@aws-sdk/middleware-logger": "3.914.0",
|
|
27
|
-
"@aws-sdk/middleware-recursion-detection": "3.
|
|
27
|
+
"@aws-sdk/middleware-recursion-detection": "3.919.0",
|
|
28
28
|
"@aws-sdk/middleware-user-agent": "3.916.0",
|
|
29
29
|
"@aws-sdk/region-config-resolver": "3.914.0",
|
|
30
30
|
"@aws-sdk/types": "3.914.0",
|