ucloud · Ali1213 · Aug 21, 2026 · Aug 20, 2026
diff --git a/ucloud/services/ukms/client.py b/ucloud/services/ukms/client.py
@@ -214,7 +214,6 @@ def describe_key(self, req: typing.Optional[dict] = None, **kwargs) -> dict:
         - **KeyState** (str) - 密钥对外状态。取值：Enabled、Disabled、PendingDeletion、PendingImport、Unavailable。
         - **KeyUsage** (list) - 密钥用途。取值：ENCRYPT_DECRYPT、SIGN_VERIFY、GENERATE_VERIFY_MAC、KEY_AGREEMENT。
         - **KeyVersion** (int) - 当前密钥版本。
-        - **OrganizationId** (int) - 密钥所属组织的数字 ID，来源于密钥关联的资源交易记录。
         - **Origin** (str) - 密钥材料来源。取值：UCLOUD_KMS、EXTERNAL；当前 CreateKey 仅支持 UCLOUD_KMS。
         - **ProjectId** (str) - 密钥所属项目的对外别名，格式为 org-xxx。该值由项目数字 ID 解析得到，可能因项目别名查询失败而为空。
         - **ResourceId** (str) - 密钥所属的 UKMS 实例资源 ID。
@@ -419,6 +418,11 @@ def generate_data_key_pair(
 
         **Response**
 
+        - **DataPublicKey** (str) - 公钥（明文）。
+        - **KeyId** (str) - 用于加密私钥的 KMS 密钥
+        - **KeyPairSpec** (str) - 生成的数据键对类型。
+        - **PrivateKeyCiphertextBlob** (str) - 私钥的加密副本。
+        - **PrivateKeyPlaintext** (str) - 私钥的明文副本。
 
         """
         # build request
@@ -445,6 +449,8 @@ def generate_data_key_pair_without_plaintext(
         - **ProjectId** (str) - (Config) 项目ID。不填写为默认项目，子帐号必须填写。 请参考 `GetProjectList接口 <https://docs.ucloud.cn/api/summary/get_project_list>`_
         - **Region** (str) - (Config) 地域。 参见  `地域和可用区列表 <https://docs.ucloud.cn/api/summary/regionlist>`_
         - **KeyId** (str) - (Required) 密钥ID
+        - **KeyPairSpec** (str) - (Required) 指定生成的数据密钥对类型。
+        - **EncryptionContext** (str) - 指定加密私钥时使用的加密上下文。
 
         **Response**
 
@@ -545,6 +551,7 @@ def generate_random(
 
         **Response**
 
+        - **Plaintext** (str) - 随机字节串。
 
         """
         # build request
@@ -722,36 +729,39 @@ def list_keys(self, req: typing.Optional[dict] = None, **kwargs) -> dict:
     def list_schedule_deletion_keys(
         self, req: typing.Optional[dict] = None, **kwargs
     ) -> dict:
-        """ListScheduleDeletionKeys - 获取计划删除密钥列表，调用ScheduleKeyDeletion命令后进入此列表， 默认30天后正式删除。正式删除前可调用CancelScheduleKeyDeletion恢复
+        """ListScheduleDeletionKeys -
 
         **Request**
 
-        - **ProjectId** (str) - (Config) 项目ID。不填写为默认项目，子帐号必须填写。 请参考 `GetProjectList接口 <https://docs.ucloud.cn/api/summary/get_project_list>`_
-        - **Alias** (str) - 按密钥 ID 或别名模糊过滤
-        - **Limit** (int) - 输出列表数量，默认返回200个
-        - **Offset** (int) - 输出列表起始位置，默认从0开始
-        - **OrderBy** (str) - 列表排序方式, 可选项: "-created_time", "created_time","plan_delete_time","-plan_delete_time";默认按-plan_delete_time 计划删除时间升序返回
-        - **ResourceId** (str) - UKMS 实例资源 ID
-        - **Sort** (str) - 排序方向，默认 desc
+        - **ProjectId** (str) - (Config)
+        - **Alias** (str) -
+        - **Limit** (int) -
+        - **Offset** (int) -
+        - **OrderBy** (str) -
+        - **ResourceId** (str) -
+        - **Sort** (str) -
 
         **Response**
 
         - **Objects** (list) - 见 **CMK** 模型定义
-        - **RequestUuid** (str) - 请求唯一标识符
-        - **Status** (str) - 操作结果
-        - **TotalCount** (int) - 符合条件的总数, 不同于Limit
+        - **RequestUuid** (str) -
+        - **Status** (str) -
+        - **TotalCount** (int) -
 
         **Response Model**
 
         **CMK**
-        - **Alias** (str) - 别名，与CMK一一对应
-        - **CreatedTime** (int) - 创建时间
-        - **Description** (str) - 对密钥的描述说明
-        - **KeyId** (str) - CMK 的唯一标识符
-        - **KeyType** (str) - 密钥类型，如RSA、EC、DES
-        - **PlanDeleteTime** (int) - 计划删除时间 时间戳
-        - **Status** (str) - 密钥状态 "Pre-Active", "Active", "Deactivated", "Compromised", "Destroyed", "Destroyed Compromised"
-        - **UpdateTime** (int) - 更新时间
+        - **Alias** (str) -
+        - **CreatedTime** (int) -
+        - **Description** (str) -
+        - **Enabled** (bool) -
+        - **KeyId** (str) -
+        - **KeyType** (str) -
+        - **LastModifiedTime** (int) -
+        - **PlanDeleteTime** (int) -
+        - **Status** (str) -
+        - **Type** (str) -
+        - **UpdateTime** (int) -
 
 
         """
@@ -762,6 +772,9 @@ def list_schedule_deletion_keys(
         req and d.update(req)
         d = apis.ListScheduleDeletionKeysRequestSchema().dumps(d)
 
+        # build options
+        kwargs["max_retries"] = 0  # ignore retry when api is not idempotent
+
         resp = self.invoke("ListScheduleDeletionKeys", d, **kwargs)
         return apis.ListScheduleDeletionKeysResponseSchema().loads(resp)
 
@@ -941,7 +954,7 @@ def verify(self, req: typing.Optional[dict] = None, **kwargs) -> dict:
         return apis.VerifyResponseSchema().loads(resp)
 
     def verify_mac(self, req: typing.Optional[dict] = None, **kwargs) -> dict:
-        """VerifyMac - 验证签名
+        """VerifyMac - 验证指定消息、HMAC KMS 密钥和 MAC 算法的基于哈希的消息认证码 (HMAC)。为了验证 HMAC，VerifyMac 会使用您指定的消息、HMAC KMS 密钥和 MAC 算法计算 HMAC，并将计算出的 HMAC 与您指定的 HMAC 进行比较。如果两个 HMAC 完全相同，则验证成功；否则，验证失败。  验证结果表明，自计算 HMAC 以来，消息未发生更改，并且使用了指定的密钥来生成和验证 HMAC。
 
         **Request**
 

diff --git a/ucloud/services/ukms/schemas/apis.py b/ucloud/services/ukms/schemas/apis.py
@@ -392,7 +392,17 @@ class GenerateDataKeyPairRequestSchema(schema.RequestSchema):
 class GenerateDataKeyPairResponseSchema(schema.ResponseSchema):
     """GenerateDataKeyPair - 创建数据密钥对"""
 
-    fields = {}
+    fields = {
+        "DataPublicKey": fields.Str(required=False, load_from="DataPublicKey"),
+        "KeyId": fields.Str(required=False, load_from="KeyId"),
+        "KeyPairSpec": fields.Str(required=False, load_from="KeyPairSpec"),
+        "PrivateKeyCiphertextBlob": fields.Str(
+            required=False, load_from="PrivateKeyCiphertextBlob"
+        ),
+        "PrivateKeyPlaintext": fields.Str(
+            required=False, load_from="PrivateKeyPlaintext"
+        ),
+    }
 
 
 """
@@ -406,7 +416,11 @@ class GenerateDataKeyPairWithoutPlaintextRequestSchema(schema.RequestSchema):
     """GenerateDataKeyPairWithoutPlaintext - 创建数据密钥对（无明文返回）"""
 
     fields = {
+        "EncryptionContext": fields.Str(
+            required=False, dump_to="EncryptionContext"
+        ),
         "KeyId": fields.Str(required=True, dump_to="KeyId"),
+        "KeyPairSpec": fields.Str(required=True, dump_to="KeyPairSpec"),
         "ProjectId": fields.Str(required=False, dump_to="ProjectId"),
         "Region": fields.Str(required=True, dump_to="Region"),
     }
@@ -498,7 +512,9 @@ class GenerateRandomRequestSchema(schema.RequestSchema):
 class GenerateRandomResponseSchema(schema.ResponseSchema):
     """GenerateRandom - 生成随机数"""
 
-    fields = {}
+    fields = {
+        "Plaintext": fields.Str(required=False, load_from="Plaintext"),
+    }
 
 
 """
@@ -647,12 +663,12 @@ class ListKeysResponseSchema(schema.ResponseSchema):
 """
 API: ListScheduleDeletionKeys
 
-获取计划删除密钥列表，调用ScheduleKeyDeletion命令后进入此列表， 默认30天后正式删除。正式删除前可调用CancelScheduleKeyDeletion恢复
+
 """
 
 
 class ListScheduleDeletionKeysRequestSchema(schema.RequestSchema):
-    """ListScheduleDeletionKeys - 获取计划删除密钥列表，调用ScheduleKeyDeletion命令后进入此列表， 默认30天后正式删除。正式删除前可调用CancelScheduleKeyDeletion恢复"""
+    """ListScheduleDeletionKeys -"""
 
     fields = {
         "Alias": fields.Str(required=False, dump_to="Alias"),
@@ -666,7 +682,7 @@ class ListScheduleDeletionKeysRequestSchema(schema.RequestSchema):
 
 
 class ListScheduleDeletionKeysResponseSchema(schema.ResponseSchema):
-    """ListScheduleDeletionKeys - 获取计划删除密钥列表，调用ScheduleKeyDeletion命令后进入此列表， 默认30天后正式删除。正式删除前可调用CancelScheduleKeyDeletion恢复"""
+    """ListScheduleDeletionKeys -"""
 
     fields = {
         "Objects": fields.List(
@@ -860,12 +876,12 @@ class VerifyResponseSchema(schema.ResponseSchema):
 """
 API: VerifyMac
 
-验证签名
+验证指定消息、HMAC KMS 密钥和 MAC 算法的基于哈希的消息认证码 (HMAC)。为了验证 HMAC，VerifyMac 会使用您指定的消息、HMAC KMS 密钥和 MAC 算法计算 HMAC，并将计算出的 HMAC 与您指定的 HMAC 进行比较。如果两个 HMAC 完全相同，则验证成功；否则，验证失败。  验证结果表明，自计算 HMAC 以来，消息未发生更改，并且使用了指定的密钥来生成和验证 HMAC。
 """
 
 
 class VerifyMacRequestSchema(schema.RequestSchema):
-    """VerifyMac - 验证签名"""
+    """VerifyMac - 验证指定消息、HMAC KMS 密钥和 MAC 算法的基于哈希的消息认证码 (HMAC)。为了验证 HMAC，VerifyMac 会使用您指定的消息、HMAC KMS 密钥和 MAC 算法计算 HMAC，并将计算出的 HMAC 与您指定的 HMAC 进行比较。如果两个 HMAC 完全相同，则验证成功；否则，验证失败。  验证结果表明，自计算 HMAC 以来，消息未发生更改，并且使用了指定的密钥来生成和验证 HMAC。"""
 
     fields = {
         "KeyId": fields.Str(required=True, dump_to="KeyId"),
@@ -878,7 +894,7 @@ class VerifyMacRequestSchema(schema.RequestSchema):
 
 
 class VerifyMacResponseSchema(schema.ResponseSchema):
-    """VerifyMac - 验证签名"""
+    """VerifyMac - 验证指定消息、HMAC KMS 密钥和 MAC 算法的基于哈希的消息认证码 (HMAC)。为了验证 HMAC，VerifyMac 会使用您指定的消息、HMAC KMS 密钥和 MAC 算法计算 HMAC，并将计算出的 HMAC 与您指定的 HMAC 进行比较。如果两个 HMAC 完全相同，则验证成功；否则，验证失败。  验证结果表明，自计算 HMAC 以来，消息未发生更改，并且使用了指定的密钥来生成和验证 HMAC。"""
 
     fields = {
         "KeyId": fields.Str(required=False, load_from="KeyId"),

diff --git a/ucloud/services/ukms/schemas/models.py b/ucloud/services/ukms/schemas/models.py
@@ -21,7 +21,7 @@ class KeyMetadataSchema(schema.ResponseSchema):
         "KeyVersion": fields.Int(required=True, load_from="KeyVersion"),
         "OrganizationId": fields.Int(
             required=False, load_from="OrganizationId"
-        ),
+        ),  # Deprecated, will be removed at 1.0
         "Origin": fields.Str(required=True, load_from="Origin"),
         "ProjectId": fields.Str(required=False, load_from="ProjectId"),
         "ResourceId": fields.Str(required=True, load_from="ResourceId"),
@@ -74,26 +74,22 @@ class DEKSchema(schema.ResponseSchema):
 
 
 class CMKSchema(schema.ResponseSchema):
-    """CMK - 用户主密钥 (Customer Master Key), 用于生成数据密钥 (Data Encryption Key), 加解密数据密钥."""
+    """CMK -"""
 
     fields = {
         "Alias": fields.Str(required=True, load_from="Alias"),
         "CreatedTime": fields.Int(required=True, load_from="CreatedTime"),
         "Description": fields.Str(required=False, load_from="Description"),
-        "Enabled": fields.Bool(
-            required=True, load_from="Enabled"
-        ),  # Deprecated, will be removed at 1.0
+        "Enabled": fields.Bool(required=True, load_from="Enabled"),
         "KeyId": fields.Str(required=True, load_from="KeyId"),
         "KeyType": fields.Str(required=True, load_from="KeyType"),
         "LastModifiedTime": fields.Int(
             required=True, load_from="LastModifiedTime"
-        ),  # Deprecated, will be removed at 1.0
+        ),
         "PlanDeleteTime": fields.Int(
             required=False, load_from="PlanDeleteTime"
         ),
         "Status": fields.Str(required=True, load_from="Status"),
-        "Type": fields.Str(
-            required=True, load_from="Type"
-        ),  # Deprecated, will be removed at 1.0
+        "Type": fields.Str(required=True, load_from="Type"),
         "UpdateTime": fields.Int(required=True, load_from="UpdateTime"),
     }
diff --git a/ucloud/version.py b/ucloud/version.py
@@ -1 +1 @@
-version = "0.11.118"
+version = "0.11.119"