AWS IoT TwinMaker

2022/04/12 - AWS IoT TwinMaker - 5 updated api methods

Changes  This release adds the following new features: 1) ListEntities API now supports search using ExternalId. 2) BatchPutPropertyValue and GetPropertyValueHistory API now allows users to represent time in sub-second level precisions.

BatchPutPropertyValues (updated) Link ¶
Changes (request, response)
Request
{'entries': {'propertyValues': {'time': 'string'}}}
Response
{'errorEntries': {'errors': {'entry': {'propertyValues': {'time': 'string'}}}}}

Sets values for multiple time series properties.

See also: AWS API Documentation

Request Syntax

client.batch_put_property_values(
    entries=[
        {
            'entityPropertyReference': {
                'componentName': 'string',
                'entityId': 'string',
                'externalIdProperty': {
                    'string': 'string'
                },
                'propertyName': 'string'
            },
            'propertyValues': [
                {
                    'time': 'string',
                    'timestamp': datetime(2015, 1, 1),
                    'value': {
                        'booleanValue': True|False,
                        'doubleValue': 123.0,
                        'expression': 'string',
                        'integerValue': 123,
                        'listValue': [
                            {'... recursive ...'},
                        ],
                        'longValue': 123,
                        'mapValue': {
                            'string': {'... recursive ...'}
                        },
                        'relationshipValue': {
                            'targetComponentName': 'string',
                            'targetEntityId': 'string'
                        },
                        'stringValue': 'string'
                    }
                },
            ]
        },
    ],
    workspaceId='string'
)
type entries

list

param entries

[REQUIRED]

An object that maps strings to the property value entries to set. Each string in the mapping must be unique to this object.

  • (dict) --

    An object that specifies information about time series property values.

    • entityPropertyReference (dict) -- [REQUIRED]

      An object that contains information about the entity that has the property.

      • componentName (string) --

        The name of the component.

      • entityId (string) --

        The ID of the entity.

      • externalIdProperty (dict) --

        A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.

        • (string) --

          • (string) --

      • propertyName (string) -- [REQUIRED]

        The name of the property.

    • propertyValues (list) --

      A list of objects that specify time series property values.

      • (dict) --

        An object that contains information about a value for a time series property.

        • time (string) --

          Timestamp represented in ISO 8601 format

        • timestamp (datetime) --

          The timestamp of a value for a time series property.

        • value (dict) -- [REQUIRED]

          An object that specifies a value for a time series property.

          • booleanValue (boolean) --

            A Boolean value.

          • doubleValue (float) --

            A double value.

          • expression (string) --

            An expression that produces the value.

          • integerValue (integer) --

            An integer value.

          • listValue (list) --

            A list of multiple values.

            • (dict) --

              An object that specifies a value for a property.

          • longValue (integer) --

            A long value.

          • mapValue (dict) --

            An object that maps strings to multiple DataValue objects.

            • (string) --

              • (dict) --

                An object that specifies a value for a property.

          • relationshipValue (dict) --

            A value that relates a component to another component.

            • targetComponentName (string) --

              The name of the target component associated with the relationship value.

            • targetEntityId (string) --

              The ID of the target entity associated with this relationship value.

          • stringValue (string) --

            A string value.

type workspaceId

string

param workspaceId

[REQUIRED]

The ID of the workspace that contains the properties to set.

rtype

dict

returns

Response Syntax

{
    'errorEntries': [
        {
            'errors': [
                {
                    'entry': {
                        'entityPropertyReference': {
                            'componentName': 'string',
                            'entityId': 'string',
                            'externalIdProperty': {
                                'string': 'string'
                            },
                            'propertyName': 'string'
                        },
                        'propertyValues': [
                            {
                                'time': 'string',
                                'timestamp': datetime(2015, 1, 1),
                                'value': {
                                    'booleanValue': True|False,
                                    'doubleValue': 123.0,
                                    'expression': 'string',
                                    'integerValue': 123,
                                    'listValue': [
                                        {'... recursive ...'},
                                    ],
                                    'longValue': 123,
                                    'mapValue': {
                                        'string': {'... recursive ...'}
                                    },
                                    'relationshipValue': {
                                        'targetComponentName': 'string',
                                        'targetEntityId': 'string'
                                    },
                                    'stringValue': 'string'
                                }
                            },
                        ]
                    },
                    'errorCode': 'string',
                    'errorMessage': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    • errorEntries (list) --

      Entries that caused errors in the batch put operation.

      • (dict) --

        An object that contains information about errors returned by the BatchPutProperty action.

        • errors (list) --

          A list of objects that contain information about errors returned by the BatchPutProperty action.

          • (dict) --

            An error returned by the BatchPutProperty action.

            • entry (dict) --

              An object that contains information about errors returned by the BatchPutProperty action.

              • entityPropertyReference (dict) --

                An object that contains information about the entity that has the property.

                • componentName (string) --

                  The name of the component.

                • entityId (string) --

                  The ID of the entity.

                • externalIdProperty (dict) --

                  A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.

                  • (string) --

                    • (string) --

                • propertyName (string) --

                  The name of the property.

              • propertyValues (list) --

                A list of objects that specify time series property values.

                • (dict) --

                  An object that contains information about a value for a time series property.

                  • time (string) --

                    Timestamp represented in ISO 8601 format

                  • timestamp (datetime) --

                    The timestamp of a value for a time series property.

                  • value (dict) --

                    An object that specifies a value for a time series property.

                    • booleanValue (boolean) --

                      A Boolean value.

                    • doubleValue (float) --

                      A double value.

                    • expression (string) --

                      An expression that produces the value.

                    • integerValue (integer) --

                      An integer value.

                    • listValue (list) --

                      A list of multiple values.

                      • (dict) --

                        An object that specifies a value for a property.

                    • longValue (integer) --

                      A long value.

                    • mapValue (dict) --

                      An object that maps strings to multiple DataValue objects.

                      • (string) --

                        • (dict) --

                          An object that specifies a value for a property.

                    • relationshipValue (dict) --

                      A value that relates a component to another component.

                      • targetComponentName (string) --

                        The name of the target component associated with the relationship value.

                      • targetEntityId (string) --

                        The ID of the target entity associated with this relationship value.

                    • stringValue (string) --

                      A string value.

            • errorCode (string) --

              The error code.

            • errorMessage (string) --

              The error message.

CreateEntity (updated) Link ¶
Changes (request)
{'components': {'properties': {'updateType': {'CREATE'}}}}

Creates an entity.

See also: AWS API Documentation

Request Syntax

client.create_entity(
    components={
        'string': {
            'componentTypeId': 'string',
            'description': 'string',
            'properties': {
                'string': {
                    'definition': {
                        'configuration': {
                            'string': 'string'
                        },
                        'dataType': {
                            'allowedValues': [
                                {
                                    'booleanValue': True|False,
                                    'doubleValue': 123.0,
                                    'expression': 'string',
                                    'integerValue': 123,
                                    'listValue': {'... recursive ...'},
                                    'longValue': 123,
                                    'mapValue': {
                                        'string': {'... recursive ...'}
                                    },
                                    'relationshipValue': {
                                        'targetComponentName': 'string',
                                        'targetEntityId': 'string'
                                    },
                                    'stringValue': 'string'
                                },
                            ],
                            'nestedType': {'... recursive ...'},
                            'relationship': {
                                'relationshipType': 'string',
                                'targetComponentTypeId': 'string'
                            },
                            'type': 'RELATIONSHIP'|'STRING'|'LONG'|'BOOLEAN'|'INTEGER'|'DOUBLE'|'LIST'|'MAP',
                            'unitOfMeasure': 'string'
                        },
                        'defaultValue': {
                            'booleanValue': True|False,
                            'doubleValue': 123.0,
                            'expression': 'string',
                            'integerValue': 123,
                            'listValue': [
                                {'... recursive ...'},
                            ],
                            'longValue': 123,
                            'mapValue': {
                                'string': {'... recursive ...'}
                            },
                            'relationshipValue': {
                                'targetComponentName': 'string',
                                'targetEntityId': 'string'
                            },
                            'stringValue': 'string'
                        },
                        'isExternalId': True|False,
                        'isRequiredInEntity': True|False,
                        'isStoredExternally': True|False,
                        'isTimeSeries': True|False
                    },
                    'updateType': 'UPDATE'|'DELETE'|'CREATE',
                    'value': {
                        'booleanValue': True|False,
                        'doubleValue': 123.0,
                        'expression': 'string',
                        'integerValue': 123,
                        'listValue': [
                            {'... recursive ...'},
                        ],
                        'longValue': 123,
                        'mapValue': {
                            'string': {'... recursive ...'}
                        },
                        'relationshipValue': {
                            'targetComponentName': 'string',
                            'targetEntityId': 'string'
                        },
                        'stringValue': 'string'
                    }
                }
            }
        }
    },
    description='string',
    entityId='string',
    entityName='string',
    parentEntityId='string',
    tags={
        'string': 'string'
    },
    workspaceId='string'
)
type components

dict

param components

An object that maps strings to the components in the entity. Each string in the mapping must be unique to this object.

  • (string) --

    • (dict) --

      An object that sets information about a component type create or update request.

      • componentTypeId (string) --

        The ID of the component type.

      • description (string) --

        The description of the component request.

      • properties (dict) --

        An object that maps strings to the properties to set in the component type. Each string in the mapping must be unique to this object.

        • (string) --

          • (dict) --

            An object that sets information about a property.

            • definition (dict) --

              An object that specifies information about a property.

              • configuration (dict) --

                A mapping that specifies configuration information about the property. Use this field to specify information that you read from and write to an external source.

                • (string) --

                  • (string) --

              • dataType (dict) --

                An object that contains information about the data type.

                • allowedValues (list) --

                  The allowed values for this data type.

                  • (dict) --

                    An object that specifies a value for a property.

                    • booleanValue (boolean) --

                      A Boolean value.

                    • doubleValue (float) --

                      A double value.

                    • expression (string) --

                      An expression that produces the value.

                    • integerValue (integer) --

                      An integer value.

                    • listValue (list) --

                      A list of multiple values.

                    • longValue (integer) --

                      A long value.

                    • mapValue (dict) --

                      An object that maps strings to multiple DataValue objects.

                      • (string) --

                        • (dict) --

                          An object that specifies a value for a property.

                    • relationshipValue (dict) --

                      A value that relates a component to another component.

                      • targetComponentName (string) --

                        The name of the target component associated with the relationship value.

                      • targetEntityId (string) --

                        The ID of the target entity associated with this relationship value.

                    • stringValue (string) --

                      A string value.

                • nestedType (dict) --

                  The nested type in the data type.

                • relationship (dict) --

                  A relationship that associates a component with another component.

                  • relationshipType (string) --

                    The type of the relationship.

                  • targetComponentTypeId (string) --

                    The ID of the target component type associated with this relationship.

                • type (string) -- [REQUIRED]

                  The underlying type of the data type.

                • unitOfMeasure (string) --

                  The unit of measure used in this data type.

              • defaultValue (dict) --

                An object that contains the default value.

                • booleanValue (boolean) --

                  A Boolean value.

                • doubleValue (float) --

                  A double value.

                • expression (string) --

                  An expression that produces the value.

                • integerValue (integer) --

                  An integer value.

                • listValue (list) --

                  A list of multiple values.

                  • (dict) --

                    An object that specifies a value for a property.

                • longValue (integer) --

                  A long value.

                • mapValue (dict) --

                  An object that maps strings to multiple DataValue objects.

                  • (string) --

                    • (dict) --

                      An object that specifies a value for a property.

                • relationshipValue (dict) --

                  A value that relates a component to another component.

                  • targetComponentName (string) --

                    The name of the target component associated with the relationship value.

                  • targetEntityId (string) --

                    The ID of the target entity associated with this relationship value.

                • stringValue (string) --

                  A string value.

              • isExternalId (boolean) --

                A Boolean value that specifies whether the property ID comes from an external data store.

              • isRequiredInEntity (boolean) --

                A Boolean value that specifies whether the property is required.

              • isStoredExternally (boolean) --

                A Boolean value that specifies whether the property is stored externally.

              • isTimeSeries (boolean) --

                A Boolean value that specifies whether the property consists of time series data.

            • updateType (string) --

              The update type of the update property request.

            • value (dict) --

              The value of the property.

              • booleanValue (boolean) --

                A Boolean value.

              • doubleValue (float) --

                A double value.

              • expression (string) --

                An expression that produces the value.

              • integerValue (integer) --

                An integer value.

              • listValue (list) --

                A list of multiple values.

                • (dict) --

                  An object that specifies a value for a property.

              • longValue (integer) --

                A long value.

              • mapValue (dict) --

                An object that maps strings to multiple DataValue objects.

                • (string) --

                  • (dict) --

                    An object that specifies a value for a property.

              • relationshipValue (dict) --

                A value that relates a component to another component.

                • targetComponentName (string) --

                  The name of the target component associated with the relationship value.

                • targetEntityId (string) --

                  The ID of the target entity associated with this relationship value.

              • stringValue (string) --

                A string value.

type description

string

param description

The description of the entity.

type entityId

string

param entityId

The ID of the entity.

type entityName

string

param entityName

[REQUIRED]

The name of the entity.

type parentEntityId

string

param parentEntityId

The ID of the entity's parent entity.

type tags

dict

param tags

Metadata that you can use to manage the entity.

  • (string) --

    • (string) --

type workspaceId

string

param workspaceId

[REQUIRED]

The ID of the workspace that contains the entity.

rtype

dict

returns

Response Syntax

{
    'arn': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'entityId': 'string',
    'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
}

Response Structure

  • (dict) --

    • arn (string) --

      The ARN of the entity.

    • creationDateTime (datetime) --

      The date and time when the entity was created.

    • entityId (string) --

      The ID of the entity.

    • state (string) --

      The current state of the entity.

GetPropertyValueHistory (updated) Link ¶
Changes (request, response)
Request
{'endTime': 'string', 'startTime': 'string'}
Response
{'propertyValues': {'values': {'time': 'string'}}}

Retrieves information about the history of a time series property value for a component, component type, entity, or workspace.

You must specify a value for workspaceId . For entity-specific queries, specify values for componentName and entityId . For cross-entity quries, specify a value for componentTypeId .

See also: AWS API Documentation

Request Syntax

client.get_property_value_history(
    componentName='string',
    componentTypeId='string',
    endDateTime=datetime(2015, 1, 1),
    endTime='string',
    entityId='string',
    interpolation={
        'interpolationType': 'LINEAR',
        'intervalInSeconds': 123
    },
    maxResults=123,
    nextToken='string',
    orderByTime='ASCENDING'|'DESCENDING',
    propertyFilters=[
        {
            'operator': 'string',
            'propertyName': 'string',
            'value': {
                'booleanValue': True|False,
                'doubleValue': 123.0,
                'expression': 'string',
                'integerValue': 123,
                'listValue': [
                    {'... recursive ...'},
                ],
                'longValue': 123,
                'mapValue': {
                    'string': {'... recursive ...'}
                },
                'relationshipValue': {
                    'targetComponentName': 'string',
                    'targetEntityId': 'string'
                },
                'stringValue': 'string'
            }
        },
    ],
    selectedProperties=[
        'string',
    ],
    startDateTime=datetime(2015, 1, 1),
    startTime='string',
    workspaceId='string'
)
type componentName

string

param componentName

The name of the component.

type componentTypeId

string

param componentTypeId

The ID of the component type.

type endDateTime

datetime

param endDateTime

The date and time of the latest property value to return.

type endTime

string

param endTime

Timestamp represented in ISO 8601 format

type entityId

string

param entityId

The ID of the entity.

type interpolation

dict

param interpolation

An object that specifies the interpolation type and the interval over which to interpolate data.

  • interpolationType (string) --

    The interpolation type.

  • intervalInSeconds (integer) --

    The interpolation time interval in seconds.

type maxResults

integer

param maxResults

The maximum number of results to return.

type nextToken

string

param nextToken

The string that specifies the next page of results.

type orderByTime

string

param orderByTime

The time direction to use in the result order.

type propertyFilters

list

param propertyFilters

A list of objects that filter the property value history request.

  • (dict) --

    An object that filters items returned by a property request.

    • operator (string) --

      The operator associated with this property filter.

    • propertyName (string) --

      The property name associated with this property filter.

    • value (dict) --

      The value associated with this property filter.

      • booleanValue (boolean) --

        A Boolean value.

      • doubleValue (float) --

        A double value.

      • expression (string) --

        An expression that produces the value.

      • integerValue (integer) --

        An integer value.

      • listValue (list) --

        A list of multiple values.

        • (dict) --

          An object that specifies a value for a property.

      • longValue (integer) --

        A long value.

      • mapValue (dict) --

        An object that maps strings to multiple DataValue objects.

        • (string) --

          • (dict) --

            An object that specifies a value for a property.

      • relationshipValue (dict) --

        A value that relates a component to another component.

        • targetComponentName (string) --

          The name of the target component associated with the relationship value.

        • targetEntityId (string) --

          The ID of the target entity associated with this relationship value.

      • stringValue (string) --

        A string value.

type selectedProperties

list

param selectedProperties

[REQUIRED]

A list of properties whose value histories the request retrieves.

  • (string) --

type startDateTime

datetime

param startDateTime

The date and time of the earliest property value to return.

type startTime

string

param startTime

Timestamp represented in ISO 8601 format

type workspaceId

string

param workspaceId

[REQUIRED]

The ID of the workspace.

rtype

dict

returns

Response Syntax

{
    'nextToken': 'string',
    'propertyValues': [
        {
            'entityPropertyReference': {
                'componentName': 'string',
                'entityId': 'string',
                'externalIdProperty': {
                    'string': 'string'
                },
                'propertyName': 'string'
            },
            'values': [
                {
                    'time': 'string',
                    'timestamp': datetime(2015, 1, 1),
                    'value': {
                        'booleanValue': True|False,
                        'doubleValue': 123.0,
                        'expression': 'string',
                        'integerValue': 123,
                        'listValue': [
                            {'... recursive ...'},
                        ],
                        'longValue': 123,
                        'mapValue': {
                            'string': {'... recursive ...'}
                        },
                        'relationshipValue': {
                            'targetComponentName': 'string',
                            'targetEntityId': 'string'
                        },
                        'stringValue': 'string'
                    }
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      The string that specifies the next page of results.

    • propertyValues (list) --

      An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.

      • (dict) --

        The history of values for a time series property.

        • entityPropertyReference (dict) --

          An object that uniquely identifies an entity property.

          • componentName (string) --

            The name of the component.

          • entityId (string) --

            The ID of the entity.

          • externalIdProperty (dict) --

            A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.

            • (string) --

              • (string) --

          • propertyName (string) --

            The name of the property.

        • values (list) --

          A list of objects that contain information about the values in the history of a time series property.

          • (dict) --

            An object that contains information about a value for a time series property.

            • time (string) --

              Timestamp represented in ISO 8601 format

            • timestamp (datetime) --

              The timestamp of a value for a time series property.

            • value (dict) --

              An object that specifies a value for a time series property.

              • booleanValue (boolean) --

                A Boolean value.

              • doubleValue (float) --

                A double value.

              • expression (string) --

                An expression that produces the value.

              • integerValue (integer) --

                An integer value.

              • listValue (list) --

                A list of multiple values.

                • (dict) --

                  An object that specifies a value for a property.

              • longValue (integer) --

                A long value.

              • mapValue (dict) --

                An object that maps strings to multiple DataValue objects.

                • (string) --

                  • (dict) --

                    An object that specifies a value for a property.

              • relationshipValue (dict) --

                A value that relates a component to another component.

                • targetComponentName (string) --

                  The name of the target component associated with the relationship value.

                • targetEntityId (string) --

                  The ID of the target entity associated with this relationship value.

              • stringValue (string) --

                A string value.

ListEntities (updated) Link ¶
Changes (request)
{'filters': {'externalId': 'string'}}

Lists all entities in a workspace.

See also: AWS API Documentation

Request Syntax

client.list_entities(
    filters=[
        {
            'componentTypeId': 'string',
            'externalId': 'string',
            'parentEntityId': 'string'
        },
    ],
    maxResults=123,
    nextToken='string',
    workspaceId='string'
)
type filters

list

param filters

A list of objects that filter the request.

  • (dict) --

    An object that filters items in a list of entities.

    • componentTypeId (string) --

      The ID of the component type in the entities in the list.

    • externalId (string) --

      The external-Id property of a component. The external-Id property is the primary key of an external storage system.

    • parentEntityId (string) --

      The parent of the entities in the list.

type maxResults

integer

param maxResults

The maximum number of results to display.

type nextToken

string

param nextToken

The string that specifies the next page of results.

type workspaceId

string

param workspaceId

[REQUIRED]

The ID of the workspace.

rtype

dict

returns

Response Syntax

{
    'entitySummaries': [
        {
            'arn': 'string',
            'creationDateTime': datetime(2015, 1, 1),
            'description': 'string',
            'entityId': 'string',
            'entityName': 'string',
            'hasChildEntities': True|False,
            'parentEntityId': 'string',
            'status': {
                'error': {
                    'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE',
                    'message': 'string'
                },
                'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
            },
            'updateDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • entitySummaries (list) --

      A list of objects that contain information about the entities.

      • (dict) --

        An object that contains information about an entity.

        • arn (string) --

          The ARN of the entity.

        • creationDateTime (datetime) --

          The date and time when the entity was created.

        • description (string) --

          The description of the entity.

        • entityId (string) --

          The ID of the entity.

        • entityName (string) --

          The name of the entity.

        • hasChildEntities (boolean) --

          A Boolean value that specifies whether the entity has child entities or not.

        • parentEntityId (string) --

          The ID of the parent entity.

        • status (dict) --

          The current status of the entity.

          • error (dict) --

            The error message.

            • code (string) --

              The error code.

            • message (string) --

              The error message.

          • state (string) --

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

        • updateDateTime (datetime) --

          The last date and time when the entity was updated.

    • nextToken (string) --

      The string that specifies the next page of results.

UpdateEntity (updated) Link ¶
Changes (request)
{'componentUpdates': {'propertyUpdates': {'updateType': {'CREATE'}}}}

Updates an entity.

See also: AWS API Documentation

Request Syntax

client.update_entity(
    componentUpdates={
        'string': {
            'componentTypeId': 'string',
            'description': 'string',
            'propertyUpdates': {
                'string': {
                    'definition': {
                        'configuration': {
                            'string': 'string'
                        },
                        'dataType': {
                            'allowedValues': [
                                {
                                    'booleanValue': True|False,
                                    'doubleValue': 123.0,
                                    'expression': 'string',
                                    'integerValue': 123,
                                    'listValue': {'... recursive ...'},
                                    'longValue': 123,
                                    'mapValue': {
                                        'string': {'... recursive ...'}
                                    },
                                    'relationshipValue': {
                                        'targetComponentName': 'string',
                                        'targetEntityId': 'string'
                                    },
                                    'stringValue': 'string'
                                },
                            ],
                            'nestedType': {'... recursive ...'},
                            'relationship': {
                                'relationshipType': 'string',
                                'targetComponentTypeId': 'string'
                            },
                            'type': 'RELATIONSHIP'|'STRING'|'LONG'|'BOOLEAN'|'INTEGER'|'DOUBLE'|'LIST'|'MAP',
                            'unitOfMeasure': 'string'
                        },
                        'defaultValue': {
                            'booleanValue': True|False,
                            'doubleValue': 123.0,
                            'expression': 'string',
                            'integerValue': 123,
                            'listValue': [
                                {'... recursive ...'},
                            ],
                            'longValue': 123,
                            'mapValue': {
                                'string': {'... recursive ...'}
                            },
                            'relationshipValue': {
                                'targetComponentName': 'string',
                                'targetEntityId': 'string'
                            },
                            'stringValue': 'string'
                        },
                        'isExternalId': True|False,
                        'isRequiredInEntity': True|False,
                        'isStoredExternally': True|False,
                        'isTimeSeries': True|False
                    },
                    'updateType': 'UPDATE'|'DELETE'|'CREATE',
                    'value': {
                        'booleanValue': True|False,
                        'doubleValue': 123.0,
                        'expression': 'string',
                        'integerValue': 123,
                        'listValue': [
                            {'... recursive ...'},
                        ],
                        'longValue': 123,
                        'mapValue': {
                            'string': {'... recursive ...'}
                        },
                        'relationshipValue': {
                            'targetComponentName': 'string',
                            'targetEntityId': 'string'
                        },
                        'stringValue': 'string'
                    }
                }
            },
            'updateType': 'CREATE'|'UPDATE'|'DELETE'
        }
    },
    description='string',
    entityId='string',
    entityName='string',
    parentEntityUpdate={
        'parentEntityId': 'string',
        'updateType': 'UPDATE'|'DELETE'
    },
    workspaceId='string'
)
type componentUpdates

dict

param componentUpdates

An object that maps strings to the component updates in the request. Each string in the mapping must be unique to this object.

  • (string) --

    • (dict) --

      The component update request.

      • componentTypeId (string) --

        The ID of the component type.

      • description (string) --

        The description of the component type.

      • propertyUpdates (dict) --

        An object that maps strings to the properties to set in the component type update. Each string in the mapping must be unique to this object.

        • (string) --

          • (dict) --

            An object that sets information about a property.

            • definition (dict) --

              An object that specifies information about a property.

              • configuration (dict) --

                A mapping that specifies configuration information about the property. Use this field to specify information that you read from and write to an external source.

                • (string) --

                  • (string) --

              • dataType (dict) --

                An object that contains information about the data type.

                • allowedValues (list) --

                  The allowed values for this data type.

                  • (dict) --

                    An object that specifies a value for a property.

                    • booleanValue (boolean) --

                      A Boolean value.

                    • doubleValue (float) --

                      A double value.

                    • expression (string) --

                      An expression that produces the value.

                    • integerValue (integer) --

                      An integer value.

                    • listValue (list) --

                      A list of multiple values.

                    • longValue (integer) --

                      A long value.

                    • mapValue (dict) --

                      An object that maps strings to multiple DataValue objects.

                      • (string) --

                        • (dict) --

                          An object that specifies a value for a property.

                    • relationshipValue (dict) --

                      A value that relates a component to another component.

                      • targetComponentName (string) --

                        The name of the target component associated with the relationship value.

                      • targetEntityId (string) --

                        The ID of the target entity associated with this relationship value.

                    • stringValue (string) --

                      A string value.

                • nestedType (dict) --

                  The nested type in the data type.

                • relationship (dict) --

                  A relationship that associates a component with another component.

                  • relationshipType (string) --

                    The type of the relationship.

                  • targetComponentTypeId (string) --

                    The ID of the target component type associated with this relationship.

                • type (string) -- [REQUIRED]

                  The underlying type of the data type.

                • unitOfMeasure (string) --

                  The unit of measure used in this data type.

              • defaultValue (dict) --

                An object that contains the default value.

                • booleanValue (boolean) --

                  A Boolean value.

                • doubleValue (float) --

                  A double value.

                • expression (string) --

                  An expression that produces the value.

                • integerValue (integer) --

                  An integer value.

                • listValue (list) --

                  A list of multiple values.

                  • (dict) --

                    An object that specifies a value for a property.

                • longValue (integer) --

                  A long value.

                • mapValue (dict) --

                  An object that maps strings to multiple DataValue objects.

                  • (string) --

                    • (dict) --

                      An object that specifies a value for a property.

                • relationshipValue (dict) --

                  A value that relates a component to another component.

                  • targetComponentName (string) --

                    The name of the target component associated with the relationship value.

                  • targetEntityId (string) --

                    The ID of the target entity associated with this relationship value.

                • stringValue (string) --

                  A string value.

              • isExternalId (boolean) --

                A Boolean value that specifies whether the property ID comes from an external data store.

              • isRequiredInEntity (boolean) --

                A Boolean value that specifies whether the property is required.

              • isStoredExternally (boolean) --

                A Boolean value that specifies whether the property is stored externally.

              • isTimeSeries (boolean) --

                A Boolean value that specifies whether the property consists of time series data.

            • updateType (string) --

              The update type of the update property request.

            • value (dict) --

              The value of the property.

              • booleanValue (boolean) --

                A Boolean value.

              • doubleValue (float) --

                A double value.

              • expression (string) --

                An expression that produces the value.

              • integerValue (integer) --

                An integer value.

              • listValue (list) --

                A list of multiple values.

                • (dict) --

                  An object that specifies a value for a property.

              • longValue (integer) --

                A long value.

              • mapValue (dict) --

                An object that maps strings to multiple DataValue objects.

                • (string) --

                  • (dict) --

                    An object that specifies a value for a property.

              • relationshipValue (dict) --

                A value that relates a component to another component.

                • targetComponentName (string) --

                  The name of the target component associated with the relationship value.

                • targetEntityId (string) --

                  The ID of the target entity associated with this relationship value.

              • stringValue (string) --

                A string value.

      • updateType (string) --

        The update type of the component update request.

type description

string

param description

The description of the entity.

type entityId

string

param entityId

[REQUIRED]

The ID of the entity.

type entityName

string

param entityName

The name of the entity.

type parentEntityUpdate

dict

param parentEntityUpdate

An object that describes the update request for a parent entity.

  • parentEntityId (string) --

    The ID of the parent entity.

  • updateType (string) -- [REQUIRED]

    The type of the update.

type workspaceId

string

param workspaceId

[REQUIRED]

The ID of the workspace that contains the entity.

rtype

dict

returns

Response Syntax

{
    'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR',
    'updateDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • state (string) --

      The current state of the entity update.

    • updateDateTime (datetime) --

      The date and time when the entity was last updated.