スケジュールの作成

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

Live Stationの VODスケジュールを作成する APIです。作成したスケジュール情報照会のためのスケジュール情報照会 APIを提供します。

参考

スケジュールの作成により、Object Storageにアップロードされた動画(mp4)を決められた時間(startTime)に合わせてライブで配信できます。
最大50個の動画再生をサポートし、詳細は下記をご参照ください。

注意

VODスケジュール作成時の注意事項は、次の通りです。

スケジュールの作成は、VODチャンネルの状態が READYの時に可能です。
チャンネルに既にスケジュールが予約されている場合、追加スケジュールを作成することはできません。
予約されたスケジュールの配信が終了したり、配信待機中のスケジュールを削除した後に再度スケジュールを登録できます。
スケジュールの開始時間(startTime)は KST(UTC+9)基準でリクエストします。

リクエスト

POST https://livestation.apigw.ntruss.com/api/v2/vod/schedule

リクエストヘッダ

ヘッダ名	必須有無	説明
x-ncp-apigw-timestamp	YES	1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	NAVERクラウドプラットフォームポータルから発行された Access Key ID値 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID値と Secret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	YES	Request body content typeを application/jsonに指定 `Content-Type: application/json`
x-ncp-region_code	YES	リージョンコード(KR)

リクエストボディ

フィールド名	必須有無	タイプ	制限事項	説明
channelId	Yes	String	スケジュールを配信する VOD Channelの channelId	スケジュールを実行するチャンネルとして、既にスケジュールが登録されているチャンネルは使用不可
startTime	Yes	Integer	リクエスト時間より過去の時間は入力不可最小入力時間: 現在のリクエスト時点 + 10分以降の時間最大入力時間: 現在のリクエスト時点 + 14日	入力した VODの配信開始時間開始時間フォーマット: yyyyMMddHHmmss KST(UTC+9)基準
vodList	Yes	Array	mp4拡張子のみ対応可能最大50個の動画を入力可能
vodList.bucketName	Yes	String		配信する動画が保存されている Object Storageのバケット名
vodList.filePath	Yes	String		配信する動画が保存されている Object Storageの filePath filePathは「/」から始めること

レスポンス

フィールド名	タイプ	説明	備考
scheduleId	Integer
channelId	String
createdTime	Timestamp	String	epoch time
startTime	Timestamp		epoch time
updatedTime	Timestamp
status	String	CREATING,PROCESSING,PROCESSING_FAIL,UPDATING,READY,FINISH,DELETED
vodList	Array

例

リクエスト例

POST /api/v2/vod/schedule
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

Request body
{
  "channelId": "ls-20211122220557-mUv3r",
  "startTime": "20211124002500",
  "vodList": [
    {
      "bucketName": "myBucket",
      "filePath": "/myFile.mp4"
    },
    {
      "bucketName": "myBucket2",
      "filePath": "/mp4/myFile2.mp4"
    },
    {
      "bucketName": "myBucket2",
      "filePath": "/mp4/myFile3.mp4"
    }
  ]
}

レスポンス例

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "scheduleId": 10053,
    "channelId": "ls-20211122220557-mUv3r",
    "createdTime": 1637679144884,
    "startTime": 1637681100000,
    "updatedTime": 1637679144884,
    "status": "CREATING",
    "vodList": [
      "/myBucket/myFile.mp4",
      "/myBucket2/mp4/myFile2.mp4",
      "/myBucket2/mp4/myFile3.mp4"
    ]
  }
}

この記事は役に立ちましたか?

What's Next

スケジュールの削除

リクエスト
レスポンス
例

タグ

Live Station