Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the desired task count is zero. If the service is actively maintaining tasks, you cannot delete it, and you must update the service to a desired task count of zero. For more information, see
UpdateService.
When you delete a service, if there are still running tasks that require cleanup, the service status moves from ACTIVE
to DRAINING
, and the service is no longer visible in the console or in ListServices API operations. After the tasks have stopped, then the service status moves from DRAINING
to INACTIVE
. Services in the DRAINING
or INACTIVE
status can still be viewed with DescribeServices API operations; however, in the future, INACTIVE
services may be cleaned up and purged from Amazon ECS record keeping, and DescribeServices API operations on those services will return a ServiceNotFoundException
error.
/// These errors are usually caused by a client action, such as using an action or resource
/// on behalf of a user that doesn't have permission to use the action or resource, or
/// specifying an identifier that is not valid.
///
/// The specified cluster could not be found. You can view your available clusters with
///
ListClusters. Amazon ECS clusters are region-specific.
///
/// The specified parameter is invalid. Review the available parameters for the API request.
///
/// These errors are usually caused by a server issue.
///
/// The specified service could not be found. You can view your available services with
///
ListServices. Amazon ECS services are cluster-specific and region-specific.
///