Table of Contents
IoTTwinMaker.
Client
¶A low-level client representing AWS IoT TwinMaker
IoT TwinMaker is a service that enables you to build operational digital twins of physical systems. IoT TwinMaker overlays measurements and analysis from real-world sensors, cameras, and enterprise applications so you can create data visualizations to monitor your physical factory, building, or industrial plant. You can use this real-world data to monitor operations and diagnose and repair errors.
import boto3
client = boto3.client('iottwinmaker')
These are the available methods:
batch_put_property_values()
can_paginate()
close()
create_component_type()
create_entity()
create_scene()
create_workspace()
delete_component_type()
delete_entity()
delete_scene()
delete_workspace()
get_component_type()
get_entity()
get_paginator()
get_property_value()
get_property_value_history()
get_scene()
get_waiter()
get_workspace()
list_component_types()
list_entities()
list_scenes()
list_tags_for_resource()
list_workspaces()
tag_resource()
untag_resource()
update_component_type()
update_entity()
update_scene()
update_workspace()
batch_put_property_values
(**kwargs)¶Sets values for multiple time series properties.
See also: AWS API Documentation
Request Syntax
response = 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'
)
[REQUIRED]
An object that maps strings to the property value entries to set. Each string in the mapping must be unique to this object.
An object that specifies information about time series property values. This object is used and consumed by the BatchPutPropertyValues action.
An object that contains information about the entity that has the property.
The name of the component.
The ID of the entity.
A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.
The name of the property.
A list of objects that specify time series property values.
An object that contains information about a value for a time series property.
ISO8601 DateTime of a value for a time series property.
The time for when the property value was recorded in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.SSSSSSSSS][Z/±HH:mm] .
Required sub-fields : YYYY-MM-DDThh:mm:ss and [Z/±HH:mm]
The timestamp of a value for a time series property.
An object that specifies a value for a time series property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
[REQUIRED]
The ID of the workspace that contains the properties to set.
dict
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.
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) --
ISO8601 DateTime of a value for a time series property.
The time for when the property value was recorded in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.SSSSSSSSS][Z/±HH:mm] .
Required sub-fields : YYYY-MM-DDThh:mm:ss and [Z/±HH:mm]
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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
can_paginate
(operation_name)¶Check if an operation can be paginated.
create_foo
, and you'd normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.True
if the operation can be paginated,
False
otherwise.close
()¶Closes underlying endpoint connections.
create_component_type
(**kwargs)¶Creates a component type.
See also: AWS API Documentation
Request Syntax
response = client.create_component_type(
componentTypeId='string',
description='string',
extendsFrom=[
'string',
],
functions={
'string': {
'implementedBy': {
'isNative': True|False,
'lambda': {
'arn': 'string'
}
},
'requiredProperties': [
'string',
],
'scope': 'ENTITY'|'WORKSPACE'
}
},
isSingleton=True|False,
propertyDefinitions={
'string': {
'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
}
},
tags={
'string': 'string'
},
workspaceId='string'
)
[REQUIRED]
The ID of the component type.
Specifies the parent component type to extend.
An object that maps strings to the functions in the component type. Each string in the mapping must be unique to this object.
The function request body.
The data connector.
A Boolean value that specifies whether the data connector is native to IoT TwinMaker.
The Lambda function associated with this data connector.
The ARN of the Lambda function.
The required properties of the function.
The scope of the function.
An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.
An object that sets information about a property.
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.
An object that contains information about the data type.
The allowed values for this data type.
An object that specifies a value for a property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
The nested type in the data type.
A relationship that associates a component with another component.
The type of the relationship.
The ID of the target component type associated with this relationship.
The underlying type of the data type.
The unit of measure used in this data type.
An object that contains the default value.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
A Boolean value that specifies whether the property ID comes from an external data store.
A Boolean value that specifies whether the property is required.
A Boolean value that specifies whether the property is stored externally.
A Boolean value that specifies whether the property consists of time series data.
Metadata that you can use to manage the component type.
[REQUIRED]
The ID of the workspace that contains the component type.
dict
Response Syntax
{
'arn': 'string',
'creationDateTime': datetime(2015, 1, 1),
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
}
Response Structure
(dict) --
arn (string) --
The ARN of the component type.
creationDateTime (datetime) --
The date and time when the entity was created.
state (string) --
The current state of the component type.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConflictException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
create_entity
(**kwargs)¶Creates an entity.
See also: AWS API Documentation
Request Syntax
response = 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'
)
An object that maps strings to the components in the entity. Each string in the mapping must be unique to this object.
An object that sets information about a component type create or update request.
The ID of the component type.
The description of the component request.
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.
An object that sets information about a property.
An object that specifies information about a property.
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.
An object that contains information about the data type.
The allowed values for this data type.
An object that specifies a value for a property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
The nested type in the data type.
A relationship that associates a component with another component.
The type of the relationship.
The ID of the target component type associated with this relationship.
The underlying type of the data type.
The unit of measure used in this data type.
An object that contains the default value.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
A Boolean value that specifies whether the property ID comes from an external data store.
A Boolean value that specifies whether the property is required.
A Boolean value that specifies whether the property is stored externally.
A Boolean value that specifies whether the property consists of time series data.
The update type of the update property request.
The value of the property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
[REQUIRED]
The name of the entity.
Metadata that you can use to manage the entity.
[REQUIRED]
The ID of the workspace that contains the entity.
dict
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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConflictException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
create_scene
(**kwargs)¶Creates a scene.
See also: AWS API Documentation
Request Syntax
response = client.create_scene(
capabilities=[
'string',
],
contentLocation='string',
description='string',
sceneId='string',
tags={
'string': 'string'
},
workspaceId='string'
)
A list of capabilities that the scene uses to render itself.
[REQUIRED]
The relative path that specifies the location of the content definition file.
[REQUIRED]
The ID of the scene.
Metadata that you can use to manage the scene.
[REQUIRED]
The ID of the workspace that contains the scene.
dict
Response Syntax
{
'arn': 'string',
'creationDateTime': datetime(2015, 1, 1)
}
Response Structure
(dict) --
arn (string) --
The ARN of the scene.
creationDateTime (datetime) --
The date and time when the scene was created.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConflictException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
create_workspace
(**kwargs)¶Creates a workplace.
See also: AWS API Documentation
Request Syntax
response = client.create_workspace(
description='string',
role='string',
s3Location='string',
tags={
'string': 'string'
},
workspaceId='string'
)
[REQUIRED]
The ARN of the execution role associated with the workspace.
[REQUIRED]
The ARN of the S3 bucket where resources associated with the workspace are stored.
Metadata that you can use to manage the workspace
[REQUIRED]
The ID of the workspace.
dict
Response Syntax
{
'arn': 'string',
'creationDateTime': datetime(2015, 1, 1)
}
Response Structure
(dict) --
arn (string) --
The ARN of the workspace.
creationDateTime (datetime) --
The date and time when the workspace was created.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConflictException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
delete_component_type
(**kwargs)¶Deletes a component type.
See also: AWS API Documentation
Request Syntax
response = client.delete_component_type(
componentTypeId='string',
workspaceId='string'
)
[REQUIRED]
The ID of the component type to delete.
[REQUIRED]
The ID of the workspace that contains the component type.
dict
Response Syntax
{
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
}
Response Structure
(dict) --
state (string) --
The current state of the component type to be deleted.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
delete_entity
(**kwargs)¶Deletes an entity.
See also: AWS API Documentation
Request Syntax
response = client.delete_entity(
entityId='string',
isRecursive=True|False,
workspaceId='string'
)
[REQUIRED]
The ID of the entity to delete.
[REQUIRED]
The ID of the workspace that contains the entity to delete.
dict
Response Syntax
{
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
}
Response Structure
(dict) --
state (string) --
The current state of the deleted entity.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
delete_scene
(**kwargs)¶Deletes a scene.
See also: AWS API Documentation
Request Syntax
response = client.delete_scene(
sceneId='string',
workspaceId='string'
)
[REQUIRED]
The ID of the scene to delete.
[REQUIRED]
The ID of the workspace.
dict
Response Syntax
{}
Response Structure
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
delete_workspace
(**kwargs)¶Deletes a workspace.
See also: AWS API Documentation
Request Syntax
response = client.delete_workspace(
workspaceId='string'
)
[REQUIRED]
The ID of the workspace to delete.
{}
Response Structure
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
get_component_type
(**kwargs)¶Retrieves information about a component type.
See also: AWS API Documentation
Request Syntax
response = client.get_component_type(
componentTypeId='string',
workspaceId='string'
)
[REQUIRED]
The ID of the component type.
[REQUIRED]
The ID of the workspace that contains the component type.
dict
Response Syntax
{
'arn': 'string',
'componentTypeId': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'extendsFrom': [
'string',
],
'functions': {
'string': {
'implementedBy': {
'isNative': True|False,
'lambda': {
'arn': 'string'
}
},
'isInherited': True|False,
'requiredProperties': [
'string',
],
'scope': 'ENTITY'|'WORKSPACE'
}
},
'isAbstract': True|False,
'isSchemaInitialized': True|False,
'isSingleton': True|False,
'propertyDefinitions': {
'string': {
'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,
'isFinal': True|False,
'isImported': True|False,
'isInherited': True|False,
'isRequiredInEntity': True|False,
'isStoredExternally': True|False,
'isTimeSeries': True|False
}
},
'status': {
'error': {
'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE',
'message': 'string'
},
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
},
'updateDateTime': datetime(2015, 1, 1),
'workspaceId': 'string'
}
Response Structure
(dict) --
arn (string) --
The ARN of the component type.
componentTypeId (string) --
The ID of the component type.
creationDateTime (datetime) --
The date and time when the component type was created.
description (string) --
The description of the component type.
extendsFrom (list) --
The name of the parent component type that this component type extends.
functions (dict) --
An object that maps strings to the functions in the component type. Each string in the mapping must be unique to this object.
(string) --
(dict) --
The function response.
implementedBy (dict) --
The data connector.
isNative (boolean) --
A Boolean value that specifies whether the data connector is native to IoT TwinMaker.
lambda (dict) --
The Lambda function associated with this data connector.
arn (string) --
The ARN of the Lambda function.
isInherited (boolean) --
Indicates whether this function is inherited.
requiredProperties (list) --
The required properties of the function.
scope (string) --
The scope of the function.
isAbstract (boolean) --
A Boolean value that specifies whether the component type is abstract.
isSchemaInitialized (boolean) --
A Boolean value that specifies whether the component type has a schema initializer and that the schema initializer has run.
isSingleton (boolean) --
A Boolean value that specifies whether an entity can have more than one component of this type.
propertyDefinitions (dict) --
An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.
(string) --
(dict) --
An object that contains response data from a property definition request.
configuration (dict) --
A mapping that specifies configuration information about the property.
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) --
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.
isFinal (boolean) --
A Boolean value that specifies whether the property definition can be updated.
isImported (boolean) --
A Boolean value that specifies whether the property definition is imported from an external data store.
isInherited (boolean) --
A Boolean value that specifies whether the property definition is inherited from a parent entity.
isRequiredInEntity (boolean) --
A Boolean value that specifies whether the property is required in an entity.
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.
status (dict) --
The current status of the component type.
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 date and time when the component was last updated.
workspaceId (string) --
The ID of the workspace that contains the component type.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
get_entity
(**kwargs)¶Retrieves information about an entity.
See also: AWS API Documentation
Request Syntax
response = client.get_entity(
entityId='string',
workspaceId='string'
)
[REQUIRED]
The ID of the entity.
[REQUIRED]
The ID of the workspace.
dict
Response Syntax
{
'arn': 'string',
'components': {
'string': {
'componentName': 'string',
'componentTypeId': 'string',
'definedIn': '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,
'isFinal': True|False,
'isImported': True|False,
'isInherited': True|False,
'isRequiredInEntity': True|False,
'isStoredExternally': True|False,
'isTimeSeries': True|False
},
'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'
}
}
},
'status': {
'error': {
'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE',
'message': 'string'
},
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
}
}
},
'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),
'workspaceId': 'string'
}
Response Structure
(dict) --
arn (string) --
The ARN of the entity.
components (dict) --
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 returns information about a component type create or update request.
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 type.
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 contains information about a property response.
definition (dict) --
An object that specifies information about a property.
configuration (dict) --
A mapping that specifies configuration information about the property.
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) --
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.
isFinal (boolean) --
A Boolean value that specifies whether the property definition can be updated.
isImported (boolean) --
A Boolean value that specifies whether the property definition is imported from an external data store.
isInherited (boolean) --
A Boolean value that specifies whether the property definition is inherited from a parent entity.
isRequiredInEntity (boolean) --
A Boolean value that specifies whether the property is required in an entity.
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.
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.
status (dict) --
The status of the component type.
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.
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 associated child entities.
parentEntityId (string) --
The ID of the parent entity for this 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 date and time when the entity was last updated.
workspaceId (string) --
The ID of the workspace.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
get_paginator
(operation_name)¶Create a paginator for an operation.
create_foo
, and you'd normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.client.can_paginate
method to
check if an operation is pageable.get_property_value
(**kwargs)¶Gets the property values for a component, component type, entity, or workspace.
You must specify a value for either componentName
, componentTypeId
, entityId
, or workspaceId
.
See also: AWS API Documentation
Request Syntax
response = client.get_property_value(
componentName='string',
componentTypeId='string',
entityId='string',
selectedProperties=[
'string',
],
workspaceId='string'
)
[REQUIRED]
The properties whose values the operation returns.
[REQUIRED]
The ID of the workspace whose values the operation returns.
dict
Response Syntax
{
'propertyValues': {
'string': {
'propertyReference': {
'componentName': 'string',
'entityId': 'string',
'externalIdProperty': {
'string': 'string'
},
'propertyName': 'string'
},
'propertyValue': {
'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) --
propertyValues (dict) --
An object that maps strings to the properties and latest property values in the response. Each string in the mapping must be unique to this object.
(string) --
(dict) --
The latest value of the property.
propertyReference (dict) --
An object that specifies information about a 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.
propertyName (string) --
The name of the property.
propertyValue (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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ConnectorFailureException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConnectorTimeoutException
get_property_value_history
(**kwargs)¶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
response = 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'
)
The ISO8601 DateTime of the latest property value to return.
For more information about the ISO8601 DateTime format, see the data type PropertyValue .
An object that specifies the interpolation type and the interval over which to interpolate data.
The interpolation type.
The interpolation time interval in seconds.
A list of objects that filter the property value history request.
An object that filters items returned by a property request.
The operator associated with this property filter.
The property name associated with this property filter.
The value associated with this property filter.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
[REQUIRED]
A list of properties whose value histories the request retrieves.
The ISO8601 DateTime of the earliest property value to return.
For more information about the ISO8601 DateTime format, see the data type PropertyValue .
[REQUIRED]
The ID of the workspace.
dict
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.
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) --
ISO8601 DateTime of a value for a time series property.
The time for when the property value was recorded in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.SSSSSSSSS][Z/±HH:mm] .
Required sub-fields : YYYY-MM-DDThh:mm:ss and [Z/±HH:mm]
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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ConnectorFailureException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConnectorTimeoutException
get_scene
(**kwargs)¶Retrieves information about a scene.
See also: AWS API Documentation
Request Syntax
response = client.get_scene(
sceneId='string',
workspaceId='string'
)
[REQUIRED]
The ID of the scene.
[REQUIRED]
The ID of the workspace that contains the scene.
dict
Response Syntax
{
'arn': 'string',
'capabilities': [
'string',
],
'contentLocation': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'sceneId': 'string',
'updateDateTime': datetime(2015, 1, 1),
'workspaceId': 'string'
}
Response Structure
(dict) --
arn (string) --
The ARN of the scene.
capabilities (list) --
A list of capabilities that the scene uses to render.
contentLocation (string) --
The relative path that specifies the location of the content definition file.
creationDateTime (datetime) --
The date and time when the scene was created.
description (string) --
The description of the scene.
sceneId (string) --
The ID of the scene.
updateDateTime (datetime) --
The date and time when the scene was last updated.
workspaceId (string) --
The ID of the workspace that contains the scene.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
get_waiter
(waiter_name)¶Returns an object that can wait for some condition.
get_workspace
(**kwargs)¶Retrieves information about a workspace.
See also: AWS API Documentation
Request Syntax
response = client.get_workspace(
workspaceId='string'
)
[REQUIRED]
The ID of the workspace.
{
'arn': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'role': 'string',
's3Location': 'string',
'updateDateTime': datetime(2015, 1, 1),
'workspaceId': 'string'
}
Response Structure
The ARN of the workspace.
The date and time when the workspace was created.
The description of the workspace.
The ARN of the execution role associated with the workspace.
The ARN of the S3 bucket where resources associated with the workspace are stored.
The date and time when the workspace was last updated.
The ID of the workspace.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
list_component_types
(**kwargs)¶Lists all component types in a workspace.
See also: AWS API Documentation
Request Syntax
response = client.list_component_types(
filters=[
{
'extendsFrom': 'string',
'isAbstract': True|False,
'namespace': 'string'
},
],
maxResults=123,
nextToken='string',
workspaceId='string'
)
A list of objects that filter the request.
An object that filters items in a list of component types.
Note
Only one object is accepted as a valid input.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: extendsFrom
, isAbstract
, namespace
.
The component type that the component types in the list extend.
A Boolean value that specifies whether the component types in the list are abstract.
The namespace to which the component types in the list belong.
[REQUIRED]
The ID of the workspace.
dict
Response Syntax
{
'componentTypeSummaries': [
{
'arn': 'string',
'componentTypeId': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'status': {
'error': {
'code': 'VALIDATION_ERROR'|'INTERNAL_FAILURE',
'message': 'string'
},
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR'
},
'updateDateTime': datetime(2015, 1, 1)
},
],
'maxResults': 123,
'nextToken': 'string',
'workspaceId': 'string'
}
Response Structure
(dict) --
componentTypeSummaries (list) --
A list of objects that contain information about the component types.
(dict) --
An object that contains information about a component type.
arn (string) --
The ARN of the component type.
componentTypeId (string) --
The ID of the component type.
creationDateTime (datetime) --
The date and time when the component type was created.
description (string) --
The description of the component type.
status (dict) --
The current status of the component type.
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 date and time when the component type was last updated.
maxResults (integer) --
Specifies the maximum number of results to display.
nextToken (string) --
The string that specifies the next page of results.
workspaceId (string) --
The ID of the workspace.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
list_entities
(**kwargs)¶Lists all entities in a workspace.
See also: AWS API Documentation
Request Syntax
response = client.list_entities(
filters=[
{
'componentTypeId': 'string',
'externalId': 'string',
'parentEntityId': 'string'
},
],
maxResults=123,
nextToken='string',
workspaceId='string'
)
A list of objects that filter the request.
Note
Only one object is accepted as a valid input.
An object that filters items in a list of entities.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: componentTypeId
, externalId
, parentEntityId
.
The ID of the component type in the entities in the list.
The external-Id property of a component. The external-Id property is the primary key of an external storage system.
The parent of the entities in the list.
[REQUIRED]
The ID of the workspace.
dict
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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
list_scenes
(**kwargs)¶Lists all scenes in a workspace.
See also: AWS API Documentation
Request Syntax
response = client.list_scenes(
maxResults=123,
nextToken='string',
workspaceId='string'
)
[REQUIRED]
The ID of the workspace that contains the scenes.
dict
Response Syntax
{
'nextToken': 'string',
'sceneSummaries': [
{
'arn': 'string',
'contentLocation': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'sceneId': 'string',
'updateDateTime': datetime(2015, 1, 1)
},
]
}
Response Structure
(dict) --
nextToken (string) --
The string that specifies the next page of results.
sceneSummaries (list) --
A list of objects that contain information about the scenes.
(dict) --
An object that contains information about a scene.
arn (string) --
The ARN of the scene.
contentLocation (string) --
The relative path that specifies the location of the content definition file.
creationDateTime (datetime) --
The date and time when the scene was created.
description (string) --
The scene description.
sceneId (string) --
The ID of the scene.
updateDateTime (datetime) --
The date and time when the scene was last updated.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
Lists all tags associated with a resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
maxResults=123,
nextToken='string',
resourceARN='string'
)
[REQUIRED]
The ARN of the resource.
dict
Response Syntax
{
'nextToken': 'string',
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
nextToken (string) --
The string that specifies the next page of results.
tags (dict) --
Metadata that you can use to manage a resource.
Exceptions
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
list_workspaces
(**kwargs)¶Retrieves information about workspaces in the current account.
See also: AWS API Documentation
Request Syntax
response = client.list_workspaces(
maxResults=123,
nextToken='string'
)
dict
Response Syntax
{
'nextToken': 'string',
'workspaceSummaries': [
{
'arn': 'string',
'creationDateTime': datetime(2015, 1, 1),
'description': 'string',
'updateDateTime': datetime(2015, 1, 1),
'workspaceId': 'string'
},
]
}
Response Structure
(dict) --
nextToken (string) --
The string that specifies the next page of results.
workspaceSummaries (list) --
A list of objects that contain information about the workspaces.
(dict) --
An object that contains information about a workspace.
arn (string) --
The ARN of the workspace.
creationDateTime (datetime) --
The date and time when the workspace was created.
description (string) --
The description of the workspace.
updateDateTime (datetime) --
The date and time when the workspace was last updated.
workspaceId (string) --
The ID of the workspace.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
tag_resource
(**kwargs)¶Adds tags to a resource.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
resourceARN='string',
tags={
'string': 'string'
}
)
[REQUIRED]
The ARN of the resource.
[REQUIRED]
Metadata to add to this resource.
dict
Response Syntax
{}
Response Structure
Exceptions
IoTTwinMaker.Client.exceptions.TooManyTagsException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
untag_resource
(**kwargs)¶Removes tags from a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
resourceARN='string',
tagKeys=[
'string',
]
)
[REQUIRED]
The ARN of the resource.
[REQUIRED]
A list of tag key names to remove from the resource. You don't specify the value. Both the key and its associated value are removed.
dict
Response Syntax
{}
Response Structure
Exceptions
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
update_component_type
(**kwargs)¶Updates information in a component type.
See also: AWS API Documentation
Request Syntax
response = client.update_component_type(
componentTypeId='string',
description='string',
extendsFrom=[
'string',
],
functions={
'string': {
'implementedBy': {
'isNative': True|False,
'lambda': {
'arn': 'string'
}
},
'requiredProperties': [
'string',
],
'scope': 'ENTITY'|'WORKSPACE'
}
},
isSingleton=True|False,
propertyDefinitions={
'string': {
'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
}
},
workspaceId='string'
)
[REQUIRED]
The ID of the component type.
Specifies the component type that this component type extends.
An object that maps strings to the functions in the component type. Each string in the mapping must be unique to this object.
The function request body.
The data connector.
A Boolean value that specifies whether the data connector is native to IoT TwinMaker.
The Lambda function associated with this data connector.
The ARN of the Lambda function.
The required properties of the function.
The scope of the function.
An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.
An object that sets information about a property.
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.
An object that contains information about the data type.
The allowed values for this data type.
An object that specifies a value for a property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
The nested type in the data type.
A relationship that associates a component with another component.
The type of the relationship.
The ID of the target component type associated with this relationship.
The underlying type of the data type.
The unit of measure used in this data type.
An object that contains the default value.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
A Boolean value that specifies whether the property ID comes from an external data store.
A Boolean value that specifies whether the property is required.
A Boolean value that specifies whether the property is stored externally.
A Boolean value that specifies whether the property consists of time series data.
[REQUIRED]
The ID of the workspace that contains the component type.
dict
Response Syntax
{
'arn': 'string',
'componentTypeId': 'string',
'state': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'ERROR',
'workspaceId': 'string'
}
Response Structure
(dict) --
arn (string) --
The ARN of the component type.
componentTypeId (string) --
The ID of the component type.
state (string) --
The current state of the component type.
workspaceId (string) --
The ID of the workspace that contains the component type.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
update_entity
(**kwargs)¶Updates an entity.
See also: AWS API Documentation
Request Syntax
response = 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'
)
An object that maps strings to the component updates in the request. Each string in the mapping must be unique to this object.
The component update request.
The ID of the component type.
The description of the component type.
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.
An object that sets information about a property.
An object that specifies information about a property.
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.
An object that contains information about the data type.
The allowed values for this data type.
An object that specifies a value for a property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
The nested type in the data type.
A relationship that associates a component with another component.
The type of the relationship.
The ID of the target component type associated with this relationship.
The underlying type of the data type.
The unit of measure used in this data type.
An object that contains the default value.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
A Boolean value that specifies whether the property ID comes from an external data store.
A Boolean value that specifies whether the property is required.
A Boolean value that specifies whether the property is stored externally.
A Boolean value that specifies whether the property consists of time series data.
The update type of the update property request.
The value of the property.
A Boolean value.
A double value.
An expression that produces the value.
An integer value.
A list of multiple values.
An object that specifies a value for a property.
A long value.
An object that maps strings to multiple DataValue
objects.
An object that specifies a value for a property.
A value that relates a component to another component.
The name of the target component associated with the relationship value.
The ID of the target entity associated with this relationship value.
A string value.
The update type of the component update request.
[REQUIRED]
The ID of the entity.
An object that describes the update request for a parent entity.
The ID of the parent entity.
The type of the update.
[REQUIRED]
The ID of the workspace that contains the entity.
dict
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.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ConflictException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
update_scene
(**kwargs)¶Updates a scene.
See also: AWS API Documentation
Request Syntax
response = client.update_scene(
capabilities=[
'string',
],
contentLocation='string',
description='string',
sceneId='string',
workspaceId='string'
)
A list of capabilities that the scene uses to render.
[REQUIRED]
The ID of the scene.
[REQUIRED]
The ID of the workspace that contains the scene.
dict
Response Syntax
{
'updateDateTime': datetime(2015, 1, 1)
}
Response Structure
(dict) --
updateDateTime (datetime) --
The date and time when the scene was last updated.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
update_workspace
(**kwargs)¶Updates a workspace.
See also: AWS API Documentation
Request Syntax
response = client.update_workspace(
description='string',
role='string',
workspaceId='string'
)
[REQUIRED]
The ID of the workspace.
dict
Response Syntax
{
'updateDateTime': datetime(2015, 1, 1)
}
Response Structure
(dict) --
updateDateTime (datetime) --
The date and time of the current update.
Exceptions
IoTTwinMaker.Client.exceptions.InternalServerException
IoTTwinMaker.Client.exceptions.AccessDeniedException
IoTTwinMaker.Client.exceptions.ResourceNotFoundException
IoTTwinMaker.Client.exceptions.ThrottlingException
IoTTwinMaker.Client.exceptions.ValidationException
IoTTwinMaker.Client.exceptions.ServiceQuotaExceededException
The available paginators are: