Describe Tasks
ecs_describe_tasks | R Documentation |
Describes a specified task or tasks¶
Description¶
Describes a specified task or tasks.
Currently, stopped tasks appear in the returned results for at least one hour.
If you have tasks with tags, and then delete the cluster, the tagged tasks are returned in the response. If you create a new cluster with the same name as the deleted cluster, the tagged tasks are not included in the response.
Usage¶
Arguments¶
cluster
The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task or tasks to describe. If you do not specify a cluster, the default cluster is assumed. This parameter is required if the task or tasks you are describing were launched in any cluster other than the default cluster.
tasks
[required] A list of up to 100 task IDs or full ARN entries.
include
Specifies whether you want to see the resource tags for the task. If
TAGS
is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.
Value¶
A list with the following syntax:
list(
tasks = list(
list(
attachments = list(
list(
id = "string",
type = "string",
status = "string",
details = list(
list(
name = "string",
value = "string"
)
)
)
),
attributes = list(
list(
name = "string",
value = "string",
targetType = "container-instance",
targetId = "string"
)
),
availabilityZone = "string",
capacityProviderName = "string",
clusterArn = "string",
connectivity = "CONNECTED"|"DISCONNECTED",
connectivityAt = as.POSIXct(
"2015-01-01"
),
containerInstanceArn = "string",
containers = list(
list(
containerArn = "string",
taskArn = "string",
name = "string",
image = "string",
imageDigest = "string",
runtimeId = "string",
lastStatus = "string",
exitCode = 123,
reason = "string",
networkBindings = list(
list(
bindIP = "string",
containerPort = 123,
hostPort = 123,
protocol = "tcp"|"udp",
containerPortRange = "string",
hostPortRange = "string"
)
),
networkInterfaces = list(
list(
attachmentId = "string",
privateIpv4Address = "string",
ipv6Address = "string"
)
),
healthStatus = "HEALTHY"|"UNHEALTHY"|"UNKNOWN",
managedAgents = list(
list(
lastStartedAt = as.POSIXct(
"2015-01-01"
),
name = "ExecuteCommandAgent",
reason = "string",
lastStatus = "string"
)
),
cpu = "string",
memory = "string",
memoryReservation = "string",
gpuIds = list(
"string"
)
)
),
cpu = "string",
createdAt = as.POSIXct(
"2015-01-01"
),
desiredStatus = "string",
enableExecuteCommand = TRUE|FALSE,
executionStoppedAt = as.POSIXct(
"2015-01-01"
),
group = "string",
healthStatus = "HEALTHY"|"UNHEALTHY"|"UNKNOWN",
inferenceAccelerators = list(
list(
deviceName = "string",
deviceType = "string"
)
),
lastStatus = "string",
launchType = "EC2"|"FARGATE"|"EXTERNAL",
memory = "string",
overrides = list(
containerOverrides = list(
list(
name = "string",
command = list(
"string"
),
environment = list(
list(
name = "string",
value = "string"
)
),
environmentFiles = list(
list(
value = "string",
type = "s3"
)
),
cpu = 123,
memory = 123,
memoryReservation = 123,
resourceRequirements = list(
list(
value = "string",
type = "GPU"|"InferenceAccelerator"
)
)
)
),
cpu = "string",
inferenceAcceleratorOverrides = list(
list(
deviceName = "string",
deviceType = "string"
)
),
executionRoleArn = "string",
memory = "string",
taskRoleArn = "string",
ephemeralStorage = list(
sizeInGiB = 123
)
),
platformVersion = "string",
platformFamily = "string",
pullStartedAt = as.POSIXct(
"2015-01-01"
),
pullStoppedAt = as.POSIXct(
"2015-01-01"
),
startedAt = as.POSIXct(
"2015-01-01"
),
startedBy = "string",
stopCode = "TaskFailedToStart"|"EssentialContainerExited"|"UserInitiated"|"ServiceSchedulerInitiated"|"SpotInterruption"|"TerminationNotice",
stoppedAt = as.POSIXct(
"2015-01-01"
),
stoppedReason = "string",
stoppingAt = as.POSIXct(
"2015-01-01"
),
tags = list(
list(
key = "string",
value = "string"
)
),
taskArn = "string",
taskDefinitionArn = "string",
version = 123,
ephemeralStorage = list(
sizeInGiB = 123
),
fargateEphemeralStorage = list(
sizeInGiB = 123,
kmsKeyId = "string"
)
)
),
failures = list(
list(
arn = "string",
reason = "string",
detail = "string"
)
)
)