/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
/*
* Do not modify this file. This file is generated from the ecs-2014-11-13.normal.json service model.
*/
using System;
using System.Collections.Generic;
using System.Xml.Serialization;
using System.Text;
using System.IO;
using System.Net;
using Amazon.Runtime;
using Amazon.Runtime.Internal;
namespace Amazon.ECS.Model
{
///
/// Container for the parameters to the ListTasks operation.
/// Returns a list of tasks. You can filter the results by cluster, task definition family,
/// container instance, launch type, what IAM principal started the task, or by the desired
/// status of the task.
///
///
///
/// Recently stopped tasks might appear in the returned results. Currently, stopped tasks
/// appear in the returned results for at least one hour.
///
///
public partial class ListTasksRequest : AmazonECSRequest
{
private string _cluster;
private string _containerInstance;
private DesiredStatus _desiredStatus;
private string _family;
private LaunchType _launchType;
private int? _maxResults;
private string _nextToken;
private string _serviceName;
private string _startedBy;
///
/// Gets and sets the property Cluster.
///
/// The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering
/// the ListTasks
results. If you do not specify a cluster, the default cluster
/// is assumed.
///
///
public string Cluster
{
get { return this._cluster; }
set { this._cluster = value; }
}
// Check to see if Cluster property is set
internal bool IsSetCluster()
{
return this._cluster != null;
}
///
/// Gets and sets the property ContainerInstance.
///
/// The container instance ID or full ARN of the container instance to use when filtering
/// the ListTasks
results. Specifying a containerInstance
limits
/// the results to tasks that belong to that container instance.
///
///
public string ContainerInstance
{
get { return this._containerInstance; }
set { this._containerInstance = value; }
}
// Check to see if ContainerInstance property is set
internal bool IsSetContainerInstance()
{
return this._containerInstance != null;
}
///
/// Gets and sets the property DesiredStatus.
///
/// The task desired status to use when filtering the ListTasks
results.
/// Specifying a desiredStatus
of STOPPED
limits the results
/// to tasks that Amazon ECS has set the desired status to STOPPED
. This
/// can be useful for debugging tasks that aren't starting properly or have died or finished.
/// The default status filter is RUNNING
, which shows tasks that Amazon ECS
/// has set the desired status to RUNNING
.
///
///
///
/// Although you can filter results based on a desired status of PENDING
,
/// this doesn't return any results. Amazon ECS never sets the desired status of a task
/// to that value (only a task's lastStatus
may have a value of PENDING
).
///
///
///
public DesiredStatus DesiredStatus
{
get { return this._desiredStatus; }
set { this._desiredStatus = value; }
}
// Check to see if DesiredStatus property is set
internal bool IsSetDesiredStatus()
{
return this._desiredStatus != null;
}
///
/// Gets and sets the property Family.
///
/// The name of the task definition family to use when filtering the ListTasks
/// results. Specifying a family
limits the results to tasks that belong
/// to that family.
///
///
public string Family
{
get { return this._family; }
set { this._family = value; }
}
// Check to see if Family property is set
internal bool IsSetFamily()
{
return this._family != null;
}
///
/// Gets and sets the property LaunchType.
///
/// The launch type to use when filtering the ListTasks
results.
///
///
public LaunchType LaunchType
{
get { return this._launchType; }
set { this._launchType = value; }
}
// Check to see if LaunchType property is set
internal bool IsSetLaunchType()
{
return this._launchType != null;
}
///
/// Gets and sets the property MaxResults.
///
/// The maximum number of task results that ListTasks
returned in paginated
/// output. When this parameter is used, ListTasks
only returns maxResults
/// results in a single page along with a nextToken
response element. The
/// remaining results of the initial request can be seen by sending another ListTasks
/// request with the returned nextToken
value. This value can be between
/// 1 and 100. If this parameter isn't used, then ListTasks
returns up to
/// 100 results and a nextToken
value if applicable.
///
///
public int MaxResults
{
get { return this._maxResults.GetValueOrDefault(); }
set { this._maxResults = value; }
}
// Check to see if MaxResults property is set
internal bool IsSetMaxResults()
{
return this._maxResults.HasValue;
}
///
/// Gets and sets the property NextToken.
///
/// The nextToken
value returned from a ListTasks
request indicating
/// that more results are available to fulfill the request and further calls will be needed.
/// If maxResults
was provided, it's possible the number of results to be
/// fewer than maxResults
.
///
///
///
/// This token should be treated as an opaque identifier that is only used to retrieve
/// the next items in a list and not for other programmatic purposes.
///
///
///
public string NextToken
{
get { return this._nextToken; }
set { this._nextToken = value; }
}
// Check to see if NextToken property is set
internal bool IsSetNextToken()
{
return this._nextToken != null;
}
///
/// Gets and sets the property ServiceName.
///
/// The name of the service to use when filtering the ListTasks
results.
/// Specifying a serviceName
limits the results to tasks that belong to that
/// service.
///
///
public string ServiceName
{
get { return this._serviceName; }
set { this._serviceName = value; }
}
// Check to see if ServiceName property is set
internal bool IsSetServiceName()
{
return this._serviceName != null;
}
///
/// Gets and sets the property StartedBy.
///
/// The startedBy
value to filter the task results with. Specifying a startedBy
/// value limits the results to tasks that were started with that value.
///
///
///
/// When you specify startedBy
as the filter, it must be the only filter
/// that you use.
///
///
public string StartedBy
{
get { return this._startedBy; }
set { this._startedBy = value; }
}
// Check to see if StartedBy property is set
internal bool IsSetStartedBy()
{
return this._startedBy != null;
}
}
}