Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_deployments

list_deployments(**kwargs)

Retrieves a paginated list of deployments.

See also: AWS API Documentation

Request Syntax

response = client.list_deployments(
    targetArn='string',
    historyFilter='ALL'|'LATEST_ONLY',
    parentTargetArn='string',
    maxResults=123,
    nextToken='string'
)
Parameters
  • targetArn (string) -- The ARN of the target IoT thing or thing group.
  • historyFilter (string) --

    The filter for the list of deployments. Choose one of the following options:

    • ALL – The list includes all deployments.
    • LATEST_ONLY – The list includes only the latest revision of each deployment.

    Default: LATEST_ONLY

  • parentTargetArn (string) -- The parent deployment's target ARN within a subdeployment.
  • maxResults (integer) -- The maximum number of results to be returned per paginated request.
  • nextToken (string) -- The token to be used for the next set of paginated results.
Return type

dict

Returns

Response Syntax

{
    'deployments': [
        {
            'targetArn': 'string',
            'revisionId': 'string',
            'deploymentId': 'string',
            'deploymentName': 'string',
            'creationTimestamp': datetime(2015, 1, 1),
            'deploymentStatus': 'ACTIVE'|'COMPLETED'|'CANCELED'|'FAILED'|'INACTIVE',
            'isLatestForTarget': True|False,
            'parentTargetArn': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • deployments (list) --

      A list that summarizes each deployment.

      • (dict) --

        Contains information about a deployment.

        • targetArn (string) --

          The ARN of the target IoT thing or thing group. When creating a subdeployment, the targetARN can only be a thing group.

        • revisionId (string) --

          The revision number of the deployment.

        • deploymentId (string) --

          The ID of the deployment.

        • deploymentName (string) --

          The name of the deployment.

        • creationTimestamp (datetime) --

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

        • deploymentStatus (string) --

          The status of the deployment.

        • isLatestForTarget (boolean) --

          Whether or not the deployment is the latest revision for its target.

        • parentTargetArn (string) --

          The parent deployment's target ARN within a subdeployment.

    • nextToken (string) --

      The token for the next set of results, or null if there are no additional results.

Exceptions

  • GreengrassV2.Client.exceptions.ValidationException
  • GreengrassV2.Client.exceptions.AccessDeniedException
  • GreengrassV2.Client.exceptions.InternalServerException
  • GreengrassV2.Client.exceptions.ThrottlingException