すべてのプロダクト
Search

このプロダクト

    :インスタンス価格の照会

    ドキュメントセンター

    :インスタンス価格の照会

    最終更新日:Mar 07, 2025

    DescribePrice操作を呼び出して、ApsaraDB RDSインスタンスの価格を照会できます。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    項目データ型必須／任意例:説明
    操作String必須DescribePrice

    実行したい操作。 値をDescribePriceに設定します。

    DBInstanceClassString必須rds.mysql.s1.small

    インスタンスのインスタンスタイプ。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。

    DBInstanceStorageInteger〇20

    インスタンスのストレージ容量。 単位 : GB ストレージ容量は5 GB単位で増加します。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。

    EngineString必須MySQL

    インスタンスで実行されるデータベースエンジン。 有効な値：

    • MySQL
    • SQLServer
    • PostgreSQL
    • マリaDB TX
    EngineVersionString必須5.5

    インスタンスで実行されるデータベースエンジンのバージョン。 有効な値：

    • MySQL: 5.5、5.6、5.7、および8.0
    • SQL Server: 2008r 2、2012、2012_ent_ヘクタール、2012_std_ヘクタール、2012_web、2014_std_ヘクタール、2016_ent_ヘクタール、2016_std_ヘクタール、2016_web、2017_std_ヘクタール、2017_ent、2019_std_ha、および2019_ent
    • PostgreSQL: 10.0, 11.0, 12.0, 13.0および14.0
    • MariaDB TX: 10.3
    数量Integer〇10

    購入するインスタンスの数。 有効値: 0〜30。

    RegionIdString必須cn-hangzhou

    インスタンスのリージョンID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。

    ClientTokenString任意ETnLKlblzczshOTUbOCzxxxxxxxxxx

    リクエストの冪等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意である必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

    コモディティコードString任意rds

    インスタンスの商品コード。有効な値：

    • bards: インスタンスは従量課金制のプライマリーインスタンスです。 この値は、中国のサイト (aliyun.com) で入手できます。
    • rds: インスタンスはサブスクリプションプライマリーインスタンスです。 デフォルト値です。 この値は、中国のサイト (aliyun.com) で入手できます。
    • rords: インスタンスは、従量課金制の読み取り専用インスタンスです。この値は、中国サイト（aliyun.com）で利用可能です。
    • rds_rordspre_public_cn: インスタンスは、サブスクリプションの読み取り専用インスタンスです。 この値は、中国のサイト (aliyun.com) で入手できます。
    • bards_intl: インスタンスは従量課金のプライマリインスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
    • rds_intl: インスタンスはサブスクリプションプライマリインスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
    • rords_intl: インスタンスは従量課金の読み取り専用インスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
    • rds_rordspre_public_intl: インスタンスはサブスクリプション読み取り専用インスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
    説明 読み取り専用インスタンスの価格を照会する場合は、このパラメーターを指定する必要があります。
    PayTypeString任意プリペイド

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

    • Prepaid: サブスクリプション
    • Postpaid: 従量課金
    ZoneIdString任意cn-hangzhou-d

    プライマリインスタンスのゾーンID。 DescribeRegions を呼び出すと、最新のゾーンリストを照会できます。

    説明 VPCとvSwitchを指定する場合は、このパラメーターを指定する必要があります。
    UsedTimeIntegerいいえ1

    インスタンスの契約期間です。有効な値：

    • TimeTypeパラメーターをYearに設定した場合、UsedTimeパラメーターの値は1〜100です。
    • TimeType パラメータを Monthに設定した場合、 UsedTimeパラメータの値は 1 to 999の範囲になります。

    デフォルト値は、1 です。

    TimeTypeString任意年

    インスタンスの課金サイクルの計算に使用される単位です。 CommodityCodeパラメーターの値がRDS、rds_rordspre_public_cn、rds_intl、またはrds_rordspre_public_intlの場合、このパラメーターを指定する必要があります。 有効な値:

    • Year
    • Month
    InstanceUsedTypeIntegerいいえ0

    インスタンスのロール。 有効な値：

    • : プライマリ0
    • : 読み取り専用3
    OrderTypeString任意購入

    注文のタイプ。 有効な値：

    • 購入: 発注書
    • UPGRADE: 仕様変更順序
    • RENEW: 更新注文
    DBInstanceStorageTypeString任意local_ssd

    インスタンスに使用されるストレージメディアのタイプ。 有効な値：

    • local_ssd: ローカルssd
    • cloud_ssd: 標準ssd
    • cloud_essd: パフォーマンスレベル1 (PL1) の拡張SSD (essd)
    • cloud_essd2: PL2のESSD
    • cloud_essd3: PL3のESSD
    DBInstanceIdString任意rm-xxxxx

    仕様を変更するインスタンスまたは更新するインスタンスのID。

    説明 特定のインスタンスの仕様を変更したり、特定のインスタンスを更新したりするために必要な価格を照会する場合は、このパラメーターを指定する必要があります。

    レスポンスパラメーター

    項目データ型例:説明
    ルールルールの配列

    プロモーションルールで構成される配列。

    ルール
    RuleIdLong1020021003939076

    プロモーションルールのID。

    名前StringRule1

    プロモーションルールの名前。

    説明 StringContent

    プロモーションルールの説明。

    PriceInfoStruct

    プロモーションルールで指定されている価格。

    CurrencyStringCNY

    価格を測定するために使用される通貨。

    ActivityInfoStruct

    プロモーションルールで指定されている価格。

    CheckErrMsgStringエラーの説明

    エラーの説明。

    ErrorCodeString 123456

    エラーのコード。

    SuccessString成功

    操作が成功したかどうかを示します。

    オリジナル価格浮く2504

    あなたが支払う必要がある元の価格。

    割引価格浮く0

    プロモーションルールに基づいて適用される割引。

    TradePrice浮く2504

    あなたが支払う必要がある割引価格。

    クーポンクーポンの配列

    クーポンに関する情報で構成される配列。

    Coupon
    名前Stringtest

    クーポンの名前。

    説明 Stringtest

    クーポンの説明。

    CouponNoString123456

    クーポンのID。

    IsSelectedString真実

    クーポンが選択されているかどうかを示します。

    RuleIdsList1001199213

    プロモーションルールのID。

    RequestIdStringCA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6

    リクエストの ID です。

    例

    リクエストの例

    http(s)://rds.aliyuncs.com/?Action=DescribePrice
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=200
&Engine=MySQL
&EngineVersion=5.7
&Quantity=1
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-h
&PayType=Prepaid
&UsedTime=1
&TimeType=Month
&<Common request parameters>

    正常に処理された場合のレスポンス例

    XML 形式

    <DescribePriceResponse>
  <RequestId>CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6</RequestId>
  <ルール>
</ルール>
  <PriceInfo>
        <OriginalPrice>2504</OriginalPrice>
        <Currency>CNY</Currency>
        <割引価格> 0</割引価格>
        <RuleIds>
    </RuleIds>
        <TradePrice>2504</TradePrice>
        <クーポン>
    </クーポン>
  </PriceInfo>
</DescribePriceResponse>

    JSON 形式

    {
    "RequestId": "CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6" 、
    "Rules": {
        "ルール": []
    },
    "PriceInfo": {
        "OriginalPrice": 2504、
        "通貨": "CNY" 、
        "DiscountPrice": 0、
        "RuleIds": {
            "RuleId": []
        },
        "TradePrice": 2504、
        "クーポン": {
            "クーポン": []
        }
    }
}

    エラーコード

    エラーコードリストについては、「API エラーセンター」をご参照ください。