ListStorageTablesInfo - 获取表存储明细

获取某个MaxCompute项目内的表存储明细。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
odps:ListStorageTablesInfoget
*Storage
acs:odps:{#regionId}:{#accountId}:storage/{#project}

请求语法

GET /api/v1/observations/analysis/storage/projects/{project}/tablesInfo HTTP/1.1

请求参数

名称类型必填描述示例值
tenantIdstring

租户 ID。可以通过登录 MaxCompute 控制台,在左侧导航栏选择租户管理>租户属性查看。

28074710977****
regionstring

地域 ID。

cn-beijing
datestring

统计日期,以天为级别,时间参数填写为YYYYMMdd

20241205
recentDaysinteger

同比对比天数。

1
projectstring

MaxCompute 项目名称。

odps_project
schemastring

归属 Schema。

schema
tablePrefixstring

表名称(模糊匹配)。

bank
typesarray

存储类型。

itemstring

存储类型。

standardStorage
orderColumnstring

排序列。

totalFrequency
ascOrderboolean

是否升序排列。

false
pageSizelong

每页返回数目,默认为 10。

10
pageNumberlong

分页页码。

1

返回参数

名称类型描述示例值
object

请求返回参数。

requestIdstring

请求 ID。

0bc12e6a16679892465424670db3eb
httpCodeinteger

HTTP 状态码。

  • 1xx:信息响应 - 请求已接收,正在处理中。
  • 2xx:成功 - 请求动作已被服务端成功接收、理解并接受。
  • 3xx:重定向 - 请求被重定向,采取进一步行动以完成请求。
  • 4xx:客户端错误 - 请求包含错误请求参、语法或特定请求条件无法满足。
  • 5xx:服务端错误 - 服务器由于其他原因无法满足请求。
200
errorCodestring

错误码。

OBJECT_NOT_EXIST
errorMsgstring

错误信息。

This object does not exist.
dataobject

请求返回结果。

storageTableInfoListarray<object>

表存储信息列表。

storageTableInfoListobject

表存储信息列表。

datestring

统计日期(不会返回)。

20241205
projectNamestring

项目名称。

odps_project
schemaNamestring

Schema 名称。

schema
tableNamestring

表名称。

bank_data
isPartitionedboolean

是否分区表。

false
storageTypestring

表存储类型。

  • standard:标准存储;
  • lowfrequency:低频存储;
  • longterm:长期存储;
  • unknown:当表为分区表时返回此值,需调用 ListStoragePartitionsInfo 查询各分区的存储类型。
standard
lastAccessTimelong

表的数据最后访问时间,当表为非分区表时有此返回值。

说明 该数据从 2023 年 7 月陆续升级采集,在升级后没有被访问过或者通过 ALGO 作业、Hologres 直读方式访问的无法采集到 last_access_time。
1694589365
totalStorageFileCountlong

总文件数。

2
totalStoragedouble

总存储用量。分区表为各分区存储用量之和。若各分区存储类型不一致,则为各类型存储用量之和。

600
totalStorageUnitstring

存储用量单位。

KB
ratedouble

总存储量近{$recentDays}天同比。

0
standardStorageFileCountlong

标准存储文件数。

2
standardStoragedouble

标准存储用量。

600
standardStorageUnitstring

标准存储用量单位。

KB
longTermStorageFileCountlong

长期存储文件数。

0
longTermStoragedouble

长期存储用量。

0
longTermStorageUnitstring

长期存储用量单位。

B
lowFreqStorageFileCountlong

低频存储文件数。

0
lowFreqStoragedouble

低频存储用量。

0
lowFreqStorageUnitstring

低频存储用量单位。

B
totalFrequencylong

访问频次。

说明
  • 访问行为包括:
    • 表作为 SQL 计算任务中的输入表。
    • 表被 Tunnel 下载。
    • 表被 StorageAPI 调用 Read(分区表的分区粒度数据暂无)。访问每增加一次,访问频次+1。
  • 该数据从 2023 年 7 月陆续升级统计,在升级后没有被访问过或者通过 ALGO 作业、Hologres 直读方式访问的将无法统计至访问频次。
  • 10
    totalInputAmountdouble

    访问数据总量。

    说明 所有访问行为读取的数据量。
    1
    totalInputAmountUnitstring

    访问数据总量单位。

    GB
    datestring

    统计日期。

    20241205
    totalCountlong

    返回结果的总数量。

    1
    pageNumberlong

    分页页码。

    1
    pageSizelong

    每页记录数。

    10

    示例

    正常返回示例

    JSON格式

    {
      "requestId": "0bc12e6a16679892465424670db3eb",
      "httpCode": 200,
      "errorCode": "OBJECT_NOT_EXIST",
      "errorMsg": "This object does not exist.\n",
      "data": {
        "storageTableInfoList": [
          {
            "date": "20241205",
            "projectName": "odps_project",
            "schemaName": "schema",
            "tableName": "bank_data",
            "isPartitioned": false,
            "storageType": "standard",
            "lastAccessTime": 1694589365,
            "totalStorageFileCount": 2,
            "totalStorage": 600,
            "totalStorageUnit": "KB",
            "rate": 0,
            "standardStorageFileCount": 2,
            "standardStorage": 600,
            "standardStorageUnit": "KB",
            "longTermStorageFileCount": 0,
            "longTermStorage": 0,
            "longTermStorageUnit": "B",
            "lowFreqStorageFileCount": 0,
            "lowFreqStorage": 0,
            "lowFreqStorageUnit": "B",
            "totalFrequency": 10,
            "totalInputAmount": 1,
            "totalInputAmountUnit": "GB"
          }
        ],
        "date": "20241205",
        "totalCount": 1,
        "pageNumber": 1,
        "pageSize": 10
      }
    }

    错误码

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