ビデオアセットのプロジェクト移動

Prev Next

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

VPC環境で利用できます。

プロジェクトを別のプロジェクトに移動します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
PATCH /api/v1/workspaces/{workspace_name}/projects/{project_id}/video-assets/{video_asset_id}

リクエストヘッダ

Media Intelligence API で共通して使用されるヘッダの詳細は、Media Intelligenceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
workspace_name String Required ワークスペース名
project_id String Required プロジェクト ID
video_asset_id String Required ビデオアセット ID

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
new_project_id String Required ビデオの移動先プロジェクトの ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request PATCH 'https://maiu.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/video-assets/1001?new_project_id=5678' \
--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'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
code String Required API処理結果コード
message String Required API処理結果メッセージ
result Object Required ビデオアセットの詳細情報
result.videoId Integer Required ビデオアセット ID
result.videoName String Required ビデオファイル名
result.projectId Integer Required ビデオの移動先プロジェクトの ID
result.metaData Object Required 動画のメタデータの詳細情報
result.metaData.resolution String Required 動画の解像度
  • <例>1920x1080
result.metaData.durationMs Integer Required 動画の長さ(ミリ秒)
result.metaData.size Integer Required 動画のファイルサイズ(Byte)
result.metaData.format String Required 動画のファイス形式
  • mp4 | mkv | mov | webm
result.key String Required Object Storageにアップロードしたビデオファイルのフルネーム
result.createUserName String Required ビデオアセットを登録したユーザー名
result.createdTime String Required ビデオアセットの登録日時
  • ISO 8601形式
result.updateUserName String Required ビデオアセットを最後に更新したユーザー名
result.updatedTime String Required ビデオアセットの最終更新日時
  • ISO 8601形式

レスポンスステータスコード

Media Intelligence APIで共通して使用されるレスポンスステータスコードの詳細は、Media Intelligenceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "code": "0",
    "message": "success",
    "result": {
        "videoId": 1001,
        "videoName": "sample-video.mp4",
        "projectId": 5678,
        "metaData": {
            "resolution": "1280x720",
            "durationMs": 242161,
            "size": 35064178,
            "format": "mp4"
        },
        "key": "sample-video.mp4",
        "createUserName": "username",
        "createdTime": "2025-04-23T17:14:11",
        "updateUserName": "username",
        "updatedTime": "2025-04-23T17:21:56"
    }
}