Create Logical Asset¶
Create a logical asset.
Operation Permissions¶
Required Service | Required Action Permission |
---|---|
Asset Tree | Full Access |
Request Format¶
POST https://{apigw-address}/asset-service/v2.1/logical-assets?action=create
Request Parameters (URI)¶
Name | Location (Path/Query) | Mandatory/Optional | Data Type | Description |
---|---|---|---|---|
orgId | Query | Mandatory | String | The organization ID which the asset belongs to. How to get orgId>> |
Request Parameters (Body)¶
Name | Mandatory/Optional | Data Type | Description |
---|---|---|---|
assetInstance | Mandatory | AssetCreateVo Struct | The details needed to create the logical asset. For more information, see below. |
AssetCreateVo Struct¶
Name | Mandatory/Optional | Data Type | Description |
---|---|---|---|
modelId | Mandatory | String | The model ID which the asset belongs to. How to get modelID>> |
name | Mandatory | StringI18n | The asset name. For more details on the structure and locales supported, see Internationalized name struct. |
timezone | Mandatory | String | Timezone of the asset’s location. For details, see timezone representation. |
description | Optional | String | The asset description. |
attributes | Depends on the model feature definition | Map (Key is of String type, and Value depends on the attribute defined in the model) | Attributes of the model which the asset belongs to. Key is the attribute ID. For more information, see attributes representation. |
tags | Optional | Map (Key and Value are of String type) | User-defined tags. For more information, see How to use tag. |
Response Parameters¶
Name | Data Type | Description |
---|---|---|
data | String | The ID of the created logical asset. |
Error Codes¶
Code | Message | Description |
---|---|---|
17946 | Quota limit error | The assets under this OU have exceeded the upper limit. |
99400 | TSL instance validation failed | The modelId cannot be found or does not exist. |
Samples¶
Request Sample¶
url: https://{apigw-address}/asset-service/v2.1/logical-assets?action=create&orgId=yourOrgId
method: POST
requestBody:
{
"assetInstance": {
"modelId": "model_001",
"name": {
"defaultValue": "instanceName",
"i18nValue": {
"en_US": "English name ",
"zh_CN": "Chinese name"
}
},
"description": "description",
"attributes": {
"color": "blue",
"number": 135
},
"timezone": "+08:00",
"tags": {
"year": "2000",
"author": "authorName"
}
}
}
Return Sample¶
{
"code": 0,
"msg": "OK",
"data": "yourAssetId",
"requestId": "fa11232e-7e45-4176-a382-963c1240a27f"
}