{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-iot-sitewise/json-schema/amazon-iot-sitewise-describe-asset-response-schema.json",
  "title": "DescribeAssetResponse",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-iot-sitewise-assets-api-openapi.yml#/components/schemas/DescribeAssetResponse",
  "type": "object",
  "properties": {
    "assetId": {
      "type": "string",
      "description": "The ID of the asset, in UUID format."
    },
    "assetExternalId": {
      "type": "string",
      "description": "The external ID of the asset, if any."
    },
    "assetArn": {
      "type": "string",
      "description": "The ARN of the asset, which has the following format. arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}"
    },
    "assetName": {
      "type": "string",
      "description": "The name of the asset."
    },
    "assetModelId": {
      "type": "string",
      "description": "The ID of the asset model that was used to create the asset."
    },
    "assetProperties": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AssetProperty"
      },
      "description": "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."
    },
    "assetHierarchies": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AssetHierarchy"
      },
      "description": "A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships."
    },
    "assetCompositeModels": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AssetCompositeModel"
      },
      "description": "The composite models for the asset."
    },
    "assetCreationDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date the asset was created, in Unix epoch time."
    },
    "assetLastUpdateDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date the asset was last updated, in Unix epoch time."
    },
    "assetStatus": {
      "$ref": "#/$defs/AssetStatus"
    },
    "assetDescription": {
      "type": "string",
      "description": "A description for the asset."
    },
    "assetCompositeModelSummaries": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AssetCompositeModelSummary"
      },
      "description": "The list of the immediate child custom composite model summaries for the asset."
    }
  },
  "required": [
    "assetId",
    "assetArn",
    "assetName",
    "assetModelId",
    "assetProperties",
    "assetHierarchies",
    "assetCreationDate",
    "assetLastUpdateDate",
    "assetStatus"
  ],
  "$defs": {
    "AssetCompositeModel": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the composite model."
        },
        "description": {
          "type": "string",
          "description": "The description of the composite model."
        },
        "type": {
          "type": "string",
          "description": "The type of the composite model. For alarm composite models, this type is AWS/ALARM."
        },
        "properties": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AssetProperty"
          },
          "description": "The asset properties that this composite model defines."
        },
        "id": {
          "type": "string",
          "description": "The ID of the asset composite model."
        },
        "externalId": {
          "type": "string",
          "description": "The external ID of the asset composite model. For more information, see Using external IDs in the IoT SiteWise User Guide."
        }
      },
      "required": [
        "name",
        "type",
        "properties"
      ]
    },
    "AssetCompositeModelPathSegment": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the path segment."
        },
        "name": {
          "type": "string",
          "description": "The name of the path segment."
        }
      }
    },
    "AssetCompositeModelSummary": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the composite model that this summary describes."
        },
        "externalId": {
          "type": "string",
          "description": "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."
        },
        "name": {
          "type": "string",
          "description": "The name of the composite model that this summary describes."
        },
        "type": {
          "type": "string",
          "description": "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": {
          "type": "string",
          "description": "A description of the composite model that this summary describes."
        },
        "path": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AssetCompositeModelPathSegment"
          },
          "description": "The path that includes all the components of the asset model for the asset."
        }
      },
      "required": [
        "id",
        "name",
        "type",
        "description",
        "path"
      ]
    },
    "AssetHierarchy": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the hierarchy. This ID is a hierarchyId."
        },
        "externalId": {
          "type": "string",
          "description": "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."
        },
        "name": {
          "type": "string",
          "description": "The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation."
        }
      },
      "required": [
        "name"
      ]
    },
    "AssetProperty": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the asset property."
        },
        "externalId": {
          "type": "string",
          "description": "The external ID of the asset property. For more information, see Using external IDs in the IoT SiteWise User Guide."
        },
        "name": {
          "type": "string",
          "description": "The name of the property."
        },
        "alias": {
          "type": "string",
          "description": "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": {
          "$ref": "#/$defs/PropertyNotification"
        },
        "dataType": {
          "type": "string",
          "enum": [
            "STRING",
            "INTEGER",
            "DOUBLE",
            "BOOLEAN",
            "STRUCT",
            "VIDEO",
            "ANNOTATION",
            "JSON"
          ],
          "description": "The data type of the asset property."
        },
        "dataTypeSpec": {
          "type": "string",
          "description": "The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type."
        },
        "unit": {
          "type": "string",
          "description": "The unit (such as Newtons or RPM) of the asset property."
        },
        "path": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AssetPropertyPathSegment"
          },
          "description": "The structured path to the property from the root of the asset."
        }
      },
      "required": [
        "id",
        "name",
        "dataType"
      ]
    },
    "AssetPropertyPathSegment": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the path segment."
        },
        "name": {
          "type": "string",
          "description": "The name of the path segment."
        }
      }
    },
    "AssetStatus": {
      "type": "object",
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "CREATING",
            "ACTIVE",
            "UPDATING",
            "DELETING",
            "FAILED"
          ],
          "description": "The current status of the asset."
        },
        "error": {
          "$ref": "#/$defs/ErrorDetails"
        }
      },
      "required": [
        "state"
      ]
    },
    "DetailedError": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "INCOMPATIBLE_COMPUTE_LOCATION",
            "INCOMPATIBLE_FORWARDING_CONFIGURATION"
          ],
          "description": "The error code."
        },
        "message": {
          "type": "string",
          "description": "The error message."
        }
      },
      "required": [
        "code",
        "message"
      ]
    },
    "ErrorDetails": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "VALIDATION_ERROR",
            "INTERNAL_FAILURE"
          ],
          "description": "The error code."
        },
        "message": {
          "type": "string",
          "description": "The error message."
        },
        "details": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/DetailedError"
          },
          "description": "A list of detailed errors."
        }
      },
      "required": [
        "code",
        "message"
      ]
    },
    "PropertyNotification": {
      "type": "object",
      "properties": {
        "topic": {
          "type": "string",
          "description": "The MQTT topic to which IoT SiteWise publishes property value update notifications."
        },
        "state": {
          "type": "string",
          "enum": [
            "ENABLED",
            "DISABLED"
          ],
          "description": "The current notification state."
        }
      },
      "required": [
        "topic",
        "state"
      ]
    }
  }
}