Upload recording file

This API uploads recording files generated from the channel of Live Station to the bucket of Object Storage.

Request

POST https://livestation.apigw.ntruss.com/api/v2/buckets/{bucketName}/upload

Request header

Request body

Response

Examples

Request example

POST /api/v2/buckets/mybucket/upload
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

{
  "recordIds" : [ 1, 2 ],
  "accessControl" : "PUBLIC_READ"
}

Response example

HTTP/1.1 202 Accepted
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
   "content" : {
      "bucketName" : "mybucket",
      "accessControl" : "PUBLIC_READ",
      "uploadedRecords" : {
        "1" : {
          "recordFileName" : "137305-104042-202003201511.mp4",
          "recordType" : "MP4",
          "status" : "TRANSFER",
          "uploadPath" : "live-station/record/ls-20200313162828-G60tN/137305-104042-202003201511.mp4",
          "objectStorageUrl" : "https://kr.object.ncloudstorage.com/mybucket/live-station/record/ls-20200313162828-G60tN/137305-104042-202003201511.mp4"
        },
        "2" : {
          "recordFileName" : "137305-104077-202003231736.mp4",
          "recordType" : "MP4",
          "status" : "TRANSFER",
          "uploadPath" : "live-station/record/ls-20200313162828-G60tN/137305-104077-202003231736.mp4",
          "objectStorageUrl" : "https://kr.object.ncloudstorage.com/mybucket/live-station/record/ls-20200313162828-G60tN/137305-104077-202003231736.mp4"
        }
      }
  }
}

Error codes

If the Live Station API request is invalid or if an error occurs during processing, it returns a success/failure to HTTP status code and returns a detailed message in JSON format.

There are two error codes: 'Common error codes' and 'API Gateway error codes' in the Live Station API.