すべてのプロダクト
Search
ドキュメントセンター

:GetImageInfos

最終更新日:Dec 15, 2025

一度に複数のイメージの基本情報を照会します。

操作説明

  • CreateUploadImage 操作を呼び出して ApsaraVideo VOD にイメージをアップロードし、この操作を呼び出して一度に複数のイメージの基本情報を照会できます。

  • ビデオスナップショットに関する情報を照会するには、ListSnapshots 操作を呼び出します。

  • 1 回の呼び出しで最大 20 個のイメージ ID を指定できます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:GetImageInfos

list

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ImageIds

string

必須

イメージ ID。複数の ID はコンマ (,) で区切ります。最大 20 個のイメージ ID を指定できます。次のいずれかの方法で ID を取得できます:

  • ApsaraVideo VOD コンソールにログインし、左側のナビゲーションウィンドウで [メディアファイル] > [イメージ] を選択します。

  • アップロード URL と認証情報を取得するために呼び出す CreateUploadImage 操作の応答から ImageId の値を取得します。

  • イメージをアップロードした後、SearchMedia 操作の応答から ImageId の値を取得します。

bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a****

AuthTimeout

integer

任意

イメージ URL の有効期限。単位:秒。

  • OutputType パラメーターが cdn に設定されている場合:

    • このパラメーターは、URL 認証が有効な場合にのみ有効です。それ以外の場合、イメージ URL に有効期限はありません。

    • 最小値:1。

    • 最大値:無制限。

    • デフォルト値:URL 認証で指定されたデフォルトの有効期間が使用されます。

  • OutputType パラメーターが oss に設定されている場合:

    • このパラメーターは、Object Storage Service (OSS) バケットの ACL が非公開の場合にのみ有効です。それ以外の場合、イメージ URL に有効期限はありません。

    • 最小値:1。

    • イメージを VOD バケットに保存する場合、このパラメーターの最大値は 2592000 (30 日) です。イメージを OSS バケットに保存する場合、このパラメーターの最大値は 129600 (36 時間) です。オリジンのセキュリティリスクを軽減するため、最大値は制限されています。

    • デフォルト値:3600。

3600

OutputType

string

任意

出力イメージ URL のタイプ。有効値:

  • oss:OSS URL

  • cdn:CDN URL

cdn

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

25818875-5F78-4AF6-D7393642CA58*****

ImageInfo

array<object>

イメージ情報。

array<object>

イメージ情報。

CreationTime

string

イメージが作成された時刻。時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠しています。時刻は UTC で表示されます。

2018-11-21T02:37:23Z

StorageLocation

string

イメージが保存されているバケット。

outin-****..oss-cn-shanghai.aliyuncs.com

Status

string

イメージファイルのステータス。有効値:

  • Uploading:イメージはアップロード中です。これは初期ステータスです。

  • Normal:イメージはアップロード済みです。

  • UploadFail:イメージのアップロードに失敗しました。

Uploading

CateId

integer

カテゴリ ID。

254766071

Tags

string

イメージのタグ。複数のタグはコンマ (,) で区切られます。

tag1,tag2,tag3

ImageType

string

イメージのタイプ。有効値:

  • default:通常のイメージ

  • cover:ビデオサムネイル

NormalSnapshot

CateName

string

カテゴリ名。

Test

Description

string

イメージの説明。

Test description

AppId

string

アプリケーション ID。

app-****

URL

string

イメージ URL。CDN ドメイン名が指定されている場合は CDN URL が返され、それ以外の場合は OSS URL が返されます。

http://example.aliyundoc.com/image/default/****.gif?auth_key=****

Title

string

イメージのタイトル。

this is a sample

ImageId

string

イメージ ID。

bbc65bba53f9*****ed90de118a7849

Mezzanine

object

イメージに関するソース情報。

FileURL

string

イメージファイルの OSS URL。

https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D

OriginalFileName

string

ソースファイルの URL。

****.gif

Width

integer

イメージの幅。単位:ピクセル。

200

Height

integer

イメージの高さ。単位:ピクセル。

200

FileSize

string

アップロードするファイルのサイズ。単位:バイト。

8932

NonExistImageIds

array

存在しないイメージの ID。

string

存在しないイメージの ID。

f45cf4eba5c80233389558c39****

成功レスポンス

JSONJSON

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58*****",
  "ImageInfo": [
    {
      "CreationTime": "2018-11-21T02:37:23Z",
      "StorageLocation": "outin-****..oss-cn-shanghai.aliyuncs.com",
      "Status": "Uploading",
      "CateId": 254766071,
      "Tags": "tag1,tag2,tag3",
      "ImageType": "NormalSnapshot",
      "CateName": "Test\n",
      "Description": "Test description\n",
      "AppId": "app-****",
      "URL": "http://example.aliyundoc.com/image/default/****.gif?auth_key=****",
      "Title": "this is a sample",
      "ImageId": "bbc65bba53f9*****ed90de118a7849",
      "Mezzanine": {
        "FileURL": "https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
        "OriginalFileName": "****.gif",
        "Width": 200,
        "Height": 200,
        "FileSize": "8932"
      }
    }
  ],
  "NonExistImageIds": [
    "f45cf4eba5c80233389558c39****"
  ]
}

エラーコード

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

変更履歴

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