Get a data asset by asset ID¶
Query an asset, its derivations, and applicable parsing manifest by asset ID.
GET https://api.moi.matrixorigin.cn/v5/catalog/data-assets/{id}
Before you call this API¶
Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5; use the corresponding product API URL for a dedicated deployment.
Obtain asset_id from actual asset results. Prepare a personal access token with read permission on the asset root volume and a workspace ID. BASE_URL includes the product prefix in the same environment; MOI_KEY and WORKSPACE_ID are product credentials and workspace ID. Example IDs and data are placeholders.
Request parameters¶
curl --fail-with-body -sS -X GET "$BASE_URL/catalog/data-assets/asset-example" \
-H "X-API-Key: $MOI_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
Field |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Asset ID in the path, not numeric record id, original file_id, or asset_ref. |
Asset IDs and original file IDs use different read endpoints. Continue using the existing file-query API for file-based queries.
Successful response¶
{
"code": "OK",
"msg": "OK",
"data": {
"asset": {
"id": 1,
"asset_id": "asset-example",
"name": "orders.csv",
"raw_file_id": "file-example",
"volume_id": 30,
"source": "workflow",
"meta": {
"source": "sample"
},
"created_at": 1794390000,
"updated_at": 1794390001,
"asset_type": "file",
"asset_ref": "file-example"
},
"derivations": [
{
"id": 2,
"asset_id": "asset-example",
"kind": "parsed_from",
"file_id": "parsed-file-example",
"meta": {
"step": "parse"
},
"created_at": 1794390000,
"updated_at": 1794390001,
"root_asset_id": "asset-example",
"source_asset_id": "asset-example",
"target_asset_id": "parsed-asset-example",
"case_id": "case-example",
"producer_workitem_id": "producer-example",
"recorded_by_workitem_id": "recorder-example",
"parallel_index": 1,
"logical_slot": "parsed",
"idempotency_key": "key-example"
}
],
"manifest": {
"id": 3,
"asset_id": "asset-example",
"raw_file_id": "file-example",
"parsed_file_id": "parsed-file-example",
"manifest": {
"format": "sample"
},
"created_at": 1794390000,
"updated_at": 1794390001,
"root_asset_id": "asset-example",
"source_file_id": "file-example",
"parsed_asset_id": "parsed-asset-example"
},
"assets_by_id": {
"asset-example": {
"id": 1,
"asset_id": "asset-example",
"name": "orders.csv",
"raw_file_id": "file-example",
"volume_id": 30,
"source": "workflow",
"meta": {
"source": "sample"
},
"created_at": 1794390000,
"updated_at": 1794390001,
"asset_type": "file",
"asset_ref": "file-example"
},
"parsed-asset-example": {
"id": 1,
"asset_id": "parsed-asset-example",
"name": "parsed.jsonl",
"volume_id": 30,
"source": "workflow",
"meta": {
"source": "sample"
},
"created_at": 1794390000,
"updated_at": 1794390001,
"asset_type": "file",
"asset_ref": "parsed-file-example"
}
}
}
}
Field |
Type |
Description |
|---|---|---|
|
string |
OK on success. |
|
string |
OK on success. |
|
object |
Target asset. See asset object for fields. |
|
object[] |
Derivations; may be omitted when empty. See derivation for fields. |
|
object |
Parsing manifest; omitted when absent. See manifest object for fields. |
|
object |
Related assets indexed by asset_id, using the same asset structure. May be omitted when empty. |
Error responses¶
{
"code": "ErrNotFound",
"msg": "示例错误信息"
}
HTTP |
code |
Condition |
|---|---|---|
404 |
ErrNotFound |
The business read found no target asset; permission boundaries may return their own errors first. |
400 |
ErrParamInvalid |
Invalid asset identifier or workspace input. |
For identity, permission, and dependency failures, use actual code, msg, and diagnostic fields. Error wording may vary by language.