tencentcloud-sdk-python 3.0.1467__tar.gz → 3.0.1469__tar.gz

{tencentcloud-sdk-python-3.0.1467/tencentcloud_sdk_python.egg-info → tencentcloud-sdk-python-3.0.1469}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python
-Version: 3.0.1467
+Version: 3.0.1469
 Summary: Tencent Cloud SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1467'
+__version__ = '3.0.1469'

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/ccc/v20200210/models.py

@@ -17002,11 +17002,20 @@ class StaffStatus(AbstractModel):
         :type Status: str
         :param _SessionId: 状态关联的会话 Id
         :type SessionId: str
+        :param _Reason: 小休原因
+        :type Reason: str
+        :param _StaffEmail: 座席邮箱
+        :type StaffEmail: str
+        :param _StaffNo: 座席工号
+        :type StaffNo: str
         """
         self._Cursor = None
         self._Timestamp = None
         self._Status = None
         self._SessionId = None
+        self._Reason = None
+        self._StaffEmail = None
+        self._StaffNo = None
 
     @property
     def Cursor(self):
@@ -17052,12 +17061,48 @@ class StaffStatus(AbstractModel):
     def SessionId(self, SessionId):
         self._SessionId = SessionId
 
+    @property
+    def Reason(self):
+        r"""小休原因
+        :rtype: str
+        """
+        return self._Reason
+
+    @Reason.setter
+    def Reason(self, Reason):
+        self._Reason = Reason
+
+    @property
+    def StaffEmail(self):
+        r"""座席邮箱
+        :rtype: str
+        """
+        return self._StaffEmail
+
+    @StaffEmail.setter
+    def StaffEmail(self, StaffEmail):
+        self._StaffEmail = StaffEmail
+
+    @property
+    def StaffNo(self):
+        r"""座席工号
+        :rtype: str
+        """
+        return self._StaffNo
+
+    @StaffNo.setter
+    def StaffNo(self, StaffNo):
+        self._StaffNo = StaffNo
+
 
     def _deserialize(self, params):
         self._Cursor = params.get("Cursor")
         self._Timestamp = params.get("Timestamp")
         self._Status = params.get("Status")
         self._SessionId = params.get("SessionId")
+        self._Reason = params.get("Reason")
+        self._StaffEmail = params.get("StaffEmail")
+        self._StaffNo = params.get("StaffNo")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/cdb/v20170320/cdb_client.py

@@ -3052,6 +3052,29 @@ class CdbClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def ModifyDBInstanceModes(self, request):
+        r"""该接口（ModifyDBInstanceModes）用于更改云数据库的模式。
+
+        :param request: Request instance for ModifyDBInstanceModes.
+        :type request: :class:`tencentcloud.cdb.v20170320.models.ModifyDBInstanceModesRequest`
+        :rtype: :class:`tencentcloud.cdb.v20170320.models.ModifyDBInstanceModesResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ModifyDBInstanceModes", params, headers=headers)
+            response = json.loads(body)
+            model = models.ModifyDBInstanceModesResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def ModifyDBInstanceName(self, request):
         r"""本接口(ModifyDBInstanceName)用于修改云数据库实例的名称。
 

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/cdb/v20170320/errorcodes.py

@@ -476,6 +476,9 @@ OPERATIONDENIED_DELAYREPLICATIONRUNNING = 'OperationDenied.DelayReplicationRunni
 # root账号禁止被删除。
 OPERATIONDENIED_DELETEROOTACCOUNTERROR = 'OperationDenied.DeleteRootAccountError'
 
+# 流程冲突，请稍后重试。
+OPERATIONDENIED_FLOWCONFLICT = 'OperationDenied.FlowConflict'
+
 # 该实例无此功能权限。
 OPERATIONDENIED_FUNCTIONDENIED = 'OperationDenied.FunctionDenied'
 

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/cdb/v20170320/models.py

@@ -6086,7 +6086,7 @@ class ClusterNodeInfo(AbstractModel):
 
 
 class ClusterTopology(AbstractModel):
-    r"""集群版的节点拓扑配置。
+    r"""云盘版的节点拓扑配置。
 
     """
 
@@ -14296,14 +14296,14 @@ class DescribeBackupOverviewRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Product: 需要查询备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        :param _Product: 需要查询备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :type Product: str
         """
         self._Product = None
 
     @property
     def Product(self):
-        r"""需要查询备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        r"""需要查询备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :rtype: str
         """
         return self._Product
@@ -14465,7 +14465,7 @@ class DescribeBackupSummariesRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Product: 需要查询备份实时统计的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        :param _Product: 需要查询备份实时统计的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :type Product: str
         :param _Offset: 分页查询数据的偏移量，默认为0。
         :type Offset: int
@@ -14484,7 +14484,7 @@ class DescribeBackupSummariesRequest(AbstractModel):
 
     @property
     def Product(self):
-        r"""需要查询备份实时统计的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        r"""需要查询备份实时统计的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :rtype: str
         """
         return self._Product
@@ -14753,14 +14753,14 @@ class DescribeBinlogBackupOverviewRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Product: 需要查询日志备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        :param _Product: 需要查询日志备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :type Product: str
         """
         self._Product = None
 
     @property
     def Product(self):
-        r"""需要查询日志备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        r"""需要查询日志备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :rtype: str
         """
         return self._Product
@@ -18153,14 +18153,14 @@ class DescribeDataBackupOverviewRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Product: 需要查询数据备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        :param _Product: 需要查询数据备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :type Product: str
         """
         self._Product = None
 
     @property
     def Product(self):
-        r"""需要查询数据备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点云盘版实例，mysql-cluster 指云盘版（原集群版）实例。
+        r"""需要查询数据备份概览的云数据库产品类型。可取值为：mysql 指双节点/三节点的高可用实例，mysql-basic 指单节点（云盘）实例，mysql-cluster 指云盘版实例。
         :rtype: str
         """
         return self._Product
@@ -29194,6 +29194,115 @@ class ModifyDBInstanceLogToCLSResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class ModifyDBInstanceModesRequest(AbstractModel):
+    r"""ModifyDBInstanceModes请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _InstanceId: 实例ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例ID相同。
+        :type InstanceId: str
+        :param _Mode: 云数据库的模式，目前仅支持传入 "protectMode" 表示修改主从同步方式。
+        :type Mode: str
+        :param _ProtectMode: 数据同步方式，可选值：0-异步复制，1-半同步复制，2-强同步复制。
+        :type ProtectMode: int
+        """
+        self._InstanceId = None
+        self._Mode = None
+        self._ProtectMode = None
+
+    @property
+    def InstanceId(self):
+        r"""实例ID，格式如：cdb-c1nl9rpv，与云数据库控制台页面中显示的实例ID相同。
+        :rtype: str
+        """
+        return self._InstanceId
+
+    @InstanceId.setter
+    def InstanceId(self, InstanceId):
+        self._InstanceId = InstanceId
+
+    @property
+    def Mode(self):
+        r"""云数据库的模式，目前仅支持传入 "protectMode" 表示修改主从同步方式。
+        :rtype: str
+        """
+        return self._Mode
+
+    @Mode.setter
+    def Mode(self, Mode):
+        self._Mode = Mode
+
+    @property
+    def ProtectMode(self):
+        r"""数据同步方式，可选值：0-异步复制，1-半同步复制，2-强同步复制。
+        :rtype: int
+        """
+        return self._ProtectMode
+
+    @ProtectMode.setter
+    def ProtectMode(self, ProtectMode):
+        self._ProtectMode = ProtectMode
+
+
+    def _deserialize(self, params):
+        self._InstanceId = params.get("InstanceId")
+        self._Mode = params.get("Mode")
+        self._ProtectMode = params.get("ProtectMode")
+        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 ModifyDBInstanceModesResponse(AbstractModel):
+    r"""ModifyDBInstanceModes返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _AsyncRequestId: 异步任务的请求ID，可使用此ID查询异步任务的执行结果。
+        :type AsyncRequestId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._AsyncRequestId = None
+        self._RequestId = None
+
+    @property
+    def AsyncRequestId(self):
+        r"""异步任务的请求ID，可使用此ID查询异步任务的执行结果。
+        :rtype: str
+        """
+        return self._AsyncRequestId
+
+    @AsyncRequestId.setter
+    def AsyncRequestId(self, AsyncRequestId):
+        self._AsyncRequestId = AsyncRequestId
+
+    @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._AsyncRequestId = params.get("AsyncRequestId")
+        self._RequestId = params.get("RequestId")
+
+
 class ModifyDBInstanceNameRequest(AbstractModel):
     r"""ModifyDBInstanceName请求参数结构体
 
@@ -29457,7 +29566,7 @@ class ModifyDBInstanceSecurityGroupsRequest(AbstractModel):
         :type SecurityGroupIds: list of str
         :param _ForReadonlyInstance: 当传入只读实例 ID 时，默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组， 需要将该入参置为 True。默认为 False。
         :type ForReadonlyInstance: bool
-        :param _OpResourceId: 变更集群版实例只读组时，InstanceId 传实例 ID，需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。
+        :param _OpResourceId: 变更云盘版实例只读组时，InstanceId 传实例 ID，需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。
         :type OpResourceId: str
         """
         self._InstanceId = None
@@ -29501,7 +29610,7 @@ class ModifyDBInstanceSecurityGroupsRequest(AbstractModel):
 
     @property
     def OpResourceId(self):
-        r"""变更集群版实例只读组时，InstanceId 传实例 ID，需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。
+        r"""变更云盘版实例只读组时，InstanceId 传实例 ID，需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。
         :rtype: str
         """
         return self._OpResourceId
@@ -33356,7 +33465,7 @@ class ProxyNodeCustom(AbstractModel):
 
 
 class ReadWriteNode(AbstractModel):
-    r"""集群版 RW 节点的配置。
+    r"""云盘版 RW 节点的配置。
 
     """
 
@@ -33364,7 +33473,7 @@ class ReadWriteNode(AbstractModel):
         r"""
         :param _Zone: RW 节点所在可用区。
         :type Zone: str
-        :param _NodeId: 升级集群版实例时，如果要调整只读节点可用区，需要指定节点id。
+        :param _NodeId: 升级云盘版实例时，如果要调整只读节点可用区，需要指定节点 ID。
         :type NodeId: str
         """
         self._Zone = None
@@ -33383,7 +33492,7 @@ class ReadWriteNode(AbstractModel):
 
     @property
     def NodeId(self):
-        r"""升级集群版实例时，如果要调整只读节点可用区，需要指定节点id。
+        r"""升级云盘版实例时，如果要调整只读节点可用区，需要指定节点 ID。
         :rtype: str
         """
         return self._NodeId
@@ -33407,7 +33516,7 @@ class ReadWriteNode(AbstractModel):
 
 
 class ReadonlyNode(AbstractModel):
-    r"""集群版的 RO 节点配置。
+    r"""云盘版的 RO 节点配置。
 
     """
 
@@ -33417,7 +33526,7 @@ class ReadonlyNode(AbstractModel):
         :type IsRandomZone: str
         :param _Zone: 指定该节点分布在哪个可用区。
         :type Zone: str
-        :param _NodeId: 升级集群版实例时，如果要调整只读节点可用区，需要指定节点id。
+        :param _NodeId: 升级云盘版实例时，如果要调整只读节点可用区，需要指定节点 ID。
         :type NodeId: str
         """
         self._IsRandomZone = None
@@ -33448,7 +33557,7 @@ class ReadonlyNode(AbstractModel):
 
     @property
     def NodeId(self):
-        r"""升级集群版实例时，如果要调整只读节点可用区，需要指定节点id。
+        r"""升级云盘版实例时，如果要调整只读节点可用区，需要指定节点 ID。
         :rtype: str
         """
         return self._NodeId
@@ -38915,7 +39024,7 @@ class UpgradeDBInstanceRequest(AbstractModel):
         :type ZoneId: str
         :param _RoTransType: 针对跨集群搬迁场景，选择同可用区RO的处理逻辑。together-同可用区RO跟随主实例迁移至目标可用区（默认选项），severally-同可用区RO保持原部署模式、不迁移至目标可用区。
         :type RoTransType: str
-        :param _ClusterTopology: 集群版节点拓扑配置。
+        :param _ClusterTopology: 云盘版节点拓扑配置。
         :type ClusterTopology: :class:`tencentcloud.cdb.v20170320.models.ClusterTopology`
         :param _CheckFastUpgradeReboot: 检查原地升级是否需要重启，1 检查， 0 不检查。如果值为1，检查为原地升级需要重启，则会停止升级并进行返回提示，如果为原地升级不重启，则正常执行升级流程。
         :type CheckFastUpgradeReboot: int
@@ -39142,7 +39251,7 @@ class UpgradeDBInstanceRequest(AbstractModel):
 
     @property
     def ClusterTopology(self):
-        r"""集群版节点拓扑配置。
+        r"""云盘版节点拓扑配置。
         :rtype: :class:`tencentcloud.cdb.v20170320.models.ClusterTopology`
         """
         return self._ClusterTopology

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/cdwpg/v20201230/models.py

@@ -1007,11 +1007,14 @@ class DescribeAccountsResponse(AbstractModel):
         :type TotalCount: int
         :param _Accounts: 账号数组
         :type Accounts: list of AccountInfo
+        :param _ErrorMsg: error:...
+        :type ErrorMsg: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._TotalCount = None
         self._Accounts = None
+        self._ErrorMsg = None
         self._RequestId = None
 
     @property
@@ -1036,6 +1039,17 @@ class DescribeAccountsResponse(AbstractModel):
     def Accounts(self, Accounts):
         self._Accounts = Accounts
 
+    @property
+    def ErrorMsg(self):
+        r"""error:...
+        :rtype: str
+        """
+        return self._ErrorMsg
+
+    @ErrorMsg.setter
+    def ErrorMsg(self, ErrorMsg):
+        self._ErrorMsg = ErrorMsg
+
     @property
     def RequestId(self):
         r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
@@ -1056,6 +1070,7 @@ class DescribeAccountsResponse(AbstractModel):
                 obj = AccountInfo()
                 obj._deserialize(item)
                 self._Accounts.append(obj)
+        self._ErrorMsg = params.get("ErrorMsg")
         self._RequestId = params.get("RequestId")
 
 

{tencentcloud-sdk-python-3.0.1467 → tencentcloud-sdk-python-3.0.1469}/tencentcloud/cls/v20201016/models.py

@@ -6096,7 +6096,7 @@ class CreateCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :type CloudProductRegion: str
         :param _ClsRegion: CLS目标地域
@@ -6173,7 +6173,7 @@ class CreateCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :rtype: str
         """
@@ -11575,7 +11575,7 @@ class DeleteCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :type CloudProductRegion: str
         """
@@ -11630,7 +11630,7 @@ class DeleteCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :rtype: str
         """
@@ -23706,7 +23706,7 @@ class ModifyCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :type CloudProductRegion: str
         :param _Extend: 日志配置拓展信息， 一般用于存储额外的日志投递配置
@@ -23764,7 +23764,7 @@ class ModifyCloudProductLogCollectionRequest(AbstractModel):
 - DCDB所有日志类型：gz
 - MariaDB所有日志类型：gz
 - PostgreSQL所有日志类型：gz
-- BH所有日志类型：overseas-polaris(国内站海外)/fsi-polaris(国内站金融)/general-polaris(国内站普通)/intl-sg-prod(国际站)
+- BH所有日志类型：overseas-polaris(中国香港地区和其他)/fsi-polaris(金融区)/general-polaris(普通区)/intl-sg-prod(国际站)
 - APIS所有日志类型：gz
         :rtype: str
         """