ListPartitionsByNames-阿里云帮助中心

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /dlf/v1/{catalogId}/databases/{database}/tables/{table}/partitions/list-by-names HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
catalogId	string	Yes	The ID of the data catalog.	clg-paimon-xxxx
database	string	Yes	The name of the database.	database_name
table	string	Yes	The name of the table.	table_name

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request body.
specs	array<object>	No	分区规格列表。
	object	No
	string	No	分区键名和键值。	"dt": "20240101"

Response elements

Element	Type	Description	Example
	object	Schema of Response
partitions	array	分区。
	Partition	分区。	[]

Examples

Success response

JSON format

{
  "partitions": [
    {
      "lastFileCreationTime": 1741701564261,
      "recordCount": 1,
      "fileSizeInBytes": 1,
      "fileCount": 1,
      "done": true,
      "spec": {
        "year": "2025"
      },
      "createdAt": 1747120676378,
      "createdBy": "acs:ram::[accountId]:root",
      "updatedAt": 1744970111419,
      "updatedBy": "acs:ram::[accountId]:root",
      "storageClass": "STANDARD",
      "storageAction": "COMPLETE",
      "storageActionTimestamp": 1758189669915,
      "totalBuckets": 1
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.