IAmazonECS.DescribeTaskDefinition Method (DescribeTaskDefinitionRequest)

Describes a task definition. You can specify a family and revision to find information about a specific task definition, or you can simply specify the family to find the latest ACTIVE revision in that family.

You can only describe INACTIVE task definitions while an active task or service references them.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DescribeTaskDefinitionAsync.

Namespace: Amazon.ECS
Assembly: AWSSDK.ECS.dll
Version: 3.x.y.z

Syntax

public abstract DescribeTaskDefinitionResponse DescribeTaskDefinition(
         DescribeTaskDefinitionRequest request
)

Parameters

request: Type: Amazon.ECS.Model.DescribeTaskDefinitionRequest

Container for the necessary parameters to execute the DescribeTaskDefinition service method.

Return Value

Type: DescribeTaskDefinitionResponse

The response from the DescribeTaskDefinition service method, as returned by ECS.

Exceptions

Exception	Condition
ClientException	These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.
InvalidParameterException	The specified parameter isn't valid. Review the available parameters for the API request.
ServerException	These errors are usually caused by a server issue.

Examples

This example provides a description of the specified task definition.

To describe a task definition


var client = new AmazonECSClient();
var response = client.DescribeTaskDefinition(new DescribeTaskDefinitionRequest 
{
    TaskDefinition = "hello_world:8"
});

TaskDefinition taskDefinition = response.TaskDefinition;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonECS.DescribeTaskDefinition (DescribeTaskDefinitionRequest)

Method