获取MaxCompute项目列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| odps:ListProjects | List |
|
| 无 |
请求语法
GET /api/v1/projects
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| tenantId | string | 否 | 租户 ID | 549532154333697 |
| region | string | 否 | 地域。 | cn-beijing |
| quotaNickName | string | 否 | Quota 名称。 | quotaA |
| quotaName | string | 否 | 这是 quota 在 maxcompute 内部的标识，与 quotaNickname 有区别。quotaNickname 是用户设置的，quotaName 是系统自动生成的。这个字段仅用于描述数据通道 quota。 | "hsajkdgbkaubh" |
| prefix | string | 否 | 限定返回的资源名称，名称必须以 Prefix 作为前缀，例如 Prefix 是 a，则返回的资源名均是以 a 开始的。 | a |
| marker | string | 否 | 设定结果从 marker 之后按字母排序的第一个开始返回。 | cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg== |
| maxItem | integer | 否 | 每页返回的最大结果数。 | 10 |
| saleTags | string | 否 | 描述了 MaxCompute quota 对象的标识，这个标识与阿里云售卖账单中的标识是一致的。实际使用与标签场景下。 | "aaaa-bbbb" |
| type | string | 否 | 这个 type 用于描述内部项目和外部项目。"external“ 表示外部项目，用于湖仓一体场景下。"managed" 表示内部项目。 | "managed" |
| listSystemCatalog | boolean | 否 | 是否列出 SystemCatalog。 枚举值：
| true |
返回参数
示例
正常返回示例
JSON格式
{
"requestId": "0b16399216671970335563173e2340",
"data": {
"projects": [
{
"name": "odps_project",
"owner": "113981577560****",
"type": "managed",
"comment": "MaxCompute项目\n",
"defaultQuota": "quotaA",
"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": "SHA1",
"key": "dafault"
},
"tunnelQuota": "quota_tunnel",
"enableTunnelQuotaRoute": 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": "\"aaaa-bbbb\"",
"resourceType": "\"project\""
},
"Tags": [
{
"TagValue": "acceptance test",
"TagKey": "Department"
}
],
"threeTierModel": true
}
],
"marker": "cHlvZHBzX3VkZl8xMDExNV8xNDU3NDI4NDkzKg==",
"maxItem": 10,
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kvikyUl3ChyRxN+qLPvtOb"
}
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||
|---|---|---|---|---|---|---|---|---|
| 2024-01-08 | OpenAPI 返回结构发生变更 | 看变更集 | ||||||
| ||||||||
| 2023-11-14 | OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 看变更集 | ||||||
| ||||||||
| 2023-09-21 | OpenAPI 返回结构发生变更 | 看变更集 | ||||||
| ||||||||
| 2023-08-23 | OpenAPI 入参发生变更 | 看变更集 | ||||||
|