すべてのプロダクト
Search

このプロダクト

    ENS:ImportImage

    ドキュメントセンター

    ENS:ImportImage

    最終更新日:Mar 24, 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

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ImageName

    string

    必須

    カスタムイメージの名前です。名前は 2 ～ 128 文字の長さで、文字または中国語の文字で始まる必要があります。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。名前は http:// または https:// で始めることはできません。

    镜像名称
    ComputeType

    string

    必須

    イメージのタイプです。有効な値: ens_vm (ENS 仮想マシンイメージ)。デフォルト値: ens_vm。

    ens_vm
    OSSRegion

    string

    任意

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

    cn-beijing
    OSSBucket

    string

    任意

    イメージファイルが保存されている OSS バケットです。

    tmp-hybrid
    OSSObject

    string

    任意

    OSS バケット内のイメージファイル (オブジェクト) の名前です。

    image-test
    OSType

    string

    必須

    オペレーティングシステムのタイプです。有効な値:

    • windows

    • linux

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

    linux
    Platform

    string

    任意

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

    • centos

    • ubuntu

    centos
    ImageFormat

    string

    必須

    イメージフォーマットです。
    有効な値: qcow2。

    qcow2
    Architecture

    string

    必須

    システムアーキテクチャーです。

    • x86_64

    x86_64
    OSVersion

    string

    任意

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

    6.8
    DiskDeviceMapping

    array<object>

    任意

    イメージファイルのソースを記述するディスクマッピングのリストです。

    object

    任意

    ディスクマッピングの詳細を指定します。

    OSSRegion

    string

    任意

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

    cn-beijing
    OSSBucket

    string

    任意

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

    www-cn
    OSSObject

    string

    任意

    OSS バケットに保存されているイメージファイルの名前 (キー) です。

    image-bucket
    TargetOSSRegionId

    string

    任意

    イメージが保存されるターゲットリージョンの ID です。

    説明

    現在、中国 (北京) と ap-southeast-1 リージョンのみがサポートされています。

    cn-beijing
    LicenseType

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ

    RequestId

    string

    リクエスト ID です。

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984
    ImageId

    string

    イメージ ID です。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

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

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

    変更履歴

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