BatchGetMediaInfos による IMS メディアアセット詳細取得 - IMS - Alibaba Cloud - Intelligent Media Services

mediaId の値を指定することで、1 回のリクエストで複数のメディアアセットの情報を取得します。

今すぐお試しください

この 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:BatchGetMediaInfos

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaIds	string	任意	クエリ対象のメディアアセット ID のカンマ区切りリスト。	****b48fb04483915d4f2cd8**,**c48fb37407365d4f2cd8****
AdditionType	string	任意	返される追加のメディアアセット情報のタイプ。このパラメーターを指定しない場合、基本情報のみが返されます。有効な値は次のとおりです： -FileInfo -DynamicMetaData	FileInfo,DynamicMetaData
AuthTimeout	integer	任意	認証タイムアウト (秒単位)。最小値：1。最大値：86400。デフォルト値：3600。	30

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマ。
RequestId	string	リクエスト ID。	****11-DB8D-4A9A-875B-275798****
MediaInfos	array<object>	メディアアセットのリスト。
	array<object>	メディアアセットの詳細。
MediaId	string	メディア ID。	****c48fb37407365d4f2cd8****
MediaBasicInfo	object	メディアアセットの基本情報。
MediaId	string	メディア ID。	****c48fb37407365d4f2cd8****
InputURL	string	ソースシステム内のメディアアセットの URL。	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	メディアタイプ。有効な値： `Image` `Video` `Audio` `Text`	video
BusinessType	string	メディアアセットのビジネスタイプ。	general
Source	string	ソース。有効な値： `OSS` `VOD`	oss
Title	string	タイトル。	title
Description	string	説明。	description
Category	string	カテゴリ。	category1
MediaTags	string	タグ。	tag1, tag2
CoverURL	string	カバー URL。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	ユーザーデータ。	userDataTest
Snapshots	string	スナップショット。	[ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
Status	string	メディアアセットのステータス。	Normal
TranscodeStatus	string	トランスコードステータス。	Init
CreateTime	string	メディアアセットが作成された時刻。	2020-12-26T04:11:10Z
ModifiedTime	string	メディアアセットが最後に変更された時刻。	2020-12-26T04:11:12Z
DeletedTime	string	メディアアセットが削除された時刻。	2020-12-26T04:11:10Z
SpriteImages	string	スプライトイメージ。	[{"bucket":"example-bucket","count":"32","iceJobId":"****83ec44d58b2069def2e**","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"**e438b14ff39293eaec25****","tileCount":"1"}]
Biz	string	メディアアセットに関連付けられたビジネス。	ICE
FileInfoList	array<object>	基本的なファイル情報のリスト。
	array<object>	ファイルに関する基本情報。
FileBasicInfo	object	再生時間やファイルサイズなど、ファイルに関する基本情報。
FileName	string	ファイル名。	example
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	再生時間。	200
Bitrate	string	ビットレート。	1132.68
Width	string	幅。	1920
Height	string	高さ。	1080
AudioStreamInfoList	array<object>	音声ストリーム。
	object	音声ストリームの詳細。
Index	string	ストリームのインデックス。
CodecName	string	コーデックの短縮名。
CodecLongName	string	コーデックのフルネーム。
CodecTimeBase	string	コーデックのタイムベース。
CodecTagString	string	コーデックタグ文字列。
CodecTag	string	コーデックタグ。
Profile	string	プロファイル。
SampleFmt	string	サンプルフォーマット。
SampleRate	string	サンプルレート。
Channels	string	オーディオチャンネル数。
ChannelLayout	string	チャンネルレイアウト。
Timebase	string	タイムベース。
StartTime	string	開始時刻。
Duration	string	再生時間。
Bitrate	string	ビットレート。
Fps	string	フレームレート。
NumFrames	string	総フレーム数。
Lang	string	言語。
VideoStreamInfoList	array<object>	ビデオストリーム。
	object	ビデオストリームの詳細。
Index	string	ストリームのインデックス。
CodecName	string	コーデックの短縮名。
CodecLongName	string	コーデックのフルネーム。
Profile	string	プロファイル。
CodecTimeBase	string	コーデックのタイムベース。
CodecTagString	string	コーデックタグ文字列。
CodecTag	string	コーデックタグ。
Width	string	ビデオの幅。
Height	string	ビデオの高さ。
HasBFrames	string	B フレームが存在するかどうかを示します。
Sar	string	サンプルアスペクト比 (SAR)。
Dar	string	表示アスペクト比 (DAR)。
PixFmt	string	ピクセルフォーマット。
Level	string	レベル。
Fps	string	フレームレート。
AvgFPS	string	平均フレームレート。
Timebase	string	タイムベース。
StartTime	string	開始時刻。
Duration	string	再生時間。
Bitrate	string	ビットレート。
NumFrames	string	総フレーム数。
Lang	string	言語。
Rotate	string	回転角度。
Nb_frames	string	このパラメーターは `NumFrames` のエイリアスです。
SubtitleStreamInfoList	array<object>	字幕ストリーム。
	object	字幕ストリームの詳細。
Index	string	ストリームのインデックス。
CodecName	string	コーデックの短縮名。
CodecLongName	string	コーデックのフルネーム。
CodecTimeBase	string	コーデックのタイムベース。
CodecTagString	string	コーデックタグ文字列。
CodecTag	string	コーデックタグ。
Timebase	string	タイムベース。
StartTime	string	開始時刻。
Duration	string	再生時間。
Lang	string	言語。
MediaDynamicInfo	object	メディアアセットに関する動的情報。
DynamicMetaData	object	動的メタデータのタイプ。有効な値： `"ai"`：生の AI 結果から派生した標準化データ。 `"user-defined"`：ユーザー定義のメタデータ。 `"system"`：システム生成データ。
Data	string	動的メタデータの内容。	system
IgnoredList	array	情報を取得できなかったメディア ID のリスト。
	string	情報を取得できなかったメディアアセットの ID。	**20b48fb04483915d4f2cd8ac**

例

成功レスポンス

JSONJSON

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "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": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Profile": "",
              "SampleFmt": "",
              "SampleRate": "",
              "Channels": "",
              "ChannelLayout": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "Fps": "",
              "NumFrames": "",
              "Lang": ""
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "Profile": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Width": "",
              "Height": "",
              "HasBFrames": "",
              "Sar": "",
              "Dar": "",
              "PixFmt": "",
              "Level": "",
              "Fps": "",
              "AvgFPS": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "NumFrames": "",
              "Lang": "",
              "Rotate": "",
              "Nb_frames": ""
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Lang": ""
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

エラーコード

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

変更履歴

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