GreengrassV2 / Paginator / ListEffectiveDeployments

ListEffectiveDeployments#

class GreengrassV2.Paginator.ListEffectiveDeployments#
paginator = client.get_paginator('list_effective_deployments')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from GreengrassV2.Client.list_effective_deployments().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    coreDeviceThingName='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • coreDeviceThingName (string) –

    [REQUIRED]

    The name of the core device. This is also the name of the IoT thing.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'effectiveDeployments': [
        {
            'deploymentId': 'string',
            'deploymentName': 'string',
            'iotJobId': 'string',
            'iotJobArn': 'string',
            'description': 'string',
            'targetArn': 'string',
            'coreDeviceExecutionStatus': 'IN_PROGRESS'|'QUEUED'|'FAILED'|'COMPLETED'|'TIMED_OUT'|'CANCELED'|'REJECTED'|'SUCCEEDED',
            'reason': 'string',
            'creationTimestamp': datetime(2015, 1, 1),
            'modifiedTimestamp': datetime(2015, 1, 1),
            'statusDetails': {
                'errorStack': [
                    'string',
                ],
                'errorTypes': [
                    'string',
                ]
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • effectiveDeployments (list) –

      A list that summarizes each deployment on the core device.

      • (dict) –

        Contains information about a deployment job that IoT Greengrass sends to a Greengrass core device.

        • deploymentId (string) –

          The ID of the deployment.

        • deploymentName (string) –

          The name of the deployment.

        • iotJobId (string) –

          The ID of the IoT job that applies the deployment to target devices.

        • iotJobArn (string) –

          The ARN of the IoT job that applies the deployment to target devices.

        • description (string) –

          The description of the deployment job.

        • targetArn (string) –

          The ARN of the target IoT thing or thing group.

        • coreDeviceExecutionStatus (string) –

          The status of the deployment job on the Greengrass core device.

          • IN_PROGRESS – The deployment job is running.

          • QUEUED – The deployment job is in the job queue and waiting to run.

          • FAILED – The deployment failed. For more information, see the statusDetails field.

          • COMPLETED – The deployment to an IoT thing was completed successfully.

          • TIMED_OUT – The deployment didn’t complete in the allotted time.

          • CANCELED – The deployment was canceled by the user.

          • REJECTED – The deployment was rejected. For more information, see the statusDetails field.

          • SUCCEEDED – The deployment to an IoT thing group was completed successfully.

        • reason (string) –

          The reason code for the update, if the job was updated.

        • creationTimestamp (datetime) –

          The time at which the deployment was created, expressed in ISO 8601 format.

        • modifiedTimestamp (datetime) –

          The time at which the deployment job was last modified, expressed in ISO 8601 format.

        • statusDetails (dict) –

          The status details that explain why a deployment has an error. This response will be null if the deployment is in a success state.

          • errorStack (list) –

            Contains an ordered list of short error codes that range from the most generic error to the most specific one. The error codes describe the reason for failure whenever the coreDeviceExecutionStatus is in a failed state. The response will be an empty list if there is no error.

            • (string) –

          • errorTypes (list) –

            Contains tags which describe the error. You can use the error types to classify errors to assist with remediating the failure. The response will be an empty list if there is no error.

            • (string) –

    • NextToken (string) –

      A token to resume pagination.