tencentcloud-sdk-python-iotexplorer 3.1.134__py2.py3-none-any.whl → 3.1.136__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.134'
+__version__ = '3.1.136'

tencentcloud/iotexplorer/v20190423/errorcodes.py

@@ -239,6 +239,9 @@ INVALIDPARAMETERVALUE_FORWARDREDIRECTDENIED = 'InvalidParameterValue.ForwardRedi
 # 拉取产品列表失败。
 INVALIDPARAMETERVALUE_GETPRODUCTSLISTERROR = 'InvalidParameterValue.GetProductsListError'
 
+# AppKey 无效
+INVALIDPARAMETERVALUE_INVALIDAPPKEY = 'InvalidParameterValue.InvalidAppKey'
+
 # 回调 Token 格式有误
 INVALIDPARAMETERVALUE_INVALIDCALLBACKTOKEN = 'InvalidParameterValue.InvalidCallbackToken'
 
@@ -350,6 +353,9 @@ INVALIDPARAMETERVALUE_RULENUMBERBEYONDLIMIT = 'InvalidParameterValue.RuleNumberB
 # 二进制数据格式只可利用 * 将数据进行转发。
 INVALIDPARAMETERVALUE_SELECTKEYFROMBINARYPAYLOAD = 'InvalidParameterValue.SelectKeyFromBinaryPayload'
 
+# 不能将设备分享给自己
+INVALIDPARAMETERVALUE_SHAREDEVICETOSELF = 'InvalidParameterValue.ShareDeviceToSelf'
+
 # 开始时间晚于结束时间。
 INVALIDPARAMETERVALUE_STARTTIMELATERENDTIME = 'InvalidParameterValue.StartTimeLaterEndTime'
 
@@ -359,6 +365,9 @@ INVALIDPARAMETERVALUE_TPNSANDROIDVALIDATIONFAILED = 'InvalidParameterValue.TPNSA
 # TPNSiOSAccessID, TPNSiOSSecretKey, TPNSiOSRegion validation failed。
 INVALIDPARAMETERVALUE_TPNSIOSVALIDATIONFAILED = 'InvalidParameterValue.TPNSiOSValidationFailed'
 
+# Topic与replyTopic必须同时设置或同时为空
+INVALIDPARAMETERVALUE_TOPICMISMATCH = 'InvalidParameterValue.TopicMismatch'
+
 # Topic已存在。
 INVALIDPARAMETERVALUE_TOPICPOLICYALREADYEXIST = 'InvalidParameterValue.TopicPolicyAlreadyExist'
 
@@ -473,6 +482,9 @@ RESOURCENOTFOUND_DEVICEHASNOFIRMWARE = 'ResourceNotFound.DeviceHasNoFirmware'
 # 设备未绑定家庭。
 RESOURCENOTFOUND_DEVICENOTBIND = 'ResourceNotFound.DeviceNotBind'
 
+# 设备未被任何用户绑定
+RESOURCENOTFOUND_DEVICENOTBOUND = 'ResourceNotFound.DeviceNotBound'
+
 # 设备不存在。
 RESOURCENOTFOUND_DEVICENOTEXIST = 'ResourceNotFound.DeviceNotExist'
 
@@ -581,6 +593,9 @@ UNAUTHORIZEDOPERATION_NOPERMISSIONTOPAY = 'UnauthorizedOperation.NoPermissionToP
 # 项目ACL错误。
 UNAUTHORIZEDOPERATION_NOPERMISSIONTOPROJECT = 'UnauthorizedOperation.NoPermissionToProject'
 
+# 无权限分享该设备，仅设备所有者可分享
+UNAUTHORIZEDOPERATION_NOPERMISSIONTOSHAREDEVICE = 'UnauthorizedOperation.NoPermissionToShareDevice'
+
 # 围栏ACL错误。
 UNAUTHORIZEDOPERATION_NOPERMISSIONTOSTUDIOFENCE = 'UnauthorizedOperation.NoPermissionToStudioFence'
 
@@ -695,6 +710,9 @@ UNSUPPORTEDOPERATION_PRODUCTHASBINDEDGATEWAYPRODUCT = 'UnsupportedOperation.Prod
 # 产品已被共享，请先解除共享。
 UNSUPPORTEDOPERATION_PRODUCTHASSHARED = 'UnsupportedOperation.ProductHasShared'
 
+# 子产品禁止直接绑定家庭，请走网关绑定
+UNSUPPORTEDOPERATION_PRODUCTISSUBPRODUCT = 'UnsupportedOperation.ProductIsSubProduct'
+
 # 存在重复项目。
 UNSUPPORTEDOPERATION_PROJECTDUPKEYEXIST = 'UnsupportedOperation.ProjectDupKeyExist'
 
@@ -724,3 +742,6 @@ UNSUPPORTEDOPERATION_VIDEOINSUFFICIENTLICENSES = 'UnsupportedOperation.VideoInsu
 
 # Video平台产品不存在。
 UNSUPPORTEDOPERATION_VIDEOPRODUCTNOTEXIST = 'UnsupportedOperation.VideoProductNotExist'
+
+# 虚拟设备禁止绑定 / 解绑
+UNSUPPORTEDOPERATION_VIRTUALDEVICECANNOTBIND = 'UnsupportedOperation.VirtualDeviceCannotBind'

tencentcloud/iotexplorer/v20190423/iotexplorer_client.py

@@ -258,6 +258,31 @@ class IotexplorerClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def BindUserDevice(self, request):
+        r"""1. 按 `(IotAppID, OpenID)` 兜底创建 / 复用 app 端用户；
+        2. 按 `(用户, FamilyName)` 兜底创建 / 复用默认家庭；
+        3. 将设备直接绑定到该家庭（已绑同家庭视为成功，并继续异步下发 `bind_device` 消息）。
+
+        :param request: Request instance for BindUserDevice.
+        :type request: :class:`tencentcloud.iotexplorer.v20190423.models.BindUserDeviceRequest`
+        :rtype: :class:`tencentcloud.iotexplorer.v20190423.models.BindUserDeviceResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("BindUserDevice", params, headers=headers)
+            response = json.loads(body)
+            model = models.BindUserDeviceResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CallDeviceActionAsync(self, request):
         r"""提供给用户异步调用设备行为的能力
 
@@ -304,6 +329,63 @@ class IotexplorerClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CallDeviceRRPCSync(self, request):
+        r"""平台向设备发起一次同步 RRPC（Reverse RPC）调用——下行下发请求，同步阻塞等待设备回包，超时未回则返回 Timeout。
+
+        适用场景：
+
+        默认模式：使用平台保留 topic $iotrrpc/down 和 $iotrrpc/up。
+        自定义模式：业务自带下行 topic；Reply topic 可选 —— 不传时平台仅依赖 clientToken 关联上行 ack。
+
+
+
+        ## 设备侧实现指引
+
+        ### 默认模式
+
+        1. 订阅 `$iotrrpc/down/{ProductId}/{DeviceName}/+`；
+        2. 收到下行后，从 topic 末段解析 `{mid}`；
+        3. 向 `$iotrrpc/up/{ProductId}/{DeviceName}/{mid}` 发送回包，**payload 任意字节**（推荐 JSON）。
+
+        ### 自定义模式
+
+        1. 订阅业务 `Topic`；
+        2. 解析 payload JSON，**保留 `clientToken` 字段**；
+        3. 处理业务后，构造 envelope JSON：
+
+           ```json
+           {
+             "method": "rrpc_sync_reply",
+             "clientToken": "<原样回填>",
+             "payload": "<base64 of 业务字节>"
+           }
+           ```
+
+        4. publish 到与平台 `ReplyTopic` 通配符匹配的具体 topic（推荐使用与下行同 topic）。
+
+        > ⚠️ `clientToken` **必填且必须原样回填**，否则平台无法关联，调用方将收到 `Status=Timeout`。
+        > ⚠️ `method` 必须为 `rrpc_sync_reply`，否则会直接 skip。
+
+        :param request: Request instance for CallDeviceRRPCSync.
+        :type request: :class:`tencentcloud.iotexplorer.v20190423.models.CallDeviceRRPCSyncRequest`
+        :rtype: :class:`tencentcloud.iotexplorer.v20190423.models.CallDeviceRRPCSyncResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CallDeviceRRPCSync", params, headers=headers)
+            response = json.loads(body)
+            model = models.CallDeviceRRPCSyncResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def ChangeP2PRoute(self, request):
         r"""p2p路线切换（此接口目前处于内测接口，可以联系申请加白 ）
 
@@ -5117,6 +5199,58 @@ class IotexplorerClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def RevokeBindUserDevice(self, request):
+        r"""1. 按 `(IotAppID, OpenID)` 只读定位用户（不存在视为已解绑，幂等成功）；
+        2. 按 `(用户, FamilyName)` 只读定位家庭（不存在视为已解绑，幂等成功）；
+        3. 解除设备与该家庭的绑定关系，异步下发 `delete_device` 消息；解绑路径不校验设备存在性，允许设备已删除时清理残留绑定关系。
+
+        :param request: Request instance for RevokeBindUserDevice.
+        :type request: :class:`tencentcloud.iotexplorer.v20190423.models.RevokeBindUserDeviceRequest`
+        :rtype: :class:`tencentcloud.iotexplorer.v20190423.models.RevokeBindUserDeviceResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("RevokeBindUserDevice", params, headers=headers)
+            response = json.loads(body)
+            model = models.RevokeBindUserDeviceResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def RevokeShareDeviceFromUser(self, request):
+        r"""Owner 取消对指定用户的设备分享：
+        1. 校验产品 ACL / 子产品禁止 / 设备真实存在；
+        2. 只读定位 Owner（必须已存在），并校验 Owner 持有该设备；
+        3. 只读定位被取消分享用户（不存在视为已取消，幂等成功）；
+        4. 删除分享关系记录（不存在视为已取消，幂等成功）。
+
+        :param request: Request instance for RevokeShareDeviceFromUser.
+        :type request: :class:`tencentcloud.iotexplorer.v20190423.models.RevokeShareDeviceFromUserRequest`
+        :rtype: :class:`tencentcloud.iotexplorer.v20190423.models.RevokeShareDeviceFromUserResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("RevokeShareDeviceFromUser", params, headers=headers)
+            response = json.loads(body)
+            model = models.RevokeShareDeviceFromUserResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def SearchPositionSpace(self, request):
         r"""搜索位置空间
 
@@ -5186,6 +5320,33 @@ class IotexplorerClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def ShareDeviceToUser(self, request):
+        r"""Owner 将其名下的设备分享给指定 App 用户：
+        1. 校验产品 ACL / 子产品禁止 / 设备真实存在；
+        2. 只读定位 Owner（必须已存在），并校验 Owner 确实持有该设备；
+        3. 兜底创建被分享用户（已存在则复用，昵称不覆盖）；
+        4. 写入分享关系（重复分享幂等成功，不修改原 CreateTime）。
+
+        :param request: Request instance for ShareDeviceToUser.
+        :type request: :class:`tencentcloud.iotexplorer.v20190423.models.ShareDeviceToUserRequest`
+        :rtype: :class:`tencentcloud.iotexplorer.v20190423.models.ShareDeviceToUserResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ShareDeviceToUser", params, headers=headers)
+            response = json.loads(body)
+            model = models.ShareDeviceToUserResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def TerminateTWeSeeSubscription(self, request):
         r"""退订 TWeSee 预付费订阅
 

tencentcloud/iotexplorer/v20190423/iotexplorer_client_async.py

@@ -207,6 +207,26 @@ class IotexplorerClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def BindUserDevice(
+            self,
+            request: models.BindUserDeviceRequest,
+            opts: Dict = None,
+    ) -> models.BindUserDeviceResponse:
+        """
+        1. 按 `(IotAppID, OpenID)` 兜底创建 / 复用 app 端用户；
+        2. 按 `(用户, FamilyName)` 兜底创建 / 复用默认家庭；
+        3. 将设备直接绑定到该家庭（已绑同家庭视为成功，并继续异步下发 `bind_device` 消息）。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "BindUserDevice"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.BindUserDeviceResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def CallDeviceActionAsync(
             self,
             request: models.CallDeviceActionAsyncRequest,
@@ -243,6 +263,58 @@ class IotexplorerClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def CallDeviceRRPCSync(
+            self,
+            request: models.CallDeviceRRPCSyncRequest,
+            opts: Dict = None,
+    ) -> models.CallDeviceRRPCSyncResponse:
+        """
+        平台向设备发起一次同步 RRPC（Reverse RPC）调用——下行下发请求，同步阻塞等待设备回包，超时未回则返回 Timeout。
+
+        适用场景：
+
+        默认模式：使用平台保留 topic $iotrrpc/down 和 $iotrrpc/up。
+        自定义模式：业务自带下行 topic；Reply topic 可选 —— 不传时平台仅依赖 clientToken 关联上行 ack。
+
+
+
+        ## 设备侧实现指引
+
+        ### 默认模式
+
+        1. 订阅 `$iotrrpc/down/{ProductId}/{DeviceName}/+`；
+        2. 收到下行后，从 topic 末段解析 `{mid}`；
+        3. 向 `$iotrrpc/up/{ProductId}/{DeviceName}/{mid}` 发送回包，**payload 任意字节**（推荐 JSON）。
+
+        ### 自定义模式
+
+        1. 订阅业务 `Topic`；
+        2. 解析 payload JSON，**保留 `clientToken` 字段**；
+        3. 处理业务后，构造 envelope JSON：
+
+           ```json
+           {
+             "method": "rrpc_sync_reply",
+             "clientToken": "<原样回填>",
+             "payload": "<base64 of 业务字节>"
+           }
+           ```
+
+        4. publish 到与平台 `ReplyTopic` 通配符匹配的具体 topic（推荐使用与下行同 topic）。
+
+        > ⚠️ `clientToken` **必填且必须原样回填**，否则平台无法关联，调用方将收到 `Status=Timeout`。
+        > ⚠️ `method` 必须为 `rrpc_sync_reply`，否则会直接 skip。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CallDeviceRRPCSync"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CallDeviceRRPCSyncResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def ChangeP2PRoute(
             self,
             request: models.ChangeP2PRouteRequest,
@@ -4011,6 +4083,48 @@ class IotexplorerClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def RevokeBindUserDevice(
+            self,
+            request: models.RevokeBindUserDeviceRequest,
+            opts: Dict = None,
+    ) -> models.RevokeBindUserDeviceResponse:
+        """
+        1. 按 `(IotAppID, OpenID)` 只读定位用户（不存在视为已解绑，幂等成功）；
+        2. 按 `(用户, FamilyName)` 只读定位家庭（不存在视为已解绑，幂等成功）；
+        3. 解除设备与该家庭的绑定关系，异步下发 `delete_device` 消息；解绑路径不校验设备存在性，允许设备已删除时清理残留绑定关系。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "RevokeBindUserDevice"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.RevokeBindUserDeviceResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def RevokeShareDeviceFromUser(
+            self,
+            request: models.RevokeShareDeviceFromUserRequest,
+            opts: Dict = None,
+    ) -> models.RevokeShareDeviceFromUserResponse:
+        """
+        Owner 取消对指定用户的设备分享：
+        1. 校验产品 ACL / 子产品禁止 / 设备真实存在；
+        2. 只读定位 Owner（必须已存在），并校验 Owner 持有该设备；
+        3. 只读定位被取消分享用户（不存在视为已取消，幂等成功）；
+        4. 删除分享关系记录（不存在视为已取消，幂等成功）。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "RevokeShareDeviceFromUser"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.RevokeShareDeviceFromUserResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def SearchPositionSpace(
             self,
             request: models.SearchPositionSpaceRequest,
@@ -4065,6 +4179,28 @@ class IotexplorerClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def ShareDeviceToUser(
+            self,
+            request: models.ShareDeviceToUserRequest,
+            opts: Dict = None,
+    ) -> models.ShareDeviceToUserResponse:
+        """
+        Owner 将其名下的设备分享给指定 App 用户：
+        1. 校验产品 ACL / 子产品禁止 / 设备真实存在；
+        2. 只读定位 Owner（必须已存在），并校验 Owner 确实持有该设备；
+        3. 兜底创建被分享用户（已存在则复用，昵称不覆盖）；
+        4. 写入分享关系（重复分享幂等成功，不修改原 CreateTime）。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ShareDeviceToUser"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ShareDeviceToUserResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def TerminateTWeSeeSubscription(
             self,
             request: models.TerminateTWeSeeSubscriptionRequest,