Iottwinmaker

This page documents function available when using the Iottwinmaker module, created with @service Iottwinmaker.

Index

Documentation

Main.Iottwinmaker.batch_put_property_valuesMethod
batch_put_property_values(entries, workspace_id)
batch_put_property_values(entries, workspace_id, params::Dict{String,<:Any})

Sets values for multiple time series properties.

Arguments

  • entries: An object that maps strings to the property value entries to set. Each string in the mapping must be unique to this object.
  • workspace_id: The ID of the workspace that contains the properties to set.
Main.Iottwinmaker.cancel_metadata_transfer_jobMethod
cancel_metadata_transfer_job(metadata_transfer_job_id)
cancel_metadata_transfer_job(metadata_transfer_job_id, params::Dict{String,<:Any})

Cancels the metadata transfer job.

Arguments

  • metadata_transfer_job_id: The metadata transfer job Id.
Main.Iottwinmaker.create_component_typeMethod
create_component_type(component_type_id, workspace_id)
create_component_type(component_type_id, workspace_id, params::Dict{String,<:Any})

Creates a component type.

Arguments

  • component_type_id: The ID of the component type.
  • workspace_id: The ID of the workspace that contains the component type.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentTypeName": A friendly name for the component type.
  • "compositeComponentTypes": This is an object that maps strings to compositeComponentTypes of the componentType. CompositeComponentType is referenced by componentTypeId.
  • "description": The description of the component type.
  • "extendsFrom": Specifies the parent component type to extend.
  • "functions": An object that maps strings to the functions in the component type. Each string in the mapping must be unique to this object.
  • "isSingleton": A Boolean value that specifies whether an entity can have more than one component of this type.
  • "propertyDefinitions": An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.
  • "propertyGroups":
  • "tags": Metadata that you can use to manage the component type.
Main.Iottwinmaker.create_entityMethod
create_entity(entity_name, workspace_id)
create_entity(entity_name, workspace_id, params::Dict{String,<:Any})

Creates an entity.

Arguments

  • entity_name: The name of the entity.
  • workspace_id: The ID of the workspace that contains the entity.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "components": An object that maps strings to the components in the entity. Each string in the mapping must be unique to this object.
  • "compositeComponents": This is an object that maps strings to compositeComponent updates in the request. Each key of the map represents the componentPath of the compositeComponent.
  • "description": The description of the entity.
  • "entityId": The ID of the entity.
  • "parentEntityId": The ID of the entity's parent entity.
  • "tags": Metadata that you can use to manage the entity.
Main.Iottwinmaker.create_metadata_transfer_jobMethod
create_metadata_transfer_job(destination, sources)
create_metadata_transfer_job(destination, sources, params::Dict{String,<:Any})

Creates a new metadata transfer job.

Arguments

  • destination: The metadata transfer job destination.
  • sources: The metadata transfer job sources.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "description": The metadata transfer job description.
  • "metadataTransferJobId": The metadata transfer job Id.
Main.Iottwinmaker.create_sceneMethod
create_scene(content_location, scene_id, workspace_id)
create_scene(content_location, scene_id, workspace_id, params::Dict{String,<:Any})

Creates a scene.

Arguments

  • content_location: The relative path that specifies the location of the content definition file.
  • scene_id: The ID of the scene.
  • workspace_id: The ID of the workspace that contains the scene.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "capabilities": A list of capabilities that the scene uses to render itself.
  • "description": The description for this scene.
  • "sceneMetadata": The request metadata.
  • "tags": Metadata that you can use to manage the scene.
Main.Iottwinmaker.create_sync_jobMethod
create_sync_job(sync_role, sync_source, workspace_id)
create_sync_job(sync_role, sync_source, workspace_id, params::Dict{String,<:Any})

This action creates a SyncJob.

Arguments

  • sync_role: The SyncJob IAM role. This IAM role is used by the SyncJob to read from the syncSource, and create, update, or delete the corresponding resources.
  • sync_source: The sync source. Currently the only supported syncSoource is SITEWISE .
  • workspace_id: The workspace ID.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "tags": The SyncJob tags.
Main.Iottwinmaker.create_workspaceMethod
create_workspace(workspace_id)
create_workspace(workspace_id, params::Dict{String,<:Any})

Creates a workplace.

Arguments

  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "description": The description of the workspace.
  • "role": The ARN of the execution role associated with the workspace.
  • "s3Location": The ARN of the S3 bucket where resources associated with the workspace are stored.
  • "tags": Metadata that you can use to manage the workspace
Main.Iottwinmaker.delete_component_typeMethod
delete_component_type(component_type_id, workspace_id)
delete_component_type(component_type_id, workspace_id, params::Dict{String,<:Any})

Deletes a component type.

Arguments

  • component_type_id: The ID of the component type to delete.
  • workspace_id: The ID of the workspace that contains the component type.
Main.Iottwinmaker.delete_entityMethod
delete_entity(entity_id, workspace_id)
delete_entity(entity_id, workspace_id, params::Dict{String,<:Any})

Deletes an entity.

Arguments

  • entity_id: The ID of the entity to delete.
  • workspace_id: The ID of the workspace that contains the entity to delete.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "isRecursive": A Boolean value that specifies whether the operation deletes child entities.
Main.Iottwinmaker.delete_sceneMethod
delete_scene(scene_id, workspace_id)
delete_scene(scene_id, workspace_id, params::Dict{String,<:Any})

Deletes a scene.

Arguments

  • scene_id: The ID of the scene to delete.
  • workspace_id: The ID of the workspace.
Main.Iottwinmaker.delete_sync_jobMethod
delete_sync_job(sync_source, workspace_id)
delete_sync_job(sync_source, workspace_id, params::Dict{String,<:Any})

Delete the SyncJob.

Arguments

  • sync_source: The sync source. Currently the only supported syncSource is SITEWISE .
  • workspace_id: The workspace ID.
Main.Iottwinmaker.delete_workspaceMethod
delete_workspace(workspace_id)
delete_workspace(workspace_id, params::Dict{String,<:Any})

Deletes a workspace.

Arguments

  • workspace_id: The ID of the workspace to delete.
Main.Iottwinmaker.execute_queryMethod
execute_query(query_statement, workspace_id)
execute_query(query_statement, workspace_id, params::Dict{String,<:Any})

Run queries to access information from your knowledge graph of entities within individual workspaces. The ExecuteQuery action only works with Amazon Web Services Java SDK2. ExecuteQuery will not work with any Amazon Web Services Java SDK version &lt; 2.x.

Arguments

  • query_statement: The query statement.
  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return at one time. The default is 50.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.get_component_typeMethod
get_component_type(component_type_id, workspace_id)
get_component_type(component_type_id, workspace_id, params::Dict{String,<:Any})

Retrieves information about a component type.

Arguments

  • component_type_id: The ID of the component type.
  • workspace_id: The ID of the workspace that contains the component type.
Main.Iottwinmaker.get_entityMethod
get_entity(entity_id, workspace_id)
get_entity(entity_id, workspace_id, params::Dict{String,<:Any})

Retrieves information about an entity.

Arguments

  • entity_id: The ID of the entity.
  • workspace_id: The ID of the workspace.
Main.Iottwinmaker.get_metadata_transfer_jobMethod
get_metadata_transfer_job(metadata_transfer_job_id)
get_metadata_transfer_job(metadata_transfer_job_id, params::Dict{String,<:Any})

Gets a nmetadata transfer job.

Arguments

  • metadata_transfer_job_id: The metadata transfer job Id.
Main.Iottwinmaker.get_property_valueMethod
get_property_value(selected_properties, workspace_id)
get_property_value(selected_properties, workspace_id, params::Dict{String,<:Any})

Gets the property values for a component, component type, entity, or workspace. You must specify a value for either componentName, componentTypeId, entityId, or workspaceId.

Arguments

  • selected_properties: The properties whose values the operation returns.
  • workspace_id: The ID of the workspace whose values the operation returns.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentName": The name of the component whose property values the operation returns.
  • "componentPath": This string specifies the path to the composite component, starting from the top-level component.
  • "componentTypeId": The ID of the component type whose property values the operation returns.
  • "entityId": The ID of the entity whose property values the operation returns.
  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
  • "propertyGroupName": The property group name.
  • "tabularConditions": The tabular conditions.
Main.Iottwinmaker.get_property_value_historyMethod
get_property_value_history(selected_properties, workspace_id)
get_property_value_history(selected_properties, workspace_id, params::Dict{String,<:Any})

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.

Arguments

  • selected_properties: A list of properties whose value histories the request retrieves.
  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentName": The name of the component.
  • "componentPath": This string specifies the path to the composite component, starting from the top-level component.
  • "componentTypeId": The ID of the component type.
  • "endDateTime": The date and time of the latest property value to return.
  • "endTime": The ISO8601 DateTime of the latest property value to return. For more information about the ISO8601 DateTime format, see the data type PropertyValue.
  • "entityId": The ID of the entity.
  • "interpolation": An object that specifies the interpolation type and the interval over which to interpolate data.
  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
  • "orderByTime": The time direction to use in the result order.
  • "propertyFilters": A list of objects that filter the property value history request.
  • "startDateTime": The date and time of the earliest property value to return.
  • "startTime": The ISO8601 DateTime of the earliest property value to return. For more information about the ISO8601 DateTime format, see the data type PropertyValue.
Main.Iottwinmaker.get_sceneMethod
get_scene(scene_id, workspace_id)
get_scene(scene_id, workspace_id, params::Dict{String,<:Any})

Retrieves information about a scene.

Arguments

  • scene_id: The ID of the scene.
  • workspace_id: The ID of the workspace that contains the scene.
Main.Iottwinmaker.get_sync_jobMethod
get_sync_job(sync_source)
get_sync_job(sync_source, params::Dict{String,<:Any})

Gets the SyncJob.

Arguments

  • sync_source: The sync source. Currently the only supported syncSource is SITEWISE .

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "workspace": The workspace ID.
Main.Iottwinmaker.get_workspaceMethod
get_workspace(workspace_id)
get_workspace(workspace_id, params::Dict{String,<:Any})

Retrieves information about a workspace.

Arguments

  • workspace_id: The ID of the workspace.
Main.Iottwinmaker.list_component_typesMethod
list_component_types(workspace_id)
list_component_types(workspace_id, params::Dict{String,<:Any})

Lists all component types in a workspace.

Arguments

  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "filters": A list of objects that filter the request.
  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_componentsMethod
list_components(entity_id, workspace_id)
list_components(entity_id, workspace_id, params::Dict{String,<:Any})

This API lists the components of an entity.

Arguments

  • entity_id: The ID for the entity whose metadata (component/properties) is returned by the operation.
  • workspace_id: The workspace ID.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentPath": This string specifies the path to the composite component, starting from the top-level component.
  • "maxResults": The maximum number of results returned at one time. The default is 25.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_entitiesMethod
list_entities(workspace_id)
list_entities(workspace_id, params::Dict{String,<:Any})

Lists all entities in a workspace.

Arguments

  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "filters": A list of objects that filter the request. Only one object is accepted as a valid input.
  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_metadata_transfer_jobsMethod
list_metadata_transfer_jobs(destination_type, source_type)
list_metadata_transfer_jobs(destination_type, source_type, params::Dict{String,<:Any})

Lists the metadata transfer jobs.

Arguments

  • destination_type: The metadata transfer job's destination type.
  • source_type: The metadata transfer job's source type.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "filters": An object that filters metadata transfer jobs.
  • "maxResults": The maximum number of results to return at one time.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_propertiesMethod
list_properties(entity_id, workspace_id)
list_properties(entity_id, workspace_id, params::Dict{String,<:Any})

This API lists the properties of a component.

Arguments

  • entity_id: The ID for the entity whose metadata (component/properties) is returned by the operation.
  • workspace_id: The workspace ID.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentName": The name of the component whose properties are returned by the operation.
  • "componentPath": This string specifies the path to the composite component, starting from the top-level component.
  • "maxResults": The maximum number of results returned at one time. The default is 25.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_scenesMethod
list_scenes(workspace_id)
list_scenes(workspace_id, params::Dict{String,<:Any})

Lists all scenes in a workspace.

Arguments

  • workspace_id: The ID of the workspace that contains the scenes.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": Specifies the maximum number of results to display.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_sync_jobsMethod
list_sync_jobs(workspace_id)
list_sync_jobs(workspace_id, params::Dict{String,<:Any})

List all SyncJobs.

Arguments

  • workspace_id: The ID of the workspace that contains the sync job.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return at one time. The default is 50. Valid Range: Minimum value of 0. Maximum value of 200.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_sync_resourcesMethod
list_sync_resources(sync_source, workspace_id)
list_sync_resources(sync_source, workspace_id, params::Dict{String,<:Any})

Lists the sync resources.

Arguments

  • sync_source: The sync source. Currently the only supported syncSource is SITEWISE .
  • workspace_id: The ID of the workspace that contains the sync job.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "filters": A list of objects that filter the request. The following filter combinations are supported: Filter with state Filter with ResourceType and ResourceId Filter with ResourceType and ExternalId
  • "maxResults": The maximum number of results to return at one time. The default is 50. Valid Range: Minimum value of 0. Maximum value of 200.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_tags_for_resourceMethod
list_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})

Lists all tags associated with a resource.

Arguments

  • resource_arn: The ARN of the resource.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.list_workspacesMethod
list_workspaces()
list_workspaces(params::Dict{String,<:Any})

Retrieves information about workspaces in the current account.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return at one time. The default is 25. Valid Range: Minimum value of 1. Maximum value of 250.
  • "nextToken": The string that specifies the next page of results.
Main.Iottwinmaker.tag_resourceMethod
tag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})

Adds tags to a resource.

Arguments

  • resource_arn: The ARN of the resource.
  • tags: Metadata to add to this resource.
Main.Iottwinmaker.untag_resourceMethod
untag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})

Removes tags from a resource.

Arguments

  • resource_arn: The ARN of the resource.
  • tag_keys: 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.
Main.Iottwinmaker.update_component_typeMethod
update_component_type(component_type_id, workspace_id)
update_component_type(component_type_id, workspace_id, params::Dict{String,<:Any})

Updates information in a component type.

Arguments

  • component_type_id: The ID of the component type.
  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentTypeName": The component type name.
  • "compositeComponentTypes": This is an object that maps strings to compositeComponentTypes of the componentType. CompositeComponentType is referenced by componentTypeId.
  • "description": The description of the component type.
  • "extendsFrom": Specifies the component type that this component type extends.
  • "functions": An object that maps strings to the functions in the component type. Each string in the mapping must be unique to this object.
  • "isSingleton": A Boolean value that specifies whether an entity can have more than one component of this type.
  • "propertyDefinitions": An object that maps strings to the property definitions in the component type. Each string in the mapping must be unique to this object.
  • "propertyGroups": The property groups.
Main.Iottwinmaker.update_entityMethod
update_entity(entity_id, workspace_id)
update_entity(entity_id, workspace_id, params::Dict{String,<:Any})

Updates an entity.

Arguments

  • entity_id: The ID of the entity.
  • workspace_id: The ID of the workspace that contains the entity.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "componentUpdates": An object that maps strings to the component updates in the request. Each string in the mapping must be unique to this object.
  • "compositeComponentUpdates": This is an object that maps strings to compositeComponent updates in the request. Each key of the map represents the componentPath of the compositeComponent.
  • "description": The description of the entity.
  • "entityName": The name of the entity.
  • "parentEntityUpdate": An object that describes the update request for a parent entity.
Main.Iottwinmaker.update_pricing_planMethod
update_pricing_plan(pricing_mode)
update_pricing_plan(pricing_mode, params::Dict{String,<:Any})

Update the pricing plan.

Arguments

  • pricing_mode: The pricing mode.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "bundleNames": The bundle names.
Main.Iottwinmaker.update_sceneMethod
update_scene(scene_id, workspace_id)
update_scene(scene_id, workspace_id, params::Dict{String,<:Any})

Updates a scene.

Arguments

  • scene_id: The ID of the scene.
  • workspace_id: The ID of the workspace that contains the scene.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "capabilities": A list of capabilities that the scene uses to render.
  • "contentLocation": The relative path that specifies the location of the content definition file.
  • "description": The description of this scene.
  • "sceneMetadata": The scene metadata.
Main.Iottwinmaker.update_workspaceMethod
update_workspace(workspace_id)
update_workspace(workspace_id, params::Dict{String,<:Any})

Updates a workspace.

Arguments

  • workspace_id: The ID of the workspace.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "description": The description of the workspace.
  • "role": The ARN of the execution role associated with the workspace.
  • "s3Location": The ARN of the S3 bucket where resources associated with the workspace are stored.