We announced the upcoming end-of-support for AWS SDK for JavaScript v2.
We recommend that you migrate to AWS SDK for JavaScript v3. For dates, additional details, and information on how to migrate, please refer to the linked announcement.

Class: AWS.IoTSiteWise

Inherits:
AWS.Service show all
Identifier:
iotsitewise
API Version:
2019-12-02
Defined in:
(unknown)

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

Welcome to the IoT SiteWise API Reference. IoT SiteWise is an Amazon Web Services service that connects Industrial Internet of Things (IIoT) devices to the power of the Amazon Web Services Cloud. For more information, see the IoT SiteWise User Guide. For information about IoT SiteWise quotas, see Quotas in the IoT SiteWise User Guide.

Sending a Request Using IoTSiteWise

var iotsitewise = new AWS.IoTSiteWise();
iotsitewise.associateAssets(params, function (err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Locking the API Version

In order to ensure that the IoTSiteWise object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var iotsitewise = new AWS.IoTSiteWise({apiVersion: '2019-12-02'});

You can also set the API version globally in AWS.config.apiVersions using the iotsitewise service identifier:

AWS.config.apiVersions = {
  iotsitewise: '2019-12-02',
  // other service API versions
};

var iotsitewise = new AWS.IoTSiteWise();

Version:

  • 2019-12-02

Waiter Resource States

This service supports a list of resource states that can be polled using the waitFor() method. The resource states are:

assetModelNotExists, assetModelActive, assetNotExists, assetActive, portalNotExists, portalActive

Constructor Summary collapse

Property Summary collapse

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, setupRequestListeners, defineService

Constructor Details

new AWS.IoTSiteWise(options = {}) ⇒ Object

Constructs a service object. This object has one method for each API operation.

Examples:

Constructing a IoTSiteWise object

var iotsitewise = new AWS.IoTSiteWise({apiVersion: '2019-12-02'});

Options Hash (options):

  • params (map)

    An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.

  • endpoint (String|AWS.Endpoint)

    The endpoint URI to send requests to. The default endpoint is built from the configured region. The endpoint should be a string like 'https://{service}.{region}.amazonaws.com' or an Endpoint object.

  • accessKeyId (String)

    your AWS access key ID.

  • secretAccessKey (String)

    your AWS secret access key.

  • sessionToken (AWS.Credentials)

    the optional AWS session token to sign requests with.

  • credentials (AWS.Credentials)

    the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.

  • credentialProvider (AWS.CredentialProviderChain)

    the provider chain used to resolve credentials if no static credentials property is set.

  • region (String)

    the region to send service requests to. See AWS.IoTSiteWise.region for more information.

  • maxRetries (Integer)

    the maximum amount of retries to attempt with a request. See AWS.IoTSiteWise.maxRetries for more information.

  • maxRedirects (Integer)

    the maximum amount of redirects to follow with a request. See AWS.IoTSiteWise.maxRedirects for more information.

  • sslEnabled (Boolean)

    whether to enable SSL for requests.

  • paramValidation (Boolean|map)

    whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:

    • min [Boolean] — Validates that a value meets the min constraint. This is enabled by default when paramValidation is set to true.
    • max [Boolean] — Validates that a value meets the max constraint.
    • pattern [Boolean] — Validates that a string value matches a regular expression.
    • enum [Boolean] — Validates that a string value matches one of the allowable enum values.
  • computeChecksums (Boolean)

    whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)

  • convertResponseTypes (Boolean)

    whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to true.

  • correctClockSkew (Boolean)

    whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to false.

  • s3ForcePathStyle (Boolean)

    whether to force path style URLs for S3 objects.

  • s3BucketEndpoint (Boolean)

    whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an endpoint to be provided explicitly to the service constructor.

  • s3DisableBodySigning (Boolean)

    whether S3 body signing should be disabled when using signature version v4. Body signing can only be disabled when using https. Defaults to true.

  • s3UsEast1RegionalEndpoint ('legacy'|'regional')

    when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to legacy

  • s3UseArnRegion (Boolean)

    whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to true

  • retryDelayOptions (map)

    A set of options to configure the retry delay on retryable errors. Currently supported options are:

    • base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
    • customBackoff [function] — A custom function that accepts a retry count and error and returns the amount of time to delay in milliseconds. If the result is a non-zero negative value, no further retry attempts will be made. The base option will be ignored if this option is supplied. The function is only called for retryable errors.
  • httpOptions (map)

    A set of options to pass to the low-level HTTP request. Currently supported options are:

    • proxy [String] — the URL to proxy requests through
    • agent [http.Agent, https.Agent] — the Agent object to perform HTTP requests with. Used for connection pooling. Defaults to the global agent (http.globalAgent) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment.
    • connectTimeout [Integer] — Sets the socket to timeout after failing to establish a connection with the server after connectTimeout milliseconds. This timeout has no effect once a socket connection has been established.
    • timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
    • xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
    • xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
  • apiVersion (String, Date)

    a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by apiVersions). Specify 'latest' to use the latest possible version.

  • apiVersions (map<String, String|Date>)

    a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.

  • logger (#write, #log)

    an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests

  • systemClockOffset (Number)

    an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global AWS.config object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds.

  • signatureVersion (String)

    the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.

  • signatureCache (Boolean)

    whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to true.

  • dynamoDbCrc32 (Boolean)

    whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default: true.

  • useAccelerateEndpoint (Boolean)

    Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default: false.

  • clientSideMonitoring (Boolean)

    whether to collect and publish this client's performance metrics of all its API requests.

  • endpointDiscoveryEnabled (Boolean|undefined)

    whether to call operations with endpoints given by service dynamically. Setting this

  • endpointCacheSize (Number)

    the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000

  • hostPrefixEnabled (Boolean)

    whether to marshal request parameters to the prefix of hostname. Defaults to true.

  • stsRegionalEndpoints ('legacy'|'regional')

    whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.

  • useFipsEndpoint (Boolean)

    Enables FIPS compatible endpoints. Defaults to false.

  • useDualstackEndpoint (Boolean)

    Enables IPv6 dualstack endpoint. Defaults to false.

Property Details

endpointAWS.Endpoint (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

  • (AWS.Endpoint)

    an Endpoint object representing the endpoint URL for service requests.

Method Details

associateAssets(params = {}, callback) ⇒ AWS.Request

Associates a child asset with the given parent asset through a hierarchy defined in the parent asset's model. For more information, see Associating assets in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the associateAssets operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  childAssetId: 'STRING_VALUE', /* required */
  hierarchyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.associateAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the parent asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • hierarchyId — (String)

      The ID of a hierarchy in the parent asset's model. (This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.) Hierarchies allow different groupings of assets to be formed that all come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

    • childAssetId — (String)

      The ID of the child asset to be associated. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

associateTimeSeriesToAssetProperty(params = {}, callback) ⇒ AWS.Request

Associates a time series (data stream) with an asset property.

Examples:

Calling the associateTimeSeriesToAssetProperty operation

var params = {
  alias: 'STRING_VALUE', /* required */
  assetId: 'STRING_VALUE', /* required */
  propertyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.associateTimeSeriesToAssetProperty(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • alias — (String)

      The alias that identifies the time series.

    • assetId — (String)

      The ID of the asset in which the asset property was created. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchAssociateProjectAssets(params = {}, callback) ⇒ AWS.Request

Associates a group (batch) of assets with an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the batchAssociateProjectAssets operation

var params = {
  assetIds: [ /* required */
    'STRING_VALUE',
    /* more items */
  ],
  projectId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.batchAssociateProjectAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project to which to associate the assets.

    • assetIds — (Array<String>)

      The IDs of the assets to be associated to the project.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errors — (Array<map>)

        A list of associated error information, if any.

        • assetIdrequired — (String)

          The ID of the asset, in UUID format.

        • coderequired — (String)

          The error code.

          Possible values include:
          • "INTERNAL_FAILURE"
        • messagerequired — (String)

          The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchDisassociateProjectAssets(params = {}, callback) ⇒ AWS.Request

Disassociates a group (batch) of assets from an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the batchDisassociateProjectAssets operation

var params = {
  assetIds: [ /* required */
    'STRING_VALUE',
    /* more items */
  ],
  projectId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.batchDisassociateProjectAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project from which to disassociate the assets.

    • assetIds — (Array<String>)

      The IDs of the assets to be disassociated from the project.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errors — (Array<map>)

        A list of associated error information, if any.

        • assetIdrequired — (String)

          The ID of the asset, in UUID format.

        • coderequired — (String)

          The error code.

          Possible values include:
          • "INTERNAL_FAILURE"
        • messagerequired — (String)

          The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchGetAssetPropertyAggregates(params = {}, callback) ⇒ AWS.Request

Gets aggregated values (for example, average, minimum, and maximum) for one or more asset properties. For more information, see Querying aggregates in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the batchGetAssetPropertyAggregates operation

var params = {
  entries: [ /* required */
    {
      aggregateTypes: [ /* required */
        AVERAGE | COUNT | MAXIMUM | MINIMUM | SUM | STANDARD_DEVIATION,
        /* more items */
      ],
      endDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
      entryId: 'STRING_VALUE', /* required */
      resolution: 'STRING_VALUE', /* required */
      startDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
      assetId: 'STRING_VALUE',
      propertyAlias: 'STRING_VALUE',
      propertyId: 'STRING_VALUE',
      qualities: [
        GOOD | BAD | UNCERTAIN,
        /* more items */
      ],
      timeOrdering: ASCENDING | DESCENDING
    },
    /* more items */
  ],
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.batchGetAssetPropertyAggregates(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • entries — (Array<map>)

      The list of asset property aggregate entries for the batch get request. You can specify up to 16 entries per request.

      • entryIdrequired — (String)

        The ID of the entry.

      • assetId — (String)

        The ID of the asset in which the asset property was created.

      • propertyId — (String)

        The ID of the asset property, in UUID format.

      • propertyAlias — (String)

        The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

      • aggregateTypesrequired — (Array<String>)

        The data aggregating function.

      • resolutionrequired — (String)

        The time interval over which to aggregate data.

      • startDaterequired — (Date)

        The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

      • endDaterequired — (Date)

        The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

      • qualities — (Array<String>)

        The quality by which to filter asset data.

      • timeOrdering — (String)

        The chronological sorting order of the requested information.

        Default: ASCENDING

        Possible values include:
        • "ASCENDING"
        • "DESCENDING"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

      • The size of the result set is equal to 1 MB.

      • The number of data points in the result set is equal to the value of maxResults. The maximum value of maxResults is 4000.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errorEntries — (Array<map>)

        A list of the errors (if any) associated with the batch request. Each error entry contains the entryId of the entry that failed.

        • errorCoderequired — (String)

          The error code.

          Possible values include:
          • "ResourceNotFoundException"
          • "InvalidRequestException"
          • "AccessDeniedException"
        • errorMessagerequired — (String)

          The associated error message.

        • entryIdrequired — (String)

          The ID of the entry.

      • successEntries — (Array<map>)

        A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

        • entryIdrequired — (String)

          The ID of the entry.

        • aggregatedValuesrequired — (Array<map>)

          The requested aggregated asset property values (for example, average, minimum, and maximum).

          • timestamprequired — (Date)

            The date the aggregating computations occurred, in Unix epoch time.

          • quality — (String)

            The quality of the aggregated data.

            Possible values include:
            • "GOOD"
            • "BAD"
            • "UNCERTAIN"
          • valuerequired — (map)

            The value of the aggregates.

            • average — (Float)

              The average (mean) value of the time series over a time interval window.

            • count — (Float)

              The count of data points in the time series over a time interval window.

            • maximum — (Float)

              The maximum value of the time series over a time interval window.

            • minimum — (Float)

              The minimum value of the time series over a time interval window.

            • sum — (Float)

              The sum of the time series over a time interval window.

            • standardDeviation — (Float)

              The standard deviation of the time series over a time interval window.

      • skippedEntries — (Array<map>)

        A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

        • entryIdrequired — (String)

          The ID of the entry.

        • completionStatusrequired — (String)

          The completion status of each entry that is associated with the BatchGetAssetPropertyAggregates API.

          Possible values include:
          • "SUCCESS"
          • "ERROR"
        • errorInfo — (map)

          The error information, such as the error code and the timestamp.

          • errorCoderequired — (String)

            The error code.

            Possible values include:
            • "ResourceNotFoundException"
            • "InvalidRequestException"
            • "AccessDeniedException"
          • errorTimestamprequired — (Date)

            The date the error occurred, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchGetAssetPropertyValue(params = {}, callback) ⇒ AWS.Request

Gets the current value for one or more asset properties. For more information, see Querying current values in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the batchGetAssetPropertyValue operation

var params = {
  entries: [ /* required */
    {
      entryId: 'STRING_VALUE', /* required */
      assetId: 'STRING_VALUE',
      propertyAlias: 'STRING_VALUE',
      propertyId: 'STRING_VALUE'
    },
    /* more items */
  ],
  nextToken: 'STRING_VALUE'
};
iotsitewise.batchGetAssetPropertyValue(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • entries — (Array<map>)

      The list of asset property value entries for the batch get request. You can specify up to 128 entries per request.

      • entryIdrequired — (String)

        The ID of the entry.

      • assetId — (String)

        The ID of the asset in which the asset property was created.

      • propertyId — (String)

        The ID of the asset property, in UUID format.

      • propertyAlias — (String)

        The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errorEntries — (Array<map>)

        A list of the errors (if any) associated with the batch request. Each error entry contains the entryId of the entry that failed.

        • errorCoderequired — (String)

          The error code.

          Possible values include:
          • "ResourceNotFoundException"
          • "InvalidRequestException"
          • "AccessDeniedException"
        • errorMessagerequired — (String)

          The associated error message.

        • entryIdrequired — (String)

          The ID of the entry.

      • successEntries — (Array<map>)

        A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

        • entryIdrequired — (String)

          The ID of the entry.

        • assetPropertyValue — (map)

          Contains asset property value information.

          • valuerequired — (map)

            The value of the asset property (see Variant).

            • stringValue — (String)

              Asset property data of type string (sequence of characters).

            • integerValue — (Integer)

              Asset property data of type integer (number that's greater than or equal to zero).

            • doubleValue — (Float)

              Asset property data of type double (floating point number).

            • booleanValue — (Boolean)

              Asset property data of type Boolean (true or false).

          • timestamprequired — (map)

            The timestamp of the asset property value.

            • timeInSecondsrequired — (Integer)

              The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

            • offsetInNanos — (Integer)

              The nanosecond offset from timeInSeconds.

          • quality — (String)

            The quality of the asset property value.

            Possible values include:
            • "GOOD"
            • "BAD"
            • "UNCERTAIN"
      • skippedEntries — (Array<map>)

        A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

        • entryIdrequired — (String)

          The ID of the entry.

        • completionStatusrequired — (String)

          The completion status of each entry that is associated with the BatchGetAssetPropertyValue request.

          Possible values include:
          • "SUCCESS"
          • "ERROR"
        • errorInfo — (map)

          The error information, such as the error code and the timestamp.

          • errorCoderequired — (String)

            The error code.

            Possible values include:
            • "ResourceNotFoundException"
            • "InvalidRequestException"
            • "AccessDeniedException"
          • errorTimestamprequired — (Date)

            The date the error occurred, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchGetAssetPropertyValueHistory(params = {}, callback) ⇒ AWS.Request

Gets the historical values for one or more asset properties. For more information, see Querying historical values in the IoT SiteWise User Guide.

Examples:

Calling the batchGetAssetPropertyValueHistory operation

var params = {
  entries: [ /* required */
    {
      entryId: 'STRING_VALUE', /* required */
      assetId: 'STRING_VALUE',
      endDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
      propertyAlias: 'STRING_VALUE',
      propertyId: 'STRING_VALUE',
      qualities: [
        GOOD | BAD | UNCERTAIN,
        /* more items */
      ],
      startDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
      timeOrdering: ASCENDING | DESCENDING
    },
    /* more items */
  ],
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.batchGetAssetPropertyValueHistory(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • entries — (Array<map>)

      The list of asset property historical value entries for the batch get request. You can specify up to 16 entries per request.

      • entryIdrequired — (String)

        The ID of the entry.

      • assetId — (String)

        The ID of the asset in which the asset property was created.

      • propertyId — (String)

        The ID of the asset property, in UUID format.

      • propertyAlias — (String)

        The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

      • startDate — (Date)

        The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

      • endDate — (Date)

        The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

      • qualities — (Array<String>)

        The quality by which to filter asset data.

      • timeOrdering — (String)

        The chronological sorting order of the requested information.

        Default: ASCENDING

        Possible values include:
        • "ASCENDING"
        • "DESCENDING"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

      • The size of the result set is equal to 4 MB.

      • The number of data points in the result set is equal to the value of maxResults. The maximum value of maxResults is 20000.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errorEntries — (Array<map>)

        A list of the errors (if any) associated with the batch request. Each error entry contains the entryId of the entry that failed.

        • errorCoderequired — (String)

          The error code.

          Possible values include:
          • "ResourceNotFoundException"
          • "InvalidRequestException"
          • "AccessDeniedException"
        • errorMessagerequired — (String)

          The associated error message.

        • entryIdrequired — (String)

          The ID of the entry.

      • successEntries — (Array<map>)

        A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

        • entryIdrequired — (String)

          The ID of the entry.

        • assetPropertyValueHistoryrequired — (Array<map>)

          The requested historical values for the specified asset property.

          • valuerequired — (map)

            The value of the asset property (see Variant).

            • stringValue — (String)

              Asset property data of type string (sequence of characters).

            • integerValue — (Integer)

              Asset property data of type integer (number that's greater than or equal to zero).

            • doubleValue — (Float)

              Asset property data of type double (floating point number).

            • booleanValue — (Boolean)

              Asset property data of type Boolean (true or false).

          • timestamprequired — (map)

            The timestamp of the asset property value.

            • timeInSecondsrequired — (Integer)

              The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

            • offsetInNanos — (Integer)

              The nanosecond offset from timeInSeconds.

          • quality — (String)

            The quality of the asset property value.

            Possible values include:
            • "GOOD"
            • "BAD"
            • "UNCERTAIN"
      • skippedEntries — (Array<map>)

        A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

        • entryIdrequired — (String)

          The ID of the entry.

        • completionStatusrequired — (String)

          The completion status of each entry that is associated with the BatchGetAssetPropertyValueHistory API.

          Possible values include:
          • "SUCCESS"
          • "ERROR"
        • errorInfo — (map)

          The error information, such as the error code and the timestamp.

          • errorCoderequired — (String)

            The error code.

            Possible values include:
            • "ResourceNotFoundException"
            • "InvalidRequestException"
            • "AccessDeniedException"
          • errorTimestamprequired — (Date)

            The date the error occurred, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

batchPutAssetPropertyValue(params = {}, callback) ⇒ AWS.Request

Sends a list of asset property values to IoT SiteWise. Each value is a timestamp-quality-value (TQV) data point. For more information, see Ingesting data using the API in the IoT SiteWise User Guide.

To identify an asset property, you must specify one of the following:

  • The assetId and propertyId of an asset property.

  • A propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

With respect to Unix epoch time, IoT SiteWise accepts only TQVs that have a timestamp of no more than 7 days in the past and no more than 10 minutes in the future. IoT SiteWise rejects timestamps outside of the inclusive range of [-7 days, +10 minutes] and returns a TimestampOutOfRangeException error.

For each asset property, IoT SiteWise overwrites TQVs with duplicate timestamps unless the newer TQV has a different quality. For example, if you store a TQV {T1, GOOD, V1}, then storing {T1, GOOD, V2} replaces the existing TQV.

IoT SiteWise authorizes access to each BatchPutAssetPropertyValue entry individually. For more information, see BatchPutAssetPropertyValue authorization in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the batchPutAssetPropertyValue operation

var params = {
  entries: [ /* required */
    {
      entryId: 'STRING_VALUE', /* required */
      propertyValues: [ /* required */
        {
          timestamp: { /* required */
            timeInSeconds: 'NUMBER_VALUE', /* required */
            offsetInNanos: 'NUMBER_VALUE'
          },
          value: { /* required */
            booleanValue: true || false,
            doubleValue: 'NUMBER_VALUE',
            integerValue: 'NUMBER_VALUE',
            stringValue: 'STRING_VALUE'
          },
          quality: GOOD | BAD | UNCERTAIN
        },
        /* more items */
      ],
      assetId: 'STRING_VALUE',
      propertyAlias: 'STRING_VALUE',
      propertyId: 'STRING_VALUE'
    },
    /* more items */
  ]
};
iotsitewise.batchPutAssetPropertyValue(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • entries — (Array<map>)

      The list of asset property value entries for the batch put request. You can specify up to 10 entries per request.

      • entryIdrequired — (String)

        The user specified ID for the entry. You can use this ID to identify which entries failed.

      • assetId — (String)

        The ID of the asset to update.

      • propertyId — (String)

        The ID of the asset property for this entry.

      • propertyAlias — (String)

        The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

      • propertyValuesrequired — (Array<map>)

        The list of property values to upload. You can specify up to 10 propertyValues array elements.

        • valuerequired — (map)

          The value of the asset property (see Variant).

          • stringValue — (String)

            Asset property data of type string (sequence of characters).

          • integerValue — (Integer)

            Asset property data of type integer (number that's greater than or equal to zero).

          • doubleValue — (Float)

            Asset property data of type double (floating point number).

          • booleanValue — (Boolean)

            Asset property data of type Boolean (true or false).

        • timestamprequired — (map)

          The timestamp of the asset property value.

          • timeInSecondsrequired — (Integer)

            The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

          • offsetInNanos — (Integer)

            The nanosecond offset from timeInSeconds.

        • quality — (String)

          The quality of the asset property value.

          Possible values include:
          • "GOOD"
          • "BAD"
          • "UNCERTAIN"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • errorEntries — (Array<map>)

        A list of the errors (if any) associated with the batch put request. Each error entry contains the entryId of the entry that failed.

        • entryIdrequired — (String)

          The ID of the failed entry.

        • errorsrequired — (Array<map>)

          The list of update property value errors.

          • errorCoderequired — (String)

            The error code.

            Possible values include:
            • "ResourceNotFoundException"
            • "InvalidRequestException"
            • "InternalFailureException"
            • "ServiceUnavailableException"
            • "ThrottlingException"
            • "LimitExceededException"
            • "ConflictingOperationException"
            • "TimestampOutOfRangeException"
            • "AccessDeniedException"
          • errorMessagerequired — (String)

            The associated error message.

          • timestampsrequired — (Array<map>)

            A list of timestamps for each error, if any.

            • timeInSecondsrequired — (Integer)

              The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

            • offsetInNanos — (Integer)

              The nanosecond offset from timeInSeconds.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createAccessPolicy(params = {}, callback) ⇒ AWS.Request

Creates an access policy that grants the specified identity (IAM Identity Center user, IAM Identity Center group, or IAM user) access to the specified IoT SiteWise Monitor portal or project resource.

Service Reference:

Examples:

Calling the createAccessPolicy operation

var params = {
  accessPolicyIdentity: { /* required */
    group: {
      id: 'STRING_VALUE' /* required */
    },
    iamRole: {
      arn: 'STRING_VALUE' /* required */
    },
    iamUser: {
      arn: 'STRING_VALUE' /* required */
    },
    user: {
      id: 'STRING_VALUE' /* required */
    }
  },
  accessPolicyPermission: ADMINISTRATOR | VIEWER, /* required */
  accessPolicyResource: { /* required */
    portal: {
      id: 'STRING_VALUE' /* required */
    },
    project: {
      id: 'STRING_VALUE' /* required */
    }
  },
  clientToken: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createAccessPolicy(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • accessPolicyIdentity — (map)

      The identity for this access policy. Choose an IAM Identity Center user, an IAM Identity Center group, or an IAM user.

      • user — (map)

        An IAM Identity Center user identity.

        • idrequired — (String)

          The IAM Identity Center ID of the user.

      • group — (map)

        An IAM Identity Center group identity.

        • idrequired — (String)

          The IAM Identity Center ID of the group.

      • iamUser — (map)

        An IAM user identity.

        • arnrequired — (String)

          The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide.

          Note: If you delete the IAM user, access policies that contain this identity include an empty arn. You can delete the access policy for the IAM user that no longer exists.
      • iamRole — (map)

        An IAM role identity.

        • arnrequired — (String)

          The ARN of the IAM role. For more information, see IAM ARNs in the IAM User Guide.

    • accessPolicyResource — (map)

      The IoT SiteWise Monitor resource for this access policy. Choose either a portal or a project.

      • portal — (map)

        A portal resource.

        • idrequired — (String)

          The ID of the portal.

      • project — (map)

        A project resource.

        • idrequired — (String)

          The ID of the project.

    • accessPolicyPermission — (String)

      The permission level for this access policy. Note that a project ADMINISTRATOR is also known as a project owner.

      Possible values include:
      • "ADMINISTRATOR"
      • "VIEWER"
    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the access policy. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • accessPolicyId — (String)

        The ID of the access policy.

      • accessPolicyArn — (String)

        The ARN of the access policy, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createAsset(params = {}, callback) ⇒ AWS.Request

Creates an asset from an existing asset model. For more information, see Creating assets in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the createAsset operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  assetName: 'STRING_VALUE', /* required */
  assetDescription: 'STRING_VALUE',
  assetExternalId: 'STRING_VALUE',
  assetId: 'STRING_VALUE',
  clientToken: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createAsset(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetName — (String)

      A friendly name for the asset.

    • assetModelId — (String)

      The ID of the asset model from which to create the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the asset. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

    • assetDescription — (String)

      A description for the asset.

    • assetId — (String)

      The ID to assign to the asset, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

    • assetExternalId — (String)

      An external ID to assign to the asset. The external ID must be unique within your Amazon Web Services account. For more information, see Using external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format. This ID uniquely identifies the asset within IoT SiteWise and can be used with other IoT SiteWise API operations.

      • assetArn — (String)

        The ARN of the asset, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

      • assetStatus — (map)

        The status of the asset, which contains a state (CREATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createAssetModel(params = {}, callback) ⇒ AWS.Request

Creates an asset model from specified property and hierarchy definitions. You create assets from asset models. With asset models, you can easily create assets of the same type that have standardized definitions. Each asset created from a model inherits the asset model's property and hierarchy definitions. For more information, see Defining asset models in the IoT SiteWise User Guide.

You can create two types of asset models, ASSET_MODEL or COMPONENT_MODEL.

  • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

  • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

Service Reference:

Examples:

Calling the createAssetModel operation

var params = {
  assetModelName: 'STRING_VALUE', /* required */
  assetModelCompositeModels: [
    {
      name: 'STRING_VALUE', /* required */
      type: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      properties: [
        {
          dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
          name: 'STRING_VALUE', /* required */
          type: { /* required */
            attribute: {
              defaultValue: 'STRING_VALUE'
            },
            measurement: {
              processingConfig: {
                forwardingConfig: { /* required */
                  state: DISABLED | ENABLED /* required */
                }
              }
            },
            metric: {
              expression: 'STRING_VALUE', /* required */
              variables: [ /* required */
                {
                  name: 'STRING_VALUE', /* required */
                  value: { /* required */
                    hierarchyId: 'STRING_VALUE',
                    propertyId: 'STRING_VALUE',
                    propertyPath: [
                      {
                        id: 'STRING_VALUE',
                        name: 'STRING_VALUE'
                      },
                      /* more items */
                    ]
                  }
                },
                /* more items */
              ],
              window: { /* required */
                tumbling: {
                  interval: 'STRING_VALUE', /* required */
                  offset: 'STRING_VALUE'
                }
              },
              processingConfig: {
                computeLocation: EDGE | CLOUD /* required */
              }
            },
            transform: {
              expression: 'STRING_VALUE', /* required */
              variables: [ /* required */
                {
                  name: 'STRING_VALUE', /* required */
                  value: { /* required */
                    hierarchyId: 'STRING_VALUE',
                    propertyId: 'STRING_VALUE',
                    propertyPath: [
                      {
                        id: 'STRING_VALUE',
                        name: 'STRING_VALUE'
                      },
                      /* more items */
                    ]
                  }
                },
                /* more items */
              ],
              processingConfig: {
                computeLocation: EDGE | CLOUD, /* required */
                forwardingConfig: {
                  state: DISABLED | ENABLED /* required */
                }
              }
            }
          },
          dataTypeSpec: 'STRING_VALUE',
          externalId: 'STRING_VALUE',
          id: 'STRING_VALUE',
          unit: 'STRING_VALUE'
        },
        /* more items */
      ]
    },
    /* more items */
  ],
  assetModelDescription: 'STRING_VALUE',
  assetModelExternalId: 'STRING_VALUE',
  assetModelHierarchies: [
    {
      childAssetModelId: 'STRING_VALUE', /* required */
      name: 'STRING_VALUE', /* required */
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE'
    },
    /* more items */
  ],
  assetModelId: 'STRING_VALUE',
  assetModelProperties: [
    {
      dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        attribute: {
          defaultValue: 'STRING_VALUE'
        },
        measurement: {
          processingConfig: {
            forwardingConfig: { /* required */
              state: DISABLED | ENABLED /* required */
            }
          }
        },
        metric: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          window: { /* required */
            tumbling: {
              interval: 'STRING_VALUE', /* required */
              offset: 'STRING_VALUE'
            }
          },
          processingConfig: {
            computeLocation: EDGE | CLOUD /* required */
          }
        },
        transform: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          processingConfig: {
            computeLocation: EDGE | CLOUD, /* required */
            forwardingConfig: {
              state: DISABLED | ENABLED /* required */
            }
          }
        }
      },
      dataTypeSpec: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      unit: 'STRING_VALUE'
    },
    /* more items */
  ],
  assetModelType: ASSET_MODEL | COMPONENT_MODEL,
  clientToken: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createAssetModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelName — (String)

      A unique, friendly name for the asset model.

    • assetModelDescription — (String)

      A description for the asset model.

    • assetModelProperties — (Array<map>)

      The property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

      You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the property definition.

      • dataTyperequired — (String)

        The data type of the property definition.

        If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this property.

        Possible values include:
        • "STRING"
        • "INTEGER"
        • "DOUBLE"
        • "BOOLEAN"
        • "STRUCT"
      • dataTypeSpec — (String)

        The data type of the structure for this property. This parameter is required on properties that have the STRUCT data type.

        The options for this parameter depend on the type of the composite model in which you define this property. Use AWS/ALARM_STATE for alarm state in alarm composite models.

      • unit — (String)

        The unit of the property definition, such as Newtons or RPM.

      • typerequired — (map)

        The property definition type (see PropertyType). You can only specify one type in a property definition.

        • attribute — (map)

          Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

          • defaultValue — (String)

            The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

        • measurement — (map)

          Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

          • processingConfig — (map)

            The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

            • forwardingConfigrequired — (map)

              The forwarding configuration for the given measurement property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • transform — (map)

          Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

          • expressionrequired — (String)

            The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • processingConfig — (map)

            The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

            • computeLocationrequired — (String)

              The compute location for the given transform property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
            • forwardingConfig — (map)

              The forwarding configuration for a given property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • metric — (map)

          Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

          • expressionrequired — (String)

            The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • windowrequired — (map)

            The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

            • tumbling — (map)

              The tumbling time interval window.

              • intervalrequired — (String)

                The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

              • offset — (String)

                The offset for the tumbling window. The offset parameter accepts the following:

                • The offset time.

                  For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The ISO 8601 format.

                  For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The 24-hour clock.

                  For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                • The offset time zone.

                  For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                  • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

          • processingConfig — (map)

            The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

            • computeLocationrequired — (String)

              The compute location for the given metric property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
      • id — (String)

        The ID to assign to the asset model property, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

      • externalId — (String)

        An external ID to assign to the property definition. The external ID must be unique among property definitions within this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • assetModelHierarchies — (Array<map>)

      The hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

      You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the asset model hierarchy definition (as specified in the CreateAssetModel or UpdateAssetModel API operation).

      • childAssetModelIdrequired — (String)

        The ID of an asset model for this hierarchy. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

      • id — (String)

        The ID to assign to the asset model hierarchy, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

      • externalId — (String)

        An external ID to assign to the asset model hierarchy. The external ID must be unique among asset model hierarchies within this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • assetModelCompositeModels — (Array<map>)

      The composite models that are part of this asset model. It groups properties (such as attributes, measurements, transforms, and metrics) and child composite models that model parts of your industrial equipment. Each composite model has a type that defines the properties that the composite model supports. Use composite models to define alarms on this asset model.

      Note: When creating custom composite models, you need to use CreateAssetModelCompositeModel. For more information, see <LINK>.
      • namerequired — (String)

        The name of the composite model.

      • description — (String)

        The description of the composite model.

      • typerequired — (String)

        The type of the composite model. For alarm composite models, this type is AWS/ALARM.

      • properties — (Array<map>)

        The asset property definitions for this composite model.

        • namerequired — (String)

          The name of the property definition.

        • dataTyperequired — (String)

          The data type of the property definition.

          If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter is required on properties that have the STRUCT data type.

          The options for this parameter depend on the type of the composite model in which you define this property. Use AWS/ALARM_STATE for alarm state in alarm composite models.

        • unit — (String)

          The unit of the property definition, such as Newtons or RPM.

        • typerequired — (map)

          The property definition type (see PropertyType). You can only specify one type in a property definition.

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • id — (String)

          The ID to assign to the asset model property, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

        • externalId — (String)

          An external ID to assign to the property definition. The external ID must be unique among property definitions within this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • id — (String)

        The ID to assign to the composite model, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

      • externalId — (String)

        An external ID to assign to the composite model. The external ID must be unique among composite models within this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the asset model. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

    • assetModelId — (String)

      The ID to assign to the asset model, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

    • assetModelExternalId — (String)

      An external ID to assign to the asset model. The external ID must be unique within your Amazon Web Services account. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • assetModelType — (String)

      The type of asset model.

      • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

      • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

      Possible values include:
      • "ASSET_MODEL"
      • "COMPONENT_MODEL"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelId — (String)

        The ID of the asset model, in UUID format. You can use this ID when you call other IoT SiteWise API operations.

      • assetModelArn — (String)

        The ARN of the asset model, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

      • assetModelStatus — (map)

        The status of the asset model, which contains a state (CREATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createAssetModelCompositeModel(params = {}, callback) ⇒ AWS.Request

Creates a custom composite model from specified property and hierarchy definitions. There are two types of custom composite models, inline and component-model-based.

Use component-model-based custom composite models to define standard, reusable components. A component-model-based custom composite model consists of a name, a description, and the ID of the component model it references. A component-model-based custom composite model has no properties of its own; its referenced component model provides its associated properties to any created assets. For more information, see Custom composite models (Components) in the IoT SiteWise User Guide.

Use inline custom composite models to organize the properties of an asset model. The properties of inline custom composite models are local to the asset model where they are included and can't be used to create multiple assets.

To create a component-model-based model, specify the composedAssetModelId of an existing asset model with assetModelType of COMPONENT_MODEL.

To create an inline model, specify the assetModelCompositeModelProperties and don't include an composedAssetModelId.

Service Reference:

Examples:

Calling the createAssetModelCompositeModel operation

var params = {
  assetModelCompositeModelName: 'STRING_VALUE', /* required */
  assetModelCompositeModelType: 'STRING_VALUE', /* required */
  assetModelId: 'STRING_VALUE', /* required */
  assetModelCompositeModelDescription: 'STRING_VALUE',
  assetModelCompositeModelExternalId: 'STRING_VALUE',
  assetModelCompositeModelId: 'STRING_VALUE',
  assetModelCompositeModelProperties: [
    {
      dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        attribute: {
          defaultValue: 'STRING_VALUE'
        },
        measurement: {
          processingConfig: {
            forwardingConfig: { /* required */
              state: DISABLED | ENABLED /* required */
            }
          }
        },
        metric: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          window: { /* required */
            tumbling: {
              interval: 'STRING_VALUE', /* required */
              offset: 'STRING_VALUE'
            }
          },
          processingConfig: {
            computeLocation: EDGE | CLOUD /* required */
          }
        },
        transform: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          processingConfig: {
            computeLocation: EDGE | CLOUD, /* required */
            forwardingConfig: {
              state: DISABLED | ENABLED /* required */
            }
          }
        }
      },
      dataTypeSpec: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      unit: 'STRING_VALUE'
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE',
  composedAssetModelId: 'STRING_VALUE',
  parentAssetModelCompositeModelId: 'STRING_VALUE'
};
iotsitewise.createAssetModelCompositeModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model this composite model is a part of.

    • parentAssetModelCompositeModelId — (String)

      The ID of the parent composite model in this asset model relationship.

    • assetModelCompositeModelExternalId — (String)

      An external ID to assign to the composite model.

      If the composite model is a derived composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

    • assetModelCompositeModelId — (String)

      The ID of the composite model. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

    • assetModelCompositeModelDescription — (String)

      A description for the composite model.

    • assetModelCompositeModelName — (String)

      A unique, friendly name for the composite model.

    • assetModelCompositeModelType — (String)

      The composite model type. Valid values are AWS/ALARM, CUSTOM, or AWS/L4E_ANOMALY.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • composedAssetModelId — (String)

      The ID of a composite model on this asset.

    • assetModelCompositeModelProperties — (Array<map>)

      The property definitions of the composite model. For more information, see <LINK>.

      You can specify up to 200 properties per composite model. For more information, see Quotas in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the property definition.

      • dataTyperequired — (String)

        The data type of the property definition.

        If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this property.

        Possible values include:
        • "STRING"
        • "INTEGER"
        • "DOUBLE"
        • "BOOLEAN"
        • "STRUCT"
      • dataTypeSpec — (String)

        The data type of the structure for this property. This parameter is required on properties that have the STRUCT data type.

        The options for this parameter depend on the type of the composite model in which you define this property. Use AWS/ALARM_STATE for alarm state in alarm composite models.

      • unit — (String)

        The unit of the property definition, such as Newtons or RPM.

      • typerequired — (map)

        The property definition type (see PropertyType). You can only specify one type in a property definition.

        • attribute — (map)

          Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

          • defaultValue — (String)

            The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

        • measurement — (map)

          Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

          • processingConfig — (map)

            The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

            • forwardingConfigrequired — (map)

              The forwarding configuration for the given measurement property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • transform — (map)

          Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

          • expressionrequired — (String)

            The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • processingConfig — (map)

            The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

            • computeLocationrequired — (String)

              The compute location for the given transform property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
            • forwardingConfig — (map)

              The forwarding configuration for a given property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • metric — (map)

          Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

          • expressionrequired — (String)

            The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • windowrequired — (map)

            The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

            • tumbling — (map)

              The tumbling time interval window.

              • intervalrequired — (String)

                The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

              • offset — (String)

                The offset for the tumbling window. The offset parameter accepts the following:

                • The offset time.

                  For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The ISO 8601 format.

                  For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The 24-hour clock.

                  For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                • The offset time zone.

                  For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                  • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

          • processingConfig — (map)

            The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

            • computeLocationrequired — (String)

              The compute location for the given metric property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
      • id — (String)

        The ID to assign to the asset model property, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

      • externalId — (String)

        An external ID to assign to the property definition. The external ID must be unique among property definitions within this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelCompositeModelId — (String)

        The ID of the composed asset model. You can use this ID when you call other IoT SiteWise APIs.

      • assetModelCompositeModelPath — (Array<map>)

        The path to the composite model listing the parent composite models.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • assetModelStatus — (map)

        Contains current status information for an asset model. For more information, see Asset and model states in the IoT SiteWise User Guide.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createBulkImportJob(params = {}, callback) ⇒ AWS.Request

Defines a job to ingest data to IoT SiteWise from Amazon S3. For more information, see Create a bulk import job (CLI) in the Amazon Simple Storage Service User Guide.

Before you create a bulk import job, you must enable IoT SiteWise warm tier or IoT SiteWise cold tier. For more information about how to configure storage settings, see PutStorageConfiguration.

Bulk import is designed to store historical data to IoT SiteWise. It does not trigger computations or notifications on IoT SiteWise warm or cold tier storage.

Service Reference:

Examples:

Calling the createBulkImportJob operation

var params = {
  errorReportLocation: { /* required */
    bucket: 'STRING_VALUE', /* required */
    prefix: 'STRING_VALUE' /* required */
  },
  files: [ /* required */
    {
      bucket: 'STRING_VALUE', /* required */
      key: 'STRING_VALUE', /* required */
      versionId: 'STRING_VALUE'
    },
    /* more items */
  ],
  jobConfiguration: { /* required */
    fileFormat: { /* required */
      csv: {
        columnNames: [ /* required */
          ALIAS | ASSET_ID | PROPERTY_ID | DATA_TYPE | TIMESTAMP_SECONDS | TIMESTAMP_NANO_OFFSET | QUALITY | VALUE,
          /* more items */
        ]
      },
      parquet: {
      }
    }
  },
  jobName: 'STRING_VALUE', /* required */
  jobRoleArn: 'STRING_VALUE', /* required */
  adaptiveIngestion: true || false,
  deleteFilesAfterImport: true || false
};
iotsitewise.createBulkImportJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • jobName — (String)

      The unique name that helps identify the job request.

    • jobRoleArn — (String)

      The ARN of the IAM role that allows IoT SiteWise to read Amazon S3 data.

    • files — (Array<map>)

      The files in the specified Amazon S3 bucket that contain your data.

      • bucketrequired — (String)

        The name of the Amazon S3 bucket from which data is imported.

      • keyrequired — (String)

        The key of the Amazon S3 object that contains your data. Each object has a key that is a unique identifier. Each object has exactly one key.

      • versionId — (String)

        The version ID to identify a specific version of the Amazon S3 object that contains your data.

    • errorReportLocation — (map)

      The Amazon S3 destination where errors associated with the job creation request are saved.

      • bucketrequired — (String)

        The name of the Amazon S3 bucket to which errors associated with the bulk import job are sent.

      • prefixrequired — (String)

        Amazon S3 uses the prefix as a folder name to organize data in the bucket. Each Amazon S3 object has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/). For more information, see Organizing objects using prefixes in the Amazon Simple Storage Service User Guide.

    • jobConfiguration — (map)

      Contains the configuration information of a job, such as the file format used to save data in Amazon S3.

      • fileFormatrequired — (map)

        The file format of the data in S3.

        • csv — (map)

          The file is in .CSV format.

          • columnNamesrequired — (Array<String>)

            The column names specified in the .csv file.

        • parquet — (map)

          The file is in parquet format.

    • adaptiveIngestion — (Boolean)

      If set to true, ingest new data into IoT SiteWise storage. Measurements with notifications, metrics and transforms are computed. If set to false, historical data is ingested into IoT SiteWise as is.

    • deleteFilesAfterImport — (Boolean)

      If set to true, your data files is deleted from S3, after ingestion into IoT SiteWise storage.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • jobId — (String)

        The ID of the job.

      • jobName — (String)

        The unique name that helps identify the job request.

      • jobStatus — (String)

        The status of the bulk import job can be one of following values:

        • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.

        • CANCELLED – The bulk import job has been canceled.

        • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.

        • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.

        • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

        • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

        Possible values include:
        • "PENDING"
        • "CANCELLED"
        • "RUNNING"
        • "COMPLETED"
        • "FAILED"
        • "COMPLETED_WITH_FAILURES"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createDashboard(params = {}, callback) ⇒ AWS.Request

Creates a dashboard in an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the createDashboard operation

var params = {
  dashboardDefinition: 'STRING_VALUE', /* required */
  dashboardName: 'STRING_VALUE', /* required */
  projectId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  dashboardDescription: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createDashboard(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project in which to create the dashboard.

    • dashboardName — (String)

      A friendly name for the dashboard.

    • dashboardDescription — (String)

      A description for the dashboard.

    • dashboardDefinition — (String)

      The dashboard definition specified in a JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the dashboard. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • dashboardId — (String)

        The ID of the dashboard.

      • dashboardArn — (String)

        The ARN of the dashboard, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createGateway(params = {}, callback) ⇒ AWS.Request

Creates a gateway, which is a virtual or edge device that delivers industrial data streams from local servers to IoT SiteWise. For more information, see Ingesting data using a gateway in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the createGateway operation

var params = {
  gatewayName: 'STRING_VALUE', /* required */
  gatewayPlatform: { /* required */
    greengrass: {
      groupArn: 'STRING_VALUE' /* required */
    },
    greengrassV2: {
      coreDeviceThingName: 'STRING_VALUE' /* required */
    }
  },
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createGateway(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayName — (String)

      A unique, friendly name for the gateway.

    • gatewayPlatform — (map)

      The gateway's platform. You can only specify one platform in a gateway.

      • greengrass — (map)

        A gateway that runs on IoT Greengrass.

        • groupArnrequired — (String)

          The ARN of the Greengrass group. For more information about how to find a group's ARN, see ListGroups and GetGroup in the IoT Greengrass API Reference.

      • greengrassV2 — (map)

        A gateway that runs on IoT Greengrass V2.

        • coreDeviceThingNamerequired — (String)

          The name of the IoT thing for your IoT Greengrass V2 core device.

    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the gateway. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • gatewayId — (String)

        The ID of the gateway device. You can use this ID when you call other IoT SiteWise API operations.

      • gatewayArn — (String)

        The ARN of the gateway, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createPortal(params = {}, callback) ⇒ AWS.Request

Creates a portal, which can contain projects and dashboards. IoT SiteWise Monitor uses IAM Identity Center or IAM to authenticate portal users and manage user permissions.

Note: Before you can sign in to a new portal, you must add at least one identity to that portal. For more information, see Adding or removing portal administrators in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the createPortal operation

var params = {
  portalContactEmail: 'STRING_VALUE', /* required */
  portalName: 'STRING_VALUE', /* required */
  roleArn: 'STRING_VALUE', /* required */
  alarms: {
    alarmRoleArn: 'STRING_VALUE', /* required */
    notificationLambdaArn: 'STRING_VALUE'
  },
  clientToken: 'STRING_VALUE',
  notificationSenderEmail: 'STRING_VALUE',
  portalAuthMode: IAM | SSO,
  portalDescription: 'STRING_VALUE',
  portalLogoImageFile: {
    data: Buffer.from('...') || 'STRING_VALUE' /* Strings will be Base-64 encoded on your behalf */, /* required */
    type: PNG /* required */
  },
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createPortal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalName — (String)

      A friendly name for the portal.

    • portalDescription — (String)

      A description for the portal.

    • portalContactEmail — (String)

      The Amazon Web Services administrator's contact email address.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • portalLogoImageFile — (map)

      A logo image to display in the portal. Upload a square, high-resolution image. The image is displayed on a dark background.

      • datarequired — (Buffer, Typed Array, Blob, String)

        The image file contents, represented as a base64-encoded string. The file size must be less than 1 MB.

      • typerequired — (String)

        The file type of the image.

        Possible values include:
        • "PNG"
    • roleArn — (String)

      The ARN of a service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the portal. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

    • portalAuthMode — (String)

      The service to use to authenticate users to the portal. Choose from the following options:

      • SSO – The portal uses IAM Identity Center to authenticate users and manage user permissions. Before you can create a portal that uses IAM Identity Center, you must enable IAM Identity Center. For more information, see Enabling IAM Identity Center in the IoT SiteWise User Guide. This option is only available in Amazon Web Services Regions other than the China Regions.

      • IAM – The portal uses Identity and Access Management to authenticate users and manage user permissions.

      You can't change this value after you create a portal.

      Default: SSO

      Possible values include:
      • "IAM"
      • "SSO"
    • notificationSenderEmail — (String)

      The email address that sends alarm notifications.

      If you use the IoT Events managed Lambda function to manage your emails, you must verify the sender email address in Amazon SES.

    • alarms — (map)

      Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal. You can use the alarm to monitor an asset property and get notified when the asset property value is outside a specified range. For more information, see Monitoring with alarms in the IoT SiteWise Application Guide.

      • alarmRoleArnrequired — (String)

        The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

      • notificationLambdaArn — (String)

        The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalId — (String)

        The ID of the created portal.

      • portalArn — (String)

        The ARN of the portal, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

      • portalStartUrl — (String)

        The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use IAM Identity Center for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

      • portalStatus — (map)

        The status of the portal, which contains a state (CREATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

      • ssoApplicationId — (String)

        The associated IAM Identity Center application ID, if the portal uses IAM Identity Center.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createProject(params = {}, callback) ⇒ AWS.Request

Creates a project in the specified portal.

Note: Make sure that the project name and description don't contain confidential information.

Service Reference:

Examples:

Calling the createProject operation

var params = {
  portalId: 'STRING_VALUE', /* required */
  projectName: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  projectDescription: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.createProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalId — (String)

      The ID of the portal in which to create the project.

    • projectName — (String)

      A friendly name for the project.

    • projectDescription — (String)

      A description for the project.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the project. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • projectId — (String)

        The ID of the project.

      • projectArn — (String)

        The ARN of the project, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteAccessPolicy(params = {}, callback) ⇒ AWS.Request

Deletes an access policy that grants the specified identity access to the specified IoT SiteWise Monitor resource. You can use this operation to revoke access to an IoT SiteWise Monitor resource.

Service Reference:

Examples:

Calling the deleteAccessPolicy operation

var params = {
  accessPolicyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteAccessPolicy(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • accessPolicyId — (String)

      The ID of the access policy to be deleted.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteAsset(params = {}, callback) ⇒ AWS.Request

Deletes an asset. This action can't be undone. For more information, see Deleting assets and models in the IoT SiteWise User Guide.

Note: You can't delete an asset that's associated to another asset. For more information, see DisassociateAssets.

Service Reference:

Examples:

Calling the deleteAsset operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteAsset(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset to delete. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetStatus — (map)

        The status of the asset, which contains a state (DELETING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteAssetModel(params = {}, callback) ⇒ AWS.Request

Deletes an asset model. This action can't be undone. You must delete all assets created from an asset model before you can delete the model. Also, you can't delete an asset model if a parent asset model exists that contains a property formula expression that depends on the asset model that you want to delete. For more information, see Deleting assets and models in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the deleteAssetModel operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteAssetModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model to delete. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelStatus — (map)

        The status of the asset model, which contains a state (DELETING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteAssetModelCompositeModel(params = {}, callback) ⇒ AWS.Request

Deletes a composite model. This action can't be undone. You must delete all assets created from a composite model before you can delete the model. Also, you can't delete a composite model if a parent asset model exists that contains a property formula expression that depends on the asset model that you want to delete. For more information, see Deleting assets and models in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the deleteAssetModelCompositeModel operation

var params = {
  assetModelCompositeModelId: 'STRING_VALUE', /* required */
  assetModelId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteAssetModelCompositeModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model, in UUID format.

    • assetModelCompositeModelId — (String)

      The ID of a composite model on this asset model.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelStatus — (map)

        Contains current status information for an asset model. For more information, see Asset and model states in the IoT SiteWise User Guide.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteDashboard(params = {}, callback) ⇒ AWS.Request

Deletes a dashboard from IoT SiteWise Monitor.

Service Reference:

Examples:

Calling the deleteDashboard operation

var params = {
  dashboardId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteDashboard(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • dashboardId — (String)

      The ID of the dashboard to delete.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteGateway(params = {}, callback) ⇒ AWS.Request

Deletes a gateway from IoT SiteWise. When you delete a gateway, some of the gateway's files remain in your gateway's file system.

Service Reference:

Examples:

Calling the deleteGateway operation

var params = {
  gatewayId: 'STRING_VALUE' /* required */
};
iotsitewise.deleteGateway(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayId — (String)

      The ID of the gateway to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deletePortal(params = {}, callback) ⇒ AWS.Request

Deletes a portal from IoT SiteWise Monitor.

Service Reference:

Examples:

Calling the deletePortal operation

var params = {
  portalId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deletePortal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalId — (String)

      The ID of the portal to delete.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalStatus — (map)

        The status of the portal, which contains a state (DELETING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteProject(params = {}, callback) ⇒ AWS.Request

Deletes a project from IoT SiteWise Monitor.

Service Reference:

Examples:

Calling the deleteProject operation

var params = {
  projectId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.deleteProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTimeSeries(params = {}, callback) ⇒ AWS.Request

Deletes a time series (data stream). If you delete a time series that's associated with an asset property, the asset property still exists, but the time series will no longer be associated with this asset property.

To identify a time series, do one of the following:

  • If the time series isn't associated with an asset property, specify the alias of the time series.

  • If the time series is associated with an asset property, specify one of the following:

    • The alias of the time series.

    • The assetId and propertyId that identifies the asset property.

Service Reference:

Examples:

Calling the deleteTimeSeries operation

var params = {
  alias: 'STRING_VALUE',
  assetId: 'STRING_VALUE',
  clientToken: 'STRING_VALUE',
  propertyId: 'STRING_VALUE'
};
iotsitewise.deleteTimeSeries(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • alias — (String)

      The alias that identifies the time series.

    • assetId — (String)

      The ID of the asset in which the asset property was created. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeAccessPolicy(params = {}, callback) ⇒ AWS.Request

Describes an access policy, which specifies an identity's access to an IoT SiteWise Monitor portal or project.

Service Reference:

Examples:

Calling the describeAccessPolicy operation

var params = {
  accessPolicyId: 'STRING_VALUE' /* required */
};
iotsitewise.describeAccessPolicy(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • accessPolicyId — (String)

      The ID of the access policy.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • accessPolicyId — (String)

        The ID of the access policy.

      • accessPolicyArn — (String)

        The ARN of the access policy, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}

      • accessPolicyIdentity — (map)

        The identity (IAM Identity Center user, IAM Identity Center group, or IAM user) to which this access policy applies.

        • user — (map)

          An IAM Identity Center user identity.

          • idrequired — (String)

            The IAM Identity Center ID of the user.

        • group — (map)

          An IAM Identity Center group identity.

          • idrequired — (String)

            The IAM Identity Center ID of the group.

        • iamUser — (map)

          An IAM user identity.

          • arnrequired — (String)

            The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide.

            Note: If you delete the IAM user, access policies that contain this identity include an empty arn. You can delete the access policy for the IAM user that no longer exists.
        • iamRole — (map)

          An IAM role identity.

          • arnrequired — (String)

            The ARN of the IAM role. For more information, see IAM ARNs in the IAM User Guide.

      • accessPolicyResource — (map)

        The IoT SiteWise Monitor resource (portal or project) to which this access policy provides access.

        • portal — (map)

          A portal resource.

          • idrequired — (String)

            The ID of the portal.

        • project — (map)

          A project resource.

          • idrequired — (String)

            The ID of the project.

      • accessPolicyPermission — (String)

        The access policy permission. Note that a project ADMINISTRATOR is also known as a project owner.

        Possible values include:
        • "ADMINISTRATOR"
        • "VIEWER"
      • accessPolicyCreationDate — (Date)

        The date the access policy was created, in Unix epoch time.

      • accessPolicyLastUpdateDate — (Date)

        The date the access policy was last updated, in Unix epoch time.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeAction(params = {}, callback) ⇒ AWS.Request

Retrieves information about an action.

Service Reference:

Examples:

Calling the describeAction operation

var params = {
  actionId: 'STRING_VALUE' /* required */
};
iotsitewise.describeAction(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • actionId — (String)

      The ID of the action.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • actionId — (String)

        The ID of the action.

      • targetResource — (map)

        The resource the action will be taken on.

        • assetIdrequired — (String)

          The ID of the asset, in UUID format.

      • actionDefinitionId — (String)

        The ID of the action definition.

      • actionPayload — (map)

        The JSON payload of the action.

        • stringValuerequired — (String)

          The payload of the action in a JSON string.

      • executionTime — (Date)

        The time the action was executed.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeAsset(params = {}, callback) ⇒ AWS.Request

Retrieves information about an asset.

Service Reference:

Examples:

Calling the describeAsset operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  excludeProperties: true || false
};
iotsitewise.describeAsset(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format.

      • assetArn — (String)

        The ARN of the asset, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

      • assetName — (String)

        The name of the asset.

      • assetModelId — (String)

        The ID of the asset model that was used to create the asset.

      • assetProperties — (Array<map>)

        The list of asset properties for the asset.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetCompositeModels object.

        • idrequired — (String)

          The ID of the asset property.

        • namerequired — (String)

          The name of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • notification — (map)

          The asset property's notification topic and state. For more information, see UpdateAssetProperty.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • dataTyperequired — (String)

          The data type of the asset property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit (such as Newtons or RPM) of the asset property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetHierarchies — (Array<map>)

        A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

        • id — (String)

          The ID of the hierarchy. This ID is a hierarchyId.

        • namerequired — (String)

          The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

        • externalId — (String)

          The external ID of the hierarchy, if it has one. When you update an asset hierarchy, you may assign an external ID if it doesn't already have one. You can't change the external ID of an asset hierarchy that already has one. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCompositeModels — (Array<map>)

        The composite models for the asset.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • propertiesrequired — (Array<map>)

          The asset properties that this composite model defines.

          • idrequired — (String)

            The ID of the asset property.

          • namerequired — (String)

            The name of the property.

          • alias — (String)

            The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

          • notification — (map)

            The asset property's notification topic and state. For more information, see UpdateAssetProperty.

            • topicrequired — (String)

              The MQTT topic to which IoT SiteWise publishes property value update notifications.

            • staterequired — (String)

              The current notification state.

              Possible values include:
              • "ENABLED"
              • "DISABLED"
          • dataTyperequired — (String)

            The data type of the asset property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit (such as Newtons or RPM) of the asset property.

          • path — (Array<map>)

            The structured path to the property from the root of the asset.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset composite model.

        • externalId — (String)

          The external ID of the asset composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCreationDate — (Date)

        The date the asset was created, in Unix epoch time.

      • assetLastUpdateDate — (Date)

        The date the asset was last updated, in Unix epoch time.

      • assetStatus — (map)

        The current status of the asset, which contains a state and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetDescription — (String)

        A description for the asset.

      • assetCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset.

        • idrequired — (String)

          The ID of the composite model that this summary describes.

        • externalId — (String)

          An external ID to assign to the asset model.

          If the composite model is a derived composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

        • namerequired — (String)

          The name of the composite model that this summary describes.

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • descriptionrequired — (String)

          A description of the composite model that this summary describes.

        • pathrequired — (Array<map>)

          The path that includes all the components of the asset model for the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetExternalId — (String)

        The external ID of the asset, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

Waiter Resource States:

describeAssetCompositeModel(params = {}, callback) ⇒ AWS.Request

Retrieves information about an asset composite model (also known as an asset component). An AssetCompositeModel is an instance of an AssetModelCompositeModel. If you want to see information about the model this is based on, call DescribeAssetModelCompositeModel.

Service Reference:

Examples:

Calling the describeAssetCompositeModel operation

var params = {
  assetCompositeModelId: 'STRING_VALUE', /* required */
  assetId: 'STRING_VALUE' /* required */
};
iotsitewise.describeAssetCompositeModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • assetCompositeModelId — (String)

      The ID of a composite model on this asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format. This ID uniquely identifies the asset within IoT SiteWise and can be used with other IoT SiteWise APIs.

      • assetCompositeModelId — (String)

        The ID of a composite model on this asset.

      • assetCompositeModelExternalId — (String)

        An external ID to assign to the asset model.

        If the composite model is a component-based composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

      • assetCompositeModelPath — (Array<map>)

        The path to the composite model listing the parent composite models.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • assetCompositeModelName — (String)

        The unique, friendly name for the composite model.

      • assetCompositeModelDescription — (String)

        A description for the composite model.

      • assetCompositeModelType — (String)

        The composite model type. Valid values are AWS/ALARM, CUSTOM, or AWS/L4E_ANOMALY.

      • assetCompositeModelProperties — (Array<map>)

        The property definitions of the composite model that was used to create the asset.

        • idrequired — (String)

          The ID of the asset property.

        • namerequired — (String)

          The name of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • notification — (map)

          The asset property's notification topic and state. For more information, see UpdateAssetProperty.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • dataTyperequired — (String)

          The data type of the asset property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit (such as Newtons or RPM) of the asset property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCompositeModelSummaries — (Array<map>)

        The list of composite model summaries.

        • idrequired — (String)

          The ID of the composite model that this summary describes.

        • externalId — (String)

          An external ID to assign to the asset model.

          If the composite model is a derived composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

        • namerequired — (String)

          The name of the composite model that this summary describes.

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • descriptionrequired — (String)

          A description of the composite model that this summary describes.

        • pathrequired — (Array<map>)

          The path that includes all the components of the asset model for the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • actionDefinitions — (Array<map>)

        The available actions for a composite model on this asset.

        • actionDefinitionIdrequired — (String)

          The ID of the action definition.

        • actionNamerequired — (String)

          The name of the action definition.

        • actionTyperequired — (String)

          The type of the action definition.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeAssetModel(params = {}, callback) ⇒ AWS.Request

Retrieves information about an asset model.

Service Reference:

Examples:

Calling the describeAssetModel operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  excludeProperties: true || false
};
iotsitewise.describeAssetModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset model properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelId — (String)

        The ID of the asset model, in UUID format.

      • assetModelArn — (String)

        The ARN of the asset model, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

      • assetModelName — (String)

        The name of the asset model.

      • assetModelDescription — (String)

        The asset model's description.

      • assetModelProperties — (Array<map>)

        The list of asset properties for the asset model.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetModelCompositeModels object.

        • id — (String)

          The ID of the asset model property.

          • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model property.

        • dataTyperequired — (String)

          The data type of the asset model property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit of the asset model property, such as Newtons or RPM.

        • typerequired — (map)

          The property type (see PropertyType).

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelHierarchies — (Array<map>)

        A list of asset model hierarchies that each contain a childAssetModelId and a hierarchyId (named id). A hierarchy specifies allowed parent/child asset relationships for an asset model.

        • id — (String)

          The ID of the asset model hierarchy. This ID is a hierarchyId.

          • If you are callling UpdateAssetModel to create a new hierarchy: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing hierarchy: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model hierarchy that you specify by using the CreateAssetModel or UpdateAssetModel API operation.

        • childAssetModelIdrequired — (String)

          The ID of the asset model, in UUID format. All assets in this hierarchy must be instances of the childAssetModelId asset model. IoT SiteWise will always return the actual asset model ID for this value. However, when you are specifying this value as part of a call to UpdateAssetModel, you may provide either the asset model ID or else externalId: followed by the asset model's external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCompositeModels — (Array<map>)

        The list of built-in composite models for the asset model, such as those with those of type AWS/ALARMS.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • properties — (Array<map>)

          The asset property definitions for this composite model.

          • id — (String)

            The ID of the asset model property.

            • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

            • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

          • namerequired — (String)

            The name of the asset model property.

          • dataTyperequired — (String)

            The data type of the asset model property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit of the asset model property, such as Newtons or RPM.

          • typerequired — (map)

            The property type (see PropertyType).

            • attribute — (map)

              Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

              • defaultValue — (String)

                The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

            • measurement — (map)

              Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

              • processingConfig — (map)

                The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

                • forwardingConfigrequired — (map)

                  The forwarding configuration for the given measurement property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • transform — (map)

              Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

              • expressionrequired — (String)

                The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • processingConfig — (map)

                The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given transform property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
                • forwardingConfig — (map)

                  The forwarding configuration for a given property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • metric — (map)

              Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

              • expressionrequired — (String)

                The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • windowrequired — (map)

                The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

                • tumbling — (map)

                  The tumbling time interval window.

                  • intervalrequired — (String)

                    The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                    IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                    When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                  • offset — (String)

                    The offset for the tumbling window. The offset parameter accepts the following:

                    • The offset time.

                      For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The ISO 8601 format.

                      For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The 24-hour clock.

                      For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                    • The offset time zone.

                      For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                      • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

              • processingConfig — (map)

                The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given metric property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
          • path — (Array<map>)

            The structured path to the property from the root of the asset model.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset model composite model.

        • externalId — (String)

          The external ID of the asset model composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCreationDate — (Date)

        The date the asset model was created, in Unix epoch time.

      • assetModelLastUpdateDate — (Date)

        The date the asset model was last updated, in Unix epoch time.

      • assetModelStatus — (map)

        The current status of the asset model, which contains a state and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetModelType — (String)

        The type of asset model.

        • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

        • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        Possible values include:
        • "ASSET_MODEL"
        • "COMPONENT_MODEL"
      • assetModelCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset model.

        • idrequired — (String)

          The ID of the the composite model that this summary describes..

        • externalId — (String)

          The external ID of a composite model on this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the the composite model that this summary describes..

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • description — (String)

          The description of the the composite model that this summary describes..

        • path — (Array<map>)

          The path that includes all the pieces that make up the composite model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetModelExternalId — (String)

        The external ID of the asset model, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

Waiter Resource States:

describeAssetModelCompositeModel(params = {}, callback) ⇒ AWS.Request

Retrieves information about an asset model composite model (also known as an asset model component). For more information, see Custom composite models (Components) in the IoT SiteWise User Guide.

Examples:

Calling the describeAssetModelCompositeModel operation

var params = {
  assetModelCompositeModelId: 'STRING_VALUE', /* required */
  assetModelId: 'STRING_VALUE' /* required */
};
iotsitewise.describeAssetModelCompositeModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • assetModelCompositeModelId — (String)

      The ID of a composite model on this asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelId — (String)

        The ID of the asset model, in UUID format.

      • assetModelCompositeModelId — (String)

        The ID of a composite model on this asset model.

      • assetModelCompositeModelExternalId — (String)

        The external ID of a composite model on this asset model.

      • assetModelCompositeModelPath — (Array<map>)

        The path to the composite model listing the parent composite models.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • assetModelCompositeModelName — (String)

        The unique, friendly name for the composite model.

      • assetModelCompositeModelDescription — (String)

        The description for the composite model.

      • assetModelCompositeModelType — (String)

        The composite model type. Valid values are AWS/ALARM, CUSTOM, or AWS/L4E_ANOMALY.

      • assetModelCompositeModelProperties — (Array<map>)

        The property definitions of the composite model.

        • id — (String)

          The ID of the asset model property.

          • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model property.

        • dataTyperequired — (String)

          The data type of the asset model property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit of the asset model property, such as Newtons or RPM.

        • typerequired — (map)

          The property type (see PropertyType).

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • compositionDetails — (map)

        Metadata for the composition relationship established by using composedAssetModelId in CreateAssetModelCompositeModel . For instance, an array detailing the path of the composition relationship for this composite model.

        • compositionRelationship — (Array<map>)

          An array detailing the composition relationship for this composite model.

          • id — (String)

            The ID of the component.

      • assetModelCompositeModelSummaries — (Array<map>)

        The list of composite model summaries for the composite model.

        • idrequired — (String)

          The ID of the the composite model that this summary describes..

        • externalId — (String)

          The external ID of a composite model on this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the the composite model that this summary describes..

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • description — (String)

          The description of the the composite model that this summary describes..

        • path — (Array<map>)

          The path that includes all the pieces that make up the composite model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • actionDefinitions — (Array<map>)

        The available actions for a composite model on this asset model.

        • actionDefinitionIdrequired — (String)

          The ID of the action definition.

        • actionNamerequired — (String)

          The name of the action definition.

        • actionTyperequired — (String)

          The type of the action definition.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeAssetProperty(params = {}, callback) ⇒ AWS.Request

Retrieves information about an asset property.

Note: When you call this operation for an attribute property, this response includes the default attribute value that you define in the asset model. If you update the default value in the model, this operation's response includes the new default value.

This operation doesn't return the value of the asset property. To get the value of an asset property, use GetAssetPropertyValue.

Service Reference:

Examples:

Calling the describeAssetProperty operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  propertyId: 'STRING_VALUE' /* required */
};
iotsitewise.describeAssetProperty(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format.

      • assetName — (String)

        The name of the asset.

      • assetModelId — (String)

        The ID of the asset model, in UUID format.

      • assetProperty — (map)

        The asset property's definition, alias, and notification state.

        This response includes this object for normal asset properties. If you describe an asset property in a composite model, this response includes the asset property information in compositeModel.

        • idrequired — (String)

          The ID of the asset property.

        • namerequired — (String)

          The name of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • notification — (map)

          The asset property's notification topic and state. For more information, see UpdateAssetProperty.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • dataTyperequired — (String)

          The property data type.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • unit — (String)

          The unit (such as Newtons or RPM) of the asset property.

        • type — (map)

          The property type (see PropertyType). A property contains one type.

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • compositeModel — (map)

        The composite model that declares this asset property, if this asset property exists in a composite model.

        • namerequired — (String)

          The name of the property.

        • typerequired — (String)

          The type of the composite model that defines this property.

        • assetPropertyrequired — (map)

          Contains asset property information.

          • idrequired — (String)

            The ID of the asset property.

          • namerequired — (String)

            The name of the property.

          • alias — (String)

            The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

          • notification — (map)

            The asset property's notification topic and state. For more information, see UpdateAssetProperty.

            • topicrequired — (String)

              The MQTT topic to which IoT SiteWise publishes property value update notifications.

            • staterequired — (String)

              The current notification state.

              Possible values include:
              • "ENABLED"
              • "DISABLED"
          • dataTyperequired — (String)

            The property data type.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • unit — (String)

            The unit (such as Newtons or RPM) of the asset property.

          • type — (map)

            The property type (see PropertyType). A property contains one type.

            • attribute — (map)

              Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

              • defaultValue — (String)

                The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

            • measurement — (map)

              Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

              • processingConfig — (map)

                The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

                • forwardingConfigrequired — (map)

                  The forwarding configuration for the given measurement property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • transform — (map)

              Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

              • expressionrequired — (String)

                The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • processingConfig — (map)

                The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given transform property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
                • forwardingConfig — (map)

                  The forwarding configuration for a given property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • metric — (map)

              Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

              • expressionrequired — (String)

                The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • windowrequired — (map)

                The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

                • tumbling — (map)

                  The tumbling time interval window.

                  • intervalrequired — (String)

                    The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                    IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                    When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                  • offset — (String)

                    The offset for the tumbling window. The offset parameter accepts the following:

                    • The offset time.

                      For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The ISO 8601 format.

                      For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The 24-hour clock.

                      For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                    • The offset time zone.

                      For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                      • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

              • processingConfig — (map)

                The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given metric property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
          • path — (Array<map>)

            The structured path to the property from the root of the asset.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the composite model that contains the property.

        • externalId — (String)

          The external ID of the composite model that contains the property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetExternalId — (String)

        The external ID of the asset. For more information, see Using external IDs in the IoT SiteWise User Guide.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeBulkImportJob(params = {}, callback) ⇒ AWS.Request

Retrieves information about a bulk import job request. For more information, see Describe a bulk import job (CLI) in the Amazon Simple Storage Service User Guide.

Service Reference:

Examples:

Calling the describeBulkImportJob operation

var params = {
  jobId: 'STRING_VALUE' /* required */
};
iotsitewise.describeBulkImportJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • jobId — (String)

      The ID of the job.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • jobId — (String)

        The ID of the job.

      • jobName — (String)

        The unique name that helps identify the job request.

      • jobStatus — (String)

        The status of the bulk import job can be one of following values:

        • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.

        • CANCELLED – The bulk import job has been canceled.

        • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.

        • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.

        • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

        • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

        Possible values include:
        • "PENDING"
        • "CANCELLED"
        • "RUNNING"
        • "COMPLETED"
        • "FAILED"
        • "COMPLETED_WITH_FAILURES"
      • jobRoleArn — (String)

        The ARN of the IAM role that allows IoT SiteWise to read Amazon S3 data.

      • files — (Array<map>)

        The files in the specified Amazon S3 bucket that contain your data.

        • bucketrequired — (String)

          The name of the Amazon S3 bucket from which data is imported.

        • keyrequired — (String)

          The key of the Amazon S3 object that contains your data. Each object has a key that is a unique identifier. Each object has exactly one key.

        • versionId — (String)

          The version ID to identify a specific version of the Amazon S3 object that contains your data.

      • errorReportLocation — (map)

        The Amazon S3 destination where errors associated with the job creation request are saved.

        • bucketrequired — (String)

          The name of the Amazon S3 bucket to which errors associated with the bulk import job are sent.

        • prefixrequired — (String)

          Amazon S3 uses the prefix as a folder name to organize data in the bucket. Each Amazon S3 object has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/). For more information, see Organizing objects using prefixes in the Amazon Simple Storage Service User Guide.

      • jobConfiguration — (map)

        Contains the configuration information of a job, such as the file format used to save data in Amazon S3.

        • fileFormatrequired — (map)

          The file format of the data in S3.

          • csv — (map)

            The file is in .CSV format.

            • columnNamesrequired — (Array<String>)

              The column names specified in the .csv file.

          • parquet — (map)

            The file is in parquet format.

      • jobCreationDate — (Date)

        The date the job was created, in Unix epoch TIME.

      • jobLastUpdateDate — (Date)

        The date the job was last updated, in Unix epoch time.

      • adaptiveIngestion — (Boolean)

        If set to true, ingest new data into IoT SiteWise storage. Measurements with notifications, metrics and transforms are computed. If set to false, historical data is ingested into IoT SiteWise as is.

      • deleteFilesAfterImport — (Boolean)

        If set to true, your data files is deleted from S3, after ingestion into IoT SiteWise storage.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeDashboard(params = {}, callback) ⇒ AWS.Request

Retrieves information about a dashboard.

Service Reference:

Examples:

Calling the describeDashboard operation

var params = {
  dashboardId: 'STRING_VALUE' /* required */
};
iotsitewise.describeDashboard(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • dashboardId — (String)

      The ID of the dashboard.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • dashboardId — (String)

        The ID of the dashboard.

      • dashboardArn — (String)

        The ARN of the dashboard, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}

      • dashboardName — (String)

        The name of the dashboard.

      • projectId — (String)

        The ID of the project that the dashboard is in.

      • dashboardDescription — (String)

        The dashboard's description.

      • dashboardDefinition — (String)

        The dashboard's definition JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

      • dashboardCreationDate — (Date)

        The date the dashboard was created, in Unix epoch time.

      • dashboardLastUpdateDate — (Date)

        The date the dashboard was last updated, in Unix epoch time.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeDefaultEncryptionConfiguration(params = {}, callback) ⇒ AWS.Request

Retrieves information about the default encryption configuration for the Amazon Web Services account in the default or specified Region. For more information, see Key management in the IoT SiteWise User Guide.

Examples:

Calling the describeDefaultEncryptionConfiguration operation

var params = {
};
iotsitewise.describeDefaultEncryptionConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • encryptionType — (String)

        The type of encryption used for the encryption configuration.

        Possible values include:
        • "SITEWISE_DEFAULT_ENCRYPTION"
        • "KMS_BASED_ENCRYPTION"
      • kmsKeyArn — (String)

        The key ARN of the customer managed key used for KMS encryption if you use KMS_BASED_ENCRYPTION.

      • configurationStatus — (map)

        The status of the account configuration. This contains the ConfigurationState. If there's an error, it also contains the ErrorDetails.

        • staterequired — (String)

          The current state of the configuration.

          Possible values include:
          • "ACTIVE"
          • "UPDATE_IN_PROGRESS"
          • "UPDATE_FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeGateway(params = {}, callback) ⇒ AWS.Request

Retrieves information about a gateway.

Service Reference:

Examples:

Calling the describeGateway operation

var params = {
  gatewayId: 'STRING_VALUE' /* required */
};
iotsitewise.describeGateway(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayId — (String)

      The ID of the gateway device.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • gatewayId — (String)

        The ID of the gateway device.

      • gatewayName — (String)

        The name of the gateway.

      • gatewayArn — (String)

        The ARN of the gateway, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}

      • gatewayPlatform — (map)

        The gateway's platform.

        • greengrass — (map)

          A gateway that runs on IoT Greengrass.

          • groupArnrequired — (String)

            The ARN of the Greengrass group. For more information about how to find a group's ARN, see ListGroups and GetGroup in the IoT Greengrass API Reference.

        • greengrassV2 — (map)

          A gateway that runs on IoT Greengrass V2.

          • coreDeviceThingNamerequired — (String)

            The name of the IoT thing for your IoT Greengrass V2 core device.

      • gatewayCapabilitySummaries — (Array<map>)

        A list of gateway capability summaries that each contain a namespace and status. Each gateway capability defines data sources for the gateway. To retrieve a capability configuration's definition, use DescribeGatewayCapabilityConfiguration.

        • capabilityNamespacerequired — (String)

          The namespace of the capability configuration. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

        • capabilitySyncStatusrequired — (String)

          The synchronization status of the capability configuration. The sync status can be one of the following:

          • IN_SYNC – The gateway is running the capability configuration.

          • OUT_OF_SYNC – The gateway hasn't received the capability configuration.

          • SYNC_FAILED – The gateway rejected the capability configuration.

          Possible values include:
          • "IN_SYNC"
          • "OUT_OF_SYNC"
          • "SYNC_FAILED"
          • "UNKNOWN"
      • creationDate — (Date)

        The date the gateway was created, in Unix epoch time.

      • lastUpdateDate — (Date)

        The date the gateway was last updated, in Unix epoch time.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeGatewayCapabilityConfiguration(params = {}, callback) ⇒ AWS.Request

Retrieves information about a gateway capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Examples:

Calling the describeGatewayCapabilityConfiguration operation

var params = {
  capabilityNamespace: 'STRING_VALUE', /* required */
  gatewayId: 'STRING_VALUE' /* required */
};
iotsitewise.describeGatewayCapabilityConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayId — (String)

      The ID of the gateway that defines the capability configuration.

    • capabilityNamespace — (String)

      The namespace of the capability configuration. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • gatewayId — (String)

        The ID of the gateway that defines the capability configuration.

      • capabilityNamespace — (String)

        The namespace of the gateway capability.

      • capabilityConfiguration — (String)

        The JSON document that defines the gateway capability's configuration. For more information, see Configuring data sources (CLI) in the IoT SiteWise User Guide.

      • capabilitySyncStatus — (String)

        The synchronization status of the capability configuration. The sync status can be one of the following:

        • IN_SYNC – The gateway is running the capability configuration.

        • OUT_OF_SYNC – The gateway hasn't received the capability configuration.

        • SYNC_FAILED – The gateway rejected the capability configuration.

        Possible values include:
        • "IN_SYNC"
        • "OUT_OF_SYNC"
        • "SYNC_FAILED"
        • "UNKNOWN"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeLoggingOptions(params = {}, callback) ⇒ AWS.Request

Retrieves the current IoT SiteWise logging options.

Service Reference:

Examples:

Calling the describeLoggingOptions operation

var params = {
};
iotsitewise.describeLoggingOptions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • loggingOptions — (map)

        The current logging options.

        • levelrequired — (String)

          The IoT SiteWise logging verbosity level.

          Possible values include:
          • "ERROR"
          • "INFO"
          • "OFF"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describePortal(params = {}, callback) ⇒ AWS.Request

Retrieves information about a portal.

Service Reference:

Examples:

Calling the describePortal operation

var params = {
  portalId: 'STRING_VALUE' /* required */
};
iotsitewise.describePortal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalId — (String)

      The ID of the portal.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalId — (String)

        The ID of the portal.

      • portalArn — (String)

        The ARN of the portal, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

      • portalName — (String)

        The name of the portal.

      • portalDescription — (String)

        The portal's description.

      • portalClientId — (String)

        The IAM Identity Center application generated client ID (used with IAM Identity Center API operations). IoT SiteWise includes portalClientId for only portals that use IAM Identity Center to authenticate users.

      • portalStartUrl — (String)

        The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use IAM Identity Center for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

      • portalContactEmail — (String)

        The Amazon Web Services administrator's contact email address.

      • portalStatus — (map)

        The current status of the portal, which contains a state and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

      • portalCreationDate — (Date)

        The date the portal was created, in Unix epoch time.

      • portalLastUpdateDate — (Date)

        The date the portal was last updated, in Unix epoch time.

      • portalLogoImageLocation — (map)

        The portal's logo image, which is available at a URL.

        • idrequired — (String)

          The ID of the image.

        • urlrequired — (String)

          The URL where the image is available. The URL is valid for 15 minutes so that you can view and download the image

      • roleArn — (String)

        The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

      • portalAuthMode — (String)

        The service to use to authenticate users to the portal.

        Possible values include:
        • "IAM"
        • "SSO"
      • notificationSenderEmail — (String)

        The email address that sends alarm notifications.

      • alarms — (map)

        Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal.

        • alarmRoleArnrequired — (String)

          The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

        • notificationLambdaArn — (String)

          The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

Waiter Resource States:

describeProject(params = {}, callback) ⇒ AWS.Request

Retrieves information about a project.

Service Reference:

Examples:

Calling the describeProject operation

var params = {
  projectId: 'STRING_VALUE' /* required */
};
iotsitewise.describeProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • projectId — (String)

        The ID of the project.

      • projectArn — (String)

        The ARN of the project, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}

      • projectName — (String)

        The name of the project.

      • portalId — (String)

        The ID of the portal that the project is in.

      • projectDescription — (String)

        The project's description.

      • projectCreationDate — (Date)

        The date the project was created, in Unix epoch time.

      • projectLastUpdateDate — (Date)

        The date the project was last updated, in Unix epoch time.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeStorageConfiguration(params = {}, callback) ⇒ AWS.Request

Retrieves information about the storage configuration for IoT SiteWise.

Service Reference:

Examples:

Calling the describeStorageConfiguration operation

var params = {
};
iotsitewise.describeStorageConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • storageType — (String)

        The storage tier that you specified for your data. The storageType parameter can be one of the following values:

        • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.

        • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

        Possible values include:
        • "SITEWISE_DEFAULT_STORAGE"
        • "MULTI_LAYER_STORAGE"
      • multiLayerStorage — (map)

        Contains information about the storage destination.

        • customerManagedS3Storagerequired — (map)

          Contains information about a customer managed Amazon S3 bucket.

          • s3ResourceArnrequired — (String)

            The ARN of the Amazon S3 object. For more information about how to find the ARN for an Amazon S3 object, see Amazon S3 resources in the Amazon Simple Storage Service User Guide.

          • roleArnrequired — (String)

            The ARN of the Identity and Access Management role that allows IoT SiteWise to send data to Amazon S3.

      • disassociatedDataStorage — (String)

        Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

        • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

          After the disassociatedDataStorage is enabled, you can't disable it.

        • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

        For more information, see Data streams in the IoT SiteWise User Guide.

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • retentionPeriod — (map)

        The number of days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.

        • numberOfDays — (Integer)

          The number of days that your data is kept.

          Note: If you specified a value for this parameter, the unlimited parameter must be false.
        • unlimited — (Boolean)

          If true, your data is kept indefinitely.

          Note: If configured to true, you must not specify a value for the numberOfDays parameter.
      • configurationStatus — (map)

        Contains current status information for the configuration.

        • staterequired — (String)

          The current state of the configuration.

          Possible values include:
          • "ACTIVE"
          • "UPDATE_IN_PROGRESS"
          • "UPDATE_FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

      • lastUpdateDate — (Date)

        The date the storage configuration was last updated, in Unix epoch time.

      • warmTier — (String)

        A service managed storage tier optimized for analytical queries. It stores periodically uploaded, buffered and historical data ingested with the CreaeBulkImportJob API.

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • warmTierRetentionPeriod — (map)

        Set this period to specify how long your data is stored in the warm tier before it is deleted. You can set this only if cold tier is enabled.

        • numberOfDays — (Integer)

          The number of days the data is stored in the warm tier.

        • unlimited — (Boolean)

          If set to true, the data is stored indefinitely in the warm tier.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeTimeSeries(params = {}, callback) ⇒ AWS.Request

Retrieves information about a time series (data stream).

To identify a time series, do one of the following:

  • If the time series isn't associated with an asset property, specify the alias of the time series.

  • If the time series is associated with an asset property, specify one of the following:

    • The alias of the time series.

    • The assetId and propertyId that identifies the asset property.

Service Reference:

Examples:

Calling the describeTimeSeries operation

var params = {
  alias: 'STRING_VALUE',
  assetId: 'STRING_VALUE',
  propertyId: 'STRING_VALUE'
};
iotsitewise.describeTimeSeries(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • alias — (String)

      The alias that identifies the time series.

    • assetId — (String)

      The ID of the asset in which the asset property was created. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset in which the asset property was created.

      • propertyId — (String)

        The ID of the asset property, in UUID format.

      • alias — (String)

        The alias that identifies the time series.

      • timeSeriesId — (String)

        The ID of the time series.

      • dataType — (String)

        The data type of the time series.

        If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this time series.

        Possible values include:
        • "STRING"
        • "INTEGER"
        • "DOUBLE"
        • "BOOLEAN"
        • "STRUCT"
      • dataTypeSpec — (String)

        The data type of the structure for this time series. This parameter is required for time series that have the STRUCT data type.

        The options for this parameter depend on the type of the composite model in which you created the asset property that is associated with your time series. Use AWS/ALARM_STATE for alarm state in alarm composite models.

      • timeSeriesCreationDate — (Date)

        The date that the time series was created, in Unix epoch time.

      • timeSeriesLastUpdateDate — (Date)

        The date that the time series was last updated, in Unix epoch time.

      • timeSeriesArn — (String)

        The ARN of the time series, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

disassociateAssets(params = {}, callback) ⇒ AWS.Request

Disassociates a child asset from the given parent asset through a hierarchy defined in the parent asset's model.

Service Reference:

Examples:

Calling the disassociateAssets operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  childAssetId: 'STRING_VALUE', /* required */
  hierarchyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.disassociateAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the parent asset from which to disassociate the child asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • hierarchyId — (String)

      The ID of a hierarchy in the parent asset's model. (This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.) Hierarchies allow different groupings of assets to be formed that all come from the same asset model. You can use the hierarchy ID to identify the correct asset to disassociate. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

    • childAssetId — (String)

      The ID of the child asset to disassociate. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

disassociateTimeSeriesFromAssetProperty(params = {}, callback) ⇒ AWS.Request

Disassociates a time series (data stream) from an asset property.

Examples:

Calling the disassociateTimeSeriesFromAssetProperty operation

var params = {
  alias: 'STRING_VALUE', /* required */
  assetId: 'STRING_VALUE', /* required */
  propertyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
iotsitewise.disassociateTimeSeriesFromAssetProperty(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • alias — (String)

      The alias that identifies the time series.

    • assetId — (String)

      The ID of the asset in which the asset property was created. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

executeAction(params = {}, callback) ⇒ AWS.Request

Executes an action on a target resource.

Service Reference:

Examples:

Calling the executeAction operation

var params = {
  actionDefinitionId: 'STRING_VALUE', /* required */
  actionPayload: { /* required */
    stringValue: 'STRING_VALUE' /* required */
  },
  targetResource: { /* required */
    assetId: 'STRING_VALUE' /* required */
  },
  clientToken: 'STRING_VALUE'
};
iotsitewise.executeAction(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • targetResource — (map)

      The resource the action will be taken on.

      • assetIdrequired — (String)

        The ID of the asset, in UUID format.

    • actionDefinitionId — (String)

      The ID of the action definition.

    • actionPayload — (map)

      The JSON payload of the action.

      • stringValuerequired — (String)

        The payload of the action in a JSON string.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • actionId — (String)

        The ID of the action.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

executeQuery(params = {}, callback) ⇒ AWS.Request

Run SQL queries to retrieve metadata and time-series data from asset models, assets, measurements, metrics, transforms, and aggregates.

Service Reference:

Examples:

Calling the executeQuery operation

var params = {
  queryStatement: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.executeQuery(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • queryStatement — (String)

      The IoT SiteWise query statement.

    • nextToken — (String)

      The string that specifies the next page of results.

    • maxResults — (Integer)

      The maximum number of results to return at one time. The default is 25.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • columns — (Array<map>)

        Represents a single column in the query results.

        • name — (String)

          The name of the column description.

        • type — (map)

          The type of the column description.

          • scalarType — (String)

            The allowed data types that the column has as it's value.

            Possible values include:
            • "BOOLEAN"
            • "INT"
            • "DOUBLE"
            • "TIMESTAMP"
            • "STRING"
      • rows — (Array<map>)

        Represents a single row in the query results.

        • datarequired — (Array<map>)

          List of data points in a single row of the result set.

          • scalarValue — (String)

            Indicates if the data point is a scalar value such as integer, string, double, or Boolean.

          • nullValue — (Boolean)

            Indicates if the data point is null.

      • nextToken — (String)

        The string that specifies the next page of results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getAssetPropertyAggregates(params = {}, callback) ⇒ AWS.Request

Gets aggregated values for an asset property. For more information, see Querying aggregates in the IoT SiteWise User Guide.

To identify an asset property, you must specify one of the following:

  • The assetId and propertyId of an asset property.

  • A propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

Service Reference:

Examples:

Calling the getAssetPropertyAggregates operation

var params = {
  aggregateTypes: [ /* required */
    AVERAGE | COUNT | MAXIMUM | MINIMUM | SUM | STANDARD_DEVIATION,
    /* more items */
  ],
  endDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
  resolution: 'STRING_VALUE', /* required */
  startDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
  assetId: 'STRING_VALUE',
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  propertyAlias: 'STRING_VALUE',
  propertyId: 'STRING_VALUE',
  qualities: [
    GOOD | BAD | UNCERTAIN,
    /* more items */
  ],
  timeOrdering: ASCENDING | DESCENDING
};
iotsitewise.getAssetPropertyAggregates(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset, in UUID format.

    • propertyId — (String)

      The ID of the asset property, in UUID format.

    • propertyAlias — (String)

      The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

    • aggregateTypes — (Array<String>)

      The data aggregating function.

    • resolution — (String)

      The time interval over which to aggregate data.

    • qualities — (Array<String>)

      The quality by which to filter asset data.

    • startDate — (Date)

      The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

    • endDate — (Date)

      The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

    • timeOrdering — (String)

      The chronological sorting order of the requested information.

      Default: ASCENDING

      Possible values include:
      • "ASCENDING"
      • "DESCENDING"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

      • The size of the result set is equal to 1 MB.

      • The number of data points in the result set is equal to the value of maxResults. The maximum value of maxResults is 2500.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • aggregatedValues — (Array<map>)

        The requested aggregated values.

        • timestamprequired — (Date)

          The date the aggregating computations occurred, in Unix epoch time.

        • quality — (String)

          The quality of the aggregated data.

          Possible values include:
          • "GOOD"
          • "BAD"
          • "UNCERTAIN"
        • valuerequired — (map)

          The value of the aggregates.

          • average — (Float)

            The average (mean) value of the time series over a time interval window.

          • count — (Float)

            The count of data points in the time series over a time interval window.

          • maximum — (Float)

            The maximum value of the time series over a time interval window.

          • minimum — (Float)

            The minimum value of the time series over a time interval window.

          • sum — (Float)

            The sum of the time series over a time interval window.

          • standardDeviation — (Float)

            The standard deviation of the time series over a time interval window.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getAssetPropertyValue(params = {}, callback) ⇒ AWS.Request

Gets an asset property's current value. For more information, see Querying current values in the IoT SiteWise User Guide.

To identify an asset property, you must specify one of the following:

  • The assetId and propertyId of an asset property.

  • A propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

Service Reference:

Examples:

Calling the getAssetPropertyValue operation

var params = {
  assetId: 'STRING_VALUE',
  propertyAlias: 'STRING_VALUE',
  propertyId: 'STRING_VALUE'
};
iotsitewise.getAssetPropertyValue(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset, in UUID format.

    • propertyId — (String)

      The ID of the asset property, in UUID format.

    • propertyAlias — (String)

      The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • propertyValue — (map)

        The current asset property value.

        • valuerequired — (map)

          The value of the asset property (see Variant).

          • stringValue — (String)

            Asset property data of type string (sequence of characters).

          • integerValue — (Integer)

            Asset property data of type integer (number that's greater than or equal to zero).

          • doubleValue — (Float)

            Asset property data of type double (floating point number).

          • booleanValue — (Boolean)

            Asset property data of type Boolean (true or false).

        • timestamprequired — (map)

          The timestamp of the asset property value.

          • timeInSecondsrequired — (Integer)

            The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

          • offsetInNanos — (Integer)

            The nanosecond offset from timeInSeconds.

        • quality — (String)

          The quality of the asset property value.

          Possible values include:
          • "GOOD"
          • "BAD"
          • "UNCERTAIN"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getAssetPropertyValueHistory(params = {}, callback) ⇒ AWS.Request

Gets the history of an asset property's values. For more information, see Querying historical values in the IoT SiteWise User Guide.

To identify an asset property, you must specify one of the following:

  • The assetId and propertyId of an asset property.

  • A propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

Service Reference:

Examples:

Calling the getAssetPropertyValueHistory operation

var params = {
  assetId: 'STRING_VALUE',
  endDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  propertyAlias: 'STRING_VALUE',
  propertyId: 'STRING_VALUE',
  qualities: [
    GOOD | BAD | UNCERTAIN,
    /* more items */
  ],
  startDate: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  timeOrdering: ASCENDING | DESCENDING
};
iotsitewise.getAssetPropertyValueHistory(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset, in UUID format.

    • propertyId — (String)

      The ID of the asset property, in UUID format.

    • propertyAlias — (String)

      The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

    • startDate — (Date)

      The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

    • endDate — (Date)

      The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

    • qualities — (Array<String>)

      The quality by which to filter asset data.

    • timeOrdering — (String)

      The chronological sorting order of the requested information.

      Default: ASCENDING

      Possible values include:
      • "ASCENDING"
      • "DESCENDING"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

      • The size of the result set is equal to 4 MB.

      • The number of data points in the result set is equal to the value of maxResults. The maximum value of maxResults is 20000.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetPropertyValueHistory — (Array<map>)

        The asset property's value history.

        • valuerequired — (map)

          The value of the asset property (see Variant).

          • stringValue — (String)

            Asset property data of type string (sequence of characters).

          • integerValue — (Integer)

            Asset property data of type integer (number that's greater than or equal to zero).

          • doubleValue — (Float)

            Asset property data of type double (floating point number).

          • booleanValue — (Boolean)

            Asset property data of type Boolean (true or false).

        • timestamprequired — (map)

          The timestamp of the asset property value.

          • timeInSecondsrequired — (Integer)

            The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

          • offsetInNanos — (Integer)

            The nanosecond offset from timeInSeconds.

        • quality — (String)

          The quality of the asset property value.

          Possible values include:
          • "GOOD"
          • "BAD"
          • "UNCERTAIN"
      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getInterpolatedAssetPropertyValues(params = {}, callback) ⇒ AWS.Request

Get interpolated values for an asset property for a specified time interval, during a period of time. If your time series is missing data points during the specified time interval, you can use interpolation to estimate the missing data.

For example, you can use this operation to return the interpolated temperature values for a wind turbine every 24 hours over a duration of 7 days.

To identify an asset property, you must specify one of the following:

  • The assetId and propertyId of an asset property.

  • A propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

Examples:

Calling the getInterpolatedAssetPropertyValues operation

var params = {
  endTimeInSeconds: 'NUMBER_VALUE', /* required */
  intervalInSeconds: 'NUMBER_VALUE', /* required */
  quality: GOOD | BAD | UNCERTAIN, /* required */
  startTimeInSeconds: 'NUMBER_VALUE', /* required */
  type: 'STRING_VALUE', /* required */
  assetId: 'STRING_VALUE',
  endTimeOffsetInNanos: 'NUMBER_VALUE',
  intervalWindowInSeconds: 'NUMBER_VALUE',
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  propertyAlias: 'STRING_VALUE',
  propertyId: 'STRING_VALUE',
  startTimeOffsetInNanos: 'NUMBER_VALUE'
};
iotsitewise.getInterpolatedAssetPropertyValues(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset, in UUID format.

    • propertyId — (String)

      The ID of the asset property, in UUID format.

    • propertyAlias — (String)

      The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

    • startTimeInSeconds — (Integer)

      The exclusive start of the range from which to interpolate data, expressed in seconds in Unix epoch time.

    • startTimeOffsetInNanos — (Integer)

      The nanosecond offset converted from startTimeInSeconds.

    • endTimeInSeconds — (Integer)

      The inclusive end of the range from which to interpolate data, expressed in seconds in Unix epoch time.

    • endTimeOffsetInNanos — (Integer)

      The nanosecond offset converted from endTimeInSeconds.

    • quality — (String)

      The quality of the asset property value. You can use this parameter as a filter to choose only the asset property values that have a specific quality.

      Possible values include:
      • "GOOD"
      • "BAD"
      • "UNCERTAIN"
    • intervalInSeconds — (Integer)

      The time interval in seconds over which to interpolate data. Each interval starts when the previous one ends.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. If not specified, the default value is 10.

    • type — (String)

      The interpolation type.

      Valid values: LINEAR_INTERPOLATION | LOCF_INTERPOLATION

      • LINEAR_INTERPOLATION – Estimates missing data using linear interpolation.

        For example, you can use this operation to return the interpolated temperature values for a wind turbine every 24 hours over a duration of 7 days. If the interpolation starts July 1, 2021, at 9 AM, IoT SiteWise returns the first interpolated value on July 2, 2021, at 9 AM, the second interpolated value on July 3, 2021, at 9 AM, and so on.

      • LOCF_INTERPOLATION – Estimates missing data using last observation carried forward interpolation

        If no data point is found for an interval, IoT SiteWise returns the last observed data point for the previous interval and carries forward this interpolated value until a new data point is found.

        For example, you can get the state of an on-off valve every 24 hours over a duration of 7 days. If the interpolation starts July 1, 2021, at 9 AM, IoT SiteWise returns the last observed data point between July 1, 2021, at 9 AM and July 2, 2021, at 9 AM as the first interpolated value. If a data point isn't found after 9 AM on July 2, 2021, IoT SiteWise uses the same interpolated value for the rest of the days.

    • intervalWindowInSeconds — (Integer)

      The query interval for the window, in seconds. IoT SiteWise computes each interpolated value by using data points from the timestamp of each interval, minus the window to the timestamp of each interval plus the window. If not specified, the window ranges between the start time minus the interval and the end time plus the interval.

      Note:
      • If you specify a value for the intervalWindowInSeconds parameter, the value for the type parameter must be LINEAR_INTERPOLATION.
      • If a data point isn't found during the specified query window, IoT SiteWise won't return an interpolated value for the interval. This indicates that there's a gap in the ingested data points.

      For example, you can get the interpolated temperature values for a wind turbine every 24 hours over a duration of 7 days. If the interpolation starts on July 1, 2021, at 9 AM with a window of 2 hours, IoT SiteWise uses the data points from 7 AM (9 AM minus 2 hours) to 11 AM (9 AM plus 2 hours) on July 2, 2021 to compute the first interpolated value. Next, IoT SiteWise uses the data points from 7 AM (9 AM minus 2 hours) to 11 AM (9 AM plus 2 hours) on July 3, 2021 to compute the second interpolated value, and so on.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • interpolatedAssetPropertyValues — (Array<map>)

        The requested interpolated values.

        • timestamprequired — (map)

          Contains a timestamp with optional nanosecond granularity.

          • timeInSecondsrequired — (Integer)

            The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

          • offsetInNanos — (Integer)

            The nanosecond offset from timeInSeconds.

        • valuerequired — (map)

          Contains an asset property value (of a single type only).

          • stringValue — (String)

            Asset property data of type string (sequence of characters).

          • integerValue — (Integer)

            Asset property data of type integer (number that's greater than or equal to zero).

          • doubleValue — (Float)

            Asset property data of type double (floating point number).

          • booleanValue — (Boolean)

            Asset property data of type Boolean (true or false).

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAccessPolicies(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of access policies for an identity (an IAM Identity Center user, an IAM Identity Center group, or an IAM user) or an IoT SiteWise Monitor resource (a portal or project).

Service Reference:

Examples:

Calling the listAccessPolicies operation

var params = {
  iamArn: 'STRING_VALUE',
  identityId: 'STRING_VALUE',
  identityType: USER | GROUP | IAM,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  resourceId: 'STRING_VALUE',
  resourceType: PORTAL | PROJECT
};
iotsitewise.listAccessPolicies(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • identityType — (String)

      The type of identity (IAM Identity Center user, IAM Identity Center group, or IAM user). This parameter is required if you specify identityId.

      Possible values include:
      • "USER"
      • "GROUP"
      • "IAM"
    • identityId — (String)

      The ID of the identity. This parameter is required if you specify USER or GROUP for identityType.

    • resourceType — (String)

      The type of resource (portal or project). This parameter is required if you specify resourceId.

      Possible values include:
      • "PORTAL"
      • "PROJECT"
    • resourceId — (String)

      The ID of the resource. This parameter is required if you specify resourceType.

    • iamArn — (String)

      The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide. This parameter is required if you specify IAM for identityType.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • accessPolicySummaries — (Array<map>)

        A list that summarizes each access policy.

        • idrequired — (String)

          The ID of the access policy.

        • identityrequired — (map)

          The identity (an IAM Identity Center user, an IAM Identity Center group, or an IAM user).

          • user — (map)

            An IAM Identity Center user identity.

            • idrequired — (String)

              The IAM Identity Center ID of the user.

          • group — (map)

            An IAM Identity Center group identity.

            • idrequired — (String)

              The IAM Identity Center ID of the group.

          • iamUser — (map)

            An IAM user identity.

            • arnrequired — (String)

              The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide.

              Note: If you delete the IAM user, access policies that contain this identity include an empty arn. You can delete the access policy for the IAM user that no longer exists.
          • iamRole — (map)

            An IAM role identity.

            • arnrequired — (String)

              The ARN of the IAM role. For more information, see IAM ARNs in the IAM User Guide.

        • resourcerequired — (map)

          The IoT SiteWise Monitor resource (a portal or project).

          • portal — (map)

            A portal resource.

            • idrequired — (String)

              The ID of the portal.

          • project — (map)

            A project resource.

            • idrequired — (String)

              The ID of the project.

        • permissionrequired — (String)

          The permissions for the access policy. Note that a project ADMINISTRATOR is also known as a project owner.

          Possible values include:
          • "ADMINISTRATOR"
          • "VIEWER"
        • creationDate — (Date)

          The date the access policy was created, in Unix epoch time.

        • lastUpdateDate — (Date)

          The date the access policy was last updated, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listActions(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of actions for a specific target resource.

Service Reference:

Examples:

Calling the listActions operation

var params = {
  targetResourceId: 'STRING_VALUE', /* required */
  targetResourceType: ASSET, /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listActions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • targetResourceType — (String)

      The type of resource.

      Possible values include:
      • "ASSET"
    • targetResourceId — (String)

      The ID of the target resource.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • actionSummaries — (Array<map>)

        A list that summarizes the actions associated with the specified asset.

        • actionId — (String)

          The ID of the action.

        • actionDefinitionId — (String)

          The ID of the action definition.

        • targetResource — (map)

          The resource the action will be taken on.

          • assetIdrequired — (String)

            The ID of the asset, in UUID format.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssetModelCompositeModels(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of composite models associated with the asset model

Service Reference:

Examples:

Calling the listAssetModelCompositeModels operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssetModelCompositeModels(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelCompositeModelSummaries — (Array<map>)

        A list that summarizes each composite model.

        • idrequired — (String)

          The ID of the the composite model that this summary describes..

        • externalId — (String)

          The external ID of a composite model on this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the the composite model that this summary describes..

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • description — (String)

          The description of the the composite model that this summary describes..

        • path — (Array<map>)

          The path that includes all the pieces that make up the composite model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssetModelProperties(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of properties associated with an asset model. If you update properties associated with the model before you finish listing all the properties, you need to start all over again.

Service Reference:

Examples:

Calling the listAssetModelProperties operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  filter: ALL | BASE,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssetModelProperties(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. If not specified, the default value is 50.

    • filter — (String)

      Filters the requested list of asset model properties. You can choose one of the following options:

      • ALL – The list includes all asset model properties for a given asset model ID.

      • BASE – The list includes only base asset model properties for a given asset model ID.

      Default: BASE

      Possible values include:
      • "ALL"
      • "BASE"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelPropertySummaries — (Array<map>)

        A list that summarizes the properties associated with the specified asset model.

        • id — (String)

          The ID of the property.

        • namerequired — (String)

          The name of the property.

        • dataTyperequired — (String)

          The data type of the property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit (such as Newtons or RPM) of the property.

        • typerequired — (map)

          Contains a property type, which can be one of attribute, measurement, metric, or transform.

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • assetModelCompositeModelId — (String)

          The ID of the composite model that contains the asset model property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssetModels(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of summaries of all asset models.

Service Reference:

Examples:

Calling the listAssetModels operation

var params = {
  assetModelTypes: [
    ASSET_MODEL | COMPONENT_MODEL,
    /* more items */
  ],
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssetModels(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

    • assetModelTypes — (Array<String>)

      The type of asset model.

      • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

      • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelSummaries — (Array<map>)

        A list that summarizes each asset model.

        • idrequired — (String)

          The ID of the asset model (used with IoT SiteWise API operations).

        • arnrequired — (String)

          The ARN of the asset model, which has the following format.

          arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

        • namerequired — (String)

          The name of the asset model.

        • descriptionrequired — (String)

          The asset model description.

        • creationDaterequired — (Date)

          The date the asset model was created, in Unix epoch time.

        • lastUpdateDaterequired — (Date)

          The date the asset model was last updated, in Unix epoch time.

        • statusrequired — (map)

          The current status of the asset model.

          • staterequired — (String)

            The current state of the asset model.

            Possible values include:
            • "CREATING"
            • "ACTIVE"
            • "UPDATING"
            • "PROPAGATING"
            • "DELETING"
            • "FAILED"
          • error — (map)

            Contains associated error information, if any.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "VALIDATION_ERROR"
              • "INTERNAL_FAILURE"
            • messagerequired — (String)

              The error message.

            • details — (Array<map>)

              A list of detailed errors.

              • coderequired — (String)

                The error code.

                Possible values include:
                • "INCOMPATIBLE_COMPUTE_LOCATION"
                • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
              • messagerequired — (String)

                The error message.

        • assetModelType — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

          Possible values include:
          • "ASSET_MODEL"
          • "COMPONENT_MODEL"
        • externalId — (String)

          The external ID of the asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssetProperties(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of properties associated with an asset. If you update properties associated with the model before you finish listing all the properties, you need to start all over again.

Service Reference:

Examples:

Calling the listAssetProperties operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  filter: ALL | BASE,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssetProperties(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request. If not specified, the default value is 50.

    • filter — (String)

      Filters the requested list of asset properties. You can choose one of the following options:

      • ALL – The list includes all asset properties for a given asset model ID.

      • BASE – The list includes only base asset properties for a given asset model ID.

      Default: BASE

      Possible values include:
      • "ALL"
      • "BASE"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetPropertySummaries — (Array<map>)

        A list that summarizes the properties associated with the specified asset.

        • idrequired — (String)

          The ID of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • unit — (String)

          The unit of measure (such as Newtons or RPM) of the asset property.

        • notification — (map)

          Contains asset property value notification information. When the notification state is enabled, IoT SiteWise publishes property value updates to a unique MQTT topic. For more information, see Interacting with other services in the IoT SiteWise User Guide.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • assetCompositeModelId — (String)

          The ID of the composite model that contains the asset property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssetRelationships(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of asset relationships for an asset. You can use this operation to identify an asset's root asset and all associated assets between that asset and its root.

Service Reference:

Examples:

Calling the listAssetRelationships operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  traversalType: PATH_TO_ROOT, /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssetRelationships(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • traversalType — (String)

      The type of traversal to use to identify asset relationships. Choose the following option:

      • PATH_TO_ROOT – Identify the asset's parent assets up to the root asset. The asset that you specify in assetId is the first result in the list of assetRelationshipSummaries, and the root asset is the last result.

      Possible values include:
      • "PATH_TO_ROOT"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetRelationshipSummaries — (Array<map>)

        A list that summarizes each asset relationship.

        • hierarchyInfo — (map)

          The assets that are related through an asset hierarchy.

          This object is present if the relationshipType is HIERARCHY.

          • parentAssetId — (String)

            The ID of the parent asset in this asset relationship.

          • childAssetId — (String)

            The ID of the child asset in this asset relationship.

        • relationshipTyperequired — (String)

          The relationship type of the assets in this relationship. This value is one of the following:

          • HIERARCHY – The assets are related through an asset hierarchy. If you specify this relationship type, this asset relationship includes the hierarchyInfo object.

          Possible values include:
          • "HIERARCHY"
      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssets(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of asset summaries.

You can use this operation to do the following:

  • List assets based on a specific asset model.

  • List top-level assets.

You can't use this operation to list all assets. To retrieve summaries for all of your assets, use ListAssetModels to get all of your asset model IDs. Then, use ListAssets to get all assets for each asset model.

Service Reference:

Examples:

Calling the listAssets operation

var params = {
  assetModelId: 'STRING_VALUE',
  filter: ALL | TOP_LEVEL,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

    • assetModelId — (String)

      The ID of the asset model by which to filter the list of assets. This parameter is required if you choose ALL for filter. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • filter — (String)

      The filter for the requested list of assets. Choose one of the following options:

      • ALL – The list includes all assets for a given asset model ID. The assetModelId parameter is required if you filter by ALL.

      • TOP_LEVEL – The list includes only top-level assets in the asset hierarchy tree.

      Default: ALL

      Possible values include:
      • "ALL"
      • "TOP_LEVEL"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetSummaries — (Array<map>)

        A list that summarizes each asset.

        • idrequired — (String)

          The ID of the asset, in UUID format.

        • arnrequired — (String)

          The ARN of the asset, which has the following format.

          arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

        • namerequired — (String)

          The name of the asset.

        • assetModelIdrequired — (String)

          The ID of the asset model used to create this asset.

        • creationDaterequired — (Date)

          The date the asset was created, in Unix epoch time.

        • lastUpdateDaterequired — (Date)

          The date the asset was last updated, in Unix epoch time.

        • statusrequired — (map)

          The current status of the asset.

          • staterequired — (String)

            The current status of the asset.

            Possible values include:
            • "CREATING"
            • "ACTIVE"
            • "UPDATING"
            • "DELETING"
            • "FAILED"
          • error — (map)

            Contains associated error information, if any.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "VALIDATION_ERROR"
              • "INTERNAL_FAILURE"
            • messagerequired — (String)

              The error message.

            • details — (Array<map>)

              A list of detailed errors.

              • coderequired — (String)

                The error code.

                Possible values include:
                • "INCOMPATIBLE_COMPUTE_LOCATION"
                • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
              • messagerequired — (String)

                The error message.

        • hierarchiesrequired — (Array<map>)

          A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

          • id — (String)

            The ID of the hierarchy. This ID is a hierarchyId.

          • namerequired — (String)

            The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

          • externalId — (String)

            The external ID of the hierarchy, if it has one. When you update an asset hierarchy, you may assign an external ID if it doesn't already have one. You can't change the external ID of an asset hierarchy that already has one. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • description — (String)

          A description for the asset.

        • externalId — (String)

          The external ID of the asset. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listAssociatedAssets(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of associated assets.

You can use this operation to do the following:

  • List child assets associated to a parent asset by a hierarchy that you specify.

  • List an asset's parent asset.

Service Reference:

Examples:

Calling the listAssociatedAssets operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  hierarchyId: 'STRING_VALUE',
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  traversalDirection: PARENT | CHILD
};
iotsitewise.listAssociatedAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset to query. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • hierarchyId — (String)

      The ID of the hierarchy by which child assets are associated to the asset. (This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.) To find a hierarchy ID, use the DescribeAsset or DescribeAssetModel operations. This parameter is required if you choose CHILD for traversalDirection.

      For more information, see Asset hierarchies in the IoT SiteWise User Guide.

    • traversalDirection — (String)

      The direction to list associated assets. Choose one of the following options:

      • CHILD – The list includes all child assets associated to the asset. The hierarchyId parameter is required if you choose CHILD.

      • PARENT – The list includes the asset's parent asset.

      Default: CHILD

      Possible values include:
      • "PARENT"
      • "CHILD"
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetSummaries — (Array<map>)

        A list that summarizes the associated assets.

        • idrequired — (String)

          The ID of the asset, in UUID format.

        • arnrequired — (String)

          The ARN of the asset, which has the following format.

          arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

        • namerequired — (String)

          The name of the asset.

        • assetModelIdrequired — (String)

          The ID of the asset model used to create the asset.

        • creationDaterequired — (Date)

          The date the asset was created, in Unix epoch time.

        • lastUpdateDaterequired — (Date)

          The date the asset was last updated, in Unix epoch time.

        • statusrequired — (map)

          The current status of the asset.

          • staterequired — (String)

            The current status of the asset.

            Possible values include:
            • "CREATING"
            • "ACTIVE"
            • "UPDATING"
            • "DELETING"
            • "FAILED"
          • error — (map)

            Contains associated error information, if any.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "VALIDATION_ERROR"
              • "INTERNAL_FAILURE"
            • messagerequired — (String)

              The error message.

            • details — (Array<map>)

              A list of detailed errors.

              • coderequired — (String)

                The error code.

                Possible values include:
                • "INCOMPATIBLE_COMPUTE_LOCATION"
                • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
              • messagerequired — (String)

                The error message.

        • hierarchiesrequired — (Array<map>)

          A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

          • id — (String)

            The ID of the hierarchy. This ID is a hierarchyId.

          • namerequired — (String)

            The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

          • externalId — (String)

            The external ID of the hierarchy, if it has one. When you update an asset hierarchy, you may assign an external ID if it doesn't already have one. You can't change the external ID of an asset hierarchy that already has one. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • description — (String)

          A description for the asset.

        • externalId — (String)

          The external ID of the asset. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listBulkImportJobs(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of bulk import job requests. For more information, see List bulk import jobs (CLI) in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the listBulkImportJobs operation

var params = {
  filter: ALL | PENDING | RUNNING | CANCELLED | FAILED | COMPLETED_WITH_FAILURES | COMPLETED,
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listBulkImportJobs(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

    • filter — (String)

      You can use a filter to select the bulk import jobs that you want to retrieve.

      Possible values include:
      • "ALL"
      • "PENDING"
      • "RUNNING"
      • "CANCELLED"
      • "FAILED"
      • "COMPLETED_WITH_FAILURES"
      • "COMPLETED"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • jobSummaries — (Array<map>)

        One or more job summaries to list.

        • idrequired — (String)

          The ID of the job.

        • namerequired — (String)

          The unique name that helps identify the job request.

        • statusrequired — (String)

          The status of the bulk import job can be one of following values:

          • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.

          • CANCELLED – The bulk import job has been canceled.

          • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.

          • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.

          • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

          • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

          Possible values include:
          • "PENDING"
          • "CANCELLED"
          • "RUNNING"
          • "COMPLETED"
          • "FAILED"
          • "COMPLETED_WITH_FAILURES"
      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listCompositionRelationships(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of composition relationships for an asset model of type COMPONENT_MODEL.

Service Reference:

Examples:

Calling the listCompositionRelationships operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listCompositionRelationships(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • compositionRelationshipSummaries — (Array<map>)

        A list that summarizes each composition relationship.

        • assetModelIdrequired — (String)

          The ID of the asset model, in UUID format.

        • assetModelCompositeModelIdrequired — (String)

          The ID of a composite model on this asset model.

        • assetModelCompositeModelTyperequired — (String)

          The composite model type. Valid values are AWS/ALARM, CUSTOM, or AWS/L4E_ANOMALY.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listDashboards(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of dashboards for an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the listDashboards operation

var params = {
  projectId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listDashboards(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • dashboardSummaries — (Array<map>)

        A list that summarizes each dashboard in the project.

        • idrequired — (String)

          The ID of the dashboard.

        • namerequired — (String)

          The name of the dashboard

        • description — (String)

          The dashboard's description.

        • creationDate — (Date)

          The date the dashboard was created, in Unix epoch time.

        • lastUpdateDate — (Date)

          The date the dashboard was last updated, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listGateways(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of gateways.

Service Reference:

Examples:

Calling the listGateways operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listGateways(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • gatewaySummaries — (Array<map>)

        A list that summarizes each gateway.

        • gatewayIdrequired — (String)

          The ID of the gateway device.

        • gatewayNamerequired — (String)

          The name of the asset.

        • gatewayPlatform — (map)

          Contains a gateway's platform information.

          • greengrass — (map)

            A gateway that runs on IoT Greengrass.

            • groupArnrequired — (String)

              The ARN of the Greengrass group. For more information about how to find a group's ARN, see ListGroups and GetGroup in the IoT Greengrass API Reference.

          • greengrassV2 — (map)

            A gateway that runs on IoT Greengrass V2.

            • coreDeviceThingNamerequired — (String)

              The name of the IoT thing for your IoT Greengrass V2 core device.

        • gatewayCapabilitySummaries — (Array<map>)

          A list of gateway capability summaries that each contain a namespace and status. Each gateway capability defines data sources for the gateway. To retrieve a capability configuration's definition, use DescribeGatewayCapabilityConfiguration.

          • capabilityNamespacerequired — (String)

            The namespace of the capability configuration. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

          • capabilitySyncStatusrequired — (String)

            The synchronization status of the capability configuration. The sync status can be one of the following:

            • IN_SYNC – The gateway is running the capability configuration.

            • OUT_OF_SYNC – The gateway hasn't received the capability configuration.

            • SYNC_FAILED – The gateway rejected the capability configuration.

            Possible values include:
            • "IN_SYNC"
            • "OUT_OF_SYNC"
            • "SYNC_FAILED"
            • "UNKNOWN"
        • creationDaterequired — (Date)

          The date the gateway was created, in Unix epoch time.

        • lastUpdateDaterequired — (Date)

          The date the gateway was last updated, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listPortals(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of IoT SiteWise Monitor portals.

Service Reference:

Examples:

Calling the listPortals operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listPortals(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalSummaries — (Array<map>)

        A list that summarizes each portal.

        • idrequired — (String)

          The ID of the portal.

        • namerequired — (String)

          The name of the portal.

        • description — (String)

          The portal's description.

        • startUrlrequired — (String)

          The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use IAM Identity Center for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

        • creationDate — (Date)

          The date the portal was created, in Unix epoch time.

        • lastUpdateDate — (Date)

          The date the portal was last updated, in Unix epoch time.

        • roleArn — (String)

          The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

        • statusrequired — (map)

          Contains information about the current status of a portal.

          • staterequired — (String)

            The current state of the portal.

            Possible values include:
            • "CREATING"
            • "UPDATING"
            • "DELETING"
            • "ACTIVE"
            • "FAILED"
          • error — (map)

            Contains associated error information, if any.

            • code — (String)

              The error code.

              Possible values include:
              • "INTERNAL_FAILURE"
              • "VALIDATION_ERROR"
              • "LIMIT_EXCEEDED"
            • message — (String)

              The error message.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listProjectAssets(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of assets associated with an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the listProjectAssets operation

var params = {
  projectId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listProjectAssets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetIds — (Array<String>)

        A list that contains the IDs of each asset associated with the project.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listProjects(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of projects for an IoT SiteWise Monitor portal.

Service Reference:

Examples:

Calling the listProjects operation

var params = {
  portalId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
iotsitewise.listProjects(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalId — (String)

      The ID of the portal.

    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

      Default: 50

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • projectSummaries — (Array<map>)

        A list that summarizes each project in the portal.

        • idrequired — (String)

          The ID of the project.

        • namerequired — (String)

          The name of the project.

        • description — (String)

          The project's description.

        • creationDate — (Date)

          The date the project was created, in Unix epoch time.

        • lastUpdateDate — (Date)

          The date the project was last updated, in Unix epoch time.

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTagsForResource(params = {}, callback) ⇒ AWS.Request

Retrieves the list of tags for an IoT SiteWise resource.

Service Reference:

Examples:

Calling the listTagsForResource operation

var params = {
  resourceArn: 'STRING_VALUE' /* required */
};
iotsitewise.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The ARN of the resource.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • tags — (map<String>)

        The list of key-value pairs that contain metadata for the resource. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTimeSeries(params = {}, callback) ⇒ AWS.Request

Retrieves a paginated list of time series (data streams).

Service Reference:

Examples:

Calling the listTimeSeries operation

var params = {
  aliasPrefix: 'STRING_VALUE',
  assetId: 'STRING_VALUE',
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  timeSeriesType: ASSOCIATED | DISASSOCIATED
};
iotsitewise.listTimeSeries(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • nextToken — (String)

      The token to be used for the next set of paginated results.

    • maxResults — (Integer)

      The maximum number of results to return for each paginated request.

    • assetId — (String)

      The ID of the asset in which the asset property was created. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • aliasPrefix — (String)

      The alias prefix of the time series.

    • timeSeriesType — (String)

      The type of the time series. The time series type can be one of the following values:

      • ASSOCIATED – The time series is associated with an asset property.

      • DISASSOCIATED – The time series isn't associated with any asset property.

      Possible values include:
      • "ASSOCIATED"
      • "DISASSOCIATED"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • TimeSeriesSummaries — (Array<map>)

        One or more time series summaries to list.

        • assetId — (String)

          The ID of the asset in which the asset property was created.

        • propertyId — (String)

          The ID of the asset property, in UUID format.

        • alias — (String)

          The alias that identifies the time series.

        • timeSeriesIdrequired — (String)

          The ID of the time series.

        • dataTyperequired — (String)

          The data type of the time series.

          If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this time series.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this time series. This parameter is required for time series that have the STRUCT data type.

          The options for this parameter depend on the type of the composite model in which you created the asset property that is associated with your time series. Use AWS/ALARM_STATE for alarm state in alarm composite models.

        • timeSeriesCreationDaterequired — (Date)

          The date that the time series was created, in Unix epoch time.

        • timeSeriesLastUpdateDaterequired — (Date)

          The date that the time series was last updated, in Unix epoch time.

        • timeSeriesArnrequired — (String)

          The ARN of the time series, which has the following format.

          arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}

      • nextToken — (String)

        The token for the next set of results, or null if there are no additional results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

putDefaultEncryptionConfiguration(params = {}, callback) ⇒ AWS.Request

Sets the default encryption configuration for the Amazon Web Services account. For more information, see Key management in the IoT SiteWise User Guide.

Examples:

Calling the putDefaultEncryptionConfiguration operation

var params = {
  encryptionType: SITEWISE_DEFAULT_ENCRYPTION | KMS_BASED_ENCRYPTION, /* required */
  kmsKeyId: 'STRING_VALUE'
};
iotsitewise.putDefaultEncryptionConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • encryptionType — (String)

      The type of encryption used for the encryption configuration.

      Possible values include:
      • "SITEWISE_DEFAULT_ENCRYPTION"
      • "KMS_BASED_ENCRYPTION"
    • kmsKeyId — (String)

      The Key ID of the customer managed key used for KMS encryption. This is required if you use KMS_BASED_ENCRYPTION.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • encryptionType — (String)

        The type of encryption used for the encryption configuration.

        Possible values include:
        • "SITEWISE_DEFAULT_ENCRYPTION"
        • "KMS_BASED_ENCRYPTION"
      • kmsKeyArn — (String)

        The Key ARN of the KMS key used for KMS encryption if you use KMS_BASED_ENCRYPTION.

      • configurationStatus — (map)

        The status of the account configuration. This contains the ConfigurationState. If there is an error, it also contains the ErrorDetails.

        • staterequired — (String)

          The current state of the configuration.

          Possible values include:
          • "ACTIVE"
          • "UPDATE_IN_PROGRESS"
          • "UPDATE_FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

putLoggingOptions(params = {}, callback) ⇒ AWS.Request

Sets logging options for IoT SiteWise.

Service Reference:

Examples:

Calling the putLoggingOptions operation

var params = {
  loggingOptions: { /* required */
    level: ERROR | INFO | OFF /* required */
  }
};
iotsitewise.putLoggingOptions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • loggingOptions — (map)

      The logging options to set.

      • levelrequired — (String)

        The IoT SiteWise logging verbosity level.

        Possible values include:
        • "ERROR"
        • "INFO"
        • "OFF"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

putStorageConfiguration(params = {}, callback) ⇒ AWS.Request

Configures storage settings for IoT SiteWise.

Service Reference:

Examples:

Calling the putStorageConfiguration operation

var params = {
  storageType: SITEWISE_DEFAULT_STORAGE | MULTI_LAYER_STORAGE, /* required */
  disassociatedDataStorage: ENABLED | DISABLED,
  multiLayerStorage: {
    customerManagedS3Storage: { /* required */
      roleArn: 'STRING_VALUE', /* required */
      s3ResourceArn: 'STRING_VALUE' /* required */
    }
  },
  retentionPeriod: {
    numberOfDays: 'NUMBER_VALUE',
    unlimited: true || false
  },
  warmTier: ENABLED | DISABLED,
  warmTierRetentionPeriod: {
    numberOfDays: 'NUMBER_VALUE',
    unlimited: true || false
  }
};
iotsitewise.putStorageConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • storageType — (String)

      The storage tier that you specified for your data. The storageType parameter can be one of the following values:

      • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.

      • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

      Possible values include:
      • "SITEWISE_DEFAULT_STORAGE"
      • "MULTI_LAYER_STORAGE"
    • multiLayerStorage — (map)

      Identifies a storage destination. If you specified MULTI_LAYER_STORAGE for the storage type, you must specify a MultiLayerStorage object.

      • customerManagedS3Storagerequired — (map)

        Contains information about a customer managed Amazon S3 bucket.

        • s3ResourceArnrequired — (String)

          The ARN of the Amazon S3 object. For more information about how to find the ARN for an Amazon S3 object, see Amazon S3 resources in the Amazon Simple Storage Service User Guide.

        • roleArnrequired — (String)

          The ARN of the Identity and Access Management role that allows IoT SiteWise to send data to Amazon S3.

    • disassociatedDataStorage — (String)

      Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

      • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

        After the disassociatedDataStorage is enabled, you can't disable it.

      • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

      For more information, see Data streams in the IoT SiteWise User Guide.

      Possible values include:
      • "ENABLED"
      • "DISABLED"
    • retentionPeriod — (map)

      The number of days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.

      • numberOfDays — (Integer)

        The number of days that your data is kept.

        Note: If you specified a value for this parameter, the unlimited parameter must be false.
      • unlimited — (Boolean)

        If true, your data is kept indefinitely.

        Note: If configured to true, you must not specify a value for the numberOfDays parameter.
    • warmTier — (String)

      A service managed storage tier optimized for analytical queries. It stores periodically uploaded, buffered and historical data ingested with the CreaeBulkImportJob API.

      Possible values include:
      • "ENABLED"
      • "DISABLED"
    • warmTierRetentionPeriod — (map)

      Set this period to specify how long your data is stored in the warm tier before it is deleted. You can set this only if cold tier is enabled.

      • numberOfDays — (Integer)

        The number of days the data is stored in the warm tier.

      • unlimited — (Boolean)

        If set to true, the data is stored indefinitely in the warm tier.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • storageType — (String)

        The storage tier that you specified for your data. The storageType parameter can be one of the following values:

        • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.

        • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

        Possible values include:
        • "SITEWISE_DEFAULT_STORAGE"
        • "MULTI_LAYER_STORAGE"
      • multiLayerStorage — (map)

        Contains information about the storage destination.

        • customerManagedS3Storagerequired — (map)

          Contains information about a customer managed Amazon S3 bucket.

          • s3ResourceArnrequired — (String)

            The ARN of the Amazon S3 object. For more information about how to find the ARN for an Amazon S3 object, see Amazon S3 resources in the Amazon Simple Storage Service User Guide.

          • roleArnrequired — (String)

            The ARN of the Identity and Access Management role that allows IoT SiteWise to send data to Amazon S3.

      • disassociatedDataStorage — (String)

        Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

        • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

          After the disassociatedDataStorage is enabled, you can't disable it.

        • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

        For more information, see Data streams in the IoT SiteWise User Guide.

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • retentionPeriod — (map)

        The number of days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.

        • numberOfDays — (Integer)

          The number of days that your data is kept.

          Note: If you specified a value for this parameter, the unlimited parameter must be false.
        • unlimited — (Boolean)

          If true, your data is kept indefinitely.

          Note: If configured to true, you must not specify a value for the numberOfDays parameter.
      • configurationStatus — (map)

        Contains current status information for the configuration.

        • staterequired — (String)

          The current state of the configuration.

          Possible values include:
          • "ACTIVE"
          • "UPDATE_IN_PROGRESS"
          • "UPDATE_FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

      • warmTier — (String)

        A service managed storage tier optimized for analytical queries. It stores periodically uploaded, buffered and historical data ingested with the CreaeBulkImportJob API.

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • warmTierRetentionPeriod — (map)

        Set this period to specify how long your data is stored in the warm tier before it is deleted. You can set this only if cold tier is enabled.

        • numberOfDays — (Integer)

          The number of days the data is stored in the warm tier.

        • unlimited — (Boolean)

          If set to true, the data is stored indefinitely in the warm tier.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

tagResource(params = {}, callback) ⇒ AWS.Request

Adds tags to an IoT SiteWise resource. If a tag already exists for the resource, this operation updates the tag's value.

Service Reference:

Examples:

Calling the tagResource operation

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tags: { /* required */
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
iotsitewise.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The ARN of the resource to tag.

    • tags — (map<String>)

      A list of key-value pairs that contain metadata for the resource. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

untagResource(params = {}, callback) ⇒ AWS.Request

Removes a tag from an IoT SiteWise resource.

Service Reference:

Examples:

Calling the untagResource operation

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tagKeys: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
iotsitewise.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The ARN of the resource to untag.

    • tagKeys — (Array<String>)

      A list of keys for tags to remove from the resource.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateAccessPolicy(params = {}, callback) ⇒ AWS.Request

Updates an existing access policy that specifies an identity's access to an IoT SiteWise Monitor portal or project resource.

Service Reference:

Examples:

Calling the updateAccessPolicy operation

var params = {
  accessPolicyId: 'STRING_VALUE', /* required */
  accessPolicyIdentity: { /* required */
    group: {
      id: 'STRING_VALUE' /* required */
    },
    iamRole: {
      arn: 'STRING_VALUE' /* required */
    },
    iamUser: {
      arn: 'STRING_VALUE' /* required */
    },
    user: {
      id: 'STRING_VALUE' /* required */
    }
  },
  accessPolicyPermission: ADMINISTRATOR | VIEWER, /* required */
  accessPolicyResource: { /* required */
    portal: {
      id: 'STRING_VALUE' /* required */
    },
    project: {
      id: 'STRING_VALUE' /* required */
    }
  },
  clientToken: 'STRING_VALUE'
};
iotsitewise.updateAccessPolicy(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • accessPolicyId — (String)

      The ID of the access policy.

    • accessPolicyIdentity — (map)

      The identity for this access policy. Choose an IAM Identity Center user, an IAM Identity Center group, or an IAM user.

      • user — (map)

        An IAM Identity Center user identity.

        • idrequired — (String)

          The IAM Identity Center ID of the user.

      • group — (map)

        An IAM Identity Center group identity.

        • idrequired — (String)

          The IAM Identity Center ID of the group.

      • iamUser — (map)

        An IAM user identity.

        • arnrequired — (String)

          The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide.

          Note: If you delete the IAM user, access policies that contain this identity include an empty arn. You can delete the access policy for the IAM user that no longer exists.
      • iamRole — (map)

        An IAM role identity.

        • arnrequired — (String)

          The ARN of the IAM role. For more information, see IAM ARNs in the IAM User Guide.

    • accessPolicyResource — (map)

      The IoT SiteWise Monitor resource for this access policy. Choose either a portal or a project.

      • portal — (map)

        A portal resource.

        • idrequired — (String)

          The ID of the portal.

      • project — (map)

        A project resource.

        • idrequired — (String)

          The ID of the project.

    • accessPolicyPermission — (String)

      The permission level for this access policy. Note that a project ADMINISTRATOR is also known as a project owner.

      Possible values include:
      • "ADMINISTRATOR"
      • "VIEWER"
    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateAsset(params = {}, callback) ⇒ AWS.Request

Updates an asset's name. For more information, see Updating assets and models in the IoT SiteWise User Guide.

Service Reference:

Examples:

Calling the updateAsset operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  assetName: 'STRING_VALUE', /* required */
  assetDescription: 'STRING_VALUE',
  assetExternalId: 'STRING_VALUE',
  clientToken: 'STRING_VALUE'
};
iotsitewise.updateAsset(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset to update. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • assetName — (String)

      A friendly name for the asset.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • assetDescription — (String)

      A description for the asset.

    • assetExternalId — (String)

      An external ID to assign to the asset. The asset must not already have an external ID. The external ID must be unique within your Amazon Web Services account. For more information, see Using external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetStatus — (map)

        The status of the asset, which contains a state (UPDATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateAssetModel(params = {}, callback) ⇒ AWS.Request

Updates an asset model and all of the assets that were created from the model. Each asset created from the model inherits the updated asset model's property and hierarchy definitions. For more information, see Updating assets and models in the IoT SiteWise User Guide.

This operation overwrites the existing model with the provided model. To avoid deleting your asset model's properties or hierarchies, you must include their IDs and definitions in the updated asset model payload. For more information, see DescribeAssetModel.

If you remove a property from an asset model, IoT SiteWise deletes all previous data for that property. If you remove a hierarchy definition from an asset model, IoT SiteWise disassociates every asset associated with that hierarchy. You can't change the type or data type of an existing property.

Service Reference:

Examples:

Calling the updateAssetModel operation

var params = {
  assetModelId: 'STRING_VALUE', /* required */
  assetModelName: 'STRING_VALUE', /* required */
  assetModelCompositeModels: [
    {
      name: 'STRING_VALUE', /* required */
      type: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      properties: [
        {
          dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
          name: 'STRING_VALUE', /* required */
          type: { /* required */
            attribute: {
              defaultValue: 'STRING_VALUE'
            },
            measurement: {
              processingConfig: {
                forwardingConfig: { /* required */
                  state: DISABLED | ENABLED /* required */
                }
              }
            },
            metric: {
              expression: 'STRING_VALUE', /* required */
              variables: [ /* required */
                {
                  name: 'STRING_VALUE', /* required */
                  value: { /* required */
                    hierarchyId: 'STRING_VALUE',
                    propertyId: 'STRING_VALUE',
                    propertyPath: [
                      {
                        id: 'STRING_VALUE',
                        name: 'STRING_VALUE'
                      },
                      /* more items */
                    ]
                  }
                },
                /* more items */
              ],
              window: { /* required */
                tumbling: {
                  interval: 'STRING_VALUE', /* required */
                  offset: 'STRING_VALUE'
                }
              },
              processingConfig: {
                computeLocation: EDGE | CLOUD /* required */
              }
            },
            transform: {
              expression: 'STRING_VALUE', /* required */
              variables: [ /* required */
                {
                  name: 'STRING_VALUE', /* required */
                  value: { /* required */
                    hierarchyId: 'STRING_VALUE',
                    propertyId: 'STRING_VALUE',
                    propertyPath: [
                      {
                        id: 'STRING_VALUE',
                        name: 'STRING_VALUE'
                      },
                      /* more items */
                    ]
                  }
                },
                /* more items */
              ],
              processingConfig: {
                computeLocation: EDGE | CLOUD, /* required */
                forwardingConfig: {
                  state: DISABLED | ENABLED /* required */
                }
              }
            }
          },
          dataTypeSpec: 'STRING_VALUE',
          externalId: 'STRING_VALUE',
          id: 'STRING_VALUE',
          path: [
            {
              id: 'STRING_VALUE',
              name: 'STRING_VALUE'
            },
            /* more items */
          ],
          unit: 'STRING_VALUE'
        },
        /* more items */
      ]
    },
    /* more items */
  ],
  assetModelDescription: 'STRING_VALUE',
  assetModelExternalId: 'STRING_VALUE',
  assetModelHierarchies: [
    {
      childAssetModelId: 'STRING_VALUE', /* required */
      name: 'STRING_VALUE', /* required */
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE'
    },
    /* more items */
  ],
  assetModelProperties: [
    {
      dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        attribute: {
          defaultValue: 'STRING_VALUE'
        },
        measurement: {
          processingConfig: {
            forwardingConfig: { /* required */
              state: DISABLED | ENABLED /* required */
            }
          }
        },
        metric: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          window: { /* required */
            tumbling: {
              interval: 'STRING_VALUE', /* required */
              offset: 'STRING_VALUE'
            }
          },
          processingConfig: {
            computeLocation: EDGE | CLOUD /* required */
          }
        },
        transform: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          processingConfig: {
            computeLocation: EDGE | CLOUD, /* required */
            forwardingConfig: {
              state: DISABLED | ENABLED /* required */
            }
          }
        }
      },
      dataTypeSpec: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      path: [
        {
          id: 'STRING_VALUE',
          name: 'STRING_VALUE'
        },
        /* more items */
      ],
      unit: 'STRING_VALUE'
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE'
};
iotsitewise.updateAssetModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model to update. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • assetModelName — (String)

      A unique, friendly name for the asset model.

    • assetModelDescription — (String)

      A description for the asset model.

    • assetModelProperties — (Array<map>)

      The updated property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

      You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

      • id — (String)

        The ID of the asset model property.

        • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

        • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the asset model property.

      • dataTyperequired — (String)

        The data type of the asset model property.

        Possible values include:
        • "STRING"
        • "INTEGER"
        • "DOUBLE"
        • "BOOLEAN"
        • "STRUCT"
      • dataTypeSpec — (String)

        The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

      • unit — (String)

        The unit of the asset model property, such as Newtons or RPM.

      • typerequired — (map)

        The property type (see PropertyType).

        • attribute — (map)

          Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

          • defaultValue — (String)

            The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

        • measurement — (map)

          Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

          • processingConfig — (map)

            The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

            • forwardingConfigrequired — (map)

              The forwarding configuration for the given measurement property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • transform — (map)

          Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

          • expressionrequired — (String)

            The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • processingConfig — (map)

            The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

            • computeLocationrequired — (String)

              The compute location for the given transform property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
            • forwardingConfig — (map)

              The forwarding configuration for a given property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • metric — (map)

          Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

          • expressionrequired — (String)

            The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • windowrequired — (map)

            The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

            • tumbling — (map)

              The tumbling time interval window.

              • intervalrequired — (String)

                The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

              • offset — (String)

                The offset for the tumbling window. The offset parameter accepts the following:

                • The offset time.

                  For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The ISO 8601 format.

                  For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The 24-hour clock.

                  For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                • The offset time zone.

                  For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                  • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

          • processingConfig — (map)

            The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

            • computeLocationrequired — (String)

              The compute location for the given metric property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
      • path — (Array<map>)

        The structured path to the property from the root of the asset model.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • externalId — (String)

        The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • assetModelHierarchies — (Array<map>)

      The updated hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

      You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

      • id — (String)

        The ID of the asset model hierarchy. This ID is a hierarchyId.

        • If you are callling UpdateAssetModel to create a new hierarchy: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

        • If you are calling UpdateAssetModel to modify an existing hierarchy: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the asset model hierarchy that you specify by using the CreateAssetModel or UpdateAssetModel API operation.

      • childAssetModelIdrequired — (String)

        The ID of the asset model, in UUID format. All assets in this hierarchy must be instances of the childAssetModelId asset model. IoT SiteWise will always return the actual asset model ID for this value. However, when you are specifying this value as part of a call to UpdateAssetModel, you may provide either the asset model ID or else externalId: followed by the asset model's external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • externalId — (String)

        The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • assetModelCompositeModels — (Array<map>)

      The composite models that are part of this asset model. It groups properties (such as attributes, measurements, transforms, and metrics) and child composite models that model parts of your industrial equipment. Each composite model has a type that defines the properties that the composite model supports. Use composite models to define alarms on this asset model.

      Note: When creating custom composite models, you need to use CreateAssetModelCompositeModel. For more information, see <LINK>.
      • namerequired — (String)

        The name of the composite model.

      • description — (String)

        The description of the composite model.

      • typerequired — (String)

        The type of the composite model. For alarm composite models, this type is AWS/ALARM.

      • properties — (Array<map>)

        The asset property definitions for this composite model.

        • id — (String)

          The ID of the asset model property.

          • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model property.

        • dataTyperequired — (String)

          The data type of the asset model property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit of the asset model property, such as Newtons or RPM.

        • typerequired — (map)

          The property type (see PropertyType).

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • id — (String)

        The ID of the asset model composite model.

      • externalId — (String)

        The external ID of the asset model composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • assetModelExternalId — (String)

      An external ID to assign to the asset model. The asset model must not already have an external ID. The external ID must be unique within your Amazon Web Services account. For more information, see Using external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelStatus — (map)

        The status of the asset model, which contains a state (UPDATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateAssetModelCompositeModel(params = {}, callback) ⇒ AWS.Request

Updates a composite model and all of the assets that were created from the model. Each asset created from the model inherits the updated asset model's property and hierarchy definitions. For more information, see Updating assets and models in the IoT SiteWise User Guide.

If you remove a property from a composite asset model, IoT SiteWise deletes all previous data for that property. You can’t change the type or data type of an existing property.

To replace an existing composite asset model property with a new one with the same name, do the following:

  1. Submit an UpdateAssetModelCompositeModel request with the entire existing property removed.

  2. Submit a second UpdateAssetModelCompositeModel request that includes the new property. The new asset property will have the same name as the previous one and IoT SiteWise will generate a new unique id.

Service Reference:

Examples:

Calling the updateAssetModelCompositeModel operation

var params = {
  assetModelCompositeModelId: 'STRING_VALUE', /* required */
  assetModelCompositeModelName: 'STRING_VALUE', /* required */
  assetModelId: 'STRING_VALUE', /* required */
  assetModelCompositeModelDescription: 'STRING_VALUE',
  assetModelCompositeModelExternalId: 'STRING_VALUE',
  assetModelCompositeModelProperties: [
    {
      dataType: STRING | INTEGER | DOUBLE | BOOLEAN | STRUCT, /* required */
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        attribute: {
          defaultValue: 'STRING_VALUE'
        },
        measurement: {
          processingConfig: {
            forwardingConfig: { /* required */
              state: DISABLED | ENABLED /* required */
            }
          }
        },
        metric: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          window: { /* required */
            tumbling: {
              interval: 'STRING_VALUE', /* required */
              offset: 'STRING_VALUE'
            }
          },
          processingConfig: {
            computeLocation: EDGE | CLOUD /* required */
          }
        },
        transform: {
          expression: 'STRING_VALUE', /* required */
          variables: [ /* required */
            {
              name: 'STRING_VALUE', /* required */
              value: { /* required */
                hierarchyId: 'STRING_VALUE',
                propertyId: 'STRING_VALUE',
                propertyPath: [
                  {
                    id: 'STRING_VALUE',
                    name: 'STRING_VALUE'
                  },
                  /* more items */
                ]
              }
            },
            /* more items */
          ],
          processingConfig: {
            computeLocation: EDGE | CLOUD, /* required */
            forwardingConfig: {
              state: DISABLED | ENABLED /* required */
            }
          }
        }
      },
      dataTypeSpec: 'STRING_VALUE',
      externalId: 'STRING_VALUE',
      id: 'STRING_VALUE',
      path: [
        {
          id: 'STRING_VALUE',
          name: 'STRING_VALUE'
        },
        /* more items */
      ],
      unit: 'STRING_VALUE'
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE'
};
iotsitewise.updateAssetModelCompositeModel(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetModelId — (String)

      The ID of the asset model, in UUID format.

    • assetModelCompositeModelId — (String)

      The ID of a composite model on this asset model.

    • assetModelCompositeModelExternalId — (String)

      An external ID to assign to the asset model. You can only set the external ID of the asset model if it wasn't set when it was created, or you're setting it to the exact same thing as when it was created.

    • assetModelCompositeModelDescription — (String)

      A description for the composite model.

    • assetModelCompositeModelName — (String)

      A unique, friendly name for the composite model.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • assetModelCompositeModelProperties — (Array<map>)

      The property definitions of the composite model. For more information, see <LINK>.

      You can specify up to 200 properties per composite model. For more information, see Quotas in the IoT SiteWise User Guide.

      • id — (String)

        The ID of the asset model property.

        • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

        • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

      • namerequired — (String)

        The name of the asset model property.

      • dataTyperequired — (String)

        The data type of the asset model property.

        Possible values include:
        • "STRING"
        • "INTEGER"
        • "DOUBLE"
        • "BOOLEAN"
        • "STRUCT"
      • dataTypeSpec — (String)

        The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

      • unit — (String)

        The unit of the asset model property, such as Newtons or RPM.

      • typerequired — (map)

        The property type (see PropertyType).

        • attribute — (map)

          Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

          • defaultValue — (String)

            The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

        • measurement — (map)

          Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

          • processingConfig — (map)

            The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

            • forwardingConfigrequired — (map)

              The forwarding configuration for the given measurement property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • transform — (map)

          Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

          • expressionrequired — (String)

            The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • processingConfig — (map)

            The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

            • computeLocationrequired — (String)

              The compute location for the given transform property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
            • forwardingConfig — (map)

              The forwarding configuration for a given property.

              • staterequired — (String)

                The forwarding state for the given property.

                Possible values include:
                • "DISABLED"
                • "ENABLED"
        • metric — (map)

          Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

          • expressionrequired — (String)

            The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

            For more information, see Quotas in the IoT SiteWise User Guide.

          • variablesrequired — (Array<map>)

            The list of variables used in the expression.

            • namerequired — (String)

              The friendly name of the variable to be used in the expression.

            • valuerequired — (map)

              The variable that identifies an asset property from which to use values.

              • propertyId — (String)

                The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

              • hierarchyId — (String)

                The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

              • propertyPath — (Array<map>)

                The path of the property.

                • id — (String)

                  The ID of the path segment.

                • name — (String)

                  The name of the path segment.

          • windowrequired — (map)

            The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

            • tumbling — (map)

              The tumbling time interval window.

              • intervalrequired — (String)

                The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

              • offset — (String)

                The offset for the tumbling window. The offset parameter accepts the following:

                • The offset time.

                  For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The ISO 8601 format.

                  For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                  • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                • The 24-hour clock.

                  For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                • The offset time zone.

                  For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                  • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                  • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

          • processingConfig — (map)

            The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

            • computeLocationrequired — (String)

              The compute location for the given metric property.

              Possible values include:
              • "EDGE"
              • "CLOUD"
      • path — (Array<map>)

        The structured path to the property from the root of the asset model.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • externalId — (String)

        The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelCompositeModelPath — (Array<map>)

        The path to the composite model listing the parent composite models.

        • id — (String)

          The ID of the path segment.

        • name — (String)

          The name of the path segment.

      • assetModelStatus — (map)

        Contains current status information for an asset model. For more information, see Asset and model states in the IoT SiteWise User Guide.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateAssetProperty(params = {}, callback) ⇒ AWS.Request

Updates an asset property's alias and notification state.

This operation overwrites the property's existing alias and notification state. To keep your existing property's alias or notification state, you must include the existing values in the UpdateAssetProperty request. For more information, see DescribeAssetProperty.

Service Reference:

Examples:

Calling the updateAssetProperty operation

var params = {
  assetId: 'STRING_VALUE', /* required */
  propertyId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  propertyAlias: 'STRING_VALUE',
  propertyNotificationState: ENABLED | DISABLED,
  propertyUnit: 'STRING_VALUE'
};
iotsitewise.updateAssetProperty(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • assetId — (String)

      The ID of the asset to be updated. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyId — (String)

      The ID of the asset property to be updated. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • propertyAlias — (String)

      The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

      If you omit this parameter, the alias is removed from the property.

    • propertyNotificationState — (String)

      The MQTT notification state (enabled or disabled) for this asset property. When the notification state is enabled, IoT SiteWise publishes property value updates to a unique MQTT topic. For more information, see Interacting with other services in the IoT SiteWise User Guide.

      If you omit this parameter, the notification state is set to DISABLED.

      Possible values include:
      • "ENABLED"
      • "DISABLED"
    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • propertyUnit — (String)

      The unit of measure (such as Newtons or RPM) of the asset property. If you don't specify a value for this parameter, the service uses the value of the assetModelProperty in the asset model.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateDashboard(params = {}, callback) ⇒ AWS.Request

Updates an IoT SiteWise Monitor dashboard.

Service Reference:

Examples:

Calling the updateDashboard operation

var params = {
  dashboardDefinition: 'STRING_VALUE', /* required */
  dashboardId: 'STRING_VALUE', /* required */
  dashboardName: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  dashboardDescription: 'STRING_VALUE'
};
iotsitewise.updateDashboard(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • dashboardId — (String)

      The ID of the dashboard to update.

    • dashboardName — (String)

      A new friendly name for the dashboard.

    • dashboardDescription — (String)

      A new description for the dashboard.

    • dashboardDefinition — (String)

      The new dashboard definition, as specified in a JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateGateway(params = {}, callback) ⇒ AWS.Request

Updates a gateway's name.

Service Reference:

Examples:

Calling the updateGateway operation

var params = {
  gatewayId: 'STRING_VALUE', /* required */
  gatewayName: 'STRING_VALUE' /* required */
};
iotsitewise.updateGateway(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayId — (String)

      The ID of the gateway to update.

    • gatewayName — (String)

      A unique, friendly name for the gateway.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateGatewayCapabilityConfiguration(params = {}, callback) ⇒ AWS.Request

Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Examples:

Calling the updateGatewayCapabilityConfiguration operation

var params = {
  capabilityConfiguration: 'STRING_VALUE', /* required */
  capabilityNamespace: 'STRING_VALUE', /* required */
  gatewayId: 'STRING_VALUE' /* required */
};
iotsitewise.updateGatewayCapabilityConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • gatewayId — (String)

      The ID of the gateway to be updated.

    • capabilityNamespace — (String)

      The namespace of the gateway capability configuration to be updated. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

    • capabilityConfiguration — (String)

      The JSON document that defines the configuration for the gateway capability. For more information, see Configuring data sources (CLI) in the IoT SiteWise User Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • capabilityNamespace — (String)

        The namespace of the gateway capability.

      • capabilitySyncStatus — (String)

        The synchronization status of the capability configuration. The sync status can be one of the following:

        • IN_SYNC – The gateway is running the capability configuration.

        • OUT_OF_SYNC – The gateway hasn't received the capability configuration.

        • SYNC_FAILED – The gateway rejected the capability configuration.

        After you update a capability configuration, its sync status is OUT_OF_SYNC until the gateway receives and applies or rejects the updated configuration.

        Possible values include:
        • "IN_SYNC"
        • "OUT_OF_SYNC"
        • "SYNC_FAILED"
        • "UNKNOWN"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updatePortal(params = {}, callback) ⇒ AWS.Request

Updates an IoT SiteWise Monitor portal.

Service Reference:

Examples:

Calling the updatePortal operation

var params = {
  portalContactEmail: 'STRING_VALUE', /* required */
  portalId: 'STRING_VALUE', /* required */
  portalName: 'STRING_VALUE', /* required */
  roleArn: 'STRING_VALUE', /* required */
  alarms: {
    alarmRoleArn: 'STRING_VALUE', /* required */
    notificationLambdaArn: 'STRING_VALUE'
  },
  clientToken: 'STRING_VALUE',
  notificationSenderEmail: 'STRING_VALUE',
  portalDescription: 'STRING_VALUE',
  portalLogoImage: {
    file: {
      data: Buffer.from('...') || 'STRING_VALUE' /* Strings will be Base-64 encoded on your behalf */, /* required */
      type: PNG /* required */
    },
    id: 'STRING_VALUE'
  }
};
iotsitewise.updatePortal(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • portalId — (String)

      The ID of the portal to update.

    • portalName — (String)

      A new friendly name for the portal.

    • portalDescription — (String)

      A new description for the portal.

    • portalContactEmail — (String)

      The Amazon Web Services administrator's contact email address.

    • portalLogoImage — (map)

      Contains an image that is one of the following:

      • An image file. Choose this option to upload a new image.

      • The ID of an existing image. Choose this option to keep an existing image.

      • id — (String)

        The ID of an existing image. Specify this parameter to keep an existing image.

      • file — (map)

        Contains an image file.

        • datarequired — (Buffer, Typed Array, Blob, String)

          The image file contents, represented as a base64-encoded string. The file size must be less than 1 MB.

        • typerequired — (String)

          The file type of the image.

          Possible values include:
          • "PNG"
    • roleArn — (String)

      The ARN of a service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.
    • notificationSenderEmail — (String)

      The email address that sends alarm notifications.

    • alarms — (map)

      Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal. You can use the alarm to monitor an asset property and get notified when the asset property value is outside a specified range. For more information, see Monitoring with alarms in the IoT SiteWise Application Guide.

      • alarmRoleArnrequired — (String)

        The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

      • notificationLambdaArn — (String)

        The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalStatus — (map)

        The status of the portal, which contains a state (UPDATING after successfully calling this operation) and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateProject(params = {}, callback) ⇒ AWS.Request

Updates an IoT SiteWise Monitor project.

Service Reference:

Examples:

Calling the updateProject operation

var params = {
  projectId: 'STRING_VALUE', /* required */
  projectName: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  projectDescription: 'STRING_VALUE'
};
iotsitewise.updateProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectId — (String)

      The ID of the project to update.

    • projectName — (String)

      A new friendly name for the project.

    • projectDescription — (String)

      A new description for the project.

    • clientToken — (String)

      A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

waitFor(state, params = {}, callback) ⇒ AWS.Request

Waits for a given IoTSiteWise resource. The final callback or 'complete' event will be fired only when the resource is either in its final state or the waiter has timed out and stopped polling for the final state.

Examples:

Waiting for the assetModelNotExists state

var params = {
  assetModelId: 'STRING_VALUE', /* required */
};
iotsitewise.waitFor('assetModelNotExists', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • state (String)

    the resource state to wait for. Available states for this service are listed in "Waiter Resource States" below.

  • params (map) (defaults to: {})

    a list of parameters for the given state. See each waiter resource state for required parameters.

Callback (callback):

  • function(err, data) { ... }

    Callback containing error and data information. See the respective resource state for the expected error or data information.

    If the waiter times out its requests, it will return a ResourceNotReady error.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

Waiter Resource States:

Waiter Resource Details

iotsitewise.waitFor('assetModelNotExists', params = {}, [callback]) ⇒ AWS.Request

Waits for the assetModelNotExists state by periodically calling the underlying IoTSiteWise.describeAssetModel() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the assetModelNotExists state

var params = {
  assetModelId: 'STRING_VALUE', /* required */
};
iotsitewise.waitFor('assetModelNotExists', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset model properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelId — (String)

        The ID of the asset model, in UUID format.

      • assetModelArn — (String)

        The ARN of the asset model, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

      • assetModelName — (String)

        The name of the asset model.

      • assetModelDescription — (String)

        The asset model's description.

      • assetModelProperties — (Array<map>)

        The list of asset properties for the asset model.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetModelCompositeModels object.

        • id — (String)

          The ID of the asset model property.

          • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model property.

        • dataTyperequired — (String)

          The data type of the asset model property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit of the asset model property, such as Newtons or RPM.

        • typerequired — (map)

          The property type (see PropertyType).

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelHierarchies — (Array<map>)

        A list of asset model hierarchies that each contain a childAssetModelId and a hierarchyId (named id). A hierarchy specifies allowed parent/child asset relationships for an asset model.

        • id — (String)

          The ID of the asset model hierarchy. This ID is a hierarchyId.

          • If you are callling UpdateAssetModel to create a new hierarchy: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing hierarchy: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model hierarchy that you specify by using the CreateAssetModel or UpdateAssetModel API operation.

        • childAssetModelIdrequired — (String)

          The ID of the asset model, in UUID format. All assets in this hierarchy must be instances of the childAssetModelId asset model. IoT SiteWise will always return the actual asset model ID for this value. However, when you are specifying this value as part of a call to UpdateAssetModel, you may provide either the asset model ID or else externalId: followed by the asset model's external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCompositeModels — (Array<map>)

        The list of built-in composite models for the asset model, such as those with those of type AWS/ALARMS.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • properties — (Array<map>)

          The asset property definitions for this composite model.

          • id — (String)

            The ID of the asset model property.

            • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

            • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

          • namerequired — (String)

            The name of the asset model property.

          • dataTyperequired — (String)

            The data type of the asset model property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit of the asset model property, such as Newtons or RPM.

          • typerequired — (map)

            The property type (see PropertyType).

            • attribute — (map)

              Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

              • defaultValue — (String)

                The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

            • measurement — (map)

              Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

              • processingConfig — (map)

                The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

                • forwardingConfigrequired — (map)

                  The forwarding configuration for the given measurement property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • transform — (map)

              Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

              • expressionrequired — (String)

                The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • processingConfig — (map)

                The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given transform property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
                • forwardingConfig — (map)

                  The forwarding configuration for a given property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • metric — (map)

              Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

              • expressionrequired — (String)

                The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • windowrequired — (map)

                The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

                • tumbling — (map)

                  The tumbling time interval window.

                  • intervalrequired — (String)

                    The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                    IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                    When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                  • offset — (String)

                    The offset for the tumbling window. The offset parameter accepts the following:

                    • The offset time.

                      For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The ISO 8601 format.

                      For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The 24-hour clock.

                      For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                    • The offset time zone.

                      For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                      • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

              • processingConfig — (map)

                The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given metric property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
          • path — (Array<map>)

            The structured path to the property from the root of the asset model.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset model composite model.

        • externalId — (String)

          The external ID of the asset model composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCreationDate — (Date)

        The date the asset model was created, in Unix epoch time.

      • assetModelLastUpdateDate — (Date)

        The date the asset model was last updated, in Unix epoch time.

      • assetModelStatus — (map)

        The current status of the asset model, which contains a state and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetModelType — (String)

        The type of asset model.

        • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

        • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        Possible values include:
        • "ASSET_MODEL"
        • "COMPONENT_MODEL"
      • assetModelCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset model.

        • idrequired — (String)

          The ID of the the composite model that this summary describes..

        • externalId — (String)

          The external ID of a composite model on this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the the composite model that this summary describes..

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • description — (String)

          The description of the the composite model that this summary describes..

        • path — (Array<map>)

          The path that includes all the pieces that make up the composite model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetModelExternalId — (String)

        The external ID of the asset model, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also:

iotsitewise.waitFor('assetModelActive', params = {}, [callback]) ⇒ AWS.Request

Waits for the assetModelActive state by periodically calling the underlying IoTSiteWise.describeAssetModel() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the assetModelActive state

var params = {
  assetModelId: 'STRING_VALUE', /* required */
};
iotsitewise.waitFor('assetModelActive', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • assetModelId — (String)

      The ID of the asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset model properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetModelId — (String)

        The ID of the asset model, in UUID format.

      • assetModelArn — (String)

        The ARN of the asset model, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

      • assetModelName — (String)

        The name of the asset model.

      • assetModelDescription — (String)

        The asset model's description.

      • assetModelProperties — (Array<map>)

        The list of asset properties for the asset model.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetModelCompositeModels object.

        • id — (String)

          The ID of the asset model property.

          • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model property.

        • dataTyperequired — (String)

          The data type of the asset model property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit of the asset model property, such as Newtons or RPM.

        • typerequired — (map)

          The property type (see PropertyType).

          • attribute — (map)

            Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

            • defaultValue — (String)

              The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

          • measurement — (map)

            Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

            • processingConfig — (map)

              The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

              • forwardingConfigrequired — (map)

                The forwarding configuration for the given measurement property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • transform — (map)

            Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

            • expressionrequired — (String)

              The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • processingConfig — (map)

              The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

              • computeLocationrequired — (String)

                The compute location for the given transform property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
              • forwardingConfig — (map)

                The forwarding configuration for a given property.

                • staterequired — (String)

                  The forwarding state for the given property.

                  Possible values include:
                  • "DISABLED"
                  • "ENABLED"
          • metric — (map)

            Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

            • expressionrequired — (String)

              The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

              For more information, see Quotas in the IoT SiteWise User Guide.

            • variablesrequired — (Array<map>)

              The list of variables used in the expression.

              • namerequired — (String)

                The friendly name of the variable to be used in the expression.

              • valuerequired — (map)

                The variable that identifies an asset property from which to use values.

                • propertyId — (String)

                  The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                • hierarchyId — (String)

                  The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                • propertyPath — (Array<map>)

                  The path of the property.

                  • id — (String)

                    The ID of the path segment.

                  • name — (String)

                    The name of the path segment.

            • windowrequired — (map)

              The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

              • tumbling — (map)

                The tumbling time interval window.

                • intervalrequired — (String)

                  The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                  IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                  When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                • offset — (String)

                  The offset for the tumbling window. The offset parameter accepts the following:

                  • The offset time.

                    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The ISO 8601 format.

                    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                    • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                  • The 24-hour clock.

                    For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                  • The offset time zone.

                    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                    • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                    • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

            • processingConfig — (map)

              The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

              • computeLocationrequired — (String)

                The compute location for the given metric property.

                Possible values include:
                • "EDGE"
                • "CLOUD"
        • path — (Array<map>)

          The structured path to the property from the root of the asset model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelHierarchies — (Array<map>)

        A list of asset model hierarchies that each contain a childAssetModelId and a hierarchyId (named id). A hierarchy specifies allowed parent/child asset relationships for an asset model.

        • id — (String)

          The ID of the asset model hierarchy. This ID is a hierarchyId.

          • If you are callling UpdateAssetModel to create a new hierarchy: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

          • If you are calling UpdateAssetModel to modify an existing hierarchy: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the asset model hierarchy that you specify by using the CreateAssetModel or UpdateAssetModel API operation.

        • childAssetModelIdrequired — (String)

          The ID of the asset model, in UUID format. All assets in this hierarchy must be instances of the childAssetModelId asset model. IoT SiteWise will always return the actual asset model ID for this value. However, when you are specifying this value as part of a call to UpdateAssetModel, you may provide either the asset model ID or else externalId: followed by the asset model's external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • externalId — (String)

          The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCompositeModels — (Array<map>)

        The list of built-in composite models for the asset model, such as those with those of type AWS/ALARMS.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • properties — (Array<map>)

          The asset property definitions for this composite model.

          • id — (String)

            The ID of the asset model property.

            • If you are callling UpdateAssetModel to create a new property: You can specify its ID here, if desired. IoT SiteWise automatically generates a unique ID for you, so this parameter is never required. However, if you prefer to supply your own ID instead, you can specify it here in UUID format. If you specify your own ID, it must be globally unique.

            • If you are calling UpdateAssetModel to modify an existing property: This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

          • namerequired — (String)

            The name of the asset model property.

          • dataTyperequired — (String)

            The data type of the asset model property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit of the asset model property, such as Newtons or RPM.

          • typerequired — (map)

            The property type (see PropertyType).

            • attribute — (map)

              Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

              • defaultValue — (String)

                The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

            • measurement — (map)

              Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

              • processingConfig — (map)

                The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

                • forwardingConfigrequired — (map)

                  The forwarding configuration for the given measurement property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • transform — (map)

              Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

              • expressionrequired — (String)

                The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • processingConfig — (map)

                The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given transform property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
                • forwardingConfig — (map)

                  The forwarding configuration for a given property.

                  • staterequired — (String)

                    The forwarding state for the given property.

                    Possible values include:
                    • "DISABLED"
                    • "ENABLED"
            • metric — (map)

              Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

              • expressionrequired — (String)

                The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

                For more information, see Quotas in the IoT SiteWise User Guide.

              • variablesrequired — (Array<map>)

                The list of variables used in the expression.

                • namerequired — (String)

                  The friendly name of the variable to be used in the expression.

                • valuerequired — (map)

                  The variable that identifies an asset property from which to use values.

                  • propertyId — (String)

                    The ID of the property to use as the variable. You can use the property name if it's from the same asset model. If the property has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                  • hierarchyId — (String)

                    The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID. If the hierarchy has an external ID, you can specify externalId: followed by the external ID. For more information, see Using external IDs in the IoT SiteWise User Guide.

                    You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

                  • propertyPath — (Array<map>)

                    The path of the property.

                    • id — (String)

                      The ID of the path segment.

                    • name — (String)

                      The name of the path segment.

              • windowrequired — (map)

                The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

                • tumbling — (map)

                  The tumbling time interval window.

                  • intervalrequired — (String)

                    The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

                    IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

                    When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

                  • offset — (String)

                    The offset for the tumbling window. The offset parameter accepts the following:

                    • The offset time.

                      For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The ISO 8601 format.

                      For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.

                      • If you create the metric after 6 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.

                    • The 24-hour clock.

                      For example, if you specify 00:03:00 for offset, 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

                    • The offset time zone.

                      For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

                      • If you create the metric before or at 6 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.

                      • If you create the metric after 6 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

              • processingConfig — (map)

                The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

                • computeLocationrequired — (String)

                  The compute location for the given metric property.

                  Possible values include:
                  • "EDGE"
                  • "CLOUD"
          • path — (Array<map>)

            The structured path to the property from the root of the asset model.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID (if any) provided in the CreateAssetModel or UpdateAssetModel operation. You can assign an external ID by specifying this value as part of a call to UpdateAssetModel. However, you can't change the external ID if one is already assigned. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset model composite model.

        • externalId — (String)

          The external ID of the asset model composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetModelCreationDate — (Date)

        The date the asset model was created, in Unix epoch time.

      • assetModelLastUpdateDate — (Date)

        The date the asset model was last updated, in Unix epoch time.

      • assetModelStatus — (map)

        The current status of the asset model, which contains a state and any error message.

        • staterequired — (String)

          The current state of the asset model.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "PROPAGATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetModelType — (String)

        The type of asset model.

        • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

        • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        Possible values include:
        • "ASSET_MODEL"
        • "COMPONENT_MODEL"
      • assetModelCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset model.

        • idrequired — (String)

          The ID of the the composite model that this summary describes..

        • externalId — (String)

          The external ID of a composite model on this asset model. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • namerequired — (String)

          The name of the the composite model that this summary describes..

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • description — (String)

          The description of the the composite model that this summary describes..

        • path — (Array<map>)

          The path that includes all the pieces that make up the composite model.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetModelExternalId — (String)

        The external ID of the asset model, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also:

iotsitewise.waitFor('assetNotExists', params = {}, [callback]) ⇒ AWS.Request

Waits for the assetNotExists state by periodically calling the underlying IoTSiteWise.describeAsset() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the assetNotExists state

var params = {
  assetId: 'STRING_VALUE', /* required */
};
iotsitewise.waitFor('assetNotExists', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format.

      • assetArn — (String)

        The ARN of the asset, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

      • assetName — (String)

        The name of the asset.

      • assetModelId — (String)

        The ID of the asset model that was used to create the asset.

      • assetProperties — (Array<map>)

        The list of asset properties for the asset.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetCompositeModels object.

        • idrequired — (String)

          The ID of the asset property.

        • namerequired — (String)

          The name of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • notification — (map)

          The asset property's notification topic and state. For more information, see UpdateAssetProperty.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • dataTyperequired — (String)

          The data type of the asset property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit (such as Newtons or RPM) of the asset property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetHierarchies — (Array<map>)

        A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

        • id — (String)

          The ID of the hierarchy. This ID is a hierarchyId.

        • namerequired — (String)

          The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

        • externalId — (String)

          The external ID of the hierarchy, if it has one. When you update an asset hierarchy, you may assign an external ID if it doesn't already have one. You can't change the external ID of an asset hierarchy that already has one. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCompositeModels — (Array<map>)

        The composite models for the asset.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • propertiesrequired — (Array<map>)

          The asset properties that this composite model defines.

          • idrequired — (String)

            The ID of the asset property.

          • namerequired — (String)

            The name of the property.

          • alias — (String)

            The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

          • notification — (map)

            The asset property's notification topic and state. For more information, see UpdateAssetProperty.

            • topicrequired — (String)

              The MQTT topic to which IoT SiteWise publishes property value update notifications.

            • staterequired — (String)

              The current notification state.

              Possible values include:
              • "ENABLED"
              • "DISABLED"
          • dataTyperequired — (String)

            The data type of the asset property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit (such as Newtons or RPM) of the asset property.

          • path — (Array<map>)

            The structured path to the property from the root of the asset.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset composite model.

        • externalId — (String)

          The external ID of the asset composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCreationDate — (Date)

        The date the asset was created, in Unix epoch time.

      • assetLastUpdateDate — (Date)

        The date the asset was last updated, in Unix epoch time.

      • assetStatus — (map)

        The current status of the asset, which contains a state and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetDescription — (String)

        A description for the asset.

      • assetCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset.

        • idrequired — (String)

          The ID of the composite model that this summary describes.

        • externalId — (String)

          An external ID to assign to the asset model.

          If the composite model is a derived composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

        • namerequired — (String)

          The name of the composite model that this summary describes.

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • descriptionrequired — (String)

          A description of the composite model that this summary describes.

        • pathrequired — (Array<map>)

          The path that includes all the components of the asset model for the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetExternalId — (String)

        The external ID of the asset, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also:

iotsitewise.waitFor('assetActive', params = {}, [callback]) ⇒ AWS.Request

Waits for the assetActive state by periodically calling the underlying IoTSiteWise.describeAsset() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the assetActive state

var params = {
  assetId: 'STRING_VALUE', /* required */
};
iotsitewise.waitFor('assetActive', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • assetId — (String)

      The ID of the asset. This can be either the actual ID in UUID format, or else externalId: followed by the external ID, if it has one. For more information, see Referencing objects with external IDs in the IoT SiteWise User Guide.

    • excludeProperties — (Boolean)

      Whether or not to exclude asset properties from the response.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • assetId — (String)

        The ID of the asset, in UUID format.

      • assetArn — (String)

        The ARN of the asset, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

      • assetName — (String)

        The name of the asset.

      • assetModelId — (String)

        The ID of the asset model that was used to create the asset.

      • assetProperties — (Array<map>)

        The list of asset properties for the asset.

        This object doesn't include properties that you define in composite models. You can find composite model properties in the assetCompositeModels object.

        • idrequired — (String)

          The ID of the asset property.

        • namerequired — (String)

          The name of the property.

        • alias — (String)

          The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

        • notification — (map)

          The asset property's notification topic and state. For more information, see UpdateAssetProperty.

          • topicrequired — (String)

            The MQTT topic to which IoT SiteWise publishes property value update notifications.

          • staterequired — (String)

            The current notification state.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
        • dataTyperequired — (String)

          The data type of the asset property.

          Possible values include:
          • "STRING"
          • "INTEGER"
          • "DOUBLE"
          • "BOOLEAN"
          • "STRUCT"
        • dataTypeSpec — (String)

          The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

        • unit — (String)

          The unit (such as Newtons or RPM) of the asset property.

        • path — (Array<map>)

          The structured path to the property from the root of the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

        • externalId — (String)

          The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetHierarchies — (Array<map>)

        A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

        • id — (String)

          The ID of the hierarchy. This ID is a hierarchyId.

        • namerequired — (String)

          The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

        • externalId — (String)

          The external ID of the hierarchy, if it has one. When you update an asset hierarchy, you may assign an external ID if it doesn't already have one. You can't change the external ID of an asset hierarchy that already has one. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCompositeModels — (Array<map>)

        The composite models for the asset.

        • namerequired — (String)

          The name of the composite model.

        • description — (String)

          The description of the composite model.

        • typerequired — (String)

          The type of the composite model. For alarm composite models, this type is AWS/ALARM.

        • propertiesrequired — (Array<map>)

          The asset properties that this composite model defines.

          • idrequired — (String)

            The ID of the asset property.

          • namerequired — (String)

            The name of the property.

          • alias — (String)

            The alias that identifies the property, such as an OPC-UA server data stream path (for example, /company/windfarm/3/turbine/7/temperature). For more information, see Mapping industrial data streams to asset properties in the IoT SiteWise User Guide.

          • notification — (map)

            The asset property's notification topic and state. For more information, see UpdateAssetProperty.

            • topicrequired — (String)

              The MQTT topic to which IoT SiteWise publishes property value update notifications.

            • staterequired — (String)

              The current notification state.

              Possible values include:
              • "ENABLED"
              • "DISABLED"
          • dataTyperequired — (String)

            The data type of the asset property.

            Possible values include:
            • "STRING"
            • "INTEGER"
            • "DOUBLE"
            • "BOOLEAN"
            • "STRUCT"
          • dataTypeSpec — (String)

            The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

          • unit — (String)

            The unit (such as Newtons or RPM) of the asset property.

          • path — (Array<map>)

            The structured path to the property from the root of the asset.

            • id — (String)

              The ID of the path segment.

            • name — (String)

              The name of the path segment.

          • externalId — (String)

            The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide.

        • id — (String)

          The ID of the asset composite model.

        • externalId — (String)

          The external ID of the asset composite model. For more information, see Using external IDs in the IoT SiteWise User Guide.

      • assetCreationDate — (Date)

        The date the asset was created, in Unix epoch time.

      • assetLastUpdateDate — (Date)

        The date the asset was last updated, in Unix epoch time.

      • assetStatus — (map)

        The current status of the asset, which contains a state and any error message.

        • staterequired — (String)

          The current status of the asset.

          Possible values include:
          • "CREATING"
          • "ACTIVE"
          • "UPDATING"
          • "DELETING"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • coderequired — (String)

            The error code.

            Possible values include:
            • "VALIDATION_ERROR"
            • "INTERNAL_FAILURE"
          • messagerequired — (String)

            The error message.

          • details — (Array<map>)

            A list of detailed errors.

            • coderequired — (String)

              The error code.

              Possible values include:
              • "INCOMPATIBLE_COMPUTE_LOCATION"
              • "INCOMPATIBLE_FORWARDING_CONFIGURATION"
            • messagerequired — (String)

              The error message.

      • assetDescription — (String)

        A description for the asset.

      • assetCompositeModelSummaries — (Array<map>)

        The list of the immediate child custom composite model summaries for the asset.

        • idrequired — (String)

          The ID of the composite model that this summary describes.

        • externalId — (String)

          An external ID to assign to the asset model.

          If the composite model is a derived composite model, or one nested inside a component model, you can only set the external ID using UpdateAssetModelCompositeModel and specifying the derived ID of the model or property from the created model it's a part of.

        • namerequired — (String)

          The name of the composite model that this summary describes.

        • typerequired — (String)

          The type of asset model.

          • ASSET_MODEL – (default) An asset model that you can use to create assets. Can't be included as a component in another asset model.

          • COMPONENT_MODEL – A reusable component that you can include in the composite models of other asset models. You can't create assets directly from this type of asset model.

        • descriptionrequired — (String)

          A description of the composite model that this summary describes.

        • pathrequired — (Array<map>)

          The path that includes all the components of the asset model for the asset.

          • id — (String)

            The ID of the path segment.

          • name — (String)

            The name of the path segment.

      • assetExternalId — (String)

        The external ID of the asset, if any.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also:

iotsitewise.waitFor('portalNotExists', params = {}, [callback]) ⇒ AWS.Request

Waits for the portalNotExists state by periodically calling the underlying IoTSiteWise.describePortal() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the portalNotExists state

var params = {
  portalId: 'STRING_VALUE' /* required */
};
iotsitewise.waitFor('portalNotExists', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • portalId — (String)

      The ID of the portal.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalId — (String)

        The ID of the portal.

      • portalArn — (String)

        The ARN of the portal, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

      • portalName — (String)

        The name of the portal.

      • portalDescription — (String)

        The portal's description.

      • portalClientId — (String)

        The IAM Identity Center application generated client ID (used with IAM Identity Center API operations). IoT SiteWise includes portalClientId for only portals that use IAM Identity Center to authenticate users.

      • portalStartUrl — (String)

        The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use IAM Identity Center for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

      • portalContactEmail — (String)

        The Amazon Web Services administrator's contact email address.

      • portalStatus — (map)

        The current status of the portal, which contains a state and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

      • portalCreationDate — (Date)

        The date the portal was created, in Unix epoch time.

      • portalLastUpdateDate — (Date)

        The date the portal was last updated, in Unix epoch time.

      • portalLogoImageLocation — (map)

        The portal's logo image, which is available at a URL.

        • idrequired — (String)

          The ID of the image.

        • urlrequired — (String)

          The URL where the image is available. The URL is valid for 15 minutes so that you can view and download the image

      • roleArn — (String)

        The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

      • portalAuthMode — (String)

        The service to use to authenticate users to the portal.

        Possible values include:
        • "IAM"
        • "SSO"
      • notificationSenderEmail — (String)

        The email address that sends alarm notifications.

      • alarms — (map)

        Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal.

        • alarmRoleArnrequired — (String)

          The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

        • notificationLambdaArn — (String)

          The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also:

iotsitewise.waitFor('portalActive', params = {}, [callback]) ⇒ AWS.Request

Waits for the portalActive state by periodically calling the underlying IoTSiteWise.describePortal() operation every 3 seconds (at most 20 times).

Examples:

Waiting for the portalActive state

var params = {
  portalId: 'STRING_VALUE' /* required */
};
iotsitewise.waitFor('portalActive', params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object)
    • portalId — (String)

      The ID of the portal.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • portalId — (String)

        The ID of the portal.

      • portalArn — (String)

        The ARN of the portal, which has the following format.

        arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

      • portalName — (String)

        The name of the portal.

      • portalDescription — (String)

        The portal's description.

      • portalClientId — (String)

        The IAM Identity Center application generated client ID (used with IAM Identity Center API operations). IoT SiteWise includes portalClientId for only portals that use IAM Identity Center to authenticate users.

      • portalStartUrl — (String)

        The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use IAM Identity Center for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

      • portalContactEmail — (String)

        The Amazon Web Services administrator's contact email address.

      • portalStatus — (map)

        The current status of the portal, which contains a state and any error message.

        • staterequired — (String)

          The current state of the portal.

          Possible values include:
          • "CREATING"
          • "UPDATING"
          • "DELETING"
          • "ACTIVE"
          • "FAILED"
        • error — (map)

          Contains associated error information, if any.

          • code — (String)

            The error code.

            Possible values include:
            • "INTERNAL_FAILURE"
            • "VALIDATION_ERROR"
            • "LIMIT_EXCEEDED"
          • message — (String)

            The error message.

      • portalCreationDate — (Date)

        The date the portal was created, in Unix epoch time.

      • portalLastUpdateDate — (Date)

        The date the portal was last updated, in Unix epoch time.

      • portalLogoImageLocation — (map)

        The portal's logo image, which is available at a URL.

        • idrequired — (String)

          The ID of the image.

        • urlrequired — (String)

          The URL where the image is available. The URL is valid for 15 minutes so that you can view and download the image

      • roleArn — (String)

        The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

      • portalAuthMode — (String)

        The service to use to authenticate users to the portal.

        Possible values include:
        • "IAM"
        • "SSO"
      • notificationSenderEmail — (String)

        The email address that sends alarm notifications.

      • alarms — (map)

        Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal.

        • alarmRoleArnrequired — (String)

          The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

        • notificationLambdaArn — (String)

          The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

See Also: