すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:ListMediaBasicInfos

    ドキュメントセンター

    Intelligent Media Services:ListMediaBasicInfos

    最終更新日:Mar 21, 2026

    指定されたパラメーターに一致するメディアアセットの基本情報を返します。

    操作説明

    • includeFileBasicInfo フィールドを true に設定した場合、レスポンスにはソースファイルの持続時間やファイルサイズなどの基本情報も含まれます。

    • 一致するメディアアセットを最大 100 件返します。

    • 結果は、指定された空でないすべてのフィルターフィールドと完全に一致する必要があります。 メディアアセットタイプ、ソース、メディアアセットのビジネスタイプ、カテゴリ、リソースステータスのフィールドは完全一致をサポートしています。

    • 結果セットが大きすぎて 1 回のレスポンスで返しきれない場合、API は nextToken を提供します。 このトークンを使用して、結果の次のページを取得できます。

    今すぐお試しください

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

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StartTime

    string

    任意

    クエリ対象の時間範囲の開始時刻。 クエリはメディアアセットの作成時間 (utcCreated) に基づいて実行されます。

    • これは開区間です。 クエリは、この時点より後に作成されたメディアアセットを返します。

    • 時刻は協定世界時 (UTC) で、ISO 8601 標準形式である必要があります。 形式は YYYY-MM-DDThh:mm:ssZ です。 たとえば、2017-01-11T12:00:00Z は 2017 年 1 月 11 日 20:00:00 (UTC+08:00) に相当します。

    2020-12-20T12:00:00Z
    EndTime

    string

    任意

    クエリ対象の時間範囲の終了時刻。 クエリはメディアアセットの作成時間 (utcCreated) に基づいて実行されます。

    • これは閉区間です。 クエリは、この時点またはそれ以前に作成されたメディアアセットを返します。

    • 時刻は協定世界時 (UTC) で、ISO 8601 標準形式である必要があります。 形式は YYYY-MM-DDThh:mm:ssZ です。 たとえば、2017-01-11T12:00:00Z は 2017 年 1 月 11 日 20:00:00 (UTC+08:00) に相当します。

    2020-12-20T13:00:00Z
    MediaType

    string

    任意

    メディアアセットのタイプ。 有効値：

    • image: イメージ

    • video: ビデオ

    • audio: オーディオファイル

    • text: テキストファイル

    video
    BusinessType

    string

    任意

    メディアアセットのビジネスタイプ。 有効値：

    • subtitles

    • watermark

    • opening

    • ending

    • general

    opening
    Source

    string

    任意

    メディアアセットのソース。 有効値：

    • oss: Object Storage Service (OSS)

    • vod: ApsaraVideo VOD

    • live: ApsaraVideo Live

    • general: その他のソース (デフォルト)

    oss
    Status

    string

    任意

    メディアアセットのステータス。 有効値：

    • Init: メディアアセットは初期化中であり、ソースファイルは準備ができていません。

    • Preparing: ソースファイルは準備中です。 たとえば、ファイルはアップロード中または編集中です。

    • PrepareFail: ソースファイルの準備に失敗しました。 たとえば、ソースファイル情報の取得に失敗しました。

    • Normal: ソースファイルの準備が完了しました。

    Normal
    NextToken

    string

    任意

    次のリクエストで結果の新しいページを取得するために使用されるページネーショントークン。 このパラメーターが空の場合、すべての結果が返されます。

    pSa1SQ0wCe5pzVrQ6mWZEw==
    MaxResults

    integer

    任意

    各ページで返すエントリの最大数。

    最大値: 100。 デフォルト値: 10。

    5
    SortBy

    string

    任意

    utcCreated に基づく結果のソート順。 デフォルト値: desc。

    • desc: 降順

    • asc: 昇順

    desc
    IncludeFileBasicInfo

    boolean

    任意

    レスポンスにファイルの基本情報を含めるかどうかを指定します。 値 true は、基本情報が含まれることを示します。

    true
    MediaId

    string

    任意

    メディアアセットの ID。

    ****019b82e24b37a1c2958dec38****
    AuthTimeout

    integer

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンススキーマ。

    RequestId

    string

    リクエスト ID。

    ******B7-7F87-4792-BFE9-63CD21******
    TotalCount

    integer

    返されたエントリの総数。

    4
    MediaInfos

    array<object>

    要件を満たすメディアアセットのコレクション。

    array<object>

    MediaId

    string

    メディアアセットの ID。

    ****019b82e24b37a1c2958dec38****
    MediaBasicInfo

    object

    メディアアセットの基本情報。

    MediaId

    string

    メディアアセットの ID。

    ****019b82e24b37a1c2958dec38****
    InputURL

    string

    対応するシステムに登録されるメディアアセットのアドレス。

    https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    MediaType

    string

    メディアアセットのタイプ。

    video
    BusinessType

    string

    メディアアセットのビジネスタイプ。

    opening
    Source

    string

    メディアアセットのソース。

    oss
    Title

    string

    メディアアセットのタイトル。

    title标题
    Description

    string

    メディアアセットの説明。

    desc 描述
    Category

    string

    メディアアセットのカテゴリ。

    分类 category
    MediaTags

    string

    メディアアセットのタグ。

    tags,tags2
    CoverURL

    string

    カバーの URL。

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    UserData

    string

    ユーザーデータ。

    userData
    Snapshots

    string

    スナップショット。

    [{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}]
    Status

    string

    リソースのステータス。

    Normal
    TranscodeStatus

    string

    トランスコードステータス。

    Init
    CreateTime

    string

    メディアアセットが作成された時刻。

    2021-01-08T16:52:04Z
    ModifiedTime

    string

    メディアアセットが変更された時刻。

    2021-01-08T16:52:07Z
    DeletedTime

    string

    メディアアセットが削除された時刻。

    2021-01-08T16:52:07Z
    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"}]
    CateId

    integer

    カテゴリの ID。

    3049
    Biz

    string

    メディアアセットが属するビジネス。

    ICE
    UploadSource

    string

    メディアアセットがアップロードされたソース。

    general
    ReferenceId

    string

    各ユーザーに固有のカスタム ID。 値には、文字、数字、ハイフン (-)、アンダースコア (_) を含めることができ、長さは 6〜64 文字である必要があります。

    123-123
    FileInfoList

    array<object>

    ファイル情報。

    array<object>

    FileBasicInfo

    object

    持続時間やサイズなど、ファイルの基本情報。

    FileName

    string

    ファイルの名前。

    example.mp4
    FileStatus

    string

    ファイルのステータス。

    Normal
    FileType

    string

    ファイルのタイプ。

    source_file
    FileSize

    string

    ファイルのサイズ。 単位: バイト。

    14340962
    FileUrl

    string

    ファイルの OSS URL。

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
    Region

    string

    ファイルが保存されているリージョン。

    cn-shanghai
    FormatName

    string

    コンテナフォーマット。

    mov,mp4,m4a,3gp,3g2,mj2
    Duration

    string

    持続時間。

    60.00000
    Bitrate

    string

    ビットレート。

    1912.13
    Width

    string

    幅。

    1280
    Height

    string

    高さ。

    720
    CreateTime

    string

    ファイルが作成された時刻。

    2021-01-08T16:52:04Z
    ModifiedTime

    string

    ファイルが変更された時刻。

    2021-01-08T16:52:07Z
    NextToken

    string

    結果の次のページを取得するために使用されるトークン。 このパラメーターが指定されていない場合、すべての結果が返されます。

    8EqYpQbZ6Eh7+Zz8DxVYoQ==
    MaxResults

    integer

    現在のページで返されるエントリの最大数。

    2

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******B7-7F87-4792-BFE9-63CD21******",
  "TotalCount": 4,
  "MediaInfos": [
    {
      "MediaId": "****019b82e24b37a1c2958dec38****",
      "MediaBasicInfo": {
        "MediaId": "****019b82e24b37a1c2958dec38****",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "title标题",
        "Description": "desc 描述",
        "Category": "分类 category",
        "MediaTags": "tags,tags2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2021-01-08T16:52:04Z",
        "ModifiedTime": "2021-01-08T16:52:07Z",
        "DeletedTime": "2021-01-08T16:52:07Z",
        "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\"}]",
        "CateId": 3049,
        "Biz": "ICE",
        "UploadSource": "general",
        "ReferenceId": "123-123"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "14340962",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000",
            "Bitrate": "1912.13",
            "Width": "1280",
            "Height": "720",
            "CreateTime": "2021-01-08T16:52:04Z",
            "ModifiedTime": "2021-01-08T16:52:07Z"
          }
        }
      ]
    }
  ],
  "NextToken": "8EqYpQbZ6Eh7+Zz8DxVYoQ==",
  "MaxResults": 2
}

    エラーコード

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

    変更履歴

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