すべてのプロダクト
Search

このプロダクト

    :CreateInstance

    ドキュメントセンター

    :CreateInstance

    最終更新日:Oct 30, 2025

    この API 操作はインスタンスを作成します。

    操作説明

    警告 この API 操作は料金が発生します。この操作を呼び出す前に、Hologres の課金方法と料金を十分に理解していることを確認してください。

    • Hologres の課金の詳細については、「課金の概要」をご参照ください。

    • Hologres インスタンスを作成するときは、インスタンスのリージョンとゾーンを指定する必要があります。1 つのリージョンには複数のゾーンを含めることができます。次のリストは、各リージョンで利用可能なゾーンを示しています。

       cn-hangzhou (杭州): cn-hangzhou-h, cn-hangzhou-j, cn-hangzhou-k
   cn-shanghai (上海): cn-shanghai-e, cn-shanghai-f, cn-shanghai-l
   cn-beijing (北京): cn-beijing-i, cn-beijing-g, cn-beijing-l
   cn-zhangjiakou (張家口): cn-zhangjiakou-b
   cn-shenzhen (深セン): cn-shenzhen-d, cn-shenzhen-f, cn-shenzhen-e
   cn-wulanchabu (ウランチャブ): cn-wulanchabu-a
   cn-hongkong (香港): cn-hongkong-b, cn-hongkong-d
   cn-shanghai-finance-1 (上海金融クラウド): cn-shanghai-finance-1z, cn-shanghai-finance-1f
   cn-hangzhou-finance (杭州金融クラウド): cn-hangzhou-finance-k
   cn-shenzhen-finance-1 (深セン金融クラウド): cn-shenzhen-finance-1d
   ap-northeast-1 (東京): ap-northeast-1a
   ap-southeast-1 (シンガポール): ap-southeast-1c, ap-southeast-1a
   ap-southeast-3 (クアラルンプール): ap-southeast-3b
   ap-southeast-5 (ジャカルタ): ap-southeast-5b
   eu-central-1 (フランクフルト): eu-central-1a
   us-east-1 (バージニア): us-east-1a
   us-west-1 (シリコンバレー): us-west-1b

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    hologram:CreateInstance

    create

    *All Resource

    *

    		 なし なし

    リクエスト構文

    POST /api/v1/instances/create HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    body

    object

    任意

    リクエストボディ。

    regionId

    string

    必須

    リージョン ID。 詳細については、「 エンドポイント」をご参照ください。

    cn-hangzhou
    zoneId

    string

    必須

    ゾーン ID。 詳細については、「使用上の注意」セクションをご参照ください。

    cn-hangzhou-h
    vpcId

    string

    必須

    VPC の ID。 VPC はインスタンスと同じリージョンにある必要があります。

    vpc-t4netc3y5xxxx
    vSwitchId

    string

    必須

    vSwitch の ID。 vSwitch はインスタンスと同じゾーンにある必要があります。

    vsw-2vccsiymtxxxxxx
    resourceGroupId

    string

    任意

    リソースグループ。 このパラメーターを空のままにすると、アカウントのデフォルトのリソースグループが使用されます。

    ""
    instanceName

    string

    必須

    インスタンス名。 名前は 2～64 文字である必要があります。漢字または文字は 1 文字としてカウントされます。

    my_holo
    instanceType

    string

    必須

    インスタンスタイプ。 有効な値:

    • Standard: 汎用。

    • Follower: 読み取り専用セカンダリインスタンス。

    • Warehouse: 計算グループ。

    • Shared: 共有。

    • Serverless: サーバーレス。

    列挙値:

    • Warehouse :

      計算グループ

    • Follower :

      フォロワー

    • Standard :

      標準

    • Serverless :

      サーバーレス

    • Shared :

      共有

    Standard
    cpu

    integer

    任意

    インスタンスタイプ。 有効な値:

    • 32 CPU コアと 128 GB のメモリ (2 計算ノード)

    • 64 CPU コアと 256 GB のメモリ (4 計算ノード)

    • 96 CPU コアと 384 GB のメモリ (6 計算ノード)

    • 128 CPU コアと 512 GB のメモリ (8 計算ノード)

    • など。

    説明

    • CPU コアの数を指定します。

    • 1,024 を超える CPU コアを持つインスタンスを購入するには、チケットを送信してください。

    • 共有インスタンスのインスタンスタイプを指定する必要はありません。

    64
    storageSize

    integer

    任意

    インスタンスの標準ストレージ容量。 単位: GB。

    説明

    このパラメーターは、従量課金 (PostPaid) インスタンスでは無視されます。

    500
    coldStorageSize

    integer

    任意

    インスタンスのコールドストレージ容量。 単位: GB。

    説明

    このパラメーターは、従量課金 (PostPaid) インスタンスでは無視されます。

    500
    gatewayCount

    integer

    任意

    ゲートウェイの数。 有効な値: [2, 50]。

    説明

    このパラメーターは、Warehouse インスタンスに対してのみ指定する必要があります。

    4
    chargeType

    string

    必須

    課金方法。 有効な値:

    • PrePaid: サブスクリプション。

    • PostPaid: 従量課金。

    説明

    このパラメーターは共有インスタンスでは無視されます。共有インスタンスは定義済みの仕様を使用し、デフォルトの課金方法は PostPaid です。

    列挙値:

    • PostPaid :

      従量課金

    • PrePaid :

      サブスクリプション

    PostPaid
    autoPay

    boolean

    任意

    自動支払いを有効にするかどうかを指定します。 デフォルト値は true です。 有効な値:

    • true: 自動支払いが有効になります。

    • false: 注文は生成されますが、支払いは行われません。

    説明

    デフォルト値は true です。アカウントの残高が不足している場合は、AutoPay パラメーターを false に設定できます。未払いの注文が生成されます。費用とコストのコンソールにログインして注文の支払いができます。

    true
    pricingCycle

    string

    任意

    課金サイクル。 有効な値:

    • Month: インスタンスは月単位で課金されます。

    • Hour: インスタンスは時間単位で課金されます。

    説明

    • PrePaid インスタンスは Month のみをサポートします。

    • PostPaid インスタンスは Hour のみをサポートします。

    • 共有インスタンスの場合、値は自動的に Hour に設定されます。このパラメーターを指定する必要はありません。

    列挙値:

    • Month :

      月

    • Hour :

      時間

    Month
    duration

    integer

    任意

    サブスクリプション期間。 たとえば、2 か月間のサブスクリプションを購入できます。

    説明

    課金方法が PostPaid の場合、このパラメーターを指定する必要はありません。

    2
    autoRenew

    boolean

    任意

    自動更新を有効にするかどうかを指定します。 デフォルト値は false です。 有効な値:

    • true: 自動更新が有効になります。

    • false: 自動更新は無効になります。

    false
    leaderInstanceId

    string

    任意

    プライマリインスタンスの ID。 このパラメーターは、Follower インスタンスに必要です。

    説明

    プライマリインスタンスとセカンダリインスタンスは、次の条件を満たす必要があります。

    • プライマリインスタンスは実行中の状態です。

    • プライマリインスタンスとセカンダリインスタンスは同じリージョンにあります。

    • プライマリインスタンスとセカンダリインスタンスは同じゾーンにあります。

    • プライマリインスタンスにアタッチされているセカンダリインスタンスは 10 未満です。

    • プライマリインスタンスとセカンダリインスタンスは、同じ Alibaba Cloud アカウントに属しています。

    hgpostcn-cn-lbj3aworq112
    initialDatabases

    string

    任意

    初期データベース。

    chatbot
    enableServerlessComputing

    boolean

    任意

    サーバーレスコンピューティングを有効にするかどうかを指定します。

    列挙値:

    • true :

      有効

    • false :

      無効

    true
    storageType

    string

    任意

    ストレージタイプ。

    列挙値:

    • local :

      ローカル冗長ストレージ。

    • redundant :

      ゾーン冗長ストレージ (マルチ AZ)。

    redundant

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーターの詳細。

    RequestId

    string

    リクエスト ID。

    9CC37B9F-F4B4-5FF1-939B-AEE78DC70130
    Data

    object

    返された結果。

    InstanceId

    string

    インスタンス ID。

    hgpostcn-cn-xxxxxx
    OrderId

    string

    注文 ID。

    217523224780172
    Code

    string

    エラーコード。

    InvalidVpcOrVSwitch.NotAvailable
    Message

    string

    エラーの詳細。

    InvalidVpcOrVSwitch.NotAvailable

    Success

    string

    インスタンスが作成されたかどうかを示します。

    • true: インスタンスは作成されました。

    • false: インスタンスの作成に失敗しました。

    true
    HttpStatusCode

    string

    HTTP ステータスコード。

    200
    ErrorMessage

    string

    エラーメッセージ。

    null
    ErrorCode

    string

    エラーコード。

    null
    説明

    • パラメーター検証エラーが発生した場合でも、Data 応答が返されます。この場合、Success パラメーターの値は false で、Code および Message パラメーターが含まれます。例外がスローされない限り、Data.Success の値に基づいて呼び出しが成功したかどうかを判断できます。

    • 最新のソフトウェア開発キット (SDK) を使用してこの API 操作を呼び出すと、タイムアウトエラーが返されることがあります。これは、SDK のクライアントのデフォルトのタイムアウト期間がサーバーのタイムアウト期間と異なるために発生します。このエラーは、操作が正常に呼び出された場合でも返される可能性があります。この問題を回避するには、呼び出しを行う前に ReadTimeout パラメーターを 20000 に設定します。

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "9CC37B9F-F4B4-5FF1-939B-AEE78DC70130",
  "Data": {
    "InstanceId": "hgpostcn-cn-xxxxxx",
    "OrderId": "217523224780172",
    "Code": "InvalidVpcOrVSwitch.NotAvailable",
    "Message": "InvalidVpcOrVSwitch.NotAvailable\n",
    "Success": "true"
  },
  "HttpStatusCode": "200",
  "ErrorMessage": "null",
  "ErrorCode": "null"
}

    エラーコード

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

    変更履歴

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