すべてのプロダクト
Search

このプロダクト

    :CreateInstance

    ドキュメントセンター

    :CreateInstance

    最終更新日:Dec 21, 2025

    インスタンスを作成します。この操作を呼び出すと、新しいインスタンスの注文が作成され、その注文は自動的に支払われます。この操作を呼び出して Elastic Compute Service (ECS) インスタンスまたは ApsaraDB RDS インスタンスを作成することはできません。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    bss:ModifyInstance

    create

    *All Resource

    *
    • bssapi:ProductCode
    • bssapi:ProductType
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProductCode

    string

    必須

    インスタンスが属するサービスのコード。QueryProductList 操作を呼び出すか、「Alibaba Cloud サービスのコード」をご参照いただくことで、サービスコードを照会できます。

    rds
    ProductType

    string

    任意

    サービスタイプ。

    rds
    SubscriptionType

    string

    必須

    課金方法。有効な値：

    • Subscription：サブスクリプション課金方法。

    • PayAsYouGo：従量課金方法。

    Subscription
    Period

    integer

    任意

    サブスクリプション期間。単位：月。値は 12 の整数倍である必要があります。

    説明

    このパラメーターは、サブスクリプションインスタンスを作成する場合に必須です。

    12
    RenewalStatus

    string

    任意

    更新方法。有効な値：

    • AutoRenewal：インスタンスは自動的に更新されます。

    • ManualRenewal：インスタンスは手動で更新されます。

    デフォルト値：ManualRenewal。

    ManualRenewal
    RenewPeriod

    integer

    任意

    自動更新期間。単位：月。

    説明

    このパラメーターは、RenewalStatus パラメーターを AutoRenewal に設定した場合に必須です。

    12
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークン。サーバーは、同じクライアントトークンを使用するリクエストが受信されたかどうかを確認します。同じクライアントトークンを使用するリクエストが受信された場合、サーバーは前のリクエストと同じリクエスト結果を返します。

    JASIOFKVNVIXXXXXX
    Logistics

    string

    任意

    この注文の物流アドレス。このパラメーターは通常、物理的な注文に対して有効です。

    {"cityCode":"330100","cityName":"Hangzhou","contactName":"Test","countryCode":"","districtName":"Puyan Street","email":"\*\*@example.com","mobilePhone":"153564848844","phone":"1234567","provCode":"330000","provName":"Zhejiang","streetCode":"33010610","streetName":"Zhuantang","zipCode":"0000"}

    Parameter

    array<object>

    任意

    モジュールの詳細。

    object

    任意

    モジュール。

    Value

    string

    必須

    N 番目のモジュールの値プロパティ。N の値：1～100。

    disk
    Code

    string

    必須

    N 番目のモジュールのコードプロパティ。N の値：1～100。複数のモジュールプロパティパラメーターが関与する場合、N の値に基づいて複数のパラメーターを順番に連結します。

    InstanceType
    PricingCycle

    integer

    任意

    前払い期間のサイクルタイプ

    • PricingCycle=1 は、前払い期間の単位が年であることを示します。

    • PricingCycle=2 は、前払い期間の単位が月であることを示します。

    • PricingCycle=3 は、前払い期間の単位が日であることを示します。

    • デフォルト値：PricingCycle=2

    特定のプロダクトタイプ (ProductType が ddos_originpre_public_cn、ddosDip、ddoscoo、ddos_originpre_public_intl、ddosDip_intl、ddoscoo_intl の場合) にのみ適用されます。

    2

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    ステータスコード。

    Success
    Message

    string

    返されたエラーメッセージ。

    Successful！
    RequestId

    string

    リクエスト ID。

    C880B065-A781-4F19-B6DD-3E0E3B715C64
    Success

    boolean

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

    true
    Data

    object

    返されたデータ。

    OrderId

    string

    作成された注文の ID。

    20240xxxx21
    InstanceId

    string

    注文が作成されたインスタンスの ID。

    OSSBAG-cn-v1hxxxxx23

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "Success",
  "Message": "Successful！",
  "RequestId": "C880B065-A781-4F19-B6DD-3E0E3B715C64",
  "Success": true,
  "Data": {
    "OrderId": "20240xxxx21",
    "InstanceId": "OSSBAG-cn-v1hxxxxx23"
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    200 INSUFFICIENT.AVAILABLE.QUOTA The account balance is negative. Add funds to the account and try again.
    400 InvalidOwner The specified owner doesn't belong to caller.
    400 ORDER.ACCOUNT_STATUS_ILLEGAL Please complete your basic personal information first.
    400 400 Failure to check order before create instance.
    400 ORDER.ACCOUNT_INFORMATION_INCOMPLETE Your information is incomplete. Complete your information before ordering
    500 InternalError The request processing has failed due to some unknown error.

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

    変更履歴

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