AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Details on a service within a cluster.
Namespace: Amazon.ECS.Model
Assembly: AWSSDK.ECS.dll
Version: 3.x.y.z
public class Service
The Service type exposes the following members
Name | Description | |
---|---|---|
Service() |
Name | Type | Description | |
---|---|---|---|
CapacityProviderStrategy | System.Collections.Generic.List<Amazon.ECS.Model.CapacityProviderStrategyItem> |
Gets and sets the property CapacityProviderStrategy. The capacity provider strategy the service uses. When using the DescribeServices API, this field is omitted if the service was created using a launch type. |
|
ClusterArn | System.String |
Gets and sets the property ClusterArn. The Amazon Resource Name (ARN) of the cluster that hosts the service. |
|
CreatedAt | System.DateTime |
Gets and sets the property CreatedAt. The Unix timestamp for the time when the service was created. |
|
CreatedBy | System.String |
Gets and sets the property CreatedBy. The principal that created the service. |
|
DeploymentConfiguration | Amazon.ECS.Model.DeploymentConfiguration |
Gets and sets the property DeploymentConfiguration. Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks. |
|
DeploymentController | Amazon.ECS.Model.DeploymentController |
Gets and sets the property DeploymentController. The deployment controller type the service is using. |
|
Deployments | System.Collections.Generic.List<Amazon.ECS.Model.Deployment> |
Gets and sets the property Deployments. The current state of deployments for the service. |
|
DesiredCount | System.Int32 |
Gets and sets the property DesiredCount. The desired number of instantiations of the task definition to keep running on the service. This value is specified when the service is created with CreateService , and it can be modified with UpdateService. |
|
EnableECSManagedTags | System.Boolean |
Gets and sets the property EnableECSManagedTags. Determines whether to use Amazon ECS managed tags for the tasks in the service. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide. |
|
EnableExecuteCommand | System.Boolean |
Gets and sets the property EnableExecuteCommand.
Determines whether the execute command functionality is turned on for the service.
If |
|
Events | System.Collections.Generic.List<Amazon.ECS.Model.ServiceEvent> |
Gets and sets the property Events. The event stream for your service. A maximum of 100 of the latest events are displayed. |
|
HealthCheckGracePeriodSeconds | System.Int32 |
Gets and sets the property HealthCheckGracePeriodSeconds. The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. |
|
LaunchType | Amazon.ECS.LaunchType |
Gets and sets the property LaunchType. The launch type the service is using. When using the DescribeServices API, this field is omitted if the service was created using a capacity provider strategy. |
|
LoadBalancers | System.Collections.Generic.List<Amazon.ECS.Model.LoadBalancer> |
Gets and sets the property LoadBalancers. A list of Elastic Load Balancing load balancer objects. It contains the load balancer name, the container name, and the container port to access from the load balancer. The container name is as it appears in a container definition. |
|
NetworkConfiguration | Amazon.ECS.Model.NetworkConfiguration |
Gets and sets the property NetworkConfiguration.
The VPC subnet and security group configuration for tasks that receive their own elastic
network interface by using the |
|
PendingCount | System.Int32 |
Gets and sets the property PendingCount.
The number of tasks in the cluster that are in the |
|
PlacementConstraints | System.Collections.Generic.List<Amazon.ECS.Model.PlacementConstraint> |
Gets and sets the property PlacementConstraints. The placement constraints for the tasks in the service. |
|
PlacementStrategy | System.Collections.Generic.List<Amazon.ECS.Model.PlacementStrategy> |
Gets and sets the property PlacementStrategy. The placement strategy that determines how tasks for the service are placed. |
|
PlatformFamily | System.String |
Gets and sets the property PlatformFamily. The operating system that your tasks in the service run on. A platform family is specified only for tasks using the Fargate launch type.
All tasks that run as part of this service must use the same |
|
PlatformVersion | System.String |
Gets and sets the property PlatformVersion.
The platform version to run your service on. A platform version is only specified
for tasks that are hosted on Fargate. If one isn't specified, the |
|
PropagateTags | Amazon.ECS.PropagateTags |
Gets and sets the property PropagateTags. Determines whether to propagate the tags from the task definition or the service to the task. If no value is specified, the tags aren't propagated. |
|
RoleArn | System.String |
Gets and sets the property RoleArn. The ARN of the IAM role that's associated with the service. It allows the Amazon ECS container agent to register container instances with an Elastic Load Balancing load balancer. |
|
RunningCount | System.Int32 |
Gets and sets the property RunningCount.
The number of tasks in the cluster that are in the |
|
SchedulingStrategy | Amazon.ECS.SchedulingStrategy |
Gets and sets the property SchedulingStrategy. The scheduling strategy to use for the service. For more information, see Services. There are two service scheduler strategies available.
|
|
ServiceArn | System.String |
Gets and sets the property ServiceArn. The ARN that identifies the service. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide. |
|
ServiceName | System.String |
Gets and sets the property ServiceName. The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Service names must be unique within a cluster. However, you can have similarly named services in multiple clusters within a Region or across multiple Regions. |
|
ServiceRegistries | System.Collections.Generic.List<Amazon.ECS.Model.ServiceRegistry> |
Gets and sets the property ServiceRegistries. The details for the service discovery registries to assign to this service. For more information, see Service Discovery. |
|
Status | System.String |
Gets and sets the property Status.
The status of the service. The valid values are |
|
Tags | System.Collections.Generic.List<Amazon.ECS.Model.Tag> |
Gets and sets the property Tags. The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value. You define bot the key and value. The following basic restrictions apply to tags:
|
|
TaskDefinition | System.String |
Gets and sets the property TaskDefinition. The task definition to use for tasks in the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService. |
|
TaskSets | System.Collections.Generic.List<Amazon.ECS.Model.TaskSet> |
Gets and sets the property TaskSets.
Information about a set of Amazon ECS tasks in either an CodeDeploy or an |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5