list_components

list_components(**kwargs)

Retrieves a paginated list of component summaries. This list includes components that you have permission to view.

See also: AWS API Documentation

Request Syntax

response = client.list_components(
    scope='PRIVATE'|'PUBLIC',
    maxResults=123,
    nextToken='string'
)

Parameters

• scope (string) --

  The scope of the components to list.

  Default: PRIVATE

• 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

{
    'components': [
        {
            'arn': 'string',
            'componentName': 'string',
            'latestVersion': {
                'arn': 'string',
                'componentVersion': 'string',
                'creationTimestamp': datetime(2015, 1, 1),
                'description': 'string',
                'publisher': 'string',
                'platforms': [
                    {
                        'name': 'string',
                        'attributes': {
                            'string': 'string'
                        }
                    },
                ]
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) --

  • components (list) --

    A list that summarizes each component.

    • (dict) --

      Contains information about a component.

      • arn (string) --

        The ARN of the component version.

      • componentName (string) --

        The name of the component.

      • latestVersion (dict) --

        The latest version of the component and its details.

        • arn (string) --

          The ARN of the component version.

        • componentVersion (string) --

          The version of the component.

        • creationTimestamp (datetime) --

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

        • description (string) --

          The description of the component version.

        • publisher (string) --

          The publisher of the component version.

        • platforms (list) --

          The platforms that the component version supports.

          • (dict) --

            Contains information about a platform that a component supports.

            • name (string) --

              The friendly name of the platform. This name helps you identify the platform.

              If you omit this parameter, IoT Greengrass creates a friendly name from the os and architecture of the platform.

            • attributes (dict) --

              A dictionary of attributes for the platform. The IoT Greengrass Core software defines the os and architecture by default. You can specify additional platform attributes for a core device when you deploy the Greengrass nucleus component. For more information, see the Greengrass nucleus component in the IoT Greengrass V2 Developer Guide .

              • (string) --
                • (string) --

  • 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.ResourceNotFoundException
• GreengrassV2.Client.exceptions.ThrottlingException
• GreengrassV2.Client.exceptions.InternalServerException