ElastiCache / Client / describe_update_actions

describe_update_actions#

ElastiCache.Client.describe_update_actions(**kwargs)#

Returns details of the update actions

Request Syntax

response = client.describe_update_actions(
    ServiceUpdateName='string',
    ReplicationGroupIds=[
        'string',
    ],
    CacheClusterIds=[
        'string',
    ],
    Engine='string',
    ServiceUpdateStatus=[
        'available'|'cancelled'|'expired',
    ],
    ServiceUpdateTimeRange={
        'StartTime': datetime(2015, 1, 1),
        'EndTime': datetime(2015, 1, 1)
    },
    UpdateActionStatus=[
        'not-applied'|'waiting-to-start'|'in-progress'|'stopping'|'stopped'|'complete'|'scheduling'|'scheduled'|'not-applicable',
    ],
    ShowNodeLevelUpdateStatus=True|False,
    MaxRecords=123,
    Marker='string'
)

Parameters:

ServiceUpdateName (string) – The unique ID of the service update
ReplicationGroupIds (list) –
The replication group IDs
- (string) –
CacheClusterIds (list) –
The cache cluster IDs
- (string) –
Engine (string) – The Elasticache engine to which the update applies. Either Valkey, Redis OSS or Memcached.
ServiceUpdateStatus (list) –
The status of the service update
- (string) –
ServiceUpdateTimeRange (dict) –
The range of time specified to search for service updates that are in available status
- StartTime (datetime) –
  
  The start time of the time range filter
- EndTime (datetime) –
  
  The end time of the time range filter
UpdateActionStatus (list) –
The status of the update action.
- (string) –
ShowNodeLevelUpdateStatus (boolean) – Dictates whether to include node level update status in the response
MaxRecords (integer) – The maximum number of records to include in the response
Marker (string) – An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Return type:

dict

Returns:

Response Syntax

{
    'Marker': 'string',
    'UpdateActions': [
        {
            'ReplicationGroupId': 'string',
            'CacheClusterId': 'string',
            'ServiceUpdateName': 'string',
            'ServiceUpdateReleaseDate': datetime(2015, 1, 1),
            'ServiceUpdateSeverity': 'critical'|'important'|'medium'|'low',
            'ServiceUpdateStatus': 'available'|'cancelled'|'expired',
            'ServiceUpdateRecommendedApplyByDate': datetime(2015, 1, 1),
            'ServiceUpdateType': 'security-update',
            'UpdateActionAvailableDate': datetime(2015, 1, 1),
            'UpdateActionStatus': 'not-applied'|'waiting-to-start'|'in-progress'|'stopping'|'stopped'|'complete'|'scheduling'|'scheduled'|'not-applicable',
            'NodesUpdated': 'string',
            'UpdateActionStatusModifiedDate': datetime(2015, 1, 1),
            'SlaMet': 'yes'|'no'|'n/a',
            'NodeGroupUpdateStatus': [
                {
                    'NodeGroupId': 'string',
                    'NodeGroupMemberUpdateStatus': [
                        {
                            'CacheClusterId': 'string',
                            'CacheNodeId': 'string',
                            'NodeUpdateStatus': 'not-applied'|'waiting-to-start'|'in-progress'|'stopping'|'stopped'|'complete',
                            'NodeDeletionDate': datetime(2015, 1, 1),
                            'NodeUpdateStartDate': datetime(2015, 1, 1),
                            'NodeUpdateEndDate': datetime(2015, 1, 1),
                            'NodeUpdateInitiatedBy': 'system'|'customer',
                            'NodeUpdateInitiatedDate': datetime(2015, 1, 1),
                            'NodeUpdateStatusModifiedDate': datetime(2015, 1, 1)
                        },
                    ]
                },
            ],
            'CacheNodeUpdateStatus': [
                {
                    'CacheNodeId': 'string',
                    'NodeUpdateStatus': 'not-applied'|'waiting-to-start'|'in-progress'|'stopping'|'stopped'|'complete',
                    'NodeDeletionDate': datetime(2015, 1, 1),
                    'NodeUpdateStartDate': datetime(2015, 1, 1),
                    'NodeUpdateEndDate': datetime(2015, 1, 1),
                    'NodeUpdateInitiatedBy': 'system'|'customer',
                    'NodeUpdateInitiatedDate': datetime(2015, 1, 1),
                    'NodeUpdateStatusModifiedDate': datetime(2015, 1, 1)
                },
            ],
            'EstimatedUpdateTime': 'string',
            'Engine': 'string'
        },
    ]
}

Response Structure

(dict) –
- Marker (string) –
  
  An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
- UpdateActions (list) –
  
  Returns a list of update actions
  - (dict) –
    
    The status of the service update for a specific replication group
    - ReplicationGroupId (string) –
      
      The ID of the replication group
    - CacheClusterId (string) –
      
      The ID of the cache cluster
    - ServiceUpdateName (string) –
      
      The unique ID of the service update
    - ServiceUpdateReleaseDate (datetime) –
      
      The date the update is first available
    - ServiceUpdateSeverity (string) –
      
      The severity of the service update
    - ServiceUpdateStatus (string) –
      
      The status of the service update
    - ServiceUpdateRecommendedApplyByDate (datetime) –
      
      The recommended date to apply the service update to ensure compliance. For information on compliance, see Self-Service Security Updates for Compliance.
    - ServiceUpdateType (string) –
      
      Reflects the nature of the service update
    - UpdateActionAvailableDate (datetime) –
      
      The date that the service update is available to a replication group
    - UpdateActionStatus (string) –
      
      The status of the update action
    - NodesUpdated (string) –
      
      The progress of the service update on the replication group
    - UpdateActionStatusModifiedDate (datetime) –
      
      The date when the UpdateActionStatus was last modified
    - SlaMet (string) –
      
      If yes, all nodes in the replication group have been updated by the recommended apply-by date. If no, at least one node in the replication group have not been updated by the recommended apply-by date. If N/A, the replication group was created after the recommended apply-by date.
    - NodeGroupUpdateStatus (list) –
      
      The status of the service update on the node group
      - (dict) –
        
        The status of the service update on the node group
        
        NodeGroupId (string) –
        
        The ID of the node group
        
        NodeGroupMemberUpdateStatus (list) –
        
        The status of the service update on the node group member
        
        (dict) –
        
        The status of the service update on the node group member
        
        CacheClusterId (string) –
        
        The cache cluster ID
        
        CacheNodeId (string) –
        
        The node ID of the cache cluster
        
        NodeUpdateStatus (string) –
        
        The update status of the node
        
        NodeDeletionDate (datetime) –
        
        The deletion date of the node
        
        NodeUpdateStartDate (datetime) –
        
        The start date of the update for a node
        
        NodeUpdateEndDate (datetime) –
        
        The end date of the update for a node
        
        NodeUpdateInitiatedBy (string) –
        
        Reflects whether the update was initiated by the customer or automatically applied
        
        NodeUpdateInitiatedDate (datetime) –
        
        The date when the update is triggered
        
        NodeUpdateStatusModifiedDate (datetime) –
        
        The date when the NodeUpdateStatus was last modified
    - CacheNodeUpdateStatus (list) –
      
      The status of the service update on the cache node
      - (dict) –
        
        The status of the service update on the cache node
        
        CacheNodeId (string) –
        
        The node ID of the cache cluster
        
        NodeUpdateStatus (string) –
        
        The update status of the node
        
        NodeDeletionDate (datetime) –
        
        The deletion date of the node
        
        NodeUpdateStartDate (datetime) –
        
        The start date of the update for a node
        
        NodeUpdateEndDate (datetime) –
        
        The end date of the update for a node
        
        NodeUpdateInitiatedBy (string) –
        
        Reflects whether the update was initiated by the customer or automatically applied
        
        NodeUpdateInitiatedDate (datetime) –
        
        The date when the update is triggered
        
        NodeUpdateStatusModifiedDate (datetime) –
        
        The date when the NodeUpdateStatus was last modified>
    - EstimatedUpdateTime (string) –
      
      The estimated length of time for the update to complete
    - Engine (string) –
      
      The Elasticache engine to which the update applies. Either Valkey, Redis OSS or Memcached.

describe_update_actions#

Request Syntax

Response Syntax

Response Structure

Exceptions