@aws-sdk/client-ecs 3.1070.0 → 3.1072.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.
@@ -3025,7 +3025,7 @@ export interface ListDaemonDeploymentsResponse {
3025
3025
  */
3026
3026
  export interface ListDaemonsRequest {
3027
3027
  /**
3028
- * <p>The Amazon Resource Name (ARN) of the cluster to filter daemons by. If not specified, daemons from all clusters are returned.</p>
3028
+ * <p>The Amazon Resource Name (ARN) of the cluster to filter daemons by. If you do not specify a cluster, the default cluster is assumed.</p>
3029
3029
  * @public
3030
3030
  */
3031
3031
  clusterArn?: string | undefined;
@@ -3822,12 +3822,12 @@ export interface DaemonTaskDefinition {
3822
3822
  */
3823
3823
  registeredBy?: string | undefined;
3824
3824
  /**
3825
- * <p>The process namespace mode for the daemon. A value of <code>shared</code> means the daemon shares the PID namespace with co-located tasks, giving it visibility into application processes. A value of <code>none</code> means the daemon has its own isolated PID namespace.</p>
3825
+ * <p>The PID namespace mode for the daemon. The valid values are <code>none</code> and <code>shared</code>. The default is <code>none</code>.</p> <p>If <code>none</code> is specified or no value is provided, the daemon runs with its own PID namespace, isolated from other tasks. If <code>shared</code> is specified, the daemon joins the host PID namespace, making it accessible to non-daemon tasks that use <code>pidMode: "host"</code> or other daemons that use <code>pidMode: "shared"</code>.</p>
3826
3826
  * @public
3827
3827
  */
3828
3828
  pidMode?: DaemonPidMode | undefined;
3829
3829
  /**
3830
- * <p>The IPC namespace mode for the daemon. A value of <code>shared</code> means the daemon shares the IPC namespace with co-located tasks, allowing communication through POSIX shared memory, semaphores, and message queues. A value of <code>none</code> means the daemon has its own isolated IPC namespace.</p>
3830
+ * <p>The IPC namespace mode for the daemon. The valid values are <code>none</code> and <code>shared</code>. The default is <code>none</code>.</p> <p>If <code>none</code> is specified or no value is provided, the daemon runs with its own IPC namespace, isolated from other tasks. If <code>shared</code> is specified, the daemon joins the host IPC namespace, making it accessible to non-daemon tasks that use <code>ipcMode: "host"</code> or other daemons that use <code>ipcMode: "shared"</code>.</p>
3831
3831
  * @public
3832
3832
  */
3833
3833
  ipcMode?: DaemonIpcMode | undefined;
@@ -3973,12 +3973,12 @@ export interface RegisterDaemonTaskDefinitionRequest {
3973
3973
  */
3974
3974
  tags?: Tag[] | undefined;
3975
3975
  /**
3976
- * <p>The process namespace mode for the daemon. When set to <code>shared</code>, the daemon shares the PID namespace with co-located tasks on the same container instance, giving the daemon visibility into application processes. When set to <code>none</code>, the daemon gets its own isolated PID namespace. The default is <code>none</code>.</p>
3976
+ * <p>The PID namespace mode for the daemon. The valid values are <code>none</code> and <code>shared</code>. The default is <code>none</code>.</p> <p>If <code>none</code> is specified or no value is provided, the daemon runs with its own PID namespace, isolated from other tasks. If <code>shared</code> is specified, the daemon joins the host PID namespace, making it accessible to non-daemon tasks that use <code>pidMode: "host"</code> or other daemons that use <code>pidMode: "shared"</code>.</p>
3977
3977
  * @public
3978
3978
  */
3979
3979
  pidMode?: DaemonPidMode | undefined;
3980
3980
  /**
3981
- * <p>The IPC namespace mode for the daemon. When set to <code>shared</code>, the daemon shares the IPC namespace with co-located tasks on the same container instance, allowing communication through POSIX shared memory, semaphores, and message queues. When set to <code>none</code>, the daemon gets its own isolated IPC namespace. The default is <code>none</code>.</p>
3981
+ * <p>The IPC namespace mode for the daemon. The valid values are <code>none</code> and <code>shared</code>. The default is <code>none</code>.</p> <p>If <code>none</code> is specified or no value is provided, the daemon runs with its own IPC namespace, isolated from other tasks. If <code>shared</code> is specified, the daemon joins the host IPC namespace, making it accessible to non-daemon tasks that use <code>ipcMode: "host"</code> or other daemons that use <code>ipcMode: "shared"</code>.</p>
3982
3982
  * @public
3983
3983
  */
3984
3984
  ipcMode?: DaemonIpcMode | undefined;
@@ -5191,18 +5191,18 @@ export interface DeploymentCircuitBreaker {
5191
5191
  */
5192
5192
  export interface DeploymentLifecycleHookTimeoutConfiguration {
5193
5193
  /**
5194
- * <p>The number of minutes Amazon ECS waits for the lifecycle hook to complete before taking the timeout action.</p>
5194
+ * <p>The number of minutes Amazon ECS waits for the lifecycle hook to complete before taking the timeout action.</p> <p>Default: 1440 (24 hours)</p>
5195
5195
  * @public
5196
5196
  */
5197
5197
  timeoutInMinutes?: number | undefined;
5198
5198
  /**
5199
- * <p>The action Amazon ECS takes when the lifecycle hook times out. Valid values are:</p> <ul> <li> <p> <code>CONTINUE</code> - Proceeds the deployment to the next lifecycle stage.</p> </li> <li> <p> <code>ROLLBACK</code> - Rolls back the deployment to the previous service revision.</p> </li> </ul>
5199
+ * <p>The action Amazon ECS takes when the lifecycle hook times out. Valid values are:</p> <ul> <li> <p> <code>CONTINUE</code> - Proceeds the deployment to the next lifecycle stage.</p> </li> <li> <p> <code>ROLLBACK</code> - Rolls back the deployment to the previous service revision.</p> </li> </ul> <p>Default: <code>ROLLBACK</code> </p>
5200
5200
  * @public
5201
5201
  */
5202
5202
  action?: DeploymentLifecycleHookAction | undefined;
5203
5203
  }
5204
5204
  /**
5205
- * <p>A deployment lifecycle hook runs custom logic at specific stages of the deployment process. Currently, you can use Lambda functions as hook targets.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html">Lifecycle hooks for Amazon ECS service deployments</a> in the <i> Amazon Elastic Container Service Developer Guide</i>.</p>
5205
+ * <p>A deployment lifecycle hook runs custom logic or pauses the deployment at specific stages of the deployment process. You can use Lambda functions or pause hooks as hook targets.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html">Lifecycle hooks for Amazon ECS service deployments</a> in the <i> Amazon Elastic Container Service Developer Guide</i>.</p>
5206
5206
  * @public
5207
5207
  */
5208
5208
  export interface DeploymentLifecycleHook {
@@ -5212,7 +5212,7 @@ export interface DeploymentLifecycleHook {
5212
5212
  */
5213
5213
  targetType?: DeploymentLifecycleHookTargetType | undefined;
5214
5214
  /**
5215
- * <p>The Amazon Resource Name (ARN) of the hook target. Currently, only Lambda function ARNs are supported.</p> <p>You must provide this parameter when configuring a deployment lifecycle hook.</p>
5215
+ * <p>The Amazon Resource Name (ARN) of the hook target. For <code>AWS_LAMBDA</code> hooks, this is the Lambda function ARN. This field is not applicable for <code>PAUSE</code> hooks.</p> <p>You must provide this parameter when configuring an <code>AWS_LAMBDA</code> lifecycle hook.</p>
5216
5216
  * @public
5217
5217
  */
5218
5218
  hookTargetArn?: string | undefined;
@@ -5222,12 +5222,12 @@ export interface DeploymentLifecycleHook {
5222
5222
  */
5223
5223
  roleArn?: string | undefined;
5224
5224
  /**
5225
- * <p>The lifecycle stages at which to run the hook. Choose from these valid values:</p> <ul> <li> <p>RECONCILE_SERVICE</p> <p>The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>PRE_SCALE_UP</p> <p>The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_SCALE_UP</p> <p>The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>TEST_TRAFFIC_SHIFT</p> <p>The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_TEST_TRAFFIC_SHIFT</p> <p>The test traffic shift is complete. The green service revision handles 100% of the test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>PRODUCTION_TRAFFIC_SHIFT</p> <p>Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_PRODUCTION_TRAFFIC_SHIFT</p> <p>The production traffic shift is complete.</p> <p>You can use a lifecycle hook for this stage.</p> </li> </ul> <p>You must provide this parameter when configuring a deployment lifecycle hook.</p>
5225
+ * <p>The lifecycle stages at which to run the hook. Choose from these valid values:</p> <ul> <li> <p>RECONCILE_SERVICE</p> <p>The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>PRE_SCALE_UP</p> <p>The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_SCALE_UP</p> <p>The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>TEST_TRAFFIC_SHIFT</p> <p>The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_TEST_TRAFFIC_SHIFT</p> <p>The test traffic shift is complete. The green service revision handles 100% of the test traffic.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>PRE_PRODUCTION_TRAFFIC_SHIFT</p> <p>Occurs before production traffic shift. For linear and canary deployments, this stage is invoked before every traffic shift step.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>PRODUCTION_TRAFFIC_SHIFT</p> <p>Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic. For linear and canary deployments, this stage is invoked at every traffic shift step.</p> <p>You can use a lifecycle hook for this stage.</p> </li> <li> <p>POST_PRODUCTION_TRAFFIC_SHIFT</p> <p>The production traffic shift is complete.</p> <p>You can use a lifecycle hook for this stage.</p> </li> </ul> <note> <p> <code>PAUSE</code> hooks cannot be configured at <code>TEST_TRAFFIC_SHIFT</code> or <code>PRODUCTION_TRAFFIC_SHIFT</code> stages. These stages are only valid for <code>AWS_LAMBDA</code> hooks.</p> </note> <p>You must provide this parameter when configuring a deployment lifecycle hook.</p>
5226
5226
  * @public
5227
5227
  */
5228
5228
  lifecycleStages?: DeploymentLifecycleHookStage[] | undefined;
5229
5229
  /**
5230
- * <p>Use this field to specify custom parameters that Amazon ECS will pass to your hook target invocations (such as a Lambda function).</p>
5230
+ * <p>Use this field to specify custom parameters that Amazon ECS passes to your Lambda function on each invocation. This field is not used for <code>PAUSE</code> hooks.</p>
5231
5231
  * @public
5232
5232
  */
5233
5233
  hookDetails?: __DocumentType | undefined;
@@ -5289,7 +5289,7 @@ export interface DeploymentConfiguration {
5289
5289
  */
5290
5290
  bakeTimeInMinutes?: number | undefined;
5291
5291
  /**
5292
- * <p>An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle.</p>
5292
+ * <p>An array of deployment lifecycle hook objects to run custom logic or pause the deployment at specific stages of the deployment lifecycle.</p>
5293
5293
  * @public
5294
5294
  */
5295
5295
  lifecycleHooks?: DeploymentLifecycleHook[] | undefined;
@@ -5325,7 +5325,7 @@ export interface DeploymentLifecycleHookDetail {
5325
5325
  */
5326
5326
  targetArn?: string | undefined;
5327
5327
  /**
5328
- * <p>The status of the lifecycle hook. Valid values depend on the hook type:</p> <ul> <li> <p>For <code>AWS_LAMBDA</code> hooks: <code>IN_PROGRESS</code>, <code>SUCCEEDED</code>, <code>FAILED</code>, and <code>TIMED_OUT</code>.</p> </li> <li> <p>For <code>PAUSE</code> hooks: <code>AWAITING_ACTION</code>, <code>SUCCEEDED</code>, <code>FAILED</code>, and <code>TIMED_OUT</code>.</p> </li> </ul>
5328
+ * <p>The status of the lifecycle hook. Valid values include <code>AWAITING_ACTION</code>, <code>IN_PROGRESS</code>, <code>SUCCEEDED</code>, <code>FAILED</code>, and <code>TIMED_OUT</code>.</p>
5329
5329
  * @public
5330
5330
  */
5331
5331
  status?: DeploymentLifecycleHookStatus | undefined;
@@ -5463,7 +5463,7 @@ export interface ServiceDeployment {
5463
5463
  */
5464
5464
  statusReason?: string | undefined;
5465
5465
  /**
5466
- * <p>The current lifecycle stage of the deployment. Possible values include:</p> <ul> <li> <p>RECONCILE_SERVICE</p> <p>The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state.</p> </li> <li> <p>PRE_SCALE_UP</p> <p>The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> </li> <li> <p>SCALE_UP</p> <p>The stage when the green service revision scales up to 100% and launches new tasks. The green service revision is not serving any traffic at this point.</p> </li> <li> <p>POST_SCALE_UP</p> <p>The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> </li> <li> <p>TEST_TRAFFIC_SHIFT</p> <p>The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic.</p> </li> <li> <p>POST_TEST_TRAFFIC_SHIFT</p> <p>The test traffic shift is complete. The green service revision handles 100% of the test traffic.</p> </li> <li> <p>PRODUCTION_TRAFFIC_SHIFT</p> <p>Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic.</p> </li> <li> <p>POST_PRODUCTION_TRAFFIC_SHIFT</p> <p>The production traffic shift is complete.</p> </li> <li> <p>BAKE_TIME</p> <p>The stage when both blue and green service revisions are running simultaneously after the production traffic has shifted.</p> </li> <li> <p>CLEAN_UP</p> <p>The stage when the blue service revision has completely scaled down to 0 running tasks. The green service revision is now the production service revision after this stage.</p> </li> </ul>
5466
+ * <p>The current lifecycle stage of the deployment. Possible values include:</p> <ul> <li> <p>RECONCILE_SERVICE</p> <p>The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state.</p> </li> <li> <p>PRE_SCALE_UP</p> <p>The green service revision has not started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> </li> <li> <p>SCALE_UP</p> <p>The stage when the green service revision scales up to 100% and launches new tasks. The green service revision is not serving any traffic at this point.</p> </li> <li> <p>POST_SCALE_UP</p> <p>The green service revision has started. The blue service revision is handling 100% of the production traffic. There is no test traffic.</p> </li> <li> <p>TEST_TRAFFIC_SHIFT</p> <p>The blue and green service revisions are running. The blue service revision handles 100% of the production traffic. The green service revision is migrating from 0% to 100% of test traffic.</p> </li> <li> <p>POST_TEST_TRAFFIC_SHIFT</p> <p>The test traffic shift is complete. The green service revision handles 100% of the test traffic.</p> </li> <li> <p>PRE_PRODUCTION_TRAFFIC_SHIFT</p> <p>Occurs before production traffic shift. For linear and canary deployments, this stage is invoked before every traffic shift step.</p> </li> <li> <p>PRODUCTION_TRAFFIC_SHIFT</p> <p>Production traffic is shifting to the green service revision. The green service revision is migrating from 0% to 100% of production traffic. For linear and canary deployments, this stage is invoked at every traffic shift step.</p> </li> <li> <p>POST_PRODUCTION_TRAFFIC_SHIFT</p> <p>The production traffic shift is complete.</p> </li> <li> <p>BAKE_TIME</p> <p>The stage when both blue and green service revisions are running simultaneously after the production traffic has shifted.</p> </li> <li> <p>CLEAN_UP</p> <p>The stage when the blue service revision has completely scaled down to 0 running tasks. The green service revision is now the production service revision after this stage.</p> </li> </ul>
5467
5467
  * @public
5468
5468
  */
5469
5469
  lifecycleStage?: ServiceDeploymentLifecycleStage | undefined;
@@ -5626,7 +5626,7 @@ export interface CreateExpressGatewayServiceRequest {
5626
5626
  * <p>The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make Amazon Web Services API calls on your behalf. This role is required for Amazon ECS to pull container images from Amazon ECR, send container logs to Amazon CloudWatch Logs, and retrieve sensitive data from Amazon Web Services Systems Manager Parameter Store or Amazon Web Services Secrets Manager.</p> <p>The execution role must include the <code>AmazonECSTaskExecutionRolePolicy</code> managed policy or equivalent permissions. For Express services, this role is used during task startup and runtime for container management operations.</p>
5627
5627
  * @public
5628
5628
  */
5629
- executionRoleArn: string | undefined;
5629
+ executionRoleArn?: string | undefined;
5630
5630
  /**
5631
5631
  * <p>The Amazon Resource Name (ARN) of the infrastructure role that grants Amazon ECS permission to create and manage Amazon Web Services resources on your behalf for the Express service. This role is used to provision and manage Application Load Balancers, target groups, security groups, auto-scaling policies, and other Amazon Web Services infrastructure components.</p> <p>The infrastructure role must include permissions for Elastic Load Balancing, Application Auto Scaling, Amazon EC2 (for security groups), and other services required for managed infrastructure. This role is only used during Express service creation, updates, and deletion operations.</p>
5632
5632
  * @public
@@ -5651,7 +5651,7 @@ export interface CreateExpressGatewayServiceRequest {
5651
5651
  * <p>The primary container configuration for the Express service. This defines the main application container that will receive traffic from the Application Load Balancer.</p> <p>The primary container must specify at minimum a container image. You can also configure the container port (defaults to 80), logging configuration, environment variables, secrets, and startup commands. The container image can be from Amazon ECR, Docker Hub, or any other container registry accessible to your execution role.</p>
5652
5652
  * @public
5653
5653
  */
5654
- primaryContainer: ExpressGatewayContainer | undefined;
5654
+ primaryContainer?: ExpressGatewayContainer | undefined;
5655
5655
  /**
5656
5656
  * <p>The Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. This role allows your application code to access other Amazon Web Services services securely.</p> <p>The task role is different from the execution role. While the execution role is used by the Amazon ECS agent to set up the task, the task role is used by your application code running inside the container to make Amazon Web Services API calls. If your application doesn't need to access Amazon Web Services services, you can omit this parameter.</p>
5657
5657
  * @public
@@ -5682,6 +5682,11 @@ export interface CreateExpressGatewayServiceRequest {
5682
5682
  * @public
5683
5683
  */
5684
5684
  tags?: Tag[] | undefined;
5685
+ /**
5686
+ * <p>The Amazon Resource Name (ARN) of a task definition to use to create the Express Gateway service. This allows you to manage your own task definition, giving you more control over the service configuration such as adding sidecar containers.</p> <p>The task definition must have a container named <code>Main</code> with a single TCP port mapping that includes a container port and port name. The task definition must also have <code>FARGATE</code> compatibility.</p> <p>If you provide a task definition ARN, you cannot also specify <code>primaryContainer</code>, <code>executionRoleArn</code>, <code>taskRoleArn</code>, <code>cpu</code>, or <code>memory</code>.</p>
5687
+ * @public
5688
+ */
5689
+ taskDefinitionArn?: string | undefined;
5685
5690
  }
5686
5691
  /**
5687
5692
  * <p>The entry point into an Express service.</p>
@@ -5719,6 +5724,11 @@ export interface ExpressGatewayServiceConfiguration {
5719
5724
  * @public
5720
5725
  */
5721
5726
  taskRoleArn?: string | undefined;
5727
+ /**
5728
+ * <p>The ARN of the task definition used by this service revision. This is present for all Express services and reflects the task definition in use, whether managed by Amazon ECS or provided by the customer.</p>
5729
+ * @public
5730
+ */
5731
+ taskDefinitionArn?: string | undefined;
5722
5732
  /**
5723
5733
  * <p>The CPU allocation for tasks in this service revision.</p>
5724
5734
  * @public
@@ -5884,6 +5894,33 @@ export interface LoadBalancer {
5884
5894
  */
5885
5895
  advancedConfiguration?: AdvancedConfiguration | undefined;
5886
5896
  }
5897
+ /**
5898
+ * <p>The configuration for a specific set of metrics to collect for a service.</p>
5899
+ * @public
5900
+ */
5901
+ export interface MetricConfiguration {
5902
+ /**
5903
+ * <p>The list of metric names to configure. The supported metric names are <code>CPUUtilization</code> and <code>MemoryUtilization</code>.</p>
5904
+ * @public
5905
+ */
5906
+ metricNames: string[] | undefined;
5907
+ /**
5908
+ * <p>The resolution, in seconds, at which to collect the metrics. The valid values are <code>20</code> and <code>60</code>.</p>
5909
+ * @public
5910
+ */
5911
+ resolutionSeconds: number | undefined;
5912
+ }
5913
+ /**
5914
+ * <p>The optional monitoring configuration for a service, which defines the resolution for the service-level <code>CPUUtilization</code> and <code>MemoryUtilization</code> Amazon CloudWatch metrics. When not specified, Amazon ECS uses the default resolution of <code>60</code> seconds.</p>
5915
+ * @public
5916
+ */
5917
+ export interface MonitoringConfiguration {
5918
+ /**
5919
+ * <p>The list of metric configurations for the service monitoring.</p>
5920
+ * @public
5921
+ */
5922
+ metricConfigurations?: MetricConfiguration[] | undefined;
5923
+ }
5887
5924
  /**
5888
5925
  * <p>An object representing the networking details for a task or service. For example <code>awsVpcConfiguration=\{subnets=["subnet-12344321"],securityGroups=["sg-12344321"]\}</code>.</p>
5889
5926
  * @public
@@ -6418,6 +6455,11 @@ export interface CreateServiceRequest {
6418
6455
  * @public
6419
6456
  */
6420
6457
  vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
6458
+ /**
6459
+ * <p>The optional monitoring configuration for the service, which defines the resolution for the service-level <code>CPUUtilization</code> and <code>MemoryUtilization</code> Amazon CloudWatch metrics. When not specified, Amazon ECS uses the default resolution of <code>60</code> seconds.</p>
6460
+ * @public
6461
+ */
6462
+ monitoring?: MonitoringConfiguration | undefined;
6421
6463
  }
6422
6464
  /**
6423
6465
  * <p>The summary of the current service revision configuration</p>
@@ -7284,6 +7326,11 @@ export interface UpdateExpressGatewayServiceRequest {
7284
7326
  * @public
7285
7327
  */
7286
7328
  scalingTarget?: ExpressGatewayScalingTarget | undefined;
7329
+ /**
7330
+ * <p>The Amazon Resource Name (ARN) of a task definition to use to update the Express Gateway service. This allows you to manage your own task definition, giving you more control over the service configuration such as adding sidecar containers.</p> <p>The task definition must have a container named <code>Main</code> with a single TCP port mapping that includes a container port and port name. The task definition must also have <code>FARGATE</code> compatibility.</p> <p>If you provide a task definition ARN, you cannot also specify <code>primaryContainer</code>, <code>taskRoleArn</code>, <code>cpu</code>, or <code>memory</code>.</p>
7331
+ * @public
7332
+ */
7333
+ taskDefinitionArn?: string | undefined;
7287
7334
  }
7288
7335
  /**
7289
7336
  * <p>An object that describes an Express service to be updated.</p>
@@ -7451,6 +7498,11 @@ export interface UpdateServiceRequest {
7451
7498
  * @public
7452
7499
  */
7453
7500
  vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
7501
+ /**
7502
+ * <p>The optional monitoring configuration for the service, which defines the resolution for the service-level <code>CPUUtilization</code> and <code>MemoryUtilization</code> Amazon CloudWatch metrics. When not specified, Amazon ECS uses the default resolution of <code>60</code> seconds.</p>
7503
+ * @public
7504
+ */
7505
+ monitoring?: MonitoringConfiguration | undefined;
7454
7506
  }
7455
7507
  /**
7456
7508
  *
@@ -7958,120 +8010,3 @@ export interface ServiceRevisionLoadBalancer {
7958
8010
  */
7959
8011
  productionListenerRule?: string | undefined;
7960
8012
  }
7961
- /**
7962
- * <p>The resolved configuration for a service revision, which contains the actual resources your service revision uses, such as which target groups serve traffic.</p>
7963
- * @public
7964
- */
7965
- export interface ResolvedConfiguration {
7966
- /**
7967
- * <p>The resolved load balancer configuration for the service revision. This includes information about which target groups serve traffic and which listener rules direct traffic to them.</p>
7968
- * @public
7969
- */
7970
- loadBalancers?: ServiceRevisionLoadBalancer[] | undefined;
7971
- }
7972
- /**
7973
- * <p>Information about the service revision.</p> <p>A service revision contains a record of the workload configuration Amazon ECS is attempting to deploy. Whenever you create or deploy a service, Amazon ECS automatically creates and captures the configuration that you're trying to deploy in the service revision. For information about service revisions, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html">Amazon ECS service revisions</a> in the <i> <i>Amazon Elastic Container Service Developer Guide</i> </i>.</p>
7974
- * @public
7975
- */
7976
- export interface ServiceRevision {
7977
- /**
7978
- * <p>The ARN of the service revision.</p>
7979
- * @public
7980
- */
7981
- serviceRevisionArn?: string | undefined;
7982
- /**
7983
- * <p>The ARN of the service for the service revision.</p>
7984
- * @public
7985
- */
7986
- serviceArn?: string | undefined;
7987
- /**
7988
- * <p>The ARN of the cluster that hosts the service.</p>
7989
- * @public
7990
- */
7991
- clusterArn?: string | undefined;
7992
- /**
7993
- * <p>The task definition the service revision uses.</p>
7994
- * @public
7995
- */
7996
- taskDefinition?: string | undefined;
7997
- /**
7998
- * <p>The capacity provider strategy the service revision uses.</p>
7999
- * @public
8000
- */
8001
- capacityProviderStrategy?: CapacityProviderStrategyItem[] | undefined;
8002
- /**
8003
- * <p>The launch type the service revision uses.</p>
8004
- * @public
8005
- */
8006
- launchType?: LaunchType | undefined;
8007
- /**
8008
- * <p>For the Fargate launch type, the platform version the service revision uses.</p>
8009
- * @public
8010
- */
8011
- platformVersion?: string | undefined;
8012
- /**
8013
- * <p>The platform family the service revision uses.</p>
8014
- * @public
8015
- */
8016
- platformFamily?: string | undefined;
8017
- /**
8018
- * <p>The load balancers the service revision uses.</p>
8019
- * @public
8020
- */
8021
- loadBalancers?: LoadBalancer[] | undefined;
8022
- /**
8023
- * <p>The service registries (for Service Discovery) the service revision uses.</p>
8024
- * @public
8025
- */
8026
- serviceRegistries?: ServiceRegistry[] | undefined;
8027
- /**
8028
- * <p>The network configuration for a task or service.</p>
8029
- * @public
8030
- */
8031
- networkConfiguration?: NetworkConfiguration | undefined;
8032
- /**
8033
- * <p>The container images the service revision uses.</p>
8034
- * @public
8035
- */
8036
- containerImages?: ContainerImage[] | undefined;
8037
- /**
8038
- * <p>Indicates whether Runtime Monitoring is turned on.</p>
8039
- * @public
8040
- */
8041
- guardDutyEnabled?: boolean | undefined;
8042
- /**
8043
- * <p>The Service Connect configuration of your Amazon ECS service. The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.</p> <p>Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html">Service Connect</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
8044
- * @public
8045
- */
8046
- serviceConnectConfiguration?: ServiceConnectConfiguration | undefined;
8047
- /**
8048
- * <p>The volumes that are configured at deployment that the service revision uses.</p>
8049
- * @public
8050
- */
8051
- volumeConfigurations?: ServiceVolumeConfiguration[] | undefined;
8052
- /**
8053
- * <p>The amount of ephemeral storage to allocate for the deployment.</p>
8054
- * @public
8055
- */
8056
- fargateEphemeralStorage?: DeploymentEphemeralStorage | undefined;
8057
- /**
8058
- * <p>The time that the service revision was created. The format is yyyy-mm-dd HH:mm:ss.SSSSS.</p>
8059
- * @public
8060
- */
8061
- createdAt?: Date | undefined;
8062
- /**
8063
- * <p>The VPC Lattice configuration for the service revision.</p>
8064
- * @public
8065
- */
8066
- vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
8067
- /**
8068
- * <p>The resolved configuration for the service revision which contains the actual resources your service revision uses, such as which target groups serve traffic.</p>
8069
- * @public
8070
- */
8071
- resolvedConfiguration?: ResolvedConfiguration | undefined;
8072
- /**
8073
- * <p>The resources created and managed by Amazon ECS when you create an Express service for Amazon ECS.</p>
8074
- * @public
8075
- */
8076
- ecsManagedResources?: ECSManagedResources | undefined;
8077
- }
@@ -1,5 +1,127 @@
1
1
  import type { Compatibility, Connectivity, HealthStatus, IpcMode, LaunchType, ManagedAgentName, NetworkMode, PidMode, PropagateTags, SortOrder, TaskDefinitionStatus, TaskField, TaskFilesystemType, TaskSetField, TaskStopCode } from "./enums";
2
- import type { Attachment, Attribute, CapacityProviderStrategyItem, ContainerDefinition, EBSTagSpecification, EnvironmentFile, EphemeralStorage, Failure, InferenceAccelerator, KeyValuePair, LoadBalancer, NetworkBinding, NetworkConfiguration, PlacementConstraint, PlacementStrategy, ProxyConfiguration, ResourceRequirement, RuntimePlatform, Scale, ServiceRegistry, ServiceRevision, Tag, TaskDefinition, TaskDefinitionPlacementConstraint, TaskSet, Volume } from "./models_0";
2
+ import type { Attachment, Attribute, CapacityProviderStrategyItem, ContainerDefinition, ContainerImage, DeploymentEphemeralStorage, EBSTagSpecification, ECSManagedResources, EnvironmentFile, EphemeralStorage, Failure, InferenceAccelerator, KeyValuePair, LoadBalancer, MonitoringConfiguration, NetworkBinding, NetworkConfiguration, PlacementConstraint, PlacementStrategy, ProxyConfiguration, ResourceRequirement, RuntimePlatform, Scale, ServiceConnectConfiguration, ServiceRegistry, ServiceRevisionLoadBalancer, ServiceVolumeConfiguration, Tag, TaskDefinition, TaskDefinitionPlacementConstraint, TaskSet, Volume, VpcLatticeConfiguration } from "./models_0";
3
+ /**
4
+ * <p>The resolved configuration for a service revision, which contains the actual resources your service revision uses, such as which target groups serve traffic.</p>
5
+ * @public
6
+ */
7
+ export interface ResolvedConfiguration {
8
+ /**
9
+ * <p>The resolved load balancer configuration for the service revision. This includes information about which target groups serve traffic and which listener rules direct traffic to them.</p>
10
+ * @public
11
+ */
12
+ loadBalancers?: ServiceRevisionLoadBalancer[] | undefined;
13
+ }
14
+ /**
15
+ * <p>Information about the service revision.</p> <p>A service revision contains a record of the workload configuration Amazon ECS is attempting to deploy. Whenever you create or deploy a service, Amazon ECS automatically creates and captures the configuration that you're trying to deploy in the service revision. For information about service revisions, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html">Amazon ECS service revisions</a> in the <i> <i>Amazon Elastic Container Service Developer Guide</i> </i>.</p>
16
+ * @public
17
+ */
18
+ export interface ServiceRevision {
19
+ /**
20
+ * <p>The ARN of the service revision.</p>
21
+ * @public
22
+ */
23
+ serviceRevisionArn?: string | undefined;
24
+ /**
25
+ * <p>The ARN of the service for the service revision.</p>
26
+ * @public
27
+ */
28
+ serviceArn?: string | undefined;
29
+ /**
30
+ * <p>The ARN of the cluster that hosts the service.</p>
31
+ * @public
32
+ */
33
+ clusterArn?: string | undefined;
34
+ /**
35
+ * <p>The task definition the service revision uses.</p>
36
+ * @public
37
+ */
38
+ taskDefinition?: string | undefined;
39
+ /**
40
+ * <p>The capacity provider strategy the service revision uses.</p>
41
+ * @public
42
+ */
43
+ capacityProviderStrategy?: CapacityProviderStrategyItem[] | undefined;
44
+ /**
45
+ * <p>The launch type the service revision uses.</p>
46
+ * @public
47
+ */
48
+ launchType?: LaunchType | undefined;
49
+ /**
50
+ * <p>For the Fargate launch type, the platform version the service revision uses.</p>
51
+ * @public
52
+ */
53
+ platformVersion?: string | undefined;
54
+ /**
55
+ * <p>The platform family the service revision uses.</p>
56
+ * @public
57
+ */
58
+ platformFamily?: string | undefined;
59
+ /**
60
+ * <p>The load balancers the service revision uses.</p>
61
+ * @public
62
+ */
63
+ loadBalancers?: LoadBalancer[] | undefined;
64
+ /**
65
+ * <p>The service registries (for Service Discovery) the service revision uses.</p>
66
+ * @public
67
+ */
68
+ serviceRegistries?: ServiceRegistry[] | undefined;
69
+ /**
70
+ * <p>The network configuration for a task or service.</p>
71
+ * @public
72
+ */
73
+ networkConfiguration?: NetworkConfiguration | undefined;
74
+ /**
75
+ * <p>The container images the service revision uses.</p>
76
+ * @public
77
+ */
78
+ containerImages?: ContainerImage[] | undefined;
79
+ /**
80
+ * <p>Indicates whether Runtime Monitoring is turned on.</p>
81
+ * @public
82
+ */
83
+ guardDutyEnabled?: boolean | undefined;
84
+ /**
85
+ * <p>The Service Connect configuration of your Amazon ECS service. The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.</p> <p>Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html">Service Connect</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
86
+ * @public
87
+ */
88
+ serviceConnectConfiguration?: ServiceConnectConfiguration | undefined;
89
+ /**
90
+ * <p>The volumes that are configured at deployment that the service revision uses.</p>
91
+ * @public
92
+ */
93
+ volumeConfigurations?: ServiceVolumeConfiguration[] | undefined;
94
+ /**
95
+ * <p>The amount of ephemeral storage to allocate for the deployment.</p>
96
+ * @public
97
+ */
98
+ fargateEphemeralStorage?: DeploymentEphemeralStorage | undefined;
99
+ /**
100
+ * <p>The time that the service revision was created. The format is yyyy-mm-dd HH:mm:ss.SSSSS.</p>
101
+ * @public
102
+ */
103
+ createdAt?: Date | undefined;
104
+ /**
105
+ * <p>The VPC Lattice configuration for the service revision.</p>
106
+ * @public
107
+ */
108
+ vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
109
+ /**
110
+ * <p>The resolved configuration for the service revision which contains the actual resources your service revision uses, such as which target groups serve traffic.</p>
111
+ * @public
112
+ */
113
+ resolvedConfiguration?: ResolvedConfiguration | undefined;
114
+ /**
115
+ * <p>The resources created and managed by Amazon ECS when you create an Express service for Amazon ECS.</p>
116
+ * @public
117
+ */
118
+ ecsManagedResources?: ECSManagedResources | undefined;
119
+ /**
120
+ * <p>The optional monitoring configuration for the service, which defines the resolution for the service-level <code>CPUUtilization</code> and <code>MemoryUtilization</code> Amazon CloudWatch metrics. When not specified, Amazon ECS uses the default resolution of <code>60</code> seconds.</p>
121
+ * @public
122
+ */
123
+ monitoring?: MonitoringConfiguration | undefined;
124
+ }
3
125
  /**
4
126
  * @public
5
127
  */
@@ -258,6 +258,8 @@ export declare var ManagedStorageConfiguration$: StaticStructureSchema;
258
258
  export declare var ManagedTargetGroup$: StaticStructureSchema;
259
259
  export declare var MemoryGiBPerVCpuRequest$: StaticStructureSchema;
260
260
  export declare var MemoryMiBRequest$: StaticStructureSchema;
261
+ export declare var MetricConfiguration$: StaticStructureSchema;
262
+ export declare var MonitoringConfiguration$: StaticStructureSchema;
261
263
  export declare var MountPoint$: StaticStructureSchema;
262
264
  export declare var NetworkBandwidthGbpsRequest$: StaticStructureSchema;
263
265
  export declare var NetworkBinding$: StaticStructureSchema;
@@ -1427,18 +1427,19 @@ export interface ExpressGatewayScalingTarget {
1427
1427
  autoScalingTargetValue?: number | undefined;
1428
1428
  }
1429
1429
  export interface CreateExpressGatewayServiceRequest {
1430
- executionRoleArn: string | undefined;
1430
+ executionRoleArn?: string | undefined;
1431
1431
  infrastructureRoleArn: string | undefined;
1432
1432
  serviceName?: string | undefined;
1433
1433
  cluster?: string | undefined;
1434
1434
  healthCheckPath?: string | undefined;
1435
- primaryContainer: ExpressGatewayContainer | undefined;
1435
+ primaryContainer?: ExpressGatewayContainer | undefined;
1436
1436
  taskRoleArn?: string | undefined;
1437
1437
  networkConfiguration?: ExpressGatewayServiceNetworkConfiguration | undefined;
1438
1438
  cpu?: string | undefined;
1439
1439
  memory?: string | undefined;
1440
1440
  scalingTarget?: ExpressGatewayScalingTarget | undefined;
1441
1441
  tags?: Tag[] | undefined;
1442
+ taskDefinitionArn?: string | undefined;
1442
1443
  }
1443
1444
  export interface IngressPathSummary {
1444
1445
  accessType: AccessType | undefined;
@@ -1448,6 +1449,7 @@ export interface ExpressGatewayServiceConfiguration {
1448
1449
  serviceRevisionArn?: string | undefined;
1449
1450
  executionRoleArn?: string | undefined;
1450
1451
  taskRoleArn?: string | undefined;
1452
+ taskDefinitionArn?: string | undefined;
1451
1453
  cpu?: string | undefined;
1452
1454
  memory?: string | undefined;
1453
1455
  networkConfiguration?: ExpressGatewayServiceNetworkConfiguration | undefined;
@@ -1486,6 +1488,13 @@ export interface LoadBalancer {
1486
1488
  containerPort?: number | undefined;
1487
1489
  advancedConfiguration?: AdvancedConfiguration | undefined;
1488
1490
  }
1491
+ export interface MetricConfiguration {
1492
+ metricNames: string[] | undefined;
1493
+ resolutionSeconds: number | undefined;
1494
+ }
1495
+ export interface MonitoringConfiguration {
1496
+ metricConfigurations?: MetricConfiguration[] | undefined;
1497
+ }
1489
1498
  export interface AwsVpcConfiguration {
1490
1499
  subnets: string[] | undefined;
1491
1500
  securityGroups?: string[] | undefined;
@@ -1608,6 +1617,7 @@ export interface CreateServiceRequest {
1608
1617
  serviceConnectConfiguration?: ServiceConnectConfiguration | undefined;
1609
1618
  volumeConfigurations?: ServiceVolumeConfiguration[] | undefined;
1610
1619
  vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
1620
+ monitoring?: MonitoringConfiguration | undefined;
1611
1621
  }
1612
1622
  export interface ServiceCurrentRevisionSummary {
1613
1623
  arn?: string | undefined;
@@ -1803,6 +1813,7 @@ export interface UpdateExpressGatewayServiceRequest {
1803
1813
  cpu?: string | undefined;
1804
1814
  memory?: string | undefined;
1805
1815
  scalingTarget?: ExpressGatewayScalingTarget | undefined;
1816
+ taskDefinitionArn?: string | undefined;
1806
1817
  }
1807
1818
  export interface UpdatedExpressGatewayService {
1808
1819
  serviceArn?: string | undefined;
@@ -1839,6 +1850,7 @@ export interface UpdateServiceRequest {
1839
1850
  serviceConnectConfiguration?: ServiceConnectConfiguration | undefined;
1840
1851
  volumeConfigurations?: ServiceVolumeConfiguration[] | undefined;
1841
1852
  vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
1853
+ monitoring?: MonitoringConfiguration | undefined;
1842
1854
  }
1843
1855
  export interface UpdateServiceResponse {
1844
1856
  service?: Service | undefined;
@@ -1959,28 +1971,3 @@ export interface ServiceRevisionLoadBalancer {
1959
1971
  targetGroupArn?: string | undefined;
1960
1972
  productionListenerRule?: string | undefined;
1961
1973
  }
1962
- export interface ResolvedConfiguration {
1963
- loadBalancers?: ServiceRevisionLoadBalancer[] | undefined;
1964
- }
1965
- export interface ServiceRevision {
1966
- serviceRevisionArn?: string | undefined;
1967
- serviceArn?: string | undefined;
1968
- clusterArn?: string | undefined;
1969
- taskDefinition?: string | undefined;
1970
- capacityProviderStrategy?: CapacityProviderStrategyItem[] | undefined;
1971
- launchType?: LaunchType | undefined;
1972
- platformVersion?: string | undefined;
1973
- platformFamily?: string | undefined;
1974
- loadBalancers?: LoadBalancer[] | undefined;
1975
- serviceRegistries?: ServiceRegistry[] | undefined;
1976
- networkConfiguration?: NetworkConfiguration | undefined;
1977
- containerImages?: ContainerImage[] | undefined;
1978
- guardDutyEnabled?: boolean | undefined;
1979
- serviceConnectConfiguration?: ServiceConnectConfiguration | undefined;
1980
- volumeConfigurations?: ServiceVolumeConfiguration[] | undefined;
1981
- fargateEphemeralStorage?: DeploymentEphemeralStorage | undefined;
1982
- createdAt?: Date | undefined;
1983
- vpcLatticeConfigurations?: VpcLatticeConfiguration[] | undefined;
1984
- resolvedConfiguration?: ResolvedConfiguration | undefined;
1985
- ecsManagedResources?: ECSManagedResources | undefined;
1986
- }