Container for the parameters to the DeleteService operation.
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 can't 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
If you attempt to create a new service with the same name as an existing service in
either ACTIVE to DRAINING, and the service is
no longer visible in the console or in the ListServices API operation. After
all tasks have transitioned to either STOPPING or STOPPED status, the
service status moves from DRAINING to INACTIVE. Services in the DRAINING
or INACTIVE status can still be viewed with the DescribeServices API
operation. However, in the future, INACTIVE services may be cleaned up and
purged from Amazon ECS record keeping, and DescribeServices calls on those
services return a ServiceNotFoundException error.
ACTIVE or DRAINING status, you receive an error.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.ECS.AmazonECSRequest
Amazon.ECS.Model.DeleteServiceRequest
Namespace: Amazon.ECS.Model
Assembly: AWSSDK.ECS.dll
Version: 3.x.y.z
Syntax
public class DeleteServiceRequest : AmazonECSRequest IAmazonWebServiceRequest
The DeleteServiceRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
DeleteServiceRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
Cluster | System.String |
Gets and sets the property Cluster. The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to delete. If you do not specify a cluster, the default cluster is assumed. |
|
|
Force | System.Boolean |
Gets and sets the property Force.
If |
|
|
Service | System.String |
Gets and sets the property Service. The name of the service to delete. |
Examples
This example deletes the my-http-service service. The service must have a desired count and running count of 0 before you can delete it.
To delete a service
var client = new AmazonECSClient();
var response = client.DeleteService(new DeleteServiceRequest
{
Service = "my-http-service"
});
Version Information
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5, 4.0, 3.5