Skip to main content

task_set

Gets an individual task_set resource

Overview

Nametask_set
TypeResource
Descriptiontask_set
Idawscc.ecs.task_set

Fields

NameDatatypeDescription
clusterstringThe short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to create the task set in.
external_idstringAn optional non-unique tag that identifies this task set in external systems. If the task set is associated with a service discovery registry, the tasks in this task set will have the ECS_TASK_SET_EXTERNAL_ID AWS Cloud Map attribute set to the provided value.
idstringThe ID of the task set.
launch_typestringThe launch type that new tasks in the task set will use. For more information, see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html in the Amazon Elastic Container Service Developer Guide.
load_balancersarray
network_configurationobject
platform_versionstringThe platform version that the tasks in the task set should use. A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the LATEST platform version is used by default.
scaleobjectA floating-point percentage of the desired number of tasks to place and keep running in the task set.
servicestringThe short name or full Amazon Resource Name (ARN) of the service to create the task set in.
service_registriesarrayThe details of the service discovery registries to assign to this task set. For more information, see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html.
tagsarray
task_definitionstringThe short name or full Amazon Resource Name (ARN) of the task definition for the tasks in the task set to use.
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
cluster,
external_id,
id,
launch_type,
load_balancers,
network_configuration,
platform_version,
scale,
service,
service_registries,
tags,
task_definition
FROM awscc.ecs.task_set
WHERE data__Identifier = '<Cluster>|<Service>|<Id>';

Permissions

To operate on the task_set resource, the following permissions are required:

Read

ecs:DescribeTaskSets

Update

ecs:DescribeTaskSets,
ecs:TagResource,
ecs:UntagResource,
ecs:UpdateTaskSet

Delete

ecs:DeleteTaskSet,
ecs:DescribeTaskSets