ECS / Client / describe_daemon_revisions

describe_daemon_revisions¶

ECS.Client.describe_daemon_revisions(**kwargs)¶

Describes one or more of your daemon revisions.

A daemon revision is a snapshot of a daemon’s configuration at the time a deployment was initiated. It captures the daemon task definition, container images, tag propagation, and execute command settings. Daemon revisions are immutable.

Request Syntax

response = client.describe_daemon_revisions(
    daemonRevisionArns=[
        'string',
    ]
)

Parameters:

daemonRevisionArns (list) –

[REQUIRED]

The ARN of the daemon revisions to describe. You can specify up to 20 ARNs.

(string) –

Return type:

dict

Returns:

Response Syntax

{
    'daemonRevisions': [
        {
            'daemonRevisionArn': 'string',
            'clusterArn': 'string',
            'daemonArn': 'string',
            'daemonTaskDefinitionArn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'containerImages': [
                {
                    'containerName': 'string',
                    'imageDigest': 'string',
                    'image': 'string'
                },
            ],
            'propagateTags': 'DAEMON'|'NONE',
            'enableECSManagedTags': True|False,
            'enableExecuteCommand': True|False,
            'critical': True|False
        },
    ],
    'failures': [
        {
            'arn': 'string',
            'reason': 'string',
            'detail': 'string'
        },
    ]
}

Response Structure

(dict) –
- daemonRevisions (list) –
  
  The list of daemon revisions.
  - (dict) –
    
    Information about a daemon revision. A daemon revision is a snapshot of the daemon’s configuration at the time a deployment was initiated.
    - daemonRevisionArn (string) –
      
      The Amazon Resource Name (ARN) of the daemon revision.
    - clusterArn (string) –
      
      The Amazon Resource Name (ARN) of the cluster that hosts the daemon.
    - daemonArn (string) –
      
      The Amazon Resource Name (ARN) of the daemon for this revision.
    - daemonTaskDefinitionArn (string) –
      
      The Amazon Resource Name (ARN) of the daemon task definition used by this revision.
    - createdAt (datetime) –
      
      The Unix timestamp for the time when the daemon revision was created.
    - containerImages (list) –
      
      The container images used by the daemon revision.
      - (dict) –
        
        The details about the container image a daemon revision uses.
        
        containerName (string) –
        
        The name of the container.
        
        imageDigest (string) –
        
        The container image digest.
        
        image (string) –
        
        The container image.
    - propagateTags (string) –
      
      Specifies whether tags are propagated from the daemon to the daemon tasks.
    - enableECSManagedTags (boolean) –
      
      Specifies whether Amazon ECS managed tags are turned on for the daemon tasks.
    - enableExecuteCommand (boolean) –
      
      Specifies whether the execute command functionality is turned on for the daemon tasks.
    - critical (boolean) –
      
      If the critical parameter of this daemon revision is true, and the daemon task fails, stops, or becomes unhealthy, Amazon ECS drains the container instance and stops the other tasks running on it. If the parameter is false, the daemon task failure doesn’t affect the other tasks on the instance, and doesn’t block instance registration. The default value is true.
- failures (list) –
  
  Any failures associated with the call.
  - (dict) –
    
    A failed resource. For a list of common causes, see API failure reasons in the Amazon Elastic Container Service Developer Guide.
    - arn (string) –
      
      The Amazon Resource Name (ARN) of the failed resource.
    - reason (string) –
      
      The reason for the failure.
    - detail (string) –
      
      The details of the failure.

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