ListCatalogs - 查询数据目录列表 - 开源大数据平台E-MapReduce

查看数据目录列表

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

emr-serverless-spark:ListCatalogs

list

*全部资源

*

无

请求语法

GET /api/v1/workspaces/{workspaceId}/catalogs HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	否	工作空间 ID。	w-d2d82aa09155****

请求参数

名称	类型	必填	描述	示例值
environment	string	否	环境类型。枚举值： dev : dev production : production	dev
regionId	string	否	区域 ID。	cn-hangzhou

返回参数

名称	类型	描述	示例值
	object	返回数据
catalogs	array<object>	数据目录。
	array<object>	数据目录。
catalogId	string	数据目录 ID。	15097**********
workspaceId	string	工作空间 ID。	w-d2d82aa09155****
environments	array	环境类型。
	string	环境类型。	dev,production
catalogType	string	是否为默认数据目录。	default_catalog
catalogProvider	string	数据目录类型。	HMS
gmtCreate	integer	创建时间。	1760604889
gmtModified	integer	更新时间。	1760604889
resourceOwnerId	string	资源持有者 ID。	15097**********
alias	string		alias
extras	object	额外信息。
	string	额外信息。	{"networkName":"hms","metastoreUrl":"thrift://master-1-1.c-70*******.cn-hangzhou.emr.aliyuncs.com:9083","keytabPath":"oss://****/hive.keytab","principal":"hive/master-1-1.c-70**************"}
requestId	string	请求 ID。	DD6B1B2A-5837-5237-ABE4-FF0C8944****
nextToken	string	下一页 TOKEN。	1
totalCount	integer	记录总数。	200
maxResults	integer	一次获取的最大记录数。	20

示例

正常返回示例

JSON格式

{
  "catalogs": [
    {
      "catalogId": "15097**********",
      "workspaceId": "w-d2d82aa09155****\n",
      "environments": [
        "dev,production"
      ],
      "catalogType": "default_catalog",
      "catalogProvider": "HMS",
      "gmtCreate": 1760604889,
      "gmtModified": 1760604889,
      "resourceOwnerId": "15097**********",
      "alias": "alias",
      "extras": {
        "key": "{\"networkName\":\"hms\",\"metastoreUrl\":\"thrift://master-1-1.c-70*********.cn-hangzhou.emr.aliyuncs.com:9083\",\"keytabPath\":\"oss://********/hive.keytab\",\"principal\":\"hive/master-1-1.c-70****************\"}"
      }
    }
  ],
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "nextToken": "1",
  "totalCount": 200,
  "maxResults": 20
}

错误码

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

变更历史

更多信息，参考变更详情。