You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* <p>Creates a new Amazon ECS cluster. By default, your account receives a <code>default</code>
32
32
* cluster when you launch your first container instance. However, you can create your own
33
-
* cluster with a unique name with the <code>CreateCluster</code> action.</p>
33
+
* cluster with a unique name.</p>
34
34
* <note>
35
-
* <p>When you call the <a>CreateCluster</a> API operation, Amazon ECS attempts to
35
+
* <p>When you call the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html">CreateCluster</a> API operation, Amazon ECS attempts to
36
36
* create the Amazon ECS service-linked role for your account. This is so that it can manage
37
37
* required resources in other Amazon Web Services services on your behalf. However, if the user that
38
38
* makes the call doesn't have permissions to create the service-linked role, it isn't
* <p>Runs and maintains your desired number of tasks from a specified task definition. If
32
32
* the number of tasks running in a service drops below the <code>desiredCount</code>,
33
33
* Amazon ECS runs another copy of the task in the specified cluster. To update an existing
34
-
* service, see the <a>UpdateService</a> action.</p>
34
+
* service, use <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>.</p>
35
35
* <note>
36
36
* <p>On March 21, 2024, a change was made to resolve the task definition revision before authorization. When a task definition revision is not specified, authorization will occur using the latest revision of a task definition.</p>
* <p>You can optionally specify a deployment configuration for your service. The deployment
71
71
* is initiated by changing properties. For example, the deployment might be initiated by
72
-
* the task definition or by your desired count of a service. This is done with an <a>UpdateService</a> operation. The default value for a replica service for
72
+
* the task definition or by your desired count of a service. You can use <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>. The default value for a replica service for
73
73
* <code>minimumHealthyPercent</code> is 100%. The default value for a daemon service
74
74
* for <code>minimumHealthyPercent</code> is 0%.</p>
75
75
* <p>If a service uses the <code>ECS</code> deployment controller, the minimum healthy
* currently visible when describing your service.</p>
108
108
* <p>When creating a service that uses the <code>EXTERNAL</code> deployment controller, you
109
109
* can specify only parameters that aren't controlled at the task set level. The only
110
-
* required parameter is the service name. You control your services using the <a>CreateTaskSet</a> operation. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS deployment types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
110
+
* required parameter is the service name. You control your services using the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html">CreateTaskSet</a>. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS deployment types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
111
111
* <p>When the service scheduler launches new tasks, it determines task placement. For
112
112
* information about task placement and task placement strategies, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html">Amazon ECS
113
113
* task placement</a> in the <i>Amazon Elastic Container Service Developer Guide</i>
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
578
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
198
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The specified service isn't active. You can't update a service that's inactive. If you
219
-
* have previously deleted a service, you can re-create it with <a>CreateService</a>.</p>
219
+
* have previously deleted a service, you can re-create it with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a>.</p>
* <p>The specified service wasn't found. You can view your available services with <a>ListServices</a>. Amazon ECS services are cluster specific and Region
222
+
* <p>The specified service wasn't found. You can view your available services with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServices.html">ListServices</a>. Amazon ECS services are cluster specific and Region
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
71
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers are
34
-
* reserved and can't be deleted. You can disassociate them from a cluster using either
35
-
* the <a>PutClusterCapacityProviders</a> API or by deleting the
34
+
* reserved and can't be deleted. You can disassociate them from a cluster using either <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProviderProviders.html">PutCapacityProviderProviders</a> or by deleting the
36
35
* cluster.</p>
37
36
* </note>
38
37
* <p>Prior to a capacity provider being deleted, the capacity provider must be removed from
39
-
* the capacity provider strategy from all services. The <a>UpdateService</a>
38
+
* the capacity provider strategy from all services. The <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>
40
39
* API can be used to remove a capacity provider from a service's capacity provider
41
40
* strategy. When updating a service, the <code>forceNewDeployment</code> option can be
42
41
* used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity
43
42
* provider are transitioned to use the capacity from the remaining capacity providers.
44
43
* Only capacity providers that aren't associated with a cluster can be deleted. To remove
45
-
* a capacity provider from a cluster, you can either use <a>PutClusterCapacityProviders</a> or delete the cluster.</p>
44
+
* a capacity provider from a cluster, you can either use <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProviderProviders.html">PutCapacityProviderProviders</a> or delete the cluster.</p>
46
45
* @example
47
46
* Use a bare-bones client and the command you need to make an API call.
* account for a period of time. However, this behavior is subject to change in the future.
34
34
* We don't recommend that you rely on <code>INACTIVE</code> clusters persisting.</p>
35
35
* <p>You must deregister all container instances from this cluster before you may delete
36
-
* it. You can list the container instances in a cluster with <a>ListContainerInstances</a> and deregister them with <a>DeregisterContainerInstance</a>.</p>
36
+
* it. You can list the container instances in a cluster with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListContainerInstances.html">ListContainerInstances</a> and deregister them with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeregisterContainerInstance.html">DeregisterContainerInstance</a>.</p>
37
37
* @example
38
38
* Use a bare-bones client and the command you need to make an API call.
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
159
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>Deletes a specified service within a cluster. You can delete a service if you have no
32
32
* running tasks in it and the desired task count is zero. If the service is actively
33
33
* maintaining tasks, you can't delete it, and you must update the service to a desired
34
-
* task count of zero. For more information, see <a>UpdateService</a>.</p>
34
+
* task count of zero. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html">UpdateService</a>.</p>
35
35
* <note>
36
36
* <p>When you delete a service, if there are still running tasks that require cleanup,
37
37
* the service status moves from <code>ACTIVE</code> to <code>DRAINING</code>, and the
38
-
* service is no longer visible in the console or in the <a>ListServices</a>
38
+
* service is no longer visible in the console or in the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServices.html">ListServices</a>
39
39
* API operation. After all tasks have transitioned to either <code>STOPPING</code> or
40
40
* <code>STOPPED</code> status, the service status moves from <code>DRAINING</code>
41
41
* to <code>INACTIVE</code>. Services in the <code>DRAINING</code> or
42
-
* <code>INACTIVE</code> status can still be viewed with the <a>DescribeServices</a> API operation. However, in the future,
42
+
* <code>INACTIVE</code> status can still be viewed with the <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServices.html">DescribeServices</a> API operation. However, in the future,
43
43
* <code>INACTIVE</code> services may be cleaned up and purged from Amazon ECS record
44
-
* keeping, and <a>DescribeServices</a> calls on those services return a
44
+
* keeping, and <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeServices.html">DescribeServices</a> calls on those services return a
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
363
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The specified service wasn't found. You can view your available services with <a>ListServices</a>. Amazon ECS services are cluster specific and Region
373
+
* <p>The specified service wasn't found. You can view your available services with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServices.html">ListServices</a>. Amazon ECS services are cluster specific and Region
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
144
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The specified service isn't active. You can't update a service that's inactive. If you
155
-
* have previously deleted a service, you can re-create it with <a>CreateService</a>.</p>
155
+
* have previously deleted a service, you can re-create it with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a>.</p>
* <p>The specified service wasn't found. You can view your available services with <a>ListServices</a>. Amazon ECS services are cluster specific and Region
158
+
* <p>The specified service wasn't found. You can view your available services with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListServices.html">ListServices</a>. Amazon ECS services are cluster specific and Region
* <p>The specified task set wasn't found. You can view your available task sets with <a>DescribeTaskSets</a>. Task sets are specific to each cluster, service and
162
+
* <p>The specified task set wasn't found. You can view your available task sets with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeTaskSets.html">DescribeTaskSets</a>. Task sets are specific to each cluster, service and
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
167
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
* <p>The specified cluster wasn't found. You can view your available clusters with <a>ListClusters</a>. Amazon ECS clusters are Region specific.</p>
166
+
* <p>The specified cluster wasn't found. You can view your available clusters with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ListClusters.html">ListClusters</a>. Amazon ECS clusters are Region specific.</p>
0 commit comments