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

Elastic High Performance Computing:ListCommunityImages

最終更新日:Dec 21, 2025

コミュニティイメージのリストを照会します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ehpc:ListCommunityImages

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

BaseOsTag

string

任意

ベースオペレーティングシステム (BOS) のタグ。

CentOS_7.2_64

InstanceType

string

任意

Elastic Compute Service (ECS) インスタンスのインスタンスタイプ。インスタンスタイプを指定しない場合、すべてのインスタンスタイプでサポートされているコミュニティイメージが照会されます。

ecs.n1.tiny

ClusterId

string

任意

クラスターの ID。クラスターが複数のオペレーティングシステムをサポートしている場合、クラスターが存在するリージョン内のすべてのコミュニティイメージが照会されます。

クラスター ID を指定しない場合、すべてのクラスターでサポートされているコミュニティイメージが照会されます。

ehpc-hz-FYUr32****

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

04F0F334-1335-436C-A1D7-6C044FE73368

Images

object

ImageInfo

array<object>

E-HPC でサポートされているカスタムイメージと共有イメージのリスト。

array<object>

Status

string

イメージの状態。有効値:

  • UnAvailable

  • Available

  • Creating

  • CreateFailed

Available

PostInstallScript

string

イメージのインストール後に実行されるスクリプト。

example.sh

Description

string

イメージの説明。

ExampleDescription

Size

integer

イメージのサイズ。単位:GiB。

40

ImageOwnerAlias

string

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

  • self:カスタムイメージ

  • others:共有イメージ

self

ImageName

string

イメージ名。

linux_CentOS7.2_OceanBase_OBD_1ECS-3OB_3.0

SkuCode

string

イメージの SKU (Stock Keeping Unit)。有効値:

  • ECS:従量課金

  • package:サブスクリプション

ECS

PricingCycle

string

イメージの課金単位。有効値:

  • Hour

  • Month

  • Year

Month

ImageId

string

イメージ ID。

m-bp181x855551ww5yq****

ProductCode

string

Alibaba Cloud Marketplace のプロダクトコード。

cmjj028279

Uid

string

イメージのオーナー。

127****

BaseOsTag

object

BOS イメージのタグ。

Platform

string

オペレーティングシステムのディストリビューション。有効値:

  • CentOS

  • Ubuntu

  • SUSE

  • OpenSUSE

  • Debian

  • CoreOS

  • Aliyun

  • Windows Server 2003

  • Windows Server 2008

  • Windows Server 2012

  • Others Linux

  • Customized Linux

CentOS

OsTag

string

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

CentOS_7.2_64

Version

string

オペレーティングシステムのバージョン。

7.2

Architecture

string

オペレーティングシステムのアーキテクチャ。有効値:

  • i386

  • x86_64

x86_64

OsTag

object

E-HPC でサポートされている OS イメージの配列。

Platform

string

OS。

CentOS

OsTag

string

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

CentOS_7.2_64

Version

string

オペレーティングシステムのバージョン。

7.2

Architecture

string

オペレーティングシステムのアーキテクチャ。有効値:

  • i386

  • x86_64

x86_64

BaseOsTag

string

BOS イメージのタグ。

CentOS_7.2_64

成功レスポンス

JSONJSON

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "Images": {
    "ImageInfo": [
      {
        "Status": "Available",
        "PostInstallScript": "example.sh",
        "Description": "ExampleDescription",
        "Size": 40,
        "ImageOwnerAlias": "self",
        "ImageName": "linux_CentOS7.2_OceanBase_OBD_1ECS-3OB_3.0",
        "SkuCode": "ECS",
        "PricingCycle": "Month",
        "ImageId": "m-bp181x855551ww5yq****",
        "ProductCode": "cmjj028279",
        "Uid": "127****",
        "BaseOsTag": {
          "Platform": "CentOS",
          "OsTag": "CentOS_7.2_64",
          "Version": "7.2",
          "Architecture": "x86_64"
        },
        "OsTag": {
          "Platform": "CentOS",
          "OsTag": "CentOS_7.2_64",
          "Version": "7.2",
          "Architecture": "x86_64",
          "BaseOsTag": "CentOS_7.2_64"
        }
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 UnknownError An unknown error occurred.
404 ImageNotFound The specified image does not exist.
503 ServiceUnavailable The request has failed due to a temporary failure of the server
406 EcsError An error occurred while calling the ECS API operation.
406 DbError A database service error occurred.
407 NotAuthorized You are not authorized by RAM for this request.

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

変更履歴

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