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