Consulta del precio de una instancia - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribePrice para consultar el precio de una instancia.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribePrice	La operación que desea ejecutar. Establezca el valor en DescribePrice.
ClientToken	String	No	ETnLKlblzczshOTUbOCz*****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único entre las distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud.
CommodityCode	String	No	rds	El código de producto de la instancia. Valores válidos: bards: La instancia es una instancia principal pay-as-you-go. Este valor está disponible en el sitio de China (aliyun.com). rds: La instancia es una instancia principal subscription. Este es el valor predeterminado. Este valor está disponible en el sitio de China (aliyun.com). rords: La instancia es una instancia de solo lectura pay-as-you-go. Este valor está disponible en el sitio de China (aliyun.com). rds_rordspre_public_cn: La instancia es una instancia de solo lectura subscription. Este valor está disponible en el sitio de China (aliyun.com). bards_intl: La instancia es una instancia principal pay-as-you-go. Este valor está disponible en el sitio internacional (alibabacloud.com). rds_intl: La instancia es una instancia principal subscription. Este valor está disponible en el sitio internacional (alibabacloud.com). rords_intl: La instancia es una instancia de solo lectura pay-as-you-go. Este valor está disponible en el sitio internacional (alibabacloud.com). rds_rordspre_public_intl: La instancia es una instancia de solo lectura subscription. Este valor está disponible en el sitio internacional (alibabacloud.com). Nota Si la instancia es de solo lectura, especifique el parámetro CommodityCode.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
Engine	String	Sí	MySQL	El motor de base de datos de la instancia. Valores válidos: MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	Sí	5.5	La versión del motor de base de datos de la instancia. Valores válidos cuando establece el parámetro Engine en MySQL: 5.5, 5.6, 5.7 y 8.0 Valores válidos cuando establece el parámetro Engine en SQLServer: 2008r2, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha y 2019_ent Valores válidos cuando establece el parámetro Engine en PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 y 15.0 Valores válidos cuando establece el parámetro Engine en MariaDB: 10.3
DBInstanceClass	String	Sí	rds.mysql.s1.small	El tipo de la instancia. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS.
DBInstanceStorage	Integer	Sí	20	La capacidad de almacenamiento de la instancia. Unidad: GB. Puede ajustar la capacidad de almacenamiento en incrementos de 5 GB. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS.
PayType	String	No	Prepaid	El método de facturación de la instancia. Valores válidos: Prepaid: subscription Postpaid: pay-as-you-go
ZoneId	String	No	cn-hangzhou-b	El ID de zona de la instancia principal. Puede llamar a la operación DescribeRegions para consultar la lista de zonas más reciente. Nota Si especifica una virtual private cloud (VPC) y un vSwitch, también debe especificar este parámetro.
UsedTime	Integer	No	1	La duración de la suscripción de la instancia. Si establece el parámetro TimeType en Year, el valor del parámetro UsedTime oscila entre 1 y 100. Si establece el parámetro TimeType en Month, el valor del parámetro UsedTime oscila entre 1 y 999. Valor predeterminado: 1.
TimeType	String	No	Year	La unidad que se utiliza para calcular la duración de la suscripción de la instancia. Si establece el parámetro CommodityCode en RDS, rds_rordspre_public_cn, rds_intl o rds_rordspre_public_intl, también debe especificar este parámetro. Valores válidos: Year Month
Quantity	Integer	Sí	10	El número de instancias que desea adquirir. Valores válidos: 0 a 30.
InstanceUsedType	Integer	No	0	La función de la instancia. Valores válidos: 0: instancia principal 3: instancia de solo lectura
OrderType	String	No	BUY	El tipo de pedido. Valores válidos: BUY: pedido de compra UPGRADE: pedido de cambio de especificaciones RENEW: pedido de renovación
DBInstanceStorageType	String	No	local_ssd	El tipo de almacenamiento de la instancia. Valores válidos: local_ssd: SSD local cloud_ssd: SSD estándar cloud_essd: SSD mejorada (ESSD) de nivel de rendimiento 1 (PL1) cloud_essd2: ESSD de PL2 cloud_essd3: ESSD de PL3
DBInstanceId	String	No	rm-*****	El ID de la instancia cuyas especificaciones desea cambiar o de la instancia que desea renovar. Nota Si desea consultar el precio de un pedido de cambio de especificaciones o de renovación, especifique este parámetro. Si la instancia es de solo lectura, establezca este parámetro en el ID de su instancia principal.
DBNode	Array	No		La información sobre el nodo. Nota Este parámetro está disponible para clústeres de ApsaraDB RDS for MySQL.
ClassCode	String	No	mysql.n2.small.xc	La especificación del nodo.
ZoneId	String	No	cn-hangzhou-j	El ID de zona del nodo.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6	El ID de la solicitud.
PriceInfo	Object		La información sobre el precio.
OriginalPrice	Float	2504	El precio original que debe pagar.
DiscountPrice	Float	0	El descuento aplicado.
Currency	String	CNY	La unidad monetaria.
TradePrice	Float	2504	El precio de la transacción, que equivale al precio original menos el descuento.
Coupons	Array of Coupon		Una matriz que contiene información sobre cupones.
Coupon
IsSelected	String	true	Indica si el cupón está seleccionado.
CouponNo	String	123456	El ID del cupón.
Name	String	test	El nombre del cupón.
Description	String	test	La descripción del cupón.
RuleIds	Array of String	1001199213	El ID de la regla de promoción.
ActivityInfo	Object		La información sobre la promoción.
CheckErrMsg	String	Error description	La descripción del error.
ErrorCode	String	123456	El código de error devuelto.
Success	String	Success	Indica si la solicitud fue exitosa.
Rules	Array of Rule		Los detalles sobre la regla de promoción.
Rule
Name	String	Rule1	El nombre de la regla de promoción.
Description	String	Activity Description	La descripción de la regla de promoción.
RuleId	Long	1020021003939076	El ID de la regla de promoción.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=DescribePrice
&ClientToken=ETnLKlblzczshOTUbOCz*****
&CommodityCode=rds
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.5
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&UsedTime=1
&TimeType=Year
&Quantity=10
&InstanceUsedType=0
&OrderType=BUY
&DBInstanceStorageType=local_ssd
&DBInstanceId=rm-*****
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<DescribePriceResponse>
    <RequestId>CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6</RequestId>
    <PriceInfo>
        <OriginalPrice>2504</OriginalPrice>
        <DiscountPrice>0</DiscountPrice>
        <Currency>CNY</Currency>
        <TradePrice>2504</TradePrice>
        <Coupons>
            <IsSelected>true</IsSelected>
            <CouponNo>123456</CouponNo>
            <Name>test</Name>
            <Description>test</Description>
        </Coupons>
        <RuleIds>1001199213</RuleIds>
        <ActivityInfo>
            <CheckErrMsg>Error description</CheckErrMsg>
            <ErrorCode> 123456</ErrorCode>
            <Success>Success</Success>
        </ActivityInfo>
    </PriceInfo>
    <Rules>
        <Name>Rule1</Name>
        <Description>Activity Description</Description>
        <RuleId>1020021003939076</RuleId>
    </Rules>
</DescribePriceResponse>

Formato JSON

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

{
  "RequestId" : "CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6",
  "PriceInfo" : {
    "OriginalPrice" : 2504,
    "DiscountPrice" : 0,
    "Currency" : "CNY",
    "TradePrice" : 2504,
    "Coupons" : [ {
      "IsSelected" : "true",
      "CouponNo" : "123456",
      "Name" : "test",
      "Description" : "test"
    } ],
    "RuleIds" : [ "1001199213" ],
    "ActivityInfo" : {
      "CheckErrMsg" : "Error description",
      "ErrorCode" : " 123456",
      "Success" : "Success"
    }
  },
  "Rules" : [ {
    "Name" : "Rule1",
    "Description" : "Activity Description",
    "RuleId" : 1020021003939076
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDBInstanceStorage.Format	InvalidDBInstanceStorage.Format	El mensaje de error devuelto porque la capacidad de almacenamiento no es válida. Compruebe la configuración de la capacidad de almacenamiento.
400	DBNodeParameter.InvalidClassCode	The ClassCode of the item of the specified parameter DBNode is inconsistent.	El mensaje de error devuelto porque la configuración de ClassCode no es válida para el parámetro DBNode.
400	DBNodeParameter.Required	The specified parameter DBNode is required.	El mensaje de error devuelto porque no se especificó el parámetro DBNode.
400	DBNodeParameter.TooFewItems	The specified parameter DBNode has too few items.	El mensaje de error devuelto porque se configuró un número insuficiente de elementos para el parámetro DBNode.
400	DBNodeParameter.TooManyItems	The specified parameter DBNode has too many items.	El mensaje de error devuelto porque se configuró un número excesivo de elementos para el parámetro DBNode.
404	InvalidTimeType.NotFound	The parameter timeType does not exist.	El mensaje de error devuelto porque el valor del parámetro TimeType no es válido. Los valores válidos del parámetro TimeType son Year, Month y Day.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.