IoTSiteWise / Client / create_asset



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

See also: AWS API Documentation

Request Syntax

response = client.create_asset(
        'string': 'string'
  • assetName (string) –


    A friendly name for the asset.

  • assetModelId (string) –


    The ID of the asset model from which to create 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.

    This field is autopopulated if not provided.

  • tags (dict) –

    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.

    • (string) –

      • (string) –

  • assetDescription (string) – A description for the asset.

Return type:



Response Syntax

    'assetId': 'string',
    'assetArn': 'string',
    'assetStatus': {
        'error': {
            'message': 'string',
            'details': [
                    'message': 'string'

Response Structure

  • (dict) –

    • assetId (string) –

      The ID of the asset. This ID uniquely identifies the asset within IoT SiteWise and can be used with other IoT SiteWise APIs.

    • assetArn (string) –

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


    • assetStatus (dict) –

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

      • state (string) –

        The current status of the asset.

      • error (dict) –

        Contains associated error information, if any.

        • code (string) –

          The error code.

        • message (string) –

          The error message.

        • details (list) –

          A list of detailed errors.

          • (dict) –

            Contains detailed error information.

            • code (string) –

              The error code.

            • message (string) –

              The error message.


  • IoTSiteWise.Client.exceptions.InvalidRequestException

  • IoTSiteWise.Client.exceptions.ResourceAlreadyExistsException

  • IoTSiteWise.Client.exceptions.ResourceNotFoundException

  • IoTSiteWise.Client.exceptions.InternalFailureException

  • IoTSiteWise.Client.exceptions.ThrottlingException

  • IoTSiteWise.Client.exceptions.LimitExceededException

  • IoTSiteWise.Client.exceptions.ConflictingOperationException