IoTTwinMaker / Client / list_components

list_components#

IoTTwinMaker.Client.list_components(**kwargs)#

This API lists the components of an entity.

See also: AWS API Documentation

Request Syntax

response = client.list_components(
    workspaceId='string',
    entityId='string',
    componentPath='string',
    maxResults=123,
    nextToken='string'
)
Parameters:
  • workspaceId (string) –

    [REQUIRED]

    The workspace ID.

  • entityId (string) –

    [REQUIRED]

    The ID for the entity whose metadata (component/properties) is returned by the operation.

  • componentPath (string) – This string specifies the path to the composite component, starting from the top-level component.

  • maxResults (integer) – The maximum number of results returned at one time. The default is 25.

  • nextToken (string) – The string that specifies the next page of results.

Return type:

dict

Returns:

Response Syntax

{
    'componentSummaries': [
        {
            'componentName': 'string',
            'componentTypeId': 'string',
            'definedIn': 'string',
            'description': 'string',
            'propertyGroups': {
                'string': {
                    'groupType': 'TABULAR',
                    'propertyNames': [
                        'string',
                    ],
                    'isInherited': True|False
                }
            },
            'status': {
                'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR',
                'error': {
                    'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE'|'SYNC_INITIALIZING_ERROR'|'SYNC_CREATING_ERROR'|'SYNC_PROCESSING_ERROR'|'SYNC_DELETING_ERROR'|'PROCESSING_ERROR'|'COMPOSITE_COMPONENT_FAILURE',
                    'message': 'string'
                }
            },
            'syncSource': 'string',
            'componentPath': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • componentSummaries (list) –

      A list of objects that contain information about the components.

      • (dict) –

        An object that returns information about a component summary.

        • componentName (string) –

          The name of the component.

        • componentTypeId (string) –

          The ID of the component type.

        • definedIn (string) –

          The name of the property definition set in the request.

        • description (string) –

          The description of the component request.

        • propertyGroups (dict) –

          The property groups.

          • (string) –

            • (dict) –

              The component property group response.

              • groupType (string) –

                The group type.

              • propertyNames (list) –

                The names of properties

                • (string) –

              • isInherited (boolean) –

                A Boolean value that specifies whether the property group is inherited from a parent entity

        • status (dict) –

          The status of the component type.

          • state (string) –

            The current state of the entity, component, component type, or workspace.

          • error (dict) –

            The error message.

            • code (string) –

              The error code.

            • message (string) –

              The error message.

        • syncSource (string) –

          The syncSource of the sync job, if this entity was created by a sync job.

        • componentPath (string) –

          This string specifies the path to the composite component, starting from the top-level component.

    • nextToken (string) –

      The string that specifies the next page of component results.

Exceptions

  • IoTTwinMaker.Client.exceptions.InternalServerException

  • IoTTwinMaker.Client.exceptions.AccessDeniedException

  • IoTTwinMaker.Client.exceptions.ResourceNotFoundException

  • IoTTwinMaker.Client.exceptions.ThrottlingException

  • IoTTwinMaker.Client.exceptions.ValidationException