BatchPutPropertyValues - AWS IoT TwinMaker
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

BatchPutPropertyValues

为多个时间序列属性设置值

请求语法

POST /workspaces/workspaceId/entity-properties HTTP/1.1
Content-type: application/json

{
   "entries": [ 
      { 
         "entityPropertyReference": { 
            "componentName": "string",
            "componentPath": "string",
            "entityId": "string",
            "externalIdProperty": { 
               "string" : "string" 
            },
            "propertyName": "string"
         },
         "propertyValues": [ 
            { 
               "time": "string",
               "timestamp": number,
               "value": { 
                  "booleanValue": boolean,
                  "doubleValue": number,
                  "expression": "string",
                  "integerValue": number,
                  "listValue": [ 
                     "DataValue"
                  ],
                  "longValue": number,
                  "mapValue": { 
                     "string" : "DataValue"
                  },
                  "relationshipValue": { 
                     "targetComponentName": "string",
                     "targetEntityId": "string"
                  },
                  "stringValue": "string"
               }
            }
         ]
      }
   ]
}

URI 请求参数

请求使用以下 URI 参数。

workspaceId

包含要设置属性的工作区的 ID。

长度限制：长度下限为 1。长度上限为 128。

模式：[a-zA-Z_0-9][a-zA-Z_\-0-9]*[a-zA-Z0-9]+

必需：是

请求体

请求接受采用 JSON 格式的以下数据。

entries

将字符串映射到要设置的属性值条目的对象。映射中的每个字符串对于该对象都必须是唯一的。

类型：PropertyValueEntry 对象数组

数组成员：最少 1 个物品。最多 10 个物品。

必需：是

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "errorEntries": [ 
      { 
         "errors": [ 
            { 
               "entry": { 
                  "entityPropertyReference": { 
                     "componentName": "string",
                     "componentPath": "string",
                     "entityId": "string",
                     "externalIdProperty": { 
                        "string" : "string" 
                     },
                     "propertyName": "string"
                  },
                  "propertyValues": [ 
                     { 
                        "time": "string",
                        "timestamp": number,
                        "value": { 
                           "booleanValue": boolean,
                           "doubleValue": number,
                           "expression": "string",
                           "integerValue": number,
                           "listValue": [ 
                              "DataValue"
                           ],
                           "longValue": number,
                           "mapValue": { 
                              "string" : "DataValue"
                           },
                           "relationshipValue": { 
                              "targetComponentName": "string",
                              "targetEntityId": "string"
                           },
                           "stringValue": "string"
                        }
                     }
                  ]
               },
               "errorCode": "string",
               "errorMessage": "string"
            }
         ]
      }
   ]
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

errorEntries

在批量输入操作中导致错误的条目。

类型：BatchPutPropertyErrorEntry 对象数组

数组成员：最少 1 个物品。最多 10 个物品。

错误

有关所有操作的常见错误信息，请参阅常见错误。

InternalServerException

出现意外错误。

HTTP 状态代码：500

ResourceNotFoundException

未找到资源。

HTTP 状态代码：404

ThrottlingException

速率超过限制。

HTTP 状态代码：429

ValidationException

失败

HTTP 状态代码：400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：