查询MaxCompute项目的基本信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
odps:GetProject |
get |
*Project
|
无 | 无 |
请求语法
GET /api/v1/projects/{projectName} HTTP/1.1
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
projectName |
string |
是 |
项目名称。 |
odps_project |
verbose |
boolean |
否 |
是否带有附加信息 |
true |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
请求返回参数。 |
||
requestId |
string |
请求 ID。 |
0b87b7b316643495896551555e855b |
httpCode |
integer |
HTTP 状态码。
|
200 |
errorCode |
string |
错误码。 |
OBJECT_NOT_EXIST |
errorMsg |
string |
错误信息。 |
This object does not exist. |
data |
object |
请求返回结果。 |
|
name |
string |
项目名称。 |
odps_project |
owner |
string |
项目 owner 账号信息。 |
ALIYUN$odps****@aliyunid.com |
type |
string |
项目类型。取值:
|
managed |
comment |
string |
项目描述。 |
BI_Analysis |
defaultQuota |
string |
默认计算 Quota。 用于实现计算资源分配。不指定计算 Quota 的情况下,该项目发起的作业将消耗默认 Quota 资源。更多计算资源使用请参见计算资源-Quota 使用 。 |
os_PayAsYouGoQuota |
status |
string |
项目状态。取值:
|
AVAILABLE |
productType |
string |
默认计算 Quota 的计费模式。 |
PayAsYouGo |
threeTierModel |
boolean |
是否支持按 Schema 存储。 MaxCompute 支持 Schema,处于 Project 下,Table、Resource、UDF 上的对象,对 Table、Resource、UDF 进行归类。一个 Project 下可以有多个 Schema。详情请参见Schema 操作 。 |
true |
costStorage |
string |
存储总量。 查看项目当前存储大小,此存储量与计量口径一致,即按 Project 采集压缩后的逻辑存储大小。 |
16489027 |
regionId |
string |
地域 ID。 |
cn-beijing |
createdTime |
integer |
创建时间。 |
1704380838000 |
properties |
object |
项目基础属性。 |
|
timezone |
string |
项目时区,即为 |
Asia/Shanghai |
retentionDays |
integer |
备份数据的保留天数。在此期间,您可以将当前版本恢复至任意一个备份的数据版本。 取值范围为[0,30],默认值为 1,0 代表关闭备份功能。 |
1 |
allowFullScan |
boolean |
项目空间是否允许全表扫描。全表扫描会占用大量资源,为提升处理效率,默认关闭该功能。 |
false |
typeSystem |
string |
数据类型版本。取值:
三种数据类型版本的区别请参见数据类型版本说明 。 |
2.0 |
enableDecimal2 |
boolean |
项目是否开启 MaxCompute 2.0 的 Decimal 数据类型。 |
true |
sqlMeteringMax |
string |
单 SQL 消费的最高阈值。 单位:扫描量(GB)*复杂度。 |
1500 |
tableLifecycle |
object |
表的生命周期属性。 |
|
type |
string |
生命周期类型。取值:
|
optional |
value |
string |
表的生命周期,单位为:天。取值范围为 1~37231,默认值为 37231。 |
37231 |
encryption |
object |
存储加密属性。 |
|
enable |
boolean |
项目是否需要开启数据加密功能。更多数据加密信息,请参见 存储加密 。 |
true |
algorithm |
string |
数据加密算法:密钥支持的加密算法,包含 AES256、AESCTR 和 RC4。 |
AES256 |
key |
string |
数据加密使用的密钥类型,包含默认密钥(MaxCompute Default Key)和自带密钥(BYOK)。默认密钥(MaxCompute Default Key)是 MaxCompute 内部创建的默认密钥。 |
dafault |
tunnelQuota |
string |
项目绑定的数据传输服务 资源组。
|
Default |
elderTunnelQuota |
string |
项目绑定的数据传输服务资源组父组(无需关注)。 |
Default_p |
enableTunnelQuotaRoute |
boolean |
是否开启数据传输服务资源组路由。
|
true |
storageTierInfo |
object |
分层存储 信息。 |
|
storageTierSize |
object |
分层存储 信息。 |
|
standardSize |
integer |
标准存储用量。 |
27649172 |
longTermSize |
integer |
长期存储用量。 |
21764917 |
lowFrequencySize |
integer |
低频存储用量。 |
767693 |
projectTotalSize |
integer |
总存储用量。 |
56066037 |
projectBackupSize |
integer |
备份存储大小。 |
86672917 |
fdcQuota |
string |
外表缓存 Quota。 |
fdc_quota |
enableFdcCacheForce |
boolean |
是否强制开启外表缓存。 |
true |
enableTieredStorage |
boolean |
是否开启分层存储 。 |
true |
tableLifecycleConfig |
object |
分层存储生命周期规则 属性,设置后系统将基于该规则触发分层存储类型自动转换。 |
|
TierToLongterm |
object |
长期存储标识。 |
|
DaysAfterLastModificationGreaterThan |
integer |
距离数据最后修改时间超过多少天后自动设置,对应表或分区的 |
180 |
DaysAfterLastAccessGreaterThan |
integer |
距离数据最后访问时间超过多少天后自动设置,对应表或分区的 说明
若表或分区的 LastAccessTime 为空,则:
|
180 |
DaysAfterLastTierModificationGreaterThan |
integer |
距离上次转换存储类型的时间。 |
1 |
TierToLowFrequency |
object |
低频存储标识。 |
|
DaysAfterLastModificationGreaterThan |
integer |
定义距离数据最后修改时间超过多少天后自动设置,对应表或分区的 |
30 |
DaysAfterLastAccessGreaterThan |
integer |
定义距离数据最后访问时间超过多少天后自动设置,对应表或分区的 说明
若表或分区的 LastAccessTime 为空,则:
|
30 |
DaysAfterLastTierModificationGreaterThan |
integer |
距离上次转换存储类型的时间。 |
1 |
externalProjectProperties |
object |
外部项目属性。 |
|
isExternalCatalogBound |
string |
是否为湖仓一体 2.0 外部项目。 |
true |
tableFormat |
string |
||
warehouse |
string |
||
foreignServerName |
string |
||
foreignServerType |
string |
||
externalCatalogId |
string |
||
enableAutoMv |
boolean |
||
autoMvQuotaGb |
integer |
||
enableDr |
boolean |
||
superAdmins |
array |
项目的 |
|
string |
项目的 |
RAM$odps****@aliyunid.com:RAM_USER |
|
securityProperties |
object |
权限属性。 |
|
usingAcl |
boolean |
是否使用ACL 权限控制 功能,默认为使用状态。 |
true |
usingPolicy |
boolean |
是否使用Policy 权限控制 功能,默认为使用状态。 |
true |
objectCreatorHasAccessPermission |
boolean |
是否允许对象创建者拥有对象的访问权限,默认为允许状态。 |
true |
objectCreatorHasGrantPermission |
boolean |
是否允许对象创建者拥有对象的授权权限,默认为允许状态。 |
true |
labelSecurity |
boolean |
是否使用Label 权限控制 功能,默认为不使用状态。 |
false |
enableDownloadPrivilege |
boolean |
是否使用Download 权限控制 功能,默认为不使用状态。 |
false |
projectProtection |
object |
数据保护机制 属性。 |
|
exceptionPolicy |
string |
如选择开启项目空间数据保护,允许设置例外或受信任项目,指定用户将指定对象的数据流出至指定项目,所有符合 Exception Policy 中描述的情形都可以打破数据保护机制。 |
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Principal": "", "Action": [ "odps:[, , ...]" ], "Resource": "acs:odps:*:", "Condition": { "StringEquals": { "odps:TaskType": [ "" ] } } } ] } |
protected |
boolean |
是否开启项目的数据保护机制 ,禁止或允许数据流出项目,默认为不开启状态。 |
true |
ipWhiteList |
object |
IP 白名单。 |
|
ipList |
string |
公网和云产品互联网络 IP 白名单。 说明
如果只配置公网和云产品互联网络 IP 白名单,则公网和云产品互联网络访问受配置限制,VPC 网络访问全部禁止。 |
10.88.111.3 |
vpcIpList |
string |
VPC 网络 IP 白名单。 说明
如果只配置 VPC 网络 IP 白名单,则 VPC 网络访问受配置限制,公网和云产品互联网络访问全部禁止。 |
10.88.111.3 |
saleTag |
object |
默认计算 Quota 的实例 ID 与付费类型。 |
|
resourceId |
string |
默认计算 Quota 的实例 ID。 |
b7afb7d1-****-****-****-c393669c307b |
resourceType |
string |
默认计算 Quota 的付费类型。 |
PayAsYouGo |
示例
正常返回示例
JSON
格式
{
"requestId": "0b87b7b316643495896551555e855b",
"httpCode": 200,
"errorCode": "OBJECT_NOT_EXIST",
"errorMsg": "This object does not exist.",
"data": {
"name": "odps_project",
"owner": "ALIYUN$odps****@aliyunid.com",
"type": "managed",
"comment": "BI_Analysis",
"defaultQuota": "os_PayAsYouGoQuota",
"status": "AVAILABLE",
"productType": "PayAsYouGo",
"threeTierModel": true,
"costStorage": "16489027",
"regionId": "cn-beijing",
"createdTime": 1704380838000,
"properties": {
"timezone": "Asia/Shanghai",
"retentionDays": 1,
"allowFullScan": false,
"typeSystem": "2.0",
"enableDecimal2": true,
"sqlMeteringMax": "1500",
"tableLifecycle": {
"type": "optional",
"value": "37231"
},
"encryption": {
"enable": true,
"algorithm": "AES256",
"key": "dafault"
},
"tunnelQuota": "Default",
"elderTunnelQuota": "Default_p",
"enableTunnelQuotaRoute": true,
"storageTierInfo": {
"storageTierSize": {
"standardSize": 27649172,
"longTermSize": 21764917,
"lowFrequencySize": 767693
},
"projectTotalSize": 56066037,
"projectBackupSize": 86672917
},
"fdcQuota": "fdc_quota",
"enableFdcCacheForce": true,
"enableTieredStorage": true,
"tableLifecycleConfig": {
"TierToLongterm": {
"DaysAfterLastModificationGreaterThan": 180,
"DaysAfterLastAccessGreaterThan": 180,
"DaysAfterLastTierModificationGreaterThan": 1
},
"TierToLowFrequency": {
"DaysAfterLastModificationGreaterThan": 30,
"DaysAfterLastAccessGreaterThan": 30,
"DaysAfterLastTierModificationGreaterThan": 1
}
},
"externalProjectProperties": {
"isExternalCatalogBound": "true",
"tableFormat": "",
"warehouse": "",
"foreignServerName": "",
"foreignServerType": "",
"externalCatalogId": ""
},
"enableAutoMv": true,
"autoMvQuotaGb": 0,
"enableDr": true
},
"superAdmins": [
"RAM$odps****@aliyunid.com:RAM_USER\n"
],
"securityProperties": {
"usingAcl": true,
"usingPolicy": true,
"objectCreatorHasAccessPermission": true,
"objectCreatorHasGrantPermission": true,
"labelSecurity": false,
"enableDownloadPrivilege": false,
"projectProtection": {
"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}",
"protected": true
}
},
"ipWhiteList": {
"ipList": "10.88.111.3",
"vpcIpList": "10.88.111.3"
},
"saleTag": {
"resourceId": "b7afb7d1-****-****-****-c393669c307b",
"resourceType": "PayAsYouGo"
}
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。