GetEditingProjectMaterials API 呼び出しによるプロジェクトメディアアセットの取得 - IMS

現在のオンライン編集プロジェクトにバインドされているすべてのメディアアセットを取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:GetEditingProjectMaterials

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProjectId	string	必須	オンライン編集プロジェクトの ID です。	***fb2101cb318***

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマです。
RequestId	string	リクエストの ID です。	****89-C21D-4B78-AE24-3788B8****
ProjectId	string	プロジェクトの ID です。	***67ae06542b9b93e0d1c387***
MediaInfos	array<object>	該当するメディアアセットのコレクションです。
	array<object>
MediaId	string	メディアアセットの ID です。	***64623a94eca8516569c8fe***
MediaBasicInfo	object	メディアアセットの基本情報です。
MediaId	string	メディアアセットの ID です。	***64623a94eca8516569c8f***
InputURL	string	ソースシステムにおけるメディアアセットの URL です。	http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4
MediaType	string	メディアアセットの種別です。	video
BusinessType	string	メディアアセットのビジネス種別です。	general
Source	string	メディアアセットのソースです。	oss
Title	string	メディアアセットのタイトルです。	file.mp4
Description	string	メディアアセットの説明です。	sample_description
Category	string	メディアアセットのカテゴリです。	video
MediaTags	string	メディアアセットに関連付けられたタグです。	标签,tag1
CoverURL	string	サムネイル画像の URL です。	http://sample-bucket.oss-cn-shanghai.aliyuncs.com/sample-corver.jpg?Expires=1628670610&OSSAccessKeyId=AK&Signature=signature
UserData	string	ユーザー定義データです。	userData
Snapshots	string	サムネイル画像です。	null
Status	string	リソースのステータスです。	Normal
TranscodeStatus	string	トランスコードタスクのステータスです。列挙値: TranscodeSuccess : トランスコードが完了しました。 TranscodeFailed : トランスコードに失敗しました。 Init : 初期化中です。 Transcoding : トランスコード中です。	Init
CreateTime	string	メディアアセットが作成された時刻です。	2020-12-26T04:11:08Z
ModifiedTime	string	メディアアセットが最後に更新された時刻です。	2020-12-26T04:11:08Z
DeletedTime	string	メディアアセットが削除された時刻です。	2020-12-26T04:11:08Z
SpriteImages	string	スプライト画像です。	null
FileInfoList	array<object>	ファイル情報です。
	array<object>
FileBasicInfo	object	ファイルの基本情報（再生時間、サイズなど）です。
FileName	string	ファイル名です。	example.mp4
FileStatus	string	ファイルのステータスです。	Normal
FileType	string	ファイルの種別です。	source_file
FileSize	string	ファイルサイズ（バイト単位）です。	30611502
FileUrl	string	OSS 上のファイルの URL です。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	ファイルが保存されているリージョンです。	cn-shanghai
FormatName	string	コンテナフォーマットです。	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	ファイルの再生時間です。	216.206667
Bitrate	string	ファイルのビットレートです。	1132.68
Width	string	動画の幅です。	960
Height	string	動画の高さです。	540
LiveMaterials	array<object>	ライブストリームに関連付けられたメディアアセットです。
	object
AppName	string	ライブストリーミングアプリケーションの名前です。	testrecord
StreamName	string	ライブストリームの名前です。	testrecord
DomainName	string	ライブストリーミング用のストリーミングドメイン名です。	test.alivecdn.com
LiveUrl	string	ライブストリームのストリーミング URL です。	rtmp://test.alivecdn.com/testrecord/teststream
ProjectMaterials	array	編集プロジェクトに関連付けられたメディアアセットです。ライブストリーム終了後、標準の編集プロジェクトにリンクされます。	***9b145c5cafc2e057304fcd***
	string	ライブ編集プロジェクトに関連付けられた標準編集プロジェクトの ID です。	***c38767ae06542b9b93e0d1***

例

成功レスポンス

JSONJSON

{
  "RequestId": "******89-C21D-4B78-AE24-3788B8******",
  "ProjectId": "*****67ae06542b9b93e0d1c387*****",
  "MediaInfos": [
    {
      "MediaId": "*****64623a94eca8516569c8fe*****",
      "MediaBasicInfo": {
        "MediaId": "*****64623a94eca8516569c8f*****",
        "InputURL": "http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "file.mp4",
        "Description": "sample_description",
        "Category": "video",
        "MediaTags": "标签,tag1",
        "CoverURL": "http://sample-bucket.oss-cn-shanghai.aliyuncs.com/sample-corver.jpg?Expires=1628670610&OSSAccessKeyId=AK&Signature=signature",
        "UserData": "userData",
        "Snapshots": "null",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:08Z",
        "ModifiedTime": "2020-12-26T04:11:08Z",
        "DeletedTime": "2020-12-26T04:11:08Z",
        "SpriteImages": "null"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "216.206667",
            "Bitrate": "1132.68",
            "Width": "960",
            "Height": "540"
          }
        }
      ]
    }
  ],
  "LiveMaterials": [
    {
      "AppName": "testrecord",
      "StreamName": "testrecord",
      "DomainName": "test.alivecdn.com",
      "LiveUrl": "rtmp://test.alivecdn.com/testrecord/teststream"
    }
  ],
  "ProjectMaterials": [
    "*****c38767ae06542b9b93e0d1*****"
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParameter	The specified parameter \ is not valid.
404	ProjectNotFound	The specified project not found

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。