The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Paws::ECS - Perl Interface to AWS Amazon EC2 Container Service

SYNOPSIS

  use Paws;

  my $obj = Paws->service('...')->new;
  my $res = $obj->Method(Arg1 => $val1, Arg2 => $val2);

DESCRIPTION

Amazon EC2 Container Service (Amazon ECS) is a highly scalable, fast, container management service that makes it easy to run, stop, and manage Docker containers on a cluster of Amazon EC2 instances. Amazon ECS lets you launch and stop container-enabled applications with simple API calls, allows you to get the state of your cluster from a centralized service, and gives you access to many familiar Amazon EC2 features like security groups, Amazon EBS volumes, and IAM roles.

You can use Amazon ECS to schedule the placement of containers across your cluster based on your resource needs, isolation policies, and availability requirements. Amazon EC2 Container Service eliminates the need for you to operate your own cluster management and configuration management systems or worry about scaling your management infrastructure.

METHODS

CreateCluster()

  Arguments described in: L<Paws::ECS::CreateCluster>

  Returns: L<Paws::ECS::CreateClusterResponse>

  

Creates a new Amazon ECS cluster. By default, your account will receive a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the CreateCluster action.

During the preview, each account is limited to two clusters.

DeleteCluster()

  Arguments described in: L<Paws::ECS::DeleteCluster>

  Returns: L<Paws::ECS::DeleteClusterResponse>

  

Deletes the specified cluster. You must deregister all container instances from this cluster before you may delete it. You can list the container instances in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.

DeregisterContainerInstance()

  Arguments described in: L<Paws::ECS::DeregisterContainerInstance>

  Returns: L<Paws::ECS::DeregisterContainerInstanceResponse>

  

Deregisters an Amazon ECS container instance from the specified cluster. This instance will no longer be available to run tasks.

DeregisterTaskDefinition()

  Arguments described in: L<Paws::ECS::DeregisterTaskDefinition>

  Returns: L<Paws::ECS::DeregisterTaskDefinitionResponse>

  

NOT YET IMPLEMENTED.

Deregisters the specified task definition. You will no longer be able to run tasks from this definition after deregistration.

DescribeClusters()

  Arguments described in: L<Paws::ECS::DescribeClusters>

  Returns: L<Paws::ECS::DescribeClustersResponse>

  

Describes one or more of your clusters.

DescribeContainerInstances()

  Arguments described in: L<Paws::ECS::DescribeContainerInstances>

  Returns: L<Paws::ECS::DescribeContainerInstancesResponse>

  

Describes Amazon EC2 Container Service container instances. Returns metadata about registered and remaining resources on each container instance requested.

DescribeTaskDefinition()

  Arguments described in: L<Paws::ECS::DescribeTaskDefinition>

  Returns: L<Paws::ECS::DescribeTaskDefinitionResponse>

  

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

DescribeTasks()

  Arguments described in: L<Paws::ECS::DescribeTasks>

  Returns: L<Paws::ECS::DescribeTasksResponse>

  

Describes a specified task or tasks.

DiscoverPollEndpoint()

  Arguments described in: L<Paws::ECS::DiscoverPollEndpoint>

  Returns: L<Paws::ECS::DiscoverPollEndpointResponse>

  

This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.

Returns an endpoint for the Amazon EC2 Container Service agent to poll for updates.

ListClusters()

  Arguments described in: L<Paws::ECS::ListClusters>

  Returns: L<Paws::ECS::ListClustersResponse>

  

Returns a list of existing clusters.

ListContainerInstances()

  Arguments described in: L<Paws::ECS::ListContainerInstances>

  Returns: L<Paws::ECS::ListContainerInstancesResponse>

  

Returns a list of container instances in a specified cluster.

ListTaskDefinitionFamilies()

  Arguments described in: L<Paws::ECS::ListTaskDefinitionFamilies>

  Returns: L<Paws::ECS::ListTaskDefinitionFamiliesResponse>

  

Returns a list of task definition families that are registered to your account. You can filter the results with the familyPrefix parameter.

ListTaskDefinitions()

  Arguments described in: L<Paws::ECS::ListTaskDefinitions>

  Returns: L<Paws::ECS::ListTaskDefinitionsResponse>

  

Returns a list of task definitions that are registered to your account. You can filter the results by family name with the familyPrefix parameter.

ListTasks()

  Arguments described in: L<Paws::ECS::ListTasks>

  Returns: L<Paws::ECS::ListTasksResponse>

  

Returns a list of tasks for a specified cluster. You can filter the results by family name or by a particular container instance with the family and containerInstance parameters.

RegisterContainerInstance()

  Arguments described in: L<Paws::ECS::RegisterContainerInstance>

  Returns: L<Paws::ECS::RegisterContainerInstanceResponse>

  

This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.

Registers an Amazon EC2 instance into the specified cluster. This instance will become available to place containers on.

RegisterTaskDefinition()

  Arguments described in: L<Paws::ECS::RegisterTaskDefinition>

  Returns: L<Paws::ECS::RegisterTaskDefinitionResponse>

  

Registers a new task definition from the supplied family and containerDefinitions. Optionally, you can add data volumes to your containers with the volumes parameter. For more information on task definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon EC2 Container Service Developer Guide.

RunTask()

  Arguments described in: L<Paws::ECS::RunTask>

  Returns: L<Paws::ECS::RunTaskResponse>

  

Start a task using random placement and the default Amazon ECS scheduler. If you want to use your own scheduler or place a task on a specific container instance, use StartTask instead.

StartTask()

  Arguments described in: L<Paws::ECS::StartTask>

  Returns: L<Paws::ECS::StartTaskResponse>

  

Starts a new task from the specified task definition on the specified container instance or instances. If you want to use the default Amazon ECS scheduler to place your task, use RunTask instead.

StopTask()

  Arguments described in: L<Paws::ECS::StopTask>

  Returns: L<Paws::ECS::StopTaskResponse>

  

Stops a running task.

SubmitContainerStateChange()

  Arguments described in: L<Paws::ECS::SubmitContainerStateChange>

  Returns: L<Paws::ECS::SubmitContainerStateChangeResponse>

  

This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a container changed states.

SubmitTaskStateChange()

  Arguments described in: L<Paws::ECS::SubmitTaskStateChange>

  Returns: L<Paws::ECS::SubmitTaskStateChangeResponse>

  

This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a task changed states.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues