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