すべてのプロダクト
Search

このプロダクト

    App Streaming:ListImage

    ドキュメントセンター

    App Streaming:ListImage

    最終更新日:Jul 04, 2026

    イメージの情報を返します。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    appstreaming:ListImage

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ImageId

    string

    任意

    イメージの ID。

    img-bp13mu****
    ImageName

    string

    任意

    イメージの名前。あいまい検索に対応しています。

    DemoImage
    Status

    string

    任意

    イメージのステータス。このパラメータを使用して、特定のステータスのイメージを照会します。このパラメータを省略した場合、削除されていないすべてのイメージが返されます。

    列挙値:

    • AVAILABLE :

      利用可能

    • INIT :

      初期化中

    • CREATE_FAILED :

      作成失敗

    • CREATING :

      作成中

    INIT
    ImageType

    string

    任意

    イメージタイプ。

    列挙値:

    • User :

      カスタムイメージ

    • Shared :

      共有イメージ

    • System :

      システムイメージ

    • Community :

      コミュニティイメージ

    User
    PackageType

    string

    任意

    イメージのパッケージタイプ。

    列挙値:

    • Ecs_Container :

      ECS + Docker イメージ

    • Ecs :

      ECS イメージ

    Ecs
    OsType

    string

    任意

    イメージのオペレーティングシステム。

    列挙値:

    • Linux :

      Linux

    • Unknown :

      不明

    • Windows :

      Windows

    • Android :

      Android

    Windows
    BizType

    integer

    任意

    ビジネスタイプ。このパラメータは内部用です。

    列挙値:

    • 1 :

      デフォルト

    1
    ProductType

    string

    任意

    プロダクトタイプ。

    列挙値:

    • CloudDesktop :

      Elastic Desktop Service

    • CloudApp :

      Wuying App Streaming

    • WuyingServer :

      Wuying Workspace

    CloudApp
    ProtocolType

    string

    任意

    ストリーミングプロトコル。

    列挙値:

    • HDX :

      HDX プロトコル

    • ASP :

      Alibaba Cloud 独自の ASP プロトコル。

    ASP
    PageSize

    integer

    任意

    ページあたりのエントリ数。最大値：100。デフォルト値：10。

    10
    PageNumber

    integer

    任意

    ページ番号。

    1
    ProductTypeList

    array

    任意

    イメージがサポートするプロダクトタイプ。

    string

    任意

    プロダクトタイプ。

    列挙値:

    • CloudDesktop :

      Elastic Desktop Service

    • CloudApp :

      Wuying App Streaming

    • WuyingServer :

      Wuying Workspace

    CloudApp
    BizTypeList

    array

    任意

    ビジネスタイプのリスト。このパラメータは内部用です。

    integer

    任意

    ビジネスタイプ。ご利用のサービスに応じて値を指定してください。

    列挙値:

    • 1 :

      デフォルト

    1
    FeatureList

    array

    任意

    イメージがサポートする機能。

    string

    任意

    イメージがサポートする機能。

    列挙値:

    • FotaChannel :

      FOTA チャネルに対応しています。

    • Builder :

      Image Builder に対応しています。

    • MultiSession :

      マルチセッションに対応しています。

    • GPU :

      GPU アクセラレーションに対応しています。

    GPU
    LanguageType

    string

    任意

    言語。

    列挙値:

    • en-US :

      英語

    • zh-HK :

      繁体字中国語 (香港)

    • zh-CN :

      簡体字中国語

    • ja-JP :

      日本語

    zh-CN
    ResourceInstanceType

    string

    任意

    インスタンスタイプ。このパラメータを使用して、特定のインスタンスタイプと互換性のあるイメージをフィルタリングします。

    eds.enterprise_office.2c4g
    FotaVersion

    string

    任意

    イメージのバージョン。

    2.0.3-xxxx
    PlatformName

    string

    任意

    オペレーティングシステムプラットフォームの名前。

    列挙値:

    • Ubuntu :

      Ubuntu

    • Debian :

      Debian

    • Windows Server 2022 :

      Windows Server 2022 オペレーティングシステム

    • Windows Server 2019 :

      Windows Server 2019 オペレーティングシステム

    • Windows Server 2016 :

      Windows Server 2016 オペレーティングシステム

    • Windows 11 :

      Windows 11 オペレーティングシステム

    • Windows 10 :

      Windows 10 オペレーティングシステム

    Windows Server 2019
    BizRegionIdList

    array

    任意

    フィルタリング対象のリージョン ID。Wuying イメージは一元管理されています。このパラメータを使用して、指定されたリージョンで利用可能なイメージを検索します。

    string

    任意

    リージョン ID。

    cn-shanghai
    TagList

    array<object>

    任意

    結果をフィルタリングするためのタグ。

    object

    任意

    Key

    string

    任意

    ユーザー定義タグのキー。

    env
    Value

    string

    任意

    ユーザー定義タグの値。

    test
    PlatformNameList

    array

    任意

    対応プラットフォームタイプのリスト。有効な値については、PlatformName パラメータをご参照ください。

    string

    任意

    プラットフォーム名。

    Windows 11
    Distro

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    イメージ情報を含むデータ構造。

    PageSize

    integer

    各ページで返されるエントリ数。

    10
    PageNumber

    integer

    ページ番号。

    1
    Data

    array<object>

    イメージの詳細を含むオブジェクトのリスト。

    array<object>

    イメージの詳細を含むオブジェクト。

    GmtCreate

    string

    イメージの作成時刻。

    2025-04-25 15:13:57
    GmtModified

    string

    イメージの最終更新時刻。

    2025-04-25 15:13:57
    AliUid

    integer

    テナントの ID。

    123456789
    ImageId

    string

    イメージの ID。システムイメージの ID は事前定義されています。カスタムイメージの ID は自動的に生成されます。

    imgc-xxxx
    ImageName

    string

    イメージの名前。

    DemoImage
    ImageType

    string

    イメージのタイプ。

    User
    PackageType

    string

    イメージのパッケージングタイプ。

    ECS
    Description

    string

    イメージの説明。

    描述
    OsType

    string

    イメージのオペレーティングシステム。

    Windows
    ProtocolType

    string

    ストリーミングプロトコル。

    ASP
    BizType

    integer

    ビジネスタイプ。

    1
    ProductType

    string

    プロダクトタイプ。

    CloudApp
    VersionId

    string

    イメージのバージョン。

    iv-xxx
    OnlineVersionId

    string

    オンラインイメージバージョンの ID。イメージには複数のバージョンが存在する場合があります。

    iv-xxxx
    LatestVersionId

    string

    最新イメージバージョンの ID。イメージには複数のバージョンが存在する場合があります。

    iv-xxx
    Status

    string

    イメージのステータス。

    INIT
    ParentImageId

    string

    親イメージの ID。継承関係を示します。システムイメージの場合、このフィールドは空です。

    imgc-xxx
    ParentImageVersion

    string

    親イメージのバージョン。

    iv-xxx
    BaseImageId

    string

    ベースイメージの ID。

    imgc-xxx
    BaseImageVersion

    string

    ベースイメージのバージョン。

    iv-xxx
    FotaVersion

    string

    FOTA バージョン。

    2.3.0-xxx
    Language

    string

    イメージの言語。イメージが VHD または コンテナ としてパッケージ化されている場合、この値は同じ構成内の ECS パッケージ化イメージから継承されます。

    zh-CN
    Platform

    integer

    イメージのオペレーティングシステムプラットフォーム。

    説明

    イメージが VHD または コンテナ としてパッケージ化されている場合、この値は同じ構成内の ECS パッケージ化イメージから継承されます。

    Windows
    OnlineVersion

    boolean

    現在のバージョンがアクティブなバージョンであるかどうかを示します。

    true
    SystemDiskSize

    integer

    システムディスクのサイズ (単位：GiB)。

    説明

    システムディスクのサイズは、イメージファイルのサイズより小さく設定できません。

    40
    DataDiskSize

    integer

    データディスクのサイズ (単位：GiB)。

    100
    AppList

    array<object>

    アプリケーション設定のリスト。

    object

    AppId

    string

    アプリケーションの ID。

    ca-xxx
    AppName

    string

    アプリケーションの名前。

    应用名称
    FeatureList

    array

    イメージの機能タグのリスト。

    string

    イメージの機能タグ。

    Builder
    ImageCreateMode

    string

    イメージの作成に使用されたメソッド。

    列挙値:

    • BY_SNAPSHOT_ID :

      スナップショットから作成。システムディスクのみを含みます。

    • BUILDER_MANUAL :

      手動で作成。

    • INSTANCE_AUTO :

      インスタンスから自動的に作成。

    • BY_INSTANCE_ID :

      インスタンスから作成。システムディスクとデータディスクの両方を含みます。

    BUILDER_MANUAL
    ImageRegionList

    array

    リージョンのリスト。

    string

    リージョン。

    地域对象。
    Distro

    string

    ディストリビューションの名前。

    Ubuntu 22.04 64位
    VersionName

    string

    バージョンの名前。

    v0.1.0
    ResourceInstanceCategory

    string

    イメージがサポートするリソースタイプ。

    ["eds.cpu.category"]
    PlatformName

    string

    システムプラットフォームの名前。

    Windows Server 2022
    SupportedLanguageList

    array

    サポートされている言語のリスト。

    string

    サポートされている言語。

    zh-CN
    VolumeEncryptionEnabled

    boolean

    ディスク暗号化が有効になっているかどうかを示します。

    true
    VolumeEncryptionKey

    string

    ディスク暗号化に使用される Key Management Service (KMS) キーの ID。このパラメーターは、ディスク暗号化が有効な場合にのみ返されます。

    a7b3c0c8-xxxx
    SessionType

    string

    セッションタイプ。

    列挙値:

    • SINGLE_SESSION :

      インスタンスごとに 1 つのユーザーセッションのみをサポートします。

    • MULTIPLE_SESSION :

      単一のインスタンスで複数の同時ユーザーセッションをサポートします。

    SINGLE_SESSION
    ImageRegionDistributeList

    array<object>

    異なるリージョン間でのイメージの配布状況。

    object

    ImageId

    string

    イメージの ID。システムイメージの ID は事前定義されています。カスタムイメージの ID は自動的に生成されます。

    imgc-xxx
    RegionId

    string

    配布先のリージョン。

    cn-shanghai
    Status

    string

    このリージョンでの配布状況。

    INIT
    VersionId

    string

    イメージのバージョン。

    iv-xxx
    Progress

    string

    配布の進捗状況 (パーセンテージ)。

    70%
    FotaChannel

    string
    説明

    このパラメーターは外部使用には利用できません。

    镜像支持的fota渠道，暂未启用
    CompatibleMode

    boolean

    イメージが互換モードであるかを示します。

    true
    DriverList

    array

    ドライバー ID のリスト。

    string

    ドライバー ID。

    ["00be80de-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
    Scene

    string

    イメージの想定ユースケース。

    AIGC
    Rating

    integer

    イメージの評価。

    95
    ImageIconUrl

    string

    イメージアイコンの URL。

    EnvironmentId

    string

    環境の ID。

    env-164c321f405ca84143e4b730dbe4
    TagList

    array<object>

    イメージに追加されたタグ。

    object

    Key

    string

    タグのキー。

    1630348213973321
    Value

    string

    タグの値。

    inner
    SnapshotList

    array<object>

    イメージのスナップショット。

    object

    SnapshotId

    string

    スナップショットの ID。

    VersionId

    string

    イメージバージョンの ID。

    DiskType

    string

    ディスクのタイプ。

    DiskSubType

    string

    ディスクのサブタイプ。

    BindType

    string

    バインドタイプ。

    DiskCategory

    string

    ディスクのカテゴリ。

    Size

    integer

    スナップショットのサイズ (単位：GiB)。

    Count

    integer

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

    22
    Success

    boolean

    リクエストが成功したかどうかを示します。

    列挙値:

    • true :

      リクエスト成功。

    • false :

      リクエスト失敗。

    true
    Code

    string

    レスポンスコード。

    200
    Message

    string

    レスポンスメッセージ。

    success
    RequestId

    string

    リクエスト ID。

    8737D130-BFD0-5D51-96F6-C08EB1139A25

    例

    成功レスポンス

    JSONJSON

    {
  "PageSize": 10,
  "PageNumber": 1,
  "Data": [
    {
      "GmtCreate": "2025-04-25 15:13:57",
      "GmtModified": "2025-04-25 15:13:57",
      "AliUid": 123456789,
      "ImageId": "imgc-xxxx",
      "ImageName": "DemoImage",
      "ImageType": "User",
      "PackageType": "ECS",
      "Description": "描述",
      "OsType": "Windows",
      "ProtocolType": "ASP",
      "BizType": 1,
      "ProductType": "CloudApp",
      "VersionId": "iv-xxx",
      "OnlineVersionId": "iv-xxxx",
      "LatestVersionId": "iv-xxx",
      "Status": "INIT",
      "ParentImageId": "imgc-xxx",
      "ParentImageVersion": "iv-xxx",
      "BaseImageId": "imgc-xxx",
      "BaseImageVersion": "iv-xxx",
      "FotaVersion": "2.3.0-xxx",
      "Language": "zh-CN",
      "Platform": 0,
      "OnlineVersion": true,
      "SystemDiskSize": 40,
      "DataDiskSize": 100,
      "AppList": [
        {
          "AppId": "ca-xxx",
          "AppName": "应用名称"
        }
      ],
      "FeatureList": [
        "Builder"
      ],
      "ImageCreateMode": "BUILDER_MANUAL",
      "ImageRegionList": [
        "地域对象。"
      ],
      "Distro": "Ubuntu 22.04 64位",
      "VersionName": "v0.1.0",
      "ResourceInstanceCategory": "[\"eds.cpu.category\"]",
      "PlatformName": "Windows Server 2022",
      "SupportedLanguageList": [
        "zh-CN"
      ],
      "VolumeEncryptionEnabled": true,
      "VolumeEncryptionKey": "a7b3c0c8-xxxx",
      "SessionType": "SINGLE_SESSION",
      "ImageRegionDistributeList": [
        {
          "ImageId": "imgc-xxx",
          "RegionId": "cn-shanghai",
          "Status": "INIT",
          "VersionId": "iv-xxx",
          "Progress": "70%"
        }
      ],
      "FotaChannel": "镜像支持的fota渠道，暂未启用",
      "CompatibleMode": true,
      "DriverList": [
        "[\"00be80de-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"]"
      ],
      "Scene": "AIGC",
      "Rating": 95,
      "ImageIconUrl": "",
      "EnvironmentId": "env-164c321f405ca84143e4b730dbe4",
      "TagList": [
        {
          "Key": "1630348213973321",
          "Value": "inner"
        }
      ],
      "SnapshotList": [
        {
          "SnapshotId": "",
          "VersionId": "",
          "DiskType": "",
          "DiskSubType": "",
          "BindType": "",
          "DiskCategory": "",
          "Size": 0
        }
      ]
    }
  ],
  "Count": 22,
  "Success": true,
  "Code": "200",
  "Message": "success",
  "RequestId": "8737D130-BFD0-5D51-96F6-C08EB1139A25"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InternalError Internal error.
    400 InvalidBizType The bizType parameter is invalid.
    403 Forbidden.NoPermission You are not authorized to access this page.

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

    変更履歴

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