ElastiCache / Client / describe_update_actions

describe_update_actions#

ElastiCache.Client.describe_update_actions(**kwargs)#

Returns details of the update actions

See also: AWS API Documentation

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 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 Redis OSS or Memcached.

Exceptions

  • ElastiCache.Client.exceptions.InvalidParameterValueException

  • ElastiCache.Client.exceptions.InvalidParameterCombinationException