@aws-sdk/client-iottwinmaker 3.67.0 → 3.69.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.69.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.68.0...v3.69.0) (2022-04-12)
+
+
+### Features
+
+* **client-iottwinmaker:** This release adds the following new features: 1) ListEntities API now supports search using ExternalId. 2) BatchPutPropertyValue and GetPropertyValueHistory API now allows users to represent time in sub-second level precisions. ([f000752](https://github.com/aws/aws-sdk-js-v3/commit/f0007527263b955c0e0af12ca2372b00caa40961))
+
+
+
+
+
 # [3.67.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.66.0...v3.67.0) (2022-04-08)
 
 **Note:** Version bump only for package @aws-sdk/client-iottwinmaker

package/README.md

@@ -7,11 +7,6 @@
 
 AWS SDK for JavaScript IoTTwinMaker Client for Node.js, Browser and React Native.
 
-<important>
-<p>
-TwinMaker is in public preview and is subject to change.
-</p>
-</important>
 <p>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

package/dist-cjs/models/models_0.js

@@ -163,6 +163,7 @@ class ServiceQuotaExceededException extends IoTTwinMakerServiceException_1.IoTTw
 exports.ServiceQuotaExceededException = ServiceQuotaExceededException;
 var PropertyUpdateType;
 (function (PropertyUpdateType) {
+    PropertyUpdateType["CREATE"] = "CREATE";
     PropertyUpdateType["DELETE"] = "DELETE";
     PropertyUpdateType["UPDATE"] = "UPDATE";
 })(PropertyUpdateType = exports.PropertyUpdateType || (exports.PropertyUpdateType = {}));
@@ -398,6 +399,8 @@ var ListEntitiesFilter;
             return visitor.parentEntityId(value.parentEntityId);
         if (value.componentTypeId !== undefined)
             return visitor.componentTypeId(value.componentTypeId);
+        if (value.externalId !== undefined)
+            return visitor.externalId(value.externalId);
         return visitor._(value.$unknown[0], value.$unknown[1]);
     };
     ListEntitiesFilter.filterSensitiveLog = (obj) => {
@@ -405,6 +408,8 @@ var ListEntitiesFilter;
             return { parentEntityId: obj.parentEntityId };
         if (obj.componentTypeId !== undefined)
             return { componentTypeId: obj.componentTypeId };
+        if (obj.externalId !== undefined)
+            return { externalId: obj.externalId };
         if (obj.$unknown !== undefined)
             return { [obj.$unknown[0]]: "UNKNOWN" };
     };

package/dist-cjs/protocols/Aws_restJson1.js

@@ -566,6 +566,7 @@ const serializeAws_restJson1GetPropertyValueHistoryCommand = async (input, conte
             input.componentTypeId !== null && { componentTypeId: input.componentTypeId }),
         ...(input.endDateTime !== undefined &&
             input.endDateTime !== null && { endDateTime: Math.round(input.endDateTime.getTime() / 1000) }),
+        ...(input.endTime !== undefined && input.endTime !== null && { endTime: input.endTime }),
         ...(input.entityId !== undefined && input.entityId !== null && { entityId: input.entityId }),
         ...(input.interpolation !== undefined &&
             input.interpolation !== null && {
@@ -584,6 +585,7 @@ const serializeAws_restJson1GetPropertyValueHistoryCommand = async (input, conte
         }),
         ...(input.startDateTime !== undefined &&
             input.startDateTime !== null && { startDateTime: Math.round(input.startDateTime.getTime() / 1000) }),
+        ...(input.startTime !== undefined && input.startTime !== null && { startTime: input.startTime }),
     });
     let { hostname: resolvedHostname } = await context.endpoint();
     if (context.disableHostPrefix !== true) {
@@ -2931,6 +2933,7 @@ const serializeAws_restJson1ListComponentTypesFilters = (input, context) => {
 const serializeAws_restJson1ListEntitiesFilter = (input, context) => {
     return models_0_1.ListEntitiesFilter.visit(input, {
         componentTypeId: (value) => ({ componentTypeId: value }),
+        externalId: (value) => ({ externalId: value }),
         parentEntityId: (value) => ({ parentEntityId: value }),
         _: (name, value) => ({ name: value }),
     });
@@ -3023,6 +3026,7 @@ const serializeAws_restJson1PropertyRequests = (input, context) => {
 };
 const serializeAws_restJson1PropertyValue = (input, context) => {
     return {
+        ...(input.time !== undefined && input.time !== null && { time: input.time }),
         ...(input.timestamp !== undefined &&
             input.timestamp !== null && { timestamp: Math.round(input.timestamp.getTime() / 1000) }),
         ...(input.value !== undefined &&
@@ -3444,6 +3448,7 @@ const deserializeAws_restJson1PropertyResponses = (output, context) => {
 };
 const deserializeAws_restJson1PropertyValue = (output, context) => {
     return {
+        time: (0, smithy_client_1.expectString)(output.time),
         timestamp: output.timestamp !== undefined && output.timestamp !== null
             ? (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(output.timestamp)))
             : undefined,

package/dist-es/models/models_0.js

@@ -138,6 +138,7 @@ var ServiceQuotaExceededException = (function (_super) {
 export { ServiceQuotaExceededException };
 export var PropertyUpdateType;
 (function (PropertyUpdateType) {
+    PropertyUpdateType["CREATE"] = "CREATE";
     PropertyUpdateType["DELETE"] = "DELETE";
     PropertyUpdateType["UPDATE"] = "UPDATE";
 })(PropertyUpdateType || (PropertyUpdateType = {}));
@@ -317,6 +318,8 @@ export var ListEntitiesFilter;
             return visitor.parentEntityId(value.parentEntityId);
         if (value.componentTypeId !== undefined)
             return visitor.componentTypeId(value.componentTypeId);
+        if (value.externalId !== undefined)
+            return visitor.externalId(value.externalId);
         return visitor._(value.$unknown[0], value.$unknown[1]);
     };
     ListEntitiesFilter.filterSensitiveLog = function (obj) {
@@ -325,6 +328,8 @@ export var ListEntitiesFilter;
             return { parentEntityId: obj.parentEntityId };
         if (obj.componentTypeId !== undefined)
             return { componentTypeId: obj.componentTypeId };
+        if (obj.externalId !== undefined)
+            return { externalId: obj.externalId };
         if (obj.$unknown !== undefined)
             return _a = {}, _a[obj.$unknown[0]] = "UNKNOWN", _a;
     };

package/dist-es/protocols/Aws_restJson1.js

@@ -611,9 +611,9 @@ export var serializeAws_restJson1GetPropertyValueHistoryCommand = function (inpu
                 else {
                     throw new Error("No value provided for input HTTP label: workspaceId.");
                 }
-                body = JSON.stringify(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.componentName !== undefined && input.componentName !== null && { componentName: input.componentName })), (input.componentTypeId !== undefined &&
+                body = JSON.stringify(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.componentName !== undefined && input.componentName !== null && { componentName: input.componentName })), (input.componentTypeId !== undefined &&
                     input.componentTypeId !== null && { componentTypeId: input.componentTypeId })), (input.endDateTime !== undefined &&
-                    input.endDateTime !== null && { endDateTime: Math.round(input.endDateTime.getTime() / 1000) })), (input.entityId !== undefined && input.entityId !== null && { entityId: input.entityId })), (input.interpolation !== undefined &&
+                    input.endDateTime !== null && { endDateTime: Math.round(input.endDateTime.getTime() / 1000) })), (input.endTime !== undefined && input.endTime !== null && { endTime: input.endTime })), (input.entityId !== undefined && input.entityId !== null && { entityId: input.entityId })), (input.interpolation !== undefined &&
                     input.interpolation !== null && {
                     interpolation: serializeAws_restJson1InterpolationParameters(input.interpolation, context),
                 })), (input.maxResults !== undefined && input.maxResults !== null && { maxResults: input.maxResults })), (input.nextToken !== undefined && input.nextToken !== null && { nextToken: input.nextToken })), (input.orderByTime !== undefined && input.orderByTime !== null && { orderByTime: input.orderByTime })), (input.propertyFilters !== undefined &&
@@ -623,7 +623,7 @@ export var serializeAws_restJson1GetPropertyValueHistoryCommand = function (inpu
                     input.selectedProperties !== null && {
                     selectedProperties: serializeAws_restJson1SelectedPropertyList(input.selectedProperties, context),
                 })), (input.startDateTime !== undefined &&
-                    input.startDateTime !== null && { startDateTime: Math.round(input.startDateTime.getTime() / 1000) })));
+                    input.startDateTime !== null && { startDateTime: Math.round(input.startDateTime.getTime() / 1000) })), (input.startTime !== undefined && input.startTime !== null && { startTime: input.startTime })));
                 return [4, context.endpoint()];
             case 2:
                 resolvedHostname = (_c.sent()).hostname;
@@ -3562,6 +3562,7 @@ var serializeAws_restJson1ListComponentTypesFilters = function (input, context)
 var serializeAws_restJson1ListEntitiesFilter = function (input, context) {
     return ListEntitiesFilter.visit(input, {
         componentTypeId: function (value) { return ({ componentTypeId: value }); },
+        externalId: function (value) { return ({ externalId: value }); },
         parentEntityId: function (value) { return ({ parentEntityId: value }); },
         _: function (name, value) { return ({ name: value }); },
     });
@@ -3632,7 +3633,7 @@ var serializeAws_restJson1PropertyRequests = function (input, context) {
     }, {});
 };
 var serializeAws_restJson1PropertyValue = function (input, context) {
-    return __assign(__assign({}, (input.timestamp !== undefined &&
+    return __assign(__assign(__assign({}, (input.time !== undefined && input.time !== null && { time: input.time })), (input.timestamp !== undefined &&
         input.timestamp !== null && { timestamp: Math.round(input.timestamp.getTime() / 1000) })), (input.value !== undefined &&
         input.value !== null && { value: serializeAws_restJson1DataValue(input.value, context) }));
 };
@@ -4033,6 +4034,7 @@ var deserializeAws_restJson1PropertyResponses = function (output, context) {
 };
 var deserializeAws_restJson1PropertyValue = function (output, context) {
     return {
+        time: __expectString(output.time),
         timestamp: output.timestamp !== undefined && output.timestamp !== null
             ? __expectNonNull(__parseEpochTimestamp(__expectNumber(output.timestamp)))
             : undefined,

package/dist-types/IoTTwinMaker.d.ts

@@ -27,12 +27,7 @@ import { UpdateSceneCommandInput, UpdateSceneCommandOutput } from "./commands/Up
 import { UpdateWorkspaceCommandInput, UpdateWorkspaceCommandOutput } from "./commands/UpdateWorkspaceCommand";
 import { IoTTwinMakerClient } from "./IoTTwinMakerClient";
 /**
- * <important>
- *             <p>
- *         TwinMaker is in public preview and is subject to change.
- *       </p>
- *          </important>
- *          <p>IoT TwinMaker is a service that enables you to build operational digital twins of
+ * <p>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
@@ -47,11 +42,6 @@ export declare class IoTTwinMaker extends IoTTwinMakerClient {
     batchPutPropertyValues(args: BatchPutPropertyValuesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: BatchPutPropertyValuesCommandOutput) => void): void;
     /**
      * <p>Creates a component type.</p>
-     *          <important>
-     *             <p>
-     *         TwinMaker is in public preview and is subject to change.
-     *       </p>
-     *          </important>
      */
     createComponentType(args: CreateComponentTypeCommandInput, options?: __HttpHandlerOptions): Promise<CreateComponentTypeCommandOutput>;
     createComponentType(args: CreateComponentTypeCommandInput, cb: (err: any, data?: CreateComponentTypeCommandOutput) => void): void;

package/dist-types/IoTTwinMakerClient.d.ts

@@ -152,12 +152,7 @@ declare type IoTTwinMakerClientResolvedConfigType = __SmithyResolvedConfiguratio
 export interface IoTTwinMakerClientResolvedConfig extends IoTTwinMakerClientResolvedConfigType {
 }
 /**
- * <important>
- *             <p>
- *         TwinMaker is in public preview and is subject to change.
- *       </p>
- *          </important>
- *          <p>IoT TwinMaker is a service that enables you to build operational digital twins of
+ * <p>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

package/dist-types/commands/CreateComponentTypeCommand.d.ts

@@ -8,11 +8,6 @@ export interface CreateComponentTypeCommandOutput extends CreateComponentTypeRes
 }
 /**
  * <p>Creates a component type.</p>
- *          <important>
- *             <p>
- *         TwinMaker is in public preview and is subject to change.
- *       </p>
- *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/models/models_0.d.ts

@@ -138,7 +138,7 @@ export interface DataConnector {
      */
     lambda?: LambdaFunction;
     /**
-     * <p>A Boolean value that specifies whether the data connector is native to TwinMaker.</p>
+     * <p>A Boolean value that specifies whether the data connector is native to IoT TwinMaker.</p>
      */
     isNative?: boolean;
 }
@@ -243,6 +243,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
     constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
 }
 export declare enum PropertyUpdateType {
+    CREATE = "CREATE",
     DELETE = "DELETE",
     UPDATE = "UPDATE"
 }
@@ -887,7 +888,7 @@ export declare namespace ListComponentTypesResponse {
 /**
  * <p>An object that filters items in a list of entities.</p>
  */
-export declare type ListEntitiesFilter = ListEntitiesFilter.ComponentTypeIdMember | ListEntitiesFilter.ParentEntityIdMember | ListEntitiesFilter.$UnknownMember;
+export declare type ListEntitiesFilter = ListEntitiesFilter.ComponentTypeIdMember | ListEntitiesFilter.ExternalIdMember | ListEntitiesFilter.ParentEntityIdMember | ListEntitiesFilter.$UnknownMember;
 export declare namespace ListEntitiesFilter {
     /**
      * <p>The parent of the entities in the list.</p>
@@ -895,6 +896,7 @@ export declare namespace ListEntitiesFilter {
     interface ParentEntityIdMember {
         parentEntityId: string;
         componentTypeId?: never;
+        externalId?: never;
         $unknown?: never;
     }
     /**
@@ -903,16 +905,28 @@ export declare namespace ListEntitiesFilter {
     interface ComponentTypeIdMember {
         parentEntityId?: never;
         componentTypeId: string;
+        externalId?: never;
+        $unknown?: never;
+    }
+    /**
+     * <p>The external-Id property of a component. The external-Id property is the primary key of an external storage system.</p>
+     */
+    interface ExternalIdMember {
+        parentEntityId?: never;
+        componentTypeId?: never;
+        externalId: string;
         $unknown?: never;
     }
     interface $UnknownMember {
         parentEntityId?: never;
         componentTypeId?: never;
+        externalId?: never;
         $unknown: [string, any];
     }
     interface Visitor<T> {
         parentEntityId: (value: string) => T;
         componentTypeId: (value: string) => T;
+        externalId: (value: string) => T;
         _: (name: string, value: any) => T;
     }
     const visit: <T>(value: ListEntitiesFilter, visitor: Visitor<T>) => T;
@@ -1477,13 +1491,19 @@ export declare namespace PropertyLatestValue {
  */
 export interface PropertyValue {
     /**
+     * @deprecated
+     *
      * <p>The timestamp of a value for a time series property.</p>
      */
-    timestamp: Date | undefined;
+    timestamp?: Date;
     /**
      * <p>An object that specifies a value for a time series property.</p>
      */
     value: DataValue | undefined;
+    /**
+     * Timestamp represented in ISO 8601 format
+     */
+    time?: string;
 }
 export declare namespace PropertyValue {
     /**
@@ -1548,13 +1568,17 @@ export interface GetPropertyValueHistoryRequest {
      */
     propertyFilters?: PropertyFilter[];
     /**
+     * @deprecated
+     *
      * <p>The date and time of the earliest property value to return.</p>
      */
-    startDateTime: Date | undefined;
+    startDateTime?: Date;
     /**
+     * @deprecated
+     *
      * <p>The date and time of the latest property value to return.</p>
      */
-    endDateTime: Date | undefined;
+    endDateTime?: Date;
     /**
      * <p>An object that specifies the interpolation type and the interval over which to interpolate data.</p>
      */
@@ -1571,6 +1595,14 @@ export interface GetPropertyValueHistoryRequest {
      * <p>The time direction to use in the result order.</p>
      */
     orderByTime?: OrderByTime | string;
+    /**
+     * Timestamp represented in ISO 8601 format
+     */
+    startTime?: string;
+    /**
+     * Timestamp represented in ISO 8601 format
+     */
+    endTime?: string;
 }
 export declare namespace GetPropertyValueHistoryRequest {
     /**

package/dist-types/ts3.4/models/models_0.d.ts

@@ -155,6 +155,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
     constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
 }
 export declare enum PropertyUpdateType {
+    CREATE = "CREATE",
     DELETE = "DELETE",
     UPDATE = "UPDATE"
 }
@@ -558,23 +559,33 @@ export declare namespace ListComponentTypesResponse {
     const filterSensitiveLog: (obj: ListComponentTypesResponse) => any;
 }
 
-export declare type ListEntitiesFilter = ListEntitiesFilter.ComponentTypeIdMember | ListEntitiesFilter.ParentEntityIdMember | ListEntitiesFilter.$UnknownMember;
+export declare type ListEntitiesFilter = ListEntitiesFilter.ComponentTypeIdMember | ListEntitiesFilter.ExternalIdMember | ListEntitiesFilter.ParentEntityIdMember | ListEntitiesFilter.$UnknownMember;
 export declare namespace ListEntitiesFilter {
     
     interface ParentEntityIdMember {
         parentEntityId: string;
         componentTypeId?: never;
+        externalId?: never;
         $unknown?: never;
     }
     
     interface ComponentTypeIdMember {
         parentEntityId?: never;
         componentTypeId: string;
+        externalId?: never;
+        $unknown?: never;
+    }
+    
+    interface ExternalIdMember {
+        parentEntityId?: never;
+        componentTypeId?: never;
+        externalId: string;
         $unknown?: never;
     }
     interface $UnknownMember {
         parentEntityId?: never;
         componentTypeId?: never;
+        externalId?: never;
         $unknown: [
             string,
             any
@@ -583,6 +594,7 @@ export declare namespace ListEntitiesFilter {
     interface Visitor<T> {
         parentEntityId: (value: string) => T;
         componentTypeId: (value: string) => T;
+        externalId: (value: string) => T;
         _: (name: string, value: any) => T;
     }
     const visit: <T>(value: ListEntitiesFilter, visitor: Visitor<T>) => T;
@@ -923,9 +935,11 @@ export declare namespace PropertyLatestValue {
 
 export interface PropertyValue {
     
-    timestamp: Date | undefined;
+    timestamp?: Date;
     
     value: DataValue | undefined;
+    
+    time?: string;
 }
 export declare namespace PropertyValue {
     
@@ -962,9 +976,9 @@ export interface GetPropertyValueHistoryRequest {
     
     propertyFilters?: PropertyFilter[];
     
-    startDateTime: Date | undefined;
+    startDateTime?: Date;
     
-    endDateTime: Date | undefined;
+    endDateTime?: Date;
     
     interpolation?: InterpolationParameters;
     
@@ -973,6 +987,10 @@ export interface GetPropertyValueHistoryRequest {
     maxResults?: number;
     
     orderByTime?: OrderByTime | string;
+    
+    startTime?: string;
+    
+    endTime?: string;
 }
 export declare namespace GetPropertyValueHistoryRequest {
     

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-iottwinmaker",
   "description": "AWS SDK for JavaScript Iottwinmaker Client for Node.js, Browser and React Native",
-  "version": "3.67.0",
+  "version": "3.69.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",