github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/ecs/getTaskDefinition.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package ecs

import (
	"context"
	"reflect"

	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// The ECS task definition data source allows access to details of
// a specific AWS ECS task definition.
//
// ## Example Usage
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecs"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			mongoTaskDefinition, err := ecs.NewTaskDefinition(ctx, "mongo", &ecs.TaskDefinitionArgs{
//				Family: pulumi.String("mongodb"),
//				ContainerDefinitions: pulumi.String(`[
//	  {
//	    "cpu": 128,
//	    "environment": [{
//	      "name": "SECRET",
//	      "value": "KEY"
//	    }],
//	    "essential": true,
//	    "image": "mongo:latest",
//	    "memory": 128,
//	    "memoryReservation": 64,
//	    "name": "mongodb"
//	  }
//
// ]
// `),
//
//			})
//			if err != nil {
//				return err
//			}
//			// Simply specify the family to find the latest ACTIVE revision in that family.
//			mongo := ecs.LookupTaskDefinitionOutput(ctx, ecs.GetTaskDefinitionOutputArgs{
//				TaskDefinition: mongoTaskDefinition.Family,
//			}, nil)
//			foo, err := ecs.NewCluster(ctx, "foo", &ecs.ClusterArgs{
//				Name: pulumi.String("foo"),
//			})
//			if err != nil {
//				return err
//			}
//			_, err = ecs.NewService(ctx, "mongo", &ecs.ServiceArgs{
//				Name:         pulumi.String("mongo"),
//				Cluster:      foo.ID(),
//				DesiredCount: pulumi.Int(2),
//				TaskDefinition: mongo.ApplyT(func(mongo ecs.GetTaskDefinitionResult) (*string, error) {
//					return &mongo.Arn, nil
//				}).(pulumi.StringPtrOutput),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
func LookupTaskDefinition(ctx *pulumi.Context, args *LookupTaskDefinitionArgs, opts ...pulumi.InvokeOption) (*LookupTaskDefinitionResult, error) {
	opts = internal.PkgInvokeDefaultOpts(opts)
	var rv LookupTaskDefinitionResult
	err := ctx.Invoke("aws:ecs/getTaskDefinition:getTaskDefinition", args, &rv, opts...)
	if err != nil {
		return nil, err
	}
	return &rv, nil
}

// A collection of arguments for invoking getTaskDefinition.
type LookupTaskDefinitionArgs struct {
	// Family for the latest ACTIVE revision, family and revision (family:revision) for a specific revision in the family, the ARN of the task definition to access to.
	TaskDefinition string `pulumi:"taskDefinition"`
}

// A collection of values returned by getTaskDefinition.
type LookupTaskDefinitionResult struct {
	// ARN of the task definition.
	Arn string `pulumi:"arn"`
	// ARN of the Task Definition with the trailing `revision` removed. This may be useful for situations where the latest task definition is always desired. If a revision isn't specified, the latest ACTIVE revision is used. See the [AWS documentation](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_StartTask.html#ECS-StartTask-request-taskDefinition) for details.
	ArnWithoutRevision string `pulumi:"arnWithoutRevision"`
	// ARN of the task execution role that the Amazon ECS container agent and the Docker.
	ExecutionRoleArn string `pulumi:"executionRoleArn"`
	// Family of this task definition.
	Family string `pulumi:"family"`
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// Docker networking mode to use for the containers in this task.
	NetworkMode string `pulumi:"networkMode"`
	// Revision of this task definition.
	Revision int `pulumi:"revision"`
	// Status of this task definition.
	Status         string `pulumi:"status"`
	TaskDefinition string `pulumi:"taskDefinition"`
	// ARN of the IAM role that containers in this task can assume.
	TaskRoleArn string `pulumi:"taskRoleArn"`
}

func LookupTaskDefinitionOutput(ctx *pulumi.Context, args LookupTaskDefinitionOutputArgs, opts ...pulumi.InvokeOption) LookupTaskDefinitionResultOutput {
	return pulumi.ToOutputWithContext(context.Background(), args).
		ApplyT(func(v interface{}) (LookupTaskDefinitionResult, error) {
			args := v.(LookupTaskDefinitionArgs)
			r, err := LookupTaskDefinition(ctx, &args, opts...)
			var s LookupTaskDefinitionResult
			if r != nil {
				s = *r
			}
			return s, err
		}).(LookupTaskDefinitionResultOutput)
}

// A collection of arguments for invoking getTaskDefinition.
type LookupTaskDefinitionOutputArgs struct {
	// Family for the latest ACTIVE revision, family and revision (family:revision) for a specific revision in the family, the ARN of the task definition to access to.
	TaskDefinition pulumi.StringInput `pulumi:"taskDefinition"`
}

func (LookupTaskDefinitionOutputArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupTaskDefinitionArgs)(nil)).Elem()
}

// A collection of values returned by getTaskDefinition.
type LookupTaskDefinitionResultOutput struct{ *pulumi.OutputState }

func (LookupTaskDefinitionResultOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupTaskDefinitionResult)(nil)).Elem()
}

func (o LookupTaskDefinitionResultOutput) ToLookupTaskDefinitionResultOutput() LookupTaskDefinitionResultOutput {
	return o
}

func (o LookupTaskDefinitionResultOutput) ToLookupTaskDefinitionResultOutputWithContext(ctx context.Context) LookupTaskDefinitionResultOutput {
	return o
}

// ARN of the task definition.
func (o LookupTaskDefinitionResultOutput) Arn() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.Arn }).(pulumi.StringOutput)
}

// ARN of the Task Definition with the trailing `revision` removed. This may be useful for situations where the latest task definition is always desired. If a revision isn't specified, the latest ACTIVE revision is used. See the [AWS documentation](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_StartTask.html#ECS-StartTask-request-taskDefinition) for details.
func (o LookupTaskDefinitionResultOutput) ArnWithoutRevision() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.ArnWithoutRevision }).(pulumi.StringOutput)
}

// ARN of the task execution role that the Amazon ECS container agent and the Docker.
func (o LookupTaskDefinitionResultOutput) ExecutionRoleArn() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.ExecutionRoleArn }).(pulumi.StringOutput)
}

// Family of this task definition.
func (o LookupTaskDefinitionResultOutput) Family() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.Family }).(pulumi.StringOutput)
}

// The provider-assigned unique ID for this managed resource.
func (o LookupTaskDefinitionResultOutput) Id() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.Id }).(pulumi.StringOutput)
}

// Docker networking mode to use for the containers in this task.
func (o LookupTaskDefinitionResultOutput) NetworkMode() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.NetworkMode }).(pulumi.StringOutput)
}

// Revision of this task definition.
func (o LookupTaskDefinitionResultOutput) Revision() pulumi.IntOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) int { return v.Revision }).(pulumi.IntOutput)
}

// Status of this task definition.
func (o LookupTaskDefinitionResultOutput) Status() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.Status }).(pulumi.StringOutput)
}

func (o LookupTaskDefinitionResultOutput) TaskDefinition() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.TaskDefinition }).(pulumi.StringOutput)
}

// ARN of the IAM role that containers in this task can assume.
func (o LookupTaskDefinitionResultOutput) TaskRoleArn() pulumi.StringOutput {
	return o.ApplyT(func(v LookupTaskDefinitionResult) string { return v.TaskRoleArn }).(pulumi.StringOutput)
}

func init() {
	pulumi.RegisterOutputType(LookupTaskDefinitionResultOutput{})
}