ECS / Client / list_daemons

list_daemons¶

ECS.Client.list_daemons(**kwargs)¶

Returns a list of daemons. You can filter the results by cluster or capacity provider.

Request Syntax

response = client.list_daemons(
    clusterArn='string',
    capacityProviderArns=[
        'string',
    ],
    maxResults=123,
    nextToken='string'
)

Parameters:

clusterArn (string) – The Amazon Resource Name (ARN) of the cluster to filter daemons by. If not specified, daemons from all clusters are returned.
capacityProviderArns (list) –
The Amazon Resource Names (ARNs) of the capacity providers to filter daemons by. Only daemons associated with the specified capacity providers are returned.
- (string) –
maxResults (integer) – The maximum number of daemon results that ListDaemons returned in paginated output. When this parameter is used, ListDaemons 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 ListDaemons request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn’t used, then ListDaemons returns up to 100 results and a nextToken value if applicable.
nextToken (string) –
The nextToken value returned from a ListDaemons request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it’s possible for the number of results to be fewer than maxResults.

Note
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.

Return type:

dict

Returns:

Response Syntax

{
    'daemonSummariesList': [
        {
            'daemonArn': 'string',
            'status': 'ACTIVE'|'DELETE_IN_PROGRESS',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- daemonSummariesList (list) –
  
  The list of daemon summaries.
  - (dict) –
    
    A summary of a daemon.
    - daemonArn (string) –
      
      The Amazon Resource Name (ARN) of the daemon.
    - status (string) –
      
      The status of the daemon.
    - createdAt (datetime) –
      
      The Unix timestamp for the time when the daemon was created.
    - updatedAt (datetime) –
      
      The Unix timestamp for the time when the daemon was last updated.
- nextToken (string) –
  
  The nextToken value to include in a future ListDaemons request. When the results of a ListDaemons request exceed maxResults, this value can be used to retrieve the next page of results.

Exceptions

ECS.Client.exceptions.AccessDeniedException
ECS.Client.exceptions.ServerException
ECS.Client.exceptions.InvalidParameterException
ECS.Client.exceptions.ClientException
ECS.Client.exceptions.ClusterNotFoundException
ECS.Client.exceptions.UnsupportedFeatureException