すべてのプロダクト
Search

このプロダクト

    App Streaming:ListImage

    ドキュメントセンター

    App Streaming:ListImage

    最終更新日:Jul 21, 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 :

      WUYING Workspace。

    • CloudApp :

      WUYING CloudApp。

    • WuyingServer :

      WUYING Workstation。

    CloudApp。
    ProtocolType

    string

    任意

    イメージのプロトコルタイプ。

    列挙値:

    • HDX :

      HDX プロトコル。

    • ASP :

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

    ASP。
    PageSize

    integer

    任意

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

    10
    PageNumber

    integer

    任意

    現在のページ番号。

    1
    ProductTypeList

    array

    任意

    イメージが複数のプロダクトをサポートしている場合にサポートされるプロダクトのリスト。

    string

    任意

    プロダクトタイプ。

    列挙値:

    • CloudDesktop :

      WUYING Workspace。

    • CloudApp :

      WUYING CloudApp。

    • WuyingServer :

      WUYING Workstation。

    CloudApp。
    BizTypeList

    array

    任意

    すべてのビジネスタイプのリスト。このパラメーターは一般公開されていません。

    integer

    任意

    ビジネスタイプ。ビジネス要件に基づいてこのパラメーターを設定します。

    列挙値:

    • 1 :

      [デフォルト値]

    1
    FeatureList

    array

    任意

    イメージがサポートする特徴のリスト。

    string

    任意

    イメージがサポートする特徴。

    列挙値:

    • FotaChannel :

      FOTA チャネルをサポートします。

    • Builder :

      イメージ Builder をサポートします。

    • MultiSession :

      複数のセッションをサポートします。

    • GPU :

      GPU をサポートします。 [parameters.17.schema.enumValueTitles.Windows Server 2022]Windows Server 2022 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows Server 2019]Windows Server 2019 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows Server 2016]Windows Server 2016 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows 11]Windows 11 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows 10]Windows 10 オペレーティングシステム

    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 オペレーティングシステム。 [_single.params.PlatformName.enum.Windows Server 2022]Windows Server 2022 オペレーティングシステム [_single.params.PlatformName.enum.Windows Server 2019]Windows Server 2019 オペレーティングシステム [_single.params.PlatformName.enum.Windows Server 2016]Windows Server 2016 オペレーティングシステム [_single.params.PlatformName.enum.Windows 11]Windows 11 オペレーティングシステム [_single.params.PlatformName.enum.Windows 10]Windows 10 オペレーティングシステム [_single.params.PlatformName.enum.Windows Server 2022]Windows Server 2022 オペレーティングシステム [_single.params.PlatformName.enum.Windows Server 2019]Windows Server 2019 オペレーティングシステム [_single.params.PlatformName.enum.Windows Server 2016]Windows Server 2016 オペレーティングシステム [_single.params.PlatformName.enum.Windows 11]Windows 11 オペレーティングシステム [_single.params.PlatformName.enum.Windows 10]Windows 10 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows Server 2022]Windows Server 2022 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows Server 2019]Windows Server 2019 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows Server 2016]Windows Server 2016 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows 11]Windows 11 オペレーティングシステム [parameters.17.schema.enumValueTitles.Windows 10]Windows 10 オペレーティングシステム

    • 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

    任意

    サポートされているリージョンのリスト。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

    1 ページあたりのエントリ数。

    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

    イメージの説明。

    Description.
    OsType

    string

    イメージのタイプ。

    Windows。
    ProtocolType

    string

    プロトコルタイプ。

    ASP。
    BizType

    integer

    ビジネスタイプ。

    1
    ProductType

    string

    プロダクトタイプ。

    CloudApp。
    VersionId

    string

    イメージバージョン。

    iv-xxx。
    OnlineVersionId

    string

    現在のイメージがメインイメージ情報を読み取るサブバージョン。イメージは複数のサブバージョンで構成されています。

    iv-xxxx。
    LatestVersionId

    string

    イメージの最新のサブバージョン。イメージは複数のサブバージョンで構成されています。

    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/Container の場合、このプロパティはイメージ組み合わせ内の ECS パッケージタイプライメージから継承されます。

    zh-CN
    Platform

    integer

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

    説明

    パッケージタイプが VHD/Container の場合、このプロパティはイメージ組み合わせ内の 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-bit.
    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

    ディスク暗号化が有効な場合に使用される KMS キー ID。

    a7b3c0c8-xxxx。
    SessionType

    string

    セッションタイプ。

    列挙値:

    • SINGLE_SESSION :

      単一セッション。

    • 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

    ドライバー情報のリスト。

    string

    ドライバーリスト。

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

    string

    AIGC。
    Rating

    integer

    95
    ImageIconUrl

    string

    EnvironmentId

    string

    env-164c321f405ca84143e4b730dbe4
    TagList

    array<object>

    object

    Key

    string

    1630348213973321
    Value

    string

    inner
    SnapshotList

    array<object>

    object

    SnapshotId

    string

    VersionId

    string

    DiskType

    string

    DiskSubType

    string

    BindType

    string

    DiskCategory

    string

    Size

    integer

    Count

    integer

    エントリの総数。

    22
    Success

    boolean

    呼び出しが成功したかどうかを示します。

    列挙値:

    • true :

      呼び出しが成功しました。

    • false :

      呼び出しが失敗しました。

    true。
    Code

    string

    エラーコード。

    200
    Message

    string

    API リクエストに対して返されたメッセージ。

    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.

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

    変更履歴

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