SumStorageMetricsByDate - MaxCompute - Alibaba Cloud Documentation Center

Retrieves aggregated storage metrics over a specified date range, grouped by project or storage class.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

odps:SumStorageMetricsByDate

*All Resource

*

None

Request syntax

POST /api/v1/storageMetrics/sumByDate HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request body.
projectNames	array	No	The project names. If this parameter is not specified, the data of all projects is returned.
	string	No	The project name.	prj
startDate	integer	No	The beginning of the time range to query. The value must be a timestamp in milliseconds. This parameter is required.	1715393576201
endDate	integer	No	The end of the time range to query. The value must be a timestamp in milliseconds. This parameter is required.	1718590596556
statsType	string	No	The dimension for aggregating storage metrics. This parameter is required. Valid values: `PROJECT` `STORAGE_TYPE`	PROJECT

Response elements

Element	Type	Description	Example
	object	The response body.
requestId	string	The request ID.	0abb781a17411408145995819e0dae
httpCode	integer	The HTTP status code. 1xx: Informational. The request is received and the process is continuing. 2xx: Success. The request is successfully received, understood, and accepted. 3xx: Redirection. Further action needs to be taken to complete the request. 4xx: Client Error. The request contains bad syntax or cannot be fulfilled. 5xx: Server Error. The server fails to fulfill an apparently valid request.	200
data	array<object>	The returned data.
	array<object>	The returned result.
storageType	string	The storage type. Valid values: Storage: Standard. LowFreqStorage: Infrequent Access (IA). ColdStorage: Archive.	Storage
dateTime	string	The date of the statistics. The format is yyyyMMdd.	20250719
usage	string	The total storage.	329.503338
unit	string	The unit of the total storage.	GB
itemStorageMetrics	array<object>	The list of storage usage of a specified type.
	object	The storage usage of a specified type.
itemName	string	If the type is PROJECT, this parameter indicates the project name. If the type is STORAGE_TYPE, this parameter indicates the storage type.	prj
usage	string	The storage usage.	300.560392
percentage	number	The percentage of the storage usage.	91.22

Examples

Success response

JSON format

{
  "requestId": "0abb781a17411408145995819e0dae",
  "httpCode": 200,
  "data": [
    {
      "storageType": "Storage",
      "dateTime": "20250719",
      "usage": "329.503338",
      "unit": "GB",
      "itemStorageMetrics": [
        {
          "itemName": "prj",
          "usage": "300.560392",
          "percentage": 91.22
        }
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.