ListStoragePartitionsInfo - 获取分区存储明细

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

调试

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

授权信息

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

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

请求语法

GET /api/v1/observations/analysis/storage/projects/{project}/tables/{table}/partitionsInfo HTTP/1.1

请求参数

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

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

40713753659****
regionstring

地域 ID。

cn-beijing
datestring

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

20241205
projectstring

MaxCompute 项目名称。

odps_project
schemastring

归属 schema。

schema
tablestring

表名称。

bank_data
partitionPrefixstring

分区名称(模糊匹配)。

20241201
typesarray

存储类型。

itemstring

存储类型。

  • standard:标准存储;
  • lowfrequency:低频存储;
  • longterm:长期存储。
standard
orderColumnstring

排序列。

totalFrequency
ascOrderboolean

是否升序排列。

false
pageSizelong

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

10
pageNumberlong

分页页码。

1

返回参数

名称类型描述示例值
object

请求返回参数。

requestIdstring

请求 ID。

0be3e0bd16661643917136451ebf55
httpCodeinteger

HTTP 状态码。

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

错误码。

OBJECT_NOT_EXIST
errorMsgstring

错误信息。

This object does not exist.
dataobject

请求返回结果。

storagePartitionInfoListarray<object>

分区存储信息列表。

storagePartitionInfoListobject

分区存储信息列表。

projectNamestring

项目名称。

odps_project
schemaNamestring

Schema 名称。

schema
tableNamestring

表名称。

bank_data
partitionstring

分区名称。

ds=20241201
isPartitionedboolean

是否分区表。本接口返回均为分区信息,无需关注此字段。

false
typestring

类型。

PARTITION
storageTypestring

存储类型。

  • standard:标准存储;
  • lowfrequency:低频存储;
  • longterm:长期存储。
standard
totalFrequencylong

访问频次。

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

    访问数据总量。

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

    访问数据总量单位。

    GB
    fileCountlong

    文件数。

    2
    fileSizedouble

    存储大小。

    1
    fileSizeUnitstring

    存储大小单位。

    GB
    ratedouble

    总存储量近{$recentDays}天同比。本接口无此返回值。

    1%
    lastAccessTimelong

    分区的数据最后访问时间。

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

    统计日期。

    20241205
    totalCountlong

    返回结果的总数量。

    57
    pageNumberlong

    当前页码。

    1
    pageSizelong

    每页记录数。

    10

    示例

    正常返回示例

    JSON格式

    {
      "requestId": "0be3e0bd16661643917136451ebf55",
      "httpCode": 200,
      "errorCode": "OBJECT_NOT_EXIST",
      "errorMsg": "This object does not exist.",
      "data": {
        "storagePartitionInfoList": [
          {
            "projectName": "odps_project",
            "schemaName": "schema",
            "tableName": "bank_data",
            "partition": "ds=20241201",
            "isPartitioned": false,
            "type": "PARTITION",
            "storageType": "standard",
            "totalFrequency": 10,
            "totalInputAmount": 1,
            "totalInputAmountUnit": "GB",
            "fileCount": 2,
            "fileSize": 1,
            "fileSizeUnit": "GB",
            "rate": 0,
            "lastAccessTime": 1694589365
          }
        ],
        "date": "20241205",
        "totalCount": 57,
        "pageNumber": 1,
        "pageSize": 10
      }
    }

    错误码

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