Available in VPC
Get the status of a video asset registered in a project.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
GET | /api/v1/workspaces/{workspace_name}/projects/{project_id}/video-assets/{video_asset_id}/import-status |
Request headers
For information about the headers common to all Media AI Understanding APIs, see Media AI Understanding request headers.
Request path parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
workspace_name |
String | Required | Workspace name |
project_id |
String | Required | Project ID
|
video_asset_id |
String | Required | Video asset ID
|
Request example
The request example is as follows:
curl --location --request GET 'https://maiu.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/video-assets/5678/import-status' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
code |
String | Required | API processing result code |
message |
String | Required | API processing result message |
result |
Object | Required | Video asset registration status information |
result.videoId |
Integer | Required | Video asset ID |
result.uploadStatus |
String | Required | Video upload status
|
result.uploadResult |
String | Optional | Message mapped to video upload status
|
result.metaData |
Object | Optional | Video metadata details |
result.metaData.resolution |
String | Optional | Video resolution
|
result.metaData.durationMs |
Integer | Optional | Video length (millisecond) |
result.metaData.size |
Integer | Optional | Video file size (byte) |
result.metaData.format |
String | Optional | Video file format
|
Response status codes
For information about the HTTP status codes common to all Media AI Understanding APIs, see Media AI Understanding response status codes.
Response example
The response example is as follows:
{
"code": "0",
"message": "success",
"result": {
"videoId": 5678,
"uploadStatus": "COMPLETED",
"uploadResult": "Video copy completed",
"metaData": {
"resolution": "1920x1080",
"durationMs": 253702,
"size": 120333399,
"format": "mp4"
}
}
}