ListUserPermissions_权限管理_API参考

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	ListUserPermissions	系统规定参数。取值：ListUserPermissions。
PermType	String	是	DATABASE	资源权限类型，取值和说明请参考 ListDatabaseUserPermssions API
Tid	Long	是	-1	租户ID
UserId	String	是	13435	用户ID
DatabaseName	String	否	db_name	库名
DbType	String	否	mysql	数据库类型
EnvType	String	否	dev	库所属环境类型
Logic	Boolean	否	false	是否逻辑库
PageNumber	Integer	否	1	第几页
PageSize	Integer	否	1	每页数据量

返回数据


名称	类型	示例值	描述
ErrorCode	String	UnknownError	错误码
ErrorMessage	String	UnknownError	错误信息
RequestId	String	C51420E3-144A-4A94-B473-8662FCF4AD10	请求ID
Success	Boolean	true	请求是否成功
TotalCount	Long	6	满足条件记录总数
UserPermissions	Array		用户权限信息列表
UserPermission			用户权限信息列表
Alias	String	instance_alias	实例别名
ColumnName	String	column_name	字段名
DbId	String	1324	库ID
DbType	String	mysql	数据库类型
DsType	String	DATABASE	权限资源类型
EnvType	String	dev	数据库所属环境类型
InstanceId	String	134	实例ID
Logic	Boolean	false	是否逻辑库
PermDetails	Array		权限详情
PermDetail			权限详情
CreateDate	String	2019-12-12 00:00:00	权限授予时间
ExpireDate	String	2020-12-12 00:00:00	授权到期时间
ExtraData	String	xxx	额外数据，预留参数
OriginFrom	String	xxx	权限授予来源信息
PermType	String	QUERY	权限类型
UserAccessId	String	1345	授权记录ID
SchemaName	String	test_db	库名
SearchName	String	test_db@xxx:3306	库搜索名
TableId	String	13434	表ID
TableName	String	test_table	表名
UserId	String	423245	用户ID
UserNickName	String	nick_name	用户名

示例

请求示例


http(s)://[Endpoint]/?Action=ListUserPermissions
&PermType=DATABASE
&Tid=-1
&UserId=13435
&<公共请求参数>

正常返回示例

XML 格式

<UserPermissions>
    <UserPermission>
        <Logic>false</Logic>
        <UserNickName>xxx</UserNickName>
        <DsType>DATABASE</DsType>
        <Alias>xxx_ent_dev</Alias>
        <PermDetails>
            <PermDetail>
                <ExpireDate>2020-10-31 00:00:00</ExpireDate>
                <UserAccessId>390913</UserAccessId>
                <PermType>EXPORT</PermType>
                <OriginFrom>xxx</OriginFrom>
                <CreateDate>2019-11-21 15:07:45</CreateDate>
            </PermDetail>
            <PermDetail>
                <ExpireDate>2020-10-31 00:00:00</ExpireDate>
                <UserAccessId>390914</UserAccessId>
                <PermType>CORRECT</PermType>
                <OriginFrom>xxx</OriginFrom>
                <CreateDate>2019-11-21 15:07:45</CreateDate>
            </PermDetail>
        </PermDetails>
        <InstanceId>24671</InstanceId>
        <SearchName>xxx@xxx:3306【xxx_ent_dev】</SearchName>
        <DbId>111369</DbId>
        <UserId>88658</UserId>
        <DbType>drds</DbType>
        <EnvType>dev</EnvType>
        <SchemaName>xxx_ent_dev</SchemaName>
    </UserPermission>
</UserPermissions>
<TotalCount>6</TotalCount>
<RequestId>C51420E3-144A-4A94-B473-8662FCF4AD10</RequestId>
<Success>true</Success>

JSON 格式

{
	"UserPermissions":{
		"UserPermission":[
			{
				"Logic":false,
				"UserNickName":"xxx",
				"DsType":"DATABASE",
				"Alias":"xxx_ent_dev",
				"PermDetails":{
					"PermDetail":[
						{
							"ExpireDate":"2020-10-31 00:00:00",
							"UserAccessId":"390913",
							"PermType":"EXPORT",
							"OriginFrom":"xxx",
							"CreateDate":"2019-11-21 15:07:45"
						},
						{
							"ExpireDate":"2020-10-31 00:00:00",
							"UserAccessId":"390914",
							"PermType":"CORRECT",
							"OriginFrom":"xxx",
							"CreateDate":"2019-11-21 15:07:45"
						}
					]
				},
				"SearchName":"xxx@xxx:3306【xxx_ent_dev】",
				"InstanceId":24671,
				"DbId":111369,
				"UserId":88658,
				"DbType":"drds",
				"EnvType":"dev",
				"SchemaName":"xxx_ent_dev"
			}
		]
	},
	"TotalCount":6,
	"RequestId":"C51420E3-144A-4A94-B473-8662FCF4AD10",
	"Success":true
}

错误码

访问错误中心查看更多错误码。