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

ENS:ImportImage

最終更新日:Sep 17, 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ens:ImportImage

create

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ImageName

string

必須

イメージ名。名前は 2~128 文字で、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。先頭は英字にする必要があり、http:// または https:// で始めることはできません。

ImageName

ComputeType

string

必須

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

ens_vm: ENS 仮想マシンイメージ (デフォルト)。

列挙値:

  • ens_vm :

    ENS 仮想マシンイメージ。

ens_vm

OSSRegion

string

任意

イメージが配置されているリージョン。現在、cn-beijing のみがサポートされています。

cn-beijing

OSSBucket

string

任意

イメージファイルを保存する OSS バケット。

tmp-hybrid

OSSObject

string

任意

イメージファイルの名前。

image-test

OSType

string

必須

オペレーティングシステムプラットフォームのタイプ。有効な値:

  • windows

  • linux

現在、linux のみがサポートされています。

列挙値:

  • linux :

    Linux。

  • windows :

    Windows。

linux

Platform

string

任意

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

  • centos

  • ubuntu

centos

ImageFormat

string

必須

イメージフォーマット。有効な値: qcow2。 現在、qcow2 のみがサポートされています。

列挙値:

  • vhd :

    VHD フォーマット。

  • raw :

    RAW フォーマット。

  • qcow2 :

    QCOW2 フォーマット。

qcow2

Architecture

string

必須

システムアーキテクチャー。有効な値:

  • x86_64

現在、x86_64 のみがサポートされています。

列挙値:

  • x86_64 :

    x86_64 アーキテクチャー。

x86_64

OSVersion

string

任意

オペレーティングシステムのディストリビューションのバージョン。

6.8

DiskDeviceMapping

array<object>

任意

カスタムイメージ情報のリスト。

object

任意

カスタムイメージ情報のリスト。

OSSBucket

string

任意

イメージを保存する OSS バケット。

www-cn

OSSObject

string

任意

イメージのアップロード後に OSS バケットに保存されるイメージファイルのファイル名 (キー)。

image-bucket

OSSRegion

string

任意

イメージが配置されているリージョン。

cn-beijing

TargetOSSRegionId

string

任意

イメージが保存される送信先 OSS バケットのリージョン。

説明

現在、cn-beijing と ap-southeast-1 のみがサポートされています。

列挙値:

  • cn-beijing :

    北京。

  • thailand :

    タイ。

  • ap-southeast-1 :

    シンガポール。

  • vietnam :

    ベトナム。

cn-beijing

LicenseType

string

任意

イメージのライセンスタイプ。有効な値: Aliyun (Alibaba Cloud ライセンス) および BYOL (Bring Your Own Key)。

列挙値:

  • Aliyun :

    Alibaba Cloud ライセンス。

  • BYOL :

    Bring Your Own Key。

Aliyun

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

ImageId

string

イメージの ID。

m-5wn1dh*******b48f440ntvad

RequestId

string

リクエストの ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

例

成功レスポンス

JSONJSON

{
  "ImageId": "m-5wn1dh*******b48f440ntvad",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 NoPermission Permission denied.
400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

変更履歴

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