tencentcloud-sdk-python-ess 3.1.157__py2.py3-none-any.whl → 3.1.166__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.157'
+__version__ = '3.1.166'

tencentcloud/ess/v20201111/ess_client.py

@@ -534,8 +534,8 @@ class EssClient(AbstractClient):
         1. 该接口可生成签署人的批量、合同组签署/查看链接 。
         2. 该签署链接**默认有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
         3. 该接口返回的签署链接适用于APP集成的场景，支持APP打开或浏览器直接打开，**不支持微信小程序嵌入**。
-        跳转到小程序的实现，参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式)，如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
         4. 因h5涉及人脸身份认证能力基于慧眼人脸核身，对Android和iOS系统均有一定要求， 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
+        5. <font color='red'>iframe 嵌入暂不支持人脸相关操作</font>，包括设置密码等需要进行的人脸核验。
 
         :param request: Request instance for CreateBatchQuickSignUrl.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateBatchQuickSignUrlRequest`
@@ -1010,6 +1010,9 @@ class EssClient(AbstractClient):
         1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
         2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
 
+        整体流程如下图
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/bb35c9cfa453d28eade16df36221f313.png)
+
         :param request: Request instance for CreateFileConvertTask.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateFileConvertTaskRequest`
         :rtype: :class:`tencentcloud.ess.v20201111.models.CreateFileConvertTaskResponse`
@@ -1624,8 +1627,8 @@ class EssClient(AbstractClient):
         **注意**
         1. 该签署链接**默认有效期为30分钟**，过期后将失效，如需签署可重新创建签署链接。
         2. 该接口返回的签署链接适用于APP集成的场景，支持APP、支付宝打开或浏览器直接打开，**不支持微信小程序嵌入**。配置方式请参考：<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
-        如需跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
         3. 因h5涉及人脸身份认证能力基于慧眼人脸核身，对Android和iOS系统均有一定要求， 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
+        4. <font color='red'>iframe 嵌入暂不支持人脸相关操作</font>，包括设置密码等需要进行的人脸核验。
 
         :param request: Request instance for CreateFlowSignUrl.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateFlowSignUrlRequest`
@@ -2393,6 +2396,143 @@ class EssClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateRequestWithEncryption(self, request):
+        r"""该接口支持对请求内容进行加密传输。调用方需使用约定的 AES-CBC 或 SM4-CBC 算法对请求内容进行加密，并使用 HMAC-SHA256 或 HMAC-SM3 算法对 IV 和加密后的数据进行完整性校验，防止请求内容被篡改。
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/391df0a37c2b213445c4909ba98824ac.svg)
+
+        **请求端加密流程**
+        1. 每次请求使用密码学安全的随机源生成 16 字节 的 IV。每次请求必须重新生成，严禁复用。
+        2. 使用约定的 AES-CBC 或 SM4-CBC 算法对原始请求体进行加密，使用 PKCS#7 Padding。
+        3. 将加密后的密文原始字节进行标准 Base64 编码，作为 EncryptedData 参数。
+        4. 将 IV 原始字节进行标准 Base64 编码，作为 IV 参数。
+        5. 对 IV 原始字节和密文原始字节直接拼接（不添加分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)
+        6. 将 HMAC 的结果进行 标准 Base64 编码，作为 EncryptionSignature 参数。
+
+        **响应端解密流程**
+        1. 先判断本接口自身是否返回外层错误，此时错误为明文（标准腾讯云错误体），有则直接失败处理。
+        2. 分别对 IV、EncryptedData、EncryptionSignature 做标准 Base64 解码，得到原始字节。
+        3. 将 IV 与密文原始字节直接拼接（无分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)。
+        4. 与响应中 EncryptionSignature 解码后的字节做恒定时间比较，不一致立即失败，不得继续解密。
+        5. 使用约定的 AES-CBC 或 SM4-CBC，以 IV 和密钥解密 EncryptedData，去除 PKCS#7 Padding 得到明文。
+        6. 先用腾讯云标准错误体反序列化明文，判断被加密业务接口是否返回 Error。
+        7. 无业务错误时，再用目标业务接口的响应结构体反序列化明文，取出实际业务参数。
+
+        **响应端错误处理**
+        1. 外层错误（本接口本身调用失败）：返回标准腾讯云错误 JSON（含 Error.Code / Error.Message），无 EncryptedData，不需要解密即可处理。
+        2. 内层错误（业务接口执行失败）：外层成功，但解密后的明文里包含 Error.Code / Error.Message，按目标业务接口的错误规范处理。
+
+        **处理过程示例**
+        ```
+        # ========== 前置约定 ==========
+        AESKey  : 加密 密钥（AES 32 字节，SM4 16 字节）
+        HMACKey : HMAC 密钥（与加密密钥需要不同）
+        ALGO    : AES-CBC 或 SM4-CBC，双方约定
+        HMAC    : ALGO == AES-CBC ? HMAC-SHA256 : HMAC-SM3
+
+        # ========== 请求端：加密并调用 ==========
+        function CallWithEncryption(bizAction, bizRequestObj):
+            # 1. 序列化业务请求
+            plaintext = JSON.stringify(bizRequestObj)
+            # 2. 生成 16 字节随机 IV（每次新生成，禁止复用）
+            iv = SecureRandom(16)
+            # 3. 对称加密（PKCS#7 Padding）
+            ciphertext = SymmetricEncrypt(ALGO, AESKey, iv, plaintext)
+            # 4. 计算完整性签名：HMAC(Key, IV || Ciphertext)
+            signature = HMAC(HMACKey, concat(iv, ciphertext))
+            # 5. 组装外层请求参数（三段均为标准 Base64）
+            encReq = {
+                RequestAction:       bizAction,
+                IV:                  Base64(iv),
+                EncryptedData:       Base64(ciphertext),
+                EncryptionSignature: Base64(signature),
+            }
+            # 6. 调用 CreateRequestWithEncryption
+            #    TC3-HMAC-SHA256 鉴权由官方 SDK 自动完成
+            encResp = CloudAPI.CreateRequestWithEncryption(encReq)
+            # 7. 外层错误：明文，直接抛出
+            if encResp.Error != nil:
+                raise OuterError(encResp.Error)
+            # 8. 解密并返回业务响应
+            return DecryptResponse(encResp.Response)
+
+        # ========== 响应端：校验并解密 ==========
+        function DecryptResponse(resp):
+            # 1. Base64 解码
+            ivBytes  = Base64Decode(resp.IV)
+            ctBytes  = Base64Decode(resp.EncryptedData)
+            sigBytes = Base64Decode(resp.EncryptionSignature)
+            # 2. 重新计算 HMAC
+            expected = HMAC(HMACKey, concat(ivBytes, ctBytes))
+            # 3. 恒定时间比较，失败立即终止（不得继续解密）
+            if not ConstantTimeEqual(expected, sigBytes):
+                raise SignatureMismatch
+            # 4. 对称解密，去除 PKCS#7 Padding
+            plaintext = SymmetricDecrypt(ALGO, AESKey, ivBytes, ctBytes)
+            # 5. 先按腾讯云错误体解析，判断业务是否失败
+            bizErr = TryParseTencentCloudError(plaintext)
+            if bizErr != nil:
+                raise BusinessError(bizErr)
+            # 6. 按目标业务接口的响应结构反序列化
+            return JSON.parse(plaintext, BizResponseSchema)
+        ```
+
+        **AES-CBC 示例**
+        以下示例参数及结果可用于验证 AES-CBC 加密和 HMAC-SHA256 签名算法的实现是否正确。
+
+        加密密钥：AES-CBC-Key-1234
+        签名密钥：AES-HMAC-Key-123
+        IV：1234567890abcdef
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "DescribeFlowComponents",
+          "IV": "MTIzNDU2Nzg5MGFiY2RlZg==",
+          "EncryptedData": "Iqp2W1jislwMNmE7bH9dKZZiMQsfkAPyvAAqDFRnWLw=",
+          "EncryptionSignature": "4TT3PUCZgZT7YmEPtXDm5PDcM6xT7FoYHfMW8xunB5I="
+        }
+        ```
+
+        **SM4-CBC 示例**
+        以下示例参数及结果可用于验证 SM4-CBC 加密和 HMAC-SM4 签名算法的实现是否正确。
+
+        加密密钥：SM4-CBC-Key-1234
+        签名密钥：SM4-HMAC-Key-123
+        IV：fedcba0987654321
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "DescribeFlowComponents",
+          "IV": "ZmVkY2JhMDk4NzY1NDMyMQ==",
+          "EncryptedData": "GwUovQhNUPaUnVM/UDXMtPOYTpTSi2B1oyZDFbyyvns=",
+          "EncryptionSignature": "nHB/v/AvOaDCQ66esFNnp12lHKcGkwaLGid0Warl/KE="
+        }
+        ```
+
+        :param request: Request instance for CreateRequestWithEncryption.
+        :type request: :class:`tencentcloud.ess.v20201111.models.CreateRequestWithEncryptionRequest`
+        :rtype: :class:`tencentcloud.ess.v20201111.models.CreateRequestWithEncryptionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateRequestWithEncryption", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateRequestWithEncryptionResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateRiskIdentificationTaskFeedback(self, request):
         r"""此接口（CreateRiskIdentificationTaskFeedback）用于创建合同审查任务结果反馈。
 
@@ -3377,6 +3517,9 @@ class EssClient(AbstractClient):
         1. `大文件转换所需的时间可能会比较长`
         2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`
 
+        整体流程如下图
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/bb35c9cfa453d28eade16df36221f313.png)
+
         :param request: Request instance for DescribeFileConvertTask.
         :type request: :class:`tencentcloud.ess.v20201111.models.DescribeFileConvertTaskRequest`
         :rtype: :class:`tencentcloud.ess.v20201111.models.DescribeFileConvertTaskResponse`

tencentcloud/ess/v20201111/ess_client_async.py

@@ -463,8 +463,8 @@ class EssClient(AbstractClient):
         1. 该接口可生成签署人的批量、合同组签署/查看链接 。
         2. 该签署链接**默认有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
         3. 该接口返回的签署链接适用于APP集成的场景，支持APP打开或浏览器直接打开，**不支持微信小程序嵌入**。
-        跳转到小程序的实现，参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式)，如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
         4. 因h5涉及人脸身份认证能力基于慧眼人脸核身，对Android和iOS系统均有一定要求， 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
+        5. <font color='red'>iframe 嵌入暂不支持人脸相关操作</font>，包括设置密码等需要进行的人脸核验。
         """
         
         kwargs = {}
@@ -863,6 +863,9 @@ class EssClient(AbstractClient):
         注:
         1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
         2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
+
+        整体流程如下图
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/bb35c9cfa453d28eade16df36221f313.png)
         """
         
         kwargs = {}
@@ -1408,8 +1411,8 @@ class EssClient(AbstractClient):
         **注意**
         1. 该签署链接**默认有效期为30分钟**，过期后将失效，如需签署可重新创建签署链接。
         2. 该接口返回的签署链接适用于APP集成的场景，支持APP、支付宝打开或浏览器直接打开，**不支持微信小程序嵌入**。配置方式请参考：<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
-        如需跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
         3. 因h5涉及人脸身份认证能力基于慧眼人脸核身，对Android和iOS系统均有一定要求， 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
+        4. <font color='red'>iframe 嵌入暂不支持人脸相关操作</font>，包括设置密码等需要进行的人脸核验。
         """
         
         kwargs = {}
@@ -2052,6 +2055,138 @@ class EssClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def CreateRequestWithEncryption(
+            self,
+            request: models.CreateRequestWithEncryptionRequest,
+            opts: Dict = None,
+    ) -> models.CreateRequestWithEncryptionResponse:
+        """
+        该接口支持对请求内容进行加密传输。调用方需使用约定的 AES-CBC 或 SM4-CBC 算法对请求内容进行加密，并使用 HMAC-SHA256 或 HMAC-SM3 算法对 IV 和加密后的数据进行完整性校验，防止请求内容被篡改。
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/391df0a37c2b213445c4909ba98824ac.svg)
+
+        **请求端加密流程**
+        1. 每次请求使用密码学安全的随机源生成 16 字节 的 IV。每次请求必须重新生成，严禁复用。
+        2. 使用约定的 AES-CBC 或 SM4-CBC 算法对原始请求体进行加密，使用 PKCS#7 Padding。
+        3. 将加密后的密文原始字节进行标准 Base64 编码，作为 EncryptedData 参数。
+        4. 将 IV 原始字节进行标准 Base64 编码，作为 IV 参数。
+        5. 对 IV 原始字节和密文原始字节直接拼接（不添加分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)
+        6. 将 HMAC 的结果进行 标准 Base64 编码，作为 EncryptionSignature 参数。
+
+        **响应端解密流程**
+        1. 先判断本接口自身是否返回外层错误，此时错误为明文（标准腾讯云错误体），有则直接失败处理。
+        2. 分别对 IV、EncryptedData、EncryptionSignature 做标准 Base64 解码，得到原始字节。
+        3. 将 IV 与密文原始字节直接拼接（无分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)。
+        4. 与响应中 EncryptionSignature 解码后的字节做恒定时间比较，不一致立即失败，不得继续解密。
+        5. 使用约定的 AES-CBC 或 SM4-CBC，以 IV 和密钥解密 EncryptedData，去除 PKCS#7 Padding 得到明文。
+        6. 先用腾讯云标准错误体反序列化明文，判断被加密业务接口是否返回 Error。
+        7. 无业务错误时，再用目标业务接口的响应结构体反序列化明文，取出实际业务参数。
+
+        **响应端错误处理**
+        1. 外层错误（本接口本身调用失败）：返回标准腾讯云错误 JSON（含 Error.Code / Error.Message），无 EncryptedData，不需要解密即可处理。
+        2. 内层错误（业务接口执行失败）：外层成功，但解密后的明文里包含 Error.Code / Error.Message，按目标业务接口的错误规范处理。
+
+        **处理过程示例**
+        ```
+        # ========== 前置约定 ==========
+        AESKey  : 加密 密钥（AES 32 字节，SM4 16 字节）
+        HMACKey : HMAC 密钥（与加密密钥需要不同）
+        ALGO    : AES-CBC 或 SM4-CBC，双方约定
+        HMAC    : ALGO == AES-CBC ? HMAC-SHA256 : HMAC-SM3
+
+        # ========== 请求端：加密并调用 ==========
+        function CallWithEncryption(bizAction, bizRequestObj):
+            # 1. 序列化业务请求
+            plaintext = JSON.stringify(bizRequestObj)
+            # 2. 生成 16 字节随机 IV（每次新生成，禁止复用）
+            iv = SecureRandom(16)
+            # 3. 对称加密（PKCS#7 Padding）
+            ciphertext = SymmetricEncrypt(ALGO, AESKey, iv, plaintext)
+            # 4. 计算完整性签名：HMAC(Key, IV || Ciphertext)
+            signature = HMAC(HMACKey, concat(iv, ciphertext))
+            # 5. 组装外层请求参数（三段均为标准 Base64）
+            encReq = {
+                RequestAction:       bizAction,
+                IV:                  Base64(iv),
+                EncryptedData:       Base64(ciphertext),
+                EncryptionSignature: Base64(signature),
+            }
+            # 6. 调用 CreateRequestWithEncryption
+            #    TC3-HMAC-SHA256 鉴权由官方 SDK 自动完成
+            encResp = CloudAPI.CreateRequestWithEncryption(encReq)
+            # 7. 外层错误：明文，直接抛出
+            if encResp.Error != nil:
+                raise OuterError(encResp.Error)
+            # 8. 解密并返回业务响应
+            return DecryptResponse(encResp.Response)
+
+        # ========== 响应端：校验并解密 ==========
+        function DecryptResponse(resp):
+            # 1. Base64 解码
+            ivBytes  = Base64Decode(resp.IV)
+            ctBytes  = Base64Decode(resp.EncryptedData)
+            sigBytes = Base64Decode(resp.EncryptionSignature)
+            # 2. 重新计算 HMAC
+            expected = HMAC(HMACKey, concat(ivBytes, ctBytes))
+            # 3. 恒定时间比较，失败立即终止（不得继续解密）
+            if not ConstantTimeEqual(expected, sigBytes):
+                raise SignatureMismatch
+            # 4. 对称解密，去除 PKCS#7 Padding
+            plaintext = SymmetricDecrypt(ALGO, AESKey, ivBytes, ctBytes)
+            # 5. 先按腾讯云错误体解析，判断业务是否失败
+            bizErr = TryParseTencentCloudError(plaintext)
+            if bizErr != nil:
+                raise BusinessError(bizErr)
+            # 6. 按目标业务接口的响应结构反序列化
+            return JSON.parse(plaintext, BizResponseSchema)
+        ```
+
+        **AES-CBC 示例**
+        以下示例参数及结果可用于验证 AES-CBC 加密和 HMAC-SHA256 签名算法的实现是否正确。
+
+        加密密钥：AES-CBC-Key-1234
+        签名密钥：AES-HMAC-Key-123
+        IV：1234567890abcdef
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "DescribeFlowComponents",
+          "IV": "MTIzNDU2Nzg5MGFiY2RlZg==",
+          "EncryptedData": "Iqp2W1jislwMNmE7bH9dKZZiMQsfkAPyvAAqDFRnWLw=",
+          "EncryptionSignature": "4TT3PUCZgZT7YmEPtXDm5PDcM6xT7FoYHfMW8xunB5I="
+        }
+        ```
+
+        **SM4-CBC 示例**
+        以下示例参数及结果可用于验证 SM4-CBC 加密和 HMAC-SM4 签名算法的实现是否正确。
+
+        加密密钥：SM4-CBC-Key-1234
+        签名密钥：SM4-HMAC-Key-123
+        IV：fedcba0987654321
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "DescribeFlowComponents",
+          "IV": "ZmVkY2JhMDk4NzY1NDMyMQ==",
+          "EncryptedData": "GwUovQhNUPaUnVM/UDXMtPOYTpTSi2B1oyZDFbyyvns=",
+          "EncryptionSignature": "nHB/v/AvOaDCQ66esFNnp12lHKcGkwaLGid0Warl/KE="
+        }
+        ```
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateRequestWithEncryption"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateRequestWithEncryptionResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def CreateRiskIdentificationTaskFeedback(
             self,
             request: models.CreateRiskIdentificationTaskFeedbackRequest,
@@ -2855,6 +2990,9 @@ class EssClient(AbstractClient):
         注：
         1. `大文件转换所需的时间可能会比较长`
         2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`
+
+        整体流程如下图
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/bb35c9cfa453d28eade16df36221f313.png)
         """
         
         kwargs = {}

tencentcloud/ess/v20201111/models.py

@@ -18507,6 +18507,160 @@ class CreateReleaseFlowResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateRequestWithEncryptionRequest(AbstractModel):
+    r"""CreateRequestWithEncryption请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _RequestAction: <p>操作的接口名称。取值参考接口文档输入参数章节关于公共参数 Action 的说明。</p>
+        :type RequestAction: str
+        :param _IV: <p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :type IV: str
+        :param _EncryptedData: <p>使用 AES-CBC 或 SM4-CBC 加密请求内容得到的密文。加密前请求内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :type EncryptedData: str
+        :param _EncryptionSignature: <p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :type EncryptionSignature: str
+        """
+        self._RequestAction = None
+        self._IV = None
+        self._EncryptedData = None
+        self._EncryptionSignature = None
+
+    @property
+    def RequestAction(self):
+        r"""<p>操作的接口名称。取值参考接口文档输入参数章节关于公共参数 Action 的说明。</p>
+        :rtype: str
+        """
+        return self._RequestAction
+
+    @RequestAction.setter
+    def RequestAction(self, RequestAction):
+        self._RequestAction = RequestAction
+
+    @property
+    def IV(self):
+        r"""<p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._IV
+
+    @IV.setter
+    def IV(self, IV):
+        self._IV = IV
+
+    @property
+    def EncryptedData(self):
+        r"""<p>使用 AES-CBC 或 SM4-CBC 加密请求内容得到的密文。加密前请求内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptedData
+
+    @EncryptedData.setter
+    def EncryptedData(self, EncryptedData):
+        self._EncryptedData = EncryptedData
+
+    @property
+    def EncryptionSignature(self):
+        r"""<p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptionSignature
+
+    @EncryptionSignature.setter
+    def EncryptionSignature(self, EncryptionSignature):
+        self._EncryptionSignature = EncryptionSignature
+
+
+    def _deserialize(self, params):
+        self._RequestAction = params.get("RequestAction")
+        self._IV = params.get("IV")
+        self._EncryptedData = params.get("EncryptedData")
+        self._EncryptionSignature = params.get("EncryptionSignature")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class CreateRequestWithEncryptionResponse(AbstractModel):
+    r"""CreateRequestWithEncryption返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _IV: <p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :type IV: str
+        :param _EncryptedData: <p>使用 AES-CBC 或 SM4-CBC 加密返回内容得到的密文。加密前返回内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :type EncryptedData: str
+        :param _EncryptionSignature: <p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :type EncryptionSignature: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._IV = None
+        self._EncryptedData = None
+        self._EncryptionSignature = None
+        self._RequestId = None
+
+    @property
+    def IV(self):
+        r"""<p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._IV
+
+    @IV.setter
+    def IV(self, IV):
+        self._IV = IV
+
+    @property
+    def EncryptedData(self):
+        r"""<p>使用 AES-CBC 或 SM4-CBC 加密返回内容得到的密文。加密前返回内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptedData
+
+    @EncryptedData.setter
+    def EncryptedData(self, EncryptedData):
+        self._EncryptedData = EncryptedData
+
+    @property
+    def EncryptionSignature(self):
+        r"""<p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptionSignature
+
+    @EncryptionSignature.setter
+    def EncryptionSignature(self, EncryptionSignature):
+        self._EncryptionSignature = EncryptionSignature
+
+    @property
+    def RequestId(self):
+        r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._IV = params.get("IV")
+        self._EncryptedData = params.get("EncryptedData")
+        self._EncryptionSignature = params.get("EncryptionSignature")
+        self._RequestId = params.get("RequestId")
+
+
 class CreateResultPageConfig(AbstractModel):
     r"""发起流程的可嵌入页面操作结果页配置
 

{tencentcloud_sdk_python_ess-3.1.157.dist-info → tencentcloud_sdk_python_ess-3.1.166.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.1.157
+Version: 3.1.166
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common <4.0.0,>=3.1.157
+Requires-Dist: tencentcloud-sdk-python-common <4.0.0,>=3.1.166
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_ess-3.1.166.dist-info/RECORD

@@ -0,0 +1,11 @@
+tencentcloud/__init__.py,sha256=yhpZww772TBu5Yq4CtKLQ0oSRJtTQXXtyIoWDqLX-L4,630
+tencentcloud/ess/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/ess/v20201111/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/ess/v20201111/errorcodes.py,sha256=F1_B_bBaEBV-LQ2Y2sOZx6STYdPLCrmovN1kMS4Y-f0,28910
+tencentcloud/ess/v20201111/ess_client.py,sha256=NgfpzsDnCgroEBvh1CZgEFA8f5Nr4W0s8BG5GsZeJxw,263368
+tencentcloud/ess/v20201111/ess_client_async.py,sha256=L5W8MzIMaxlGFby7bMG6xxkezWLXDv8VqEH_BiC36Zg,214946
+tencentcloud/ess/v20201111/models.py,sha256=1C7sTOgtJHXQigTRUdpaubhNdz6mdc15Hfew5OSTVUA,2040542
+tencentcloud_sdk_python_ess-3.1.166.dist-info/METADATA,sha256=_mrFoynDT1oymepI5v_lONeDCqvMznDbgtmT6N-hz3Y,1497
+tencentcloud_sdk_python_ess-3.1.166.dist-info/WHEEL,sha256=a5ogxI61vGGBHYbAAwISCXsfU7mxKr76gTpCEmSNOI8,109
+tencentcloud_sdk_python_ess-3.1.166.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_ess-3.1.166.dist-info/RECORD,,

tencentcloud_sdk_python_ess-3.1.157.dist-info/RECORD

@@ -1,11 +0,0 @@
-tencentcloud/__init__.py,sha256=U63FkrJRP7HjC_aWhQCRC4MxxLkVCjY2rI618cSXOY0,630
-tencentcloud/ess/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tencentcloud/ess/v20201111/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tencentcloud/ess/v20201111/errorcodes.py,sha256=F1_B_bBaEBV-LQ2Y2sOZx6STYdPLCrmovN1kMS4Y-f0,28910
-tencentcloud/ess/v20201111/ess_client.py,sha256=kblSg7iiRGyJIUaNztSuILWFeAoBjzR1IA-hddQGwKU,256510
-tencentcloud/ess/v20201111/ess_client_async.py,sha256=8ti3FycxNkBN1olaqZj2T9bc9gMJ9P8M5rsR9USuCsg,208397
-tencentcloud/ess/v20201111/models.py,sha256=krSAa_18Sq9p7NA1nkgVWOxkzsKVM0rW-oRHK_76fuQ,2034143
-tencentcloud_sdk_python_ess-3.1.157.dist-info/METADATA,sha256=7JuqQlO3Am_CiTmI2UajjxfH3OtuNjDadjhm_ewrIPM,1497
-tencentcloud_sdk_python_ess-3.1.157.dist-info/WHEEL,sha256=a5ogxI61vGGBHYbAAwISCXsfU7mxKr76gTpCEmSNOI8,109
-tencentcloud_sdk_python_ess-3.1.157.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_ess-3.1.157.dist-info/RECORD,,