すべてのプロダクト
Search

このプロダクト

    :CreateInstance

    ドキュメントセンター

    :CreateInstance

    最終更新日:Nov 10, 2025

    ApsaraMQ for RabbitMQ インスタンスを作成します。

    リクエストパラメータ

    パラメータ

    タイプ

    必須

    例

    説明

    Action

    String

    はい

    CreateInstance

    実行するオペレーション。値を CreateInstance に設定します。

    ClientToken

    String

    いいえ

    c2c5d1274axxxxxxxx

    クライアントトークン。

    PaymentType

    String

    はい

    Subscription

    インスタンスの課金方法。有効な値：

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

    • PayAsYouGo：従量課金方式。

    Period

    Integer

    いいえ

    1

    サブスクリプション期間。サブスクリプション期間の単位は periodCycle で指定します。

    説明

    このパラメータは、PaymentType を Subscription に設定した場合にのみ有効です。デフォルト値：1。

    PeriodCycle

    String

    いいえ

    Month

    サブスクリプション期間の単位。有効な値：

    • Month

    • Year

    このパラメータは、PaymentType を Subscription に設定した場合にのみ有効です。デフォルト値：Month。

    AutoRenew

    Boolean

    いいえ

    false

    自動更新を有効にするかどうかを指定します。有効な値：

    • true：自動更新を有効にします。

    • false：自動更新を無効にします。この値を選択した場合、インスタンスを手動で更新する必要があります。

    AutoRenewPeriod

    Integer

    いいえ

    1

    自動更新期間。自動更新期間の単位は RenewalDurationUnit で指定します。デフォルト値：Month。

    説明

    このパラメータは、AutoRenew を true に設定した場合にのみ有効です。デフォルト値：1。

    RenewStatus

    String

    いいえ

    false

    更新ステータス。このパラメータは AutoRenew と同じです。これらのパラメータのいずれかを設定できます。有効な値：

    • AutoRenewal

    説明

    このパラメータと AutoRenew の両方を設定した場合、このパラメータの値が使用されます。

    RenewalDurationUnit

    String

    いいえ

    Month

    自動更新期間の単位。有効な値：

    • Month

    • Year

    InstanceType

    String

    いいえ

    professional

    インスタンスエディション。

    サブスクリプションインスタンスでは、以下のエディションが利用可能です。

    • professional：プロフェッショナル版。

    • enterprise：エンタープライズ版

    • vip：エンタープライズプラチナ版。

    インスタンスが従量課金インスタンスの場合は、このパラメータを設定する必要はありません。

    ServerlessChargeType

    String

    いいえ

    onDemand

    従量課金インスタンスの課金方法。有効な値：

    • onDemand：実際の使用量に基づいて課金されます。

    InstanceName

    String

    いいえ

    amqp-xxxxx

    インスタンス名。長さが 64 文字を超えない名前を指定することをお勧めします。

    MaxPrivateTps

    Long

    いいえ

    1000

    インスタンスの仮想プライベートクラウド（ VPC ）ベースの 1 秒あたりのトランザクション数（ TPS ）の最大値。

    ApsaraMQ for RocketMQ 購入ページ に記載されている値に基づいて、このパラメータを設定します。

    SupportEip

    Boolean

    いいえ

    true

    Elastic IP アドレス（ EIP ）がサポートされているかどうかを指定します。有効な値：

    • True

    • False

    MaxEipTps

    Long

    いいえ

    128

    インスタンスの EIP ベースの TPS の最大数。

    ApsaraMQ for RocketMQ 購入ページ に記載されている値に基づいて、このパラメータを設定します。

    QueueCapacity

    Integer

    いいえ

    1000

    インスタンスのキューの数。

    ApsaraMQ for RocketMQ 購入ページ に記載されている値に基づいて、このパラメータを設定します。

    MaxConnections

    Integer

    いいえ

    50000

    インスタンスに確立できる接続の最大数。

    ApsaraMQ for RocketMQ 購入ページ に記載されている値に基づいて、このパラメータを設定します。

    StorageSize

    Integer

    いいえ

    7

    ストレージ容量。単位： GB 。有効な値：

    • プロフェッショナル版およびエンタープライズ版インスタンス：このパラメータを 0 に設定します。

    説明

    値 0 は、ストレージ容量は使用可能ですが、ストレージ料金は発生しないことを指定します。

    • エンタープライズプラチナ版インスタンス：このパラメータを 100 の倍数に設定します。倍数は 7 ～ 28 です。

    SupportTracing

    Boolean

    いいえ

    true

    メッセージトレース機能を有効にするかどうかを指定します。有効な値：

    • true

    • false

    説明

    • エンタープライズプラチナ版インスタンスでは、メッセージトレースを 15 日間無料で保持できます。エンタープライズプラチナ版インスタンスを使用する場合は、このパラメータを true に、TracingStorageTime を 15 にのみ設定できます。

    • 他のエディションのインスタンスの場合は、このパラメータを true または false に設定できます。

    TracingStorageTime

    Integer

    いいえ

    3

    メッセージの保持期間。単位：日。有効な値：

    • 3

    • 7

    • 15

    このパラメータは、SupportTracing を true に設定した場合にのみ有効です。

    レスポンスパラメータ

    パラメータ

    タイプ

    例

    説明

    RequestId

    String

    CCBB1225-C392-480E-8C7F-D09AB2CD2***

    リクエスト ID 。この ID を使用して問題のトラブルシューティングを行うことができます。このパラメータは共通パラメータです。

    Code

    Integer

    200

    レスポンスコード。値 200 は、リクエストが成功したことを示します。

    Message

    String

    xxx failed,xxxx

    返されたメッセージ。

    Data

    Any

    amqp-cn-xxxxx

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

    Success

    Boolean

    true

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

    例

    サブスクリプションインスタンスのパラメータ

    ApsaraMQ for RabbitMQ インスタンスの PaymentType を Subscription に設定する場合は、次のパラメータを設定する必要があります。 

    &PaymentType=Subscription
&AutoRenew=true
&AutoRenewPeriod=1
&Period=1
&PeriodCycle=Month
&InstanceType=professional
&MaxPrivateTps=1000
&SupportEip=true
&MaxEipTps=128
&QueueCapacity=1000
&MaxConnections=50000
&StorageSize=7
&SupportTracing=true
&TracingStorageTime=3
&Common request parameters

    次の表は、サブスクリプション ApsaraMQ for RabbitMQ インスタンスのメッセージトレースの制限について説明しています。

    InstanceType

    SupportTracing

    TracingStorageTime

    • professional

    • enterprise

    false

    0

    • professional

    • enterprise

    true

    • 3

    • 7

    • 15

    vip

    true

    15

    サーバーレスインスタンスのパラメータ

    サーバーレス ApsaraMQ for RabbitMQ インスタンスの PaymentType を PayAsYouGo に設定する場合は、次のパラメータを設定する必要があります。 

    &PaymentType=PayAsYouGo
&ServerlessChargeType=onDemand
&SupportEip=true
&SupportTracing=true
&Common request parameters

    正常なレスポンスの例

    XML 形式

    HTTP/1.1 200 OK
Content-Type:application/xml

<CreateInstanceResponse>
    <RequestId>CCBB1225-C392-480E-8C7F-D09AB2CD2***</RequestId>
    <Code>200</Code>
    <Message>xxx failed,xxxx</Message>
    <Data>amqp-cn-xxxxx</Data>
    <Success>true</Success>
</CreateInstanceResponse>

    JSON 形式

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CCBB1225-C392-480E-8C7F-D09AB2CD2***",
  "Code" : 200,
  "Message" : "xxx failed,xxxx",
  "Data" : "amqp-cn-xxxxx",
  "Success" : true
}

    エラーコード

    エラーコードの一覧については、「サービスエラーコード」をご参照ください。