获取MaxCompute项目列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| odps:ListProjects | list | *Project acs:odps:{#regionId}:{#accountId}:projects/* |
| 无 |
请求语法
GET /api/v1/projects HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| tenantId | string | 否 | 租户 ID。可以通过登录 MaxCompute 控制台，在左侧导航栏选择租户管理>租户属性查看。 | 5495****3697 |
| region | string | 否 | 地域 ID。 | cn-beijing |
| quotaNickName | string | 否 | Quota 昵称（可通过登录 MaxCompute 控制台，在左侧导航栏选择工作区>配额（Quota）管理查看获取）。 | os_PayAsYouGoQuota |
| quotaName | string | 否 | Quota 名称（系统自动生成，可通过登录 MaxCompute 控制台，在左侧导航栏选择工作区>配额（Quota）管理查看获取）。 | aliyun_5495***3697 |
| prefix | string | 否 | 限定返回的资源名称，名称必须以 Prefix 作为前缀，例如 Prefix 是 a，则返回的资源名均是以 a 开始的。 | a |
| marker | string | 否 | 设定结果从 marker 之后按字母排序的第一个开始返回。 | cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg== |
| maxItem | integer | 否 | 每页返回的最大结果数，默认为 10。 | 10 |
| saleTags | string | 否 | 默认计算 Quota 的实例 ID 与付费类型。 | { "resourceId": "b7afb7d1-****-****-****-c393669c307b", "resourceType": "PayAsYouGo" } |
| type | string | 否 | 项目类型。取值：
| managed |
| listSystemCatalog | boolean | 否 | 是否列出内建SYSTEM_CATALOG项目，用于提供项目元数据及使用历史数据等信息，详细请参考 Information Schema功能。 枚举值：
| true |
返回参数
示例
正常返回示例
JSON格式
{
"requestId": "0b16399216671970335563173e2340",
"data": {
"projects": [
{
"name": "odps_project",
"owner": "ALIYUN$odps****@aliyunid.com\n",
"type": "managed",
"comment": "BI_Analysis",
"defaultQuota": "os_PayAsYouGoQuota\n",
"status": "AVAILABLE",
"costStorage": "16489027",
"regionId": "cn-beijing",
"createdTime": 1704380838000,
"properties": {
"timezone": "Asia/Shanghai\n",
"retentionDays": 1,
"allowFullScan": false,
"typeSystem": "2",
"enableDecimal2": true,
"sqlMeteringMax": "1500",
"tableLifecycle": {
"type": "optional",
"value": "37231\n"
},
"encryption": {
"enable": true,
"algorithm": "AES256",
"key": "dafault"
},
"tunnelQuota": "Default",
"enableTunnelQuotaRoute": true,
"externalProjectProperties": {
"isExternalCatalogBound": "true"
}
},
"securityProperties": {
"usingAcl": true,
"usingPolicy": true,
"objectCreatorHasAccessPermission": true,
"objectCreatorHasGrantPermission": true,
"labelSecurity": false,
"enableDownloadPrivilege": false,
"projectProtection": {
"protected": true,
"exceptionPolicy": "{\n \"Version\": \"1\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Principal\": \"\",\n \"Action\": [\n \"odps:[, , ...]\"\n ],\n \"Resource\": \"acs:odps:*:\",\n \"Condition\": {\n \"StringEquals\": {\n \"odps:TaskType\": [\n \"\"\n ]\n }\n }\n }\n ]\n}"
}
},
"ipWhiteList": {
"ipList": "10.88.111.3",
"vpcIpList": "10.88.111.3"
},
"saleTag": {
"resourceId": "b7afb7d1-****-****-****-c393669c307b\n",
"resourceType": "PayAsYouGo\n"
},
"threeTierModel": true
}
],
"marker": "cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==",
"maxItem": 10,
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kvikyUl3ChyRxN+qLPvtOb"
}
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-09-12 | OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-07-31 | OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-01-08 | OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2023-11-14 | OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2023-09-21 | OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2023-08-23 | OpenAPI 入参发生变更 | 查看变更详情 |