ECS / Client / describe_daemon

describe_daemon¶

ECS.Client.describe_daemon(**kwargs)¶

Describes the specified daemon.

Request Syntax

response = client.describe_daemon(
    daemonArn='string'
)

Parameters:

daemonArn (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the daemon to describe.

Return type:

dict

Returns:

Response Syntax

{
    'daemon': {
        'daemonArn': 'string',
        'clusterArn': 'string',
        'status': 'ACTIVE'|'DELETE_IN_PROGRESS',
        'currentRevisions': [
            {
                'arn': 'string',
                'capacityProviders': [
                    {
                        'arn': 'string',
                        'runningCount': 123,
                        'withoutDaemonCount': 123
                    },
                ],
                'totalRunningCount': 123,
                'totalWithoutDaemonCount': 123
            },
        ],
        'deploymentArn': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) –
- daemon (dict) –
  
  The full description of the daemon, including the current revisions, deployment ARN, cluster, and status information.
  - daemonArn (string) –
    
    The Amazon Resource Name (ARN) of the daemon.
  - clusterArn (string) –
    
    The Amazon Resource Name (ARN) of the cluster that the daemon is running in.
  - status (string) –
    
    The status of the daemon.
  - currentRevisions (list) –
    
    The current daemon revision details, including the running task counts per capacity provider.
    - (dict) –
      
      Details about a daemon revision, including the running task counts per capacity provider.
      - arn (string) –
        
        The Amazon Resource Name (ARN) of the daemon revision.
      - capacityProviders (list) –
        
        The capacity providers associated with this daemon revision.
        
        (dict) –
        
        Information about a capacity provider associated with a daemon revision.
        
        arn (string) –
        
        The Amazon Resource Name (ARN) of the capacity provider.
        
        runningCount (integer) –
        
        The number of daemon tasks running on this capacity provider.
        
        withoutDaemonCount (integer) –
        
        The number of instances on this capacity provider that are running without the daemon task. This applies to daemons that aren’t critical, where the instance remains available for your other tasks even if the daemon task can’t start or stops. These instances aren’t included in runningCount.
      - totalRunningCount (integer) –
        
        The total number of daemon tasks running for this revision.
      - totalWithoutDaemonCount (integer) –
        
        The total number of instances running without the daemon task for this revision, across all capacity providers. These instances aren’t included in totalRunningCount.
  - deploymentArn (string) –
    
    The Amazon Resource Name (ARN) of the most recent daemon deployment.
  - 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.

Exceptions

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