Class: Aws::ECS::Types::Service

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-ecs/types.rb

Overview

Details on a service within a cluster

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#capacity_provider_strategyArray<Types::CapacityProviderStrategyItem>

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.


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#cluster_arnString

The Amazon Resource Name (ARN) of the cluster that hosts the service.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#created_atTime

The Unix timestamp for the time when the service was created.

Returns:

  • (Time)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#created_byString

The principal that created the service.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#deployment_configurationTypes::DeploymentConfiguration

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#deployment_controllerTypes::DeploymentController

The deployment controller type the service is using. When using the DescribeServices API, this field is omitted if the service uses the `ECS` deployment controller type.


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#deploymentsArray<Types::Deployment>

The current state of deployments for the service.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#desired_countInteger

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.

Returns:

  • (Integer)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#enable_ecs_managed_tagsBoolean

Determines whether to enable 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*.

[1]: docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html

Returns:

  • (Boolean)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#enable_execute_commandBoolean

Determines whether the execute command functionality is enabled for the service. If `true`, the execute command functionality is enabled for all containers in tasks as part of the service.

Returns:

  • (Boolean)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#eventsArray<Types::ServiceEvent>

The event stream for your service. A maximum of 100 of the latest events are displayed.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#health_check_grace_period_secondsInteger

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.

Returns:

  • (Integer)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#launch_typeString

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.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#load_balancersArray<Types::LoadBalancer>

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.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#network_configurationTypes::NetworkConfiguration

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the `awsvpc` networking mode.


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#pending_countInteger

The number of tasks in the cluster that are in the `PENDING` state.

Returns:

  • (Integer)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#placement_constraintsArray<Types::PlacementConstraint>

The placement constraints for the tasks in the service.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#placement_strategyArray<Types::PlacementStrategy>

The placement strategy that determines how tasks for the service are placed.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#platform_familyString

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 `platformFamily` value as the service (for example, `LINUX`).

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#platform_versionString

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 `LATEST` platform version is used. For more information, see [Fargate Platform Versions] in the *Amazon Elastic Container Service Developer Guide*.

[1]: docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#propagate_tagsString

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.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#role_arnString

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.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#running_countInteger

The number of tasks in the cluster that are in the `RUNNING` state.

Returns:

  • (Integer)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#scheduling_strategyString

The scheduling strategy to use for the service. For more information, see [Services].

There are two service scheduler strategies available.

  • `REPLICA`-The replica scheduling strategy places and maintains the desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions.

  • `DAEMON`-The daemon scheduling strategy deploys exactly one task on each active container instance. This taskmeets all of the task placement constraints that you specify in your cluster. The service scheduler also evaluates the task placement constraints for running tasks. It stop tasks that don't meet the placement constraints.

    <note markdown=“1”> Fargate tasks don't support the `DAEMON` scheduling strategy.

    </note>
    

[1]: docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#service_arnString

The ARN that identifies the service. The ARN contains the `arn:aws:ecs` namespace, followed by the Region of the service, the Amazon Web Services account ID of the service owner, the `service` namespace, and then the service name. For example, `arn:aws:ecs:region:012345678910:service/my-service`.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#service_nameString

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.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#service_registriesArray<Types::ServiceRegistry>

The details for the service discovery registries to assign to this service. For more information, see [Service Discovery].

[1]: docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#statusString

The status of the service. The valid values are `ACTIVE`, `DRAINING`, or `INACTIVE`.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#tagsArray<Types::Tag>

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:

  • Maximum number of tags per resource - 50

  • For each resource, each tag key must be unique, and each tag key can have only one value.

  • Maximum key length - 128 Unicode characters in UTF-8

  • Maximum value length - 256 Unicode characters in UTF-8

  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

  • Tag keys and values are case-sensitive.

  • Do not use `aws:`, `AWS:`, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#task_definitionString

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.

Returns:

  • (String)

9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end

#task_setsArray<Types::TaskSet>

Information about a set of Amazon ECS tasks in either an CodeDeploy or an `EXTERNAL` deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic.

Returns:


9341
9342
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353
9354
9355
9356
9357
9358
9359
9360
9361
9362
9363
9364
9365
9366
9367
9368
9369
9370
9371
9372
9373
9374
9375
# File 'lib/aws-sdk-ecs/types.rb', line 9341

class Service < Struct.new(
  :service_arn,
  :service_name,
  :cluster_arn,
  :load_balancers,
  :service_registries,
  :status,
  :desired_count,
  :running_count,
  :pending_count,
  :launch_type,
  :capacity_provider_strategy,
  :platform_version,
  :platform_family,
  :task_definition,
  :deployment_configuration,
  :task_sets,
  :deployments,
  :role_arn,
  :events,
  :created_at,
  :placement_constraints,
  :placement_strategy,
  :network_configuration,
  :health_check_grace_period_seconds,
  :scheduling_strategy,
  :deployment_controller,
  :tags,
  :created_by,
  :enable_ecs_managed_tags,
  :propagate_tags,
  :enable_execute_command)
  SENSITIVE = []
  include Aws::Structure
end