@aws-sdk/client-ecs 3.722.0 → 3.723.0

package/dist-types/commands/PutClusterCapacityProvidersCommand.d.ts

@@ -183,6 +183,255 @@ declare const PutClusterCapacityProvidersCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To add an existing capacity provider to a cluuster
+ * ```javascript
+ * // This example adds an existing capacity provider "MyCapacityProvider2" to a cluster that already has the capacity provider "MyCapacityProvider1" associated with it. Both "MyCapacityProvider2" and "MyCapacityProvider1" need to be specified.
+ * const input = {
+ *   "capacityProviders": [
+ *     "MyCapacityProvider1",
+ *     "MyCapacityProvider2"
+ *   ],
+ *   "cluster": "MyCluster",
+ *   "defaultCapacityProviderStrategy": [
+ *     {
+ *       "capacityProvider": "MyCapacityProvider1",
+ *       "weight": 1
+ *     },
+ *     {
+ *       "capacityProvider": "MyCapacityProvider2",
+ *       "weight": 1
+ *     }
+ *   ]
+ * };
+ * const command = new PutClusterCapacityProvidersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "attachments": [
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider1"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
+ *           }
+ *         ],
+ *         "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
+ *         "status": "ACTIVE"
+ *       },
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider2"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
+ *           }
+ *         ],
+ *         "id": "ae592060-2382-4663-9476-b015c685593c",
+ *         "status": "ACTIVE"
+ *       }
+ *     ],
+ *     "attachmentsStatus": "UPDATE_IN_PROGRESS",
+ *     "capacityProviders": [
+ *       "MyCapacityProvider1",
+ *       "MyCapacityProvider2"
+ *     ],
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
+ *     "clusterName": "MyCluster",
+ *     "defaultCapacityProviderStrategy": [
+ *       {
+ *         "base": 0,
+ *         "capacityProvider": "MyCapacityProvider1",
+ *         "weight": 1
+ *       },
+ *       {
+ *         "base": 0,
+ *         "capacityProvider": "MyCapacityProvider2",
+ *         "weight": 1
+ *       }
+ *     ],
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enabled"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-add-an-existing-capacity-provider-to-a-cluster-1734385195698
+ * ```
+ *
+ * @example To remove a capacity provider from a cluster
+ * ```javascript
+ * // This example removes a capacity provider "MyCapacityProvider2" from a cluster that has both "MyCapacityProvider2" and "MyCapacityProvider1" associated with it. Only "MyCapacityProvider1" needs to be specified in this scenario.
+ * const input = {
+ *   "capacityProviders": [
+ *     "MyCapacityProvider1"
+ *   ],
+ *   "cluster": "MyCluster",
+ *   "defaultCapacityProviderStrategy": [
+ *     {
+ *       "base": 0,
+ *       "capacityProvider": "MyCapacityProvider1",
+ *       "weight": 1
+ *     }
+ *   ]
+ * };
+ * const command = new PutClusterCapacityProvidersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "attachments": [
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider1"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
+ *           }
+ *         ],
+ *         "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
+ *         "status": "ACTIVE"
+ *       },
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider2"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
+ *           }
+ *         ],
+ *         "id": "ae592060-2382-4663-9476-b015c685593c",
+ *         "status": "DELETING"
+ *       }
+ *     ],
+ *     "attachmentsStatus": "UPDATE_IN_PROGRESS",
+ *     "capacityProviders": [
+ *       "MyCapacityProvider1"
+ *     ],
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
+ *     "clusterName": "MyCluster",
+ *     "defaultCapacityProviderStrategy": [
+ *       {
+ *         "base": 0,
+ *         "capacityProvider": "MyCapacityProvider1",
+ *         "weight": 1
+ *       }
+ *     ],
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enabled"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-remove-a-capacity-provider-from-a-cluster-1734386641517
+ * ```
+ *
+ * @example To remove all capacity providers from a cluster
+ * ```javascript
+ * // This example removes all capacity providers associated with a cluster.
+ * const input = {
+ *   "capacityProviders": [],
+ *   "cluster": "MyCluster",
+ *   "defaultCapacityProviderStrategy": []
+ * };
+ * const command = new PutClusterCapacityProvidersCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "attachments": [
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider1"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
+ *           }
+ *         ],
+ *         "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918",
+ *         "status": "DELETING"
+ *       },
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "MyCapacityProvider2"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
+ *           }
+ *         ],
+ *         "id": "ae592060-2382-4663-9476-b015c685593c",
+ *         "status": "DELETING"
+ *       }
+ *     ],
+ *     "attachmentsStatus": "UPDATE_IN_PROGRESS",
+ *     "capacityProviders": [],
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
+ *     "clusterName": "MyCluster",
+ *     "defaultCapacityProviderStrategy": [],
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enabled"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-remove-all-capacity-providers-from-a-cluster-1734387170874
+ * ```
+ *
  */
 export declare class PutClusterCapacityProvidersCommand extends PutClusterCapacityProvidersCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/StartTaskCommand.d.ts

@@ -362,6 +362,62 @@ declare const StartTaskCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To start a new task
+ * ```javascript
+ * // This example starts a new task in the cluster "MyCluster" on the specified container instance using the latest revision of the "hello-world" task definition.
+ * const input = {
+ *   "cluster": "MyCluster",
+ *   "containerInstances": [
+ *     "4c543eed-f83f-47da-b1d8-3d23f1da4c64"
+ *   ],
+ *   "taskDefinition": "hello-world"
+ * };
+ * const command = new StartTaskCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "failures": [],
+ *   "tasks": [
+ *     {
+ *       "version": 1,
+ *       "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default",
+ *       "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/default/4c543eed-f83f-47da-b1d8-3d23f1da4c64",
+ *       "containers": [
+ *         {
+ *           "name": "wordpress",
+ *           "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e76594d4-27e1-4c74-98b5-46a6435eb769",
+ *           "lastStatus": "PENDING",
+ *           "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb"
+ *         },
+ *         {
+ *           "name": "mysql",
+ *           "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/default/b19106ea-4fa8-4f1d-9767-96922c82b070",
+ *           "lastStatus": "PENDING",
+ *           "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb"
+ *         }
+ *       ],
+ *       "createdAt": 1479765460.842,
+ *       "desiredStatus": "RUNNING",
+ *       "lastStatus": "PENDING",
+ *       "overrides": {
+ *         "containerOverrides": [
+ *           {
+ *             "name": "wordpress"
+ *           },
+ *           {
+ *             "name": "mysql"
+ *           }
+ *         ]
+ *       },
+ *       "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb",
+ *       "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-start-a-new-task-1734455482966
+ * ```
+ *
  */
 export declare class StartTaskCommand extends StartTaskCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/StopTaskCommand.d.ts

@@ -256,6 +256,69 @@ declare const StopTaskCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To stop a task
+ * ```javascript
+ * // This example stops a task with ID "1dc5c17a-422b-4dc4-b493-371970c6c4d6" in cluster "MyCluster".
+ * const input = {
+ *   "cluster": "MyCluster",
+ *   "reason": "testing stop task.",
+ *   "task": "1dc5c17a-422b-4dc4-b493-371970c6c4d6"
+ * };
+ * const command = new StopTaskCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "task": {
+ *     "version": 0,
+ *     "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/MyCluster",
+ *     "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/MyCluster/5991d8da-1d59-49d2-a31f-4230f9e73140",
+ *     "containers": [
+ *       {
+ *         "name": "simple-app",
+ *         "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/4df26bb4-f057-467b-a079-961675296e64",
+ *         "lastStatus": "RUNNING",
+ *         "networkBindings": [
+ *           {
+ *             "bindIP": "0.0.0.0",
+ *             "containerPort": 80,
+ *             "hostPort": 32774,
+ *             "protocol": "tcp"
+ *           }
+ *         ],
+ *         "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6"
+ *       },
+ *       {
+ *         "name": "busybox",
+ *         "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e09064f7-7361-4c87-8ab9-8d073bbdbcb9",
+ *         "lastStatus": "RUNNING",
+ *         "networkBindings": [],
+ *         "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6"
+ *       }
+ *     ],
+ *     "createdAt": 1476822811.295,
+ *     "desiredStatus": "STOPPED",
+ *     "lastStatus": "RUNNING",
+ *     "overrides": {
+ *       "containerOverrides": [
+ *         {
+ *           "name": "simple-app"
+ *         },
+ *         {
+ *           "name": "busybox"
+ *         }
+ *       ]
+ *     },
+ *     "startedAt": 1476822833.998,
+ *     "startedBy": "ecs-svc/9223370560032507596",
+ *     "stoppedReason": "testing stop task.",
+ *     "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/1dc5c17a-422b-4dc4-b493-371970c6c4d6",
+ *     "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-dynamic-ports:1"
+ *   }
+ * }
+ * *\/
+ * // example id: to-stop-a-task-1734457210346
+ * ```
+ *
  */
 export declare class StopTaskCommand extends StopTaskCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/UpdateCapacityProviderCommand.d.ts

@@ -112,6 +112,46 @@ declare const UpdateCapacityProviderCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To update a capacity provider's parameters
+ * ```javascript
+ * // This example updates the targetCapacity and instanceWarmupPeriod parameters for the capacity provider MyCapacityProvider to 90 and 150 respectively.
+ * const input = {
+ *   "name": "MyCapacityProvider",
+ *   "autoScalingGroupProvider": {
+ *     "managedScaling": {
+ *       "instanceWarmupPeriod": 150,
+ *       "status": "ENABLED",
+ *       "targetCapacity": 90
+ *     }
+ *   }
+ * };
+ * const command = new UpdateCapacityProviderCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "capacityProvider": {
+ *     "name": "MyCapacityProvider",
+ *     "autoScalingGroupProvider": {
+ *       "autoScalingGroupArn": "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG",
+ *       "managedScaling": {
+ *         "instanceWarmupPeriod": 150,
+ *         "maximumScalingStepSize": 10000,
+ *         "minimumScalingStepSize": 1,
+ *         "status": "ENABLED",
+ *         "targetCapacity": 90
+ *       },
+ *       "managedTerminationProtection": "ENABLED"
+ *     },
+ *     "capacityProviderArn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider",
+ *     "status": "ACTIVE",
+ *     "tags": [],
+ *     "updateStatus": "UPDATE_COMPLETE"
+ *   }
+ * }
+ * *\/
+ * // example id: to-update-a-capacity-providers-parameters-1734557290198
+ * ```
+ *
  */
 export declare class UpdateCapacityProviderCommand extends UpdateCapacityProviderCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/UpdateClusterCommand.d.ts

@@ -179,6 +179,195 @@ declare const UpdateClusterCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To update a cluster's observability settings.
+ * ```javascript
+ * // This example turns on enhanced containerInsights in an existing cluster.
+ * const input = {
+ *   "cluster": "ECS-project-update-cluster",
+ *   "settings": [
+ *     {
+ *       "name": "containerInsights",
+ *       "value": "enhanced"
+ *     }
+ *   ]
+ * };
+ * const command = new UpdateClusterCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "attachments": [
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
+ *           }
+ *         ],
+ *         "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
+ *         "status": "CREATED"
+ *       },
+ *       {
+ *         "type": "managed_draining",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *           },
+ *           {
+ *             "name": "autoScalingLifecycleHookName",
+ *             "value": "ecs-managed-draining-termination-hook"
+ *           }
+ *         ],
+ *         "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
+ *         "status": "CREATED"
+ *       },
+ *       {
+ *         "type": "sc",
+ *         "details": [],
+ *         "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
+ *         "status": "ATTACHED"
+ *       }
+ *     ],
+ *     "attachmentsStatus": "UPDATE_COMPLETE",
+ *     "capacityProviders": [
+ *       "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *     ],
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
+ *     "clusterName": "ECS-project-update-cluster",
+ *     "defaultCapacityProviderStrategy": [
+ *       {
+ *         "base": 0,
+ *         "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+ *         "weight": 1
+ *       }
+ *     ],
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "serviceConnectDefaults": {
+ *       "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx"
+ *     },
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enhanced"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-update-a-clusters-observability-settings-1734626018966
+ * ```
+ *
+ * @example To update a cluster's Service Connect defaults.
+ * ```javascript
+ * // This example sets a default Service Connect namespace.
+ * const input = {
+ *   "cluster": "ECS-project-update-cluster",
+ *   "serviceConnectDefaults": {
+ *     "namespace": "test"
+ *   }
+ * };
+ * const command = new UpdateClusterCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "attachments": [
+ *       {
+ *         "type": "as_policy",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *           },
+ *           {
+ *             "name": "scalingPolicyName",
+ *             "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
+ *           }
+ *         ],
+ *         "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
+ *         "status": "CREATED"
+ *       },
+ *       {
+ *         "type": "managed_draining",
+ *         "details": [
+ *           {
+ *             "name": "capacityProviderName",
+ *             "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *           },
+ *           {
+ *             "name": "autoScalingLifecycleHookName",
+ *             "value": "ecs-managed-draining-termination-hook"
+ *           }
+ *         ],
+ *         "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
+ *         "status": "CREATED"
+ *       },
+ *       {
+ *         "type": "sc",
+ *         "details": [],
+ *         "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
+ *         "status": "DELETED"
+ *       },
+ *       {
+ *         "type": "sc",
+ *         "details": [],
+ *         "id": "3e6890c3-609c-4832-91de-d6ca891b3ef1",
+ *         "status": "ATTACHED"
+ *       },
+ *       {
+ *         "type": "sc",
+ *         "details": [],
+ *         "id": "961b8ec1-c2f1-4070-8495-e669b7668e90",
+ *         "status": "DELETED"
+ *       }
+ *     ],
+ *     "attachmentsStatus": "UPDATE_COMPLETE",
+ *     "capacityProviders": [
+ *       "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
+ *     ],
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
+ *     "clusterName": "ECS-project-update-cluster",
+ *     "defaultCapacityProviderStrategy": [
+ *       {
+ *         "base": 0,
+ *         "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
+ *         "weight": 1
+ *       }
+ *     ],
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "serviceConnectDefaults": {
+ *       "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr"
+ *     },
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enhanced"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-update-a-clusters-service-connect-defaults-1734626891648
+ * ```
+ *
  */
 export declare class UpdateClusterCommand extends UpdateClusterCommand_base {
     /** @internal type navigation helper, not in runtime. */

package/dist-types/commands/UpdateClusterSettingsCommand.d.ts

@@ -156,6 +156,44 @@ declare const UpdateClusterSettingsCommand_base: {
  * <p>Base exception class for all service exceptions from ECS service.</p>
  *
  * @public
+ * @example To update a cluster's settings
+ * ```javascript
+ * // This example enables CloudWatch Container Insights for the default cluster.
+ * const input = {
+ *   "cluster": "default",
+ *   "settings": [
+ *     {
+ *       "name": "containerInsights",
+ *       "value": "enabled"
+ *     }
+ *   ]
+ * };
+ * const command = new UpdateClusterSettingsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "cluster": {
+ *     "activeServicesCount": 0,
+ *     "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
+ *     "clusterName": "default",
+ *     "pendingTasksCount": 0,
+ *     "registeredContainerInstancesCount": 0,
+ *     "runningTasksCount": 0,
+ *     "settings": [
+ *       {
+ *         "name": "containerInsights",
+ *         "value": "enabled"
+ *       }
+ *     ],
+ *     "statistics": [],
+ *     "status": "ACTIVE",
+ *     "tags": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-update-a-clusters-settings-1734628004887
+ * ```
+ *
  */
 export declare class UpdateClusterSettingsCommand extends UpdateClusterSettingsCommand_base {
     /** @internal type navigation helper, not in runtime. */