Interroger le prix d'une instance - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribePrice	Opération à effectuer. Définissez la valeur sur DescribePrice.
ClientToken	String	No	ETnLKlblzczshOTUbOCz*****	Jeton client utilisé pour garantir l'idempotence de la requête. Générez le jeton via le client, en veillant à son unicité pour chaque requête. Le jeton ne doit contenir que des caractères ASCII et ne pas dépasser 64 caractères.
CommodityCode	String	No	rds	Code de produit de l'instance. Valeurs possibles : bards : Instance principale en paiement à l'utilisation. Disponible sur le site Chine (aliyun.com). rds : Instance principale par abonnement. Valeur par défaut. Disponible sur le site Chine (aliyun.com). rords : Instance en lecture seule en paiement à l'utilisation. Disponible sur le site Chine (aliyun.com). rds_rordspre_public_cn : Instance en lecture seule par abonnement. Disponible sur le site Chine (aliyun.com). bards_intl : Instance principale en paiement à l'utilisation. Disponible sur le site International (alibabacloud.com). rds_intl : Instance principale par abonnement. Disponible sur le site International (alibabacloud.com). rords_intl : Instance en lecture seule en paiement à l'utilisation. Disponible sur le site International (alibabacloud.com). rds_rordspre_public_intl : Instance en lecture seule par abonnement. Disponible sur le site International (alibabacloud.com). Remarque Pour une instance en lecture seule, spécifiez le paramètre CommodityCode.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
Engine	String	Yes	MySQL	Moteur de base de données de l'instance. Valeurs possibles : MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	Yes	5,5	Version du moteur de base de données de l'instance. Si Engine est défini sur MySQL : 5,5, 5,6, 5,7 et 8,0 Si Engine est défini sur 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 et 2019_ent Si Engine est défini sur PostgreSQL : 10,0, 11,0, 12,0, 13,0, 14,0 et 15,0 Si Engine est défini sur MariaDB : 10,3
DBInstanceClass	String	Yes	rds.mysql.s1.small	Type d'instance. Pour plus d'informations, consultez Types d'instances principales ApsaraDB RDS.
DBInstanceStorage	Integer	Yes	20	Capacité de stockage de l'instance (en Go). Ajustez la capacité par paliers de 5 Go. Pour plus d'informations, consultez Types d'instances principales ApsaraDB RDS.
PayType	String	No	Prepaid	Mode de facturation de l'instance. Valeurs possibles : Prepaid : abonnement Postpaid : paiement à l'utilisation
ZoneId	String	No	cn-hangzhou-b	ID de zone de l'instance principale. Appelez l'opération DescribeRegions pour obtenir la liste des zones la plus récente. Remarque Si vous spécifiez un VPC et un vSwitch, ce paramètre est obligatoire.
UsedTime	Integer	No	1	Durée d'abonnement de l'instance. Si TimeType est défini sur Year, UsedTime varie de 1 à 100. Si TimeType est défini sur Month, UsedTime varie de 1 à 999. Valeur par défaut : 1.
TimeType	String	No	Year	Unité de calcul de la durée d'abonnement. Si CommodityCode est défini sur RDS, rds_rordspre_public_cn, rds_intl ou rds_rordspre_public_intl, ce paramètre est obligatoire. Valeurs possibles : Year Month
Quantity	Integer	Yes	10	Nombre d'instances à acheter. Valeurs possibles : 0 à 30.
InstanceUsedType	Integer	No	0	Rôle de l'instance. Valeurs possibles : 0 : instance principale 3 : instance en lecture seule
OrderType	String	No	BUY	Type de commande. Valeurs possibles : BUY : achat UPGRADE : modification des spécifications RENEW : renouvellement
DBInstanceStorageType	String	No	local_ssd	Type de stockage de l'instance. Valeurs possibles : local_ssd : SSD local cloud_ssd : SSD standard cloud_essd : ESSD PL1 cloud_essd2 : ESSD PL2 cloud_essd3 : ESSD PL3
DBInstanceId	String	No	rm-*****	ID de l'instance dont vous souhaitez modifier les spécifications ou renouveler l'abonnement. Remarque Pour interroger le prix d'une commande de modification des spécifications ou de renouvellement, ce paramètre est obligatoire. Pour une instance en lecture seule, définissez ce paramètre sur l'ID de l'instance principale associée.
DBNode	Array	No		Informations sur le nœud. Remarque Ce paramètre est disponible pour les clusters ApsaraDB RDS for MySQL.
ClassCode	String	No	mysql.n2.small.xc	Spécification du nœud.
ZoneId	String	No	cn-hangzhou-j	ID de zone du nœud.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	CA0ADDDC-0BEB-4381-A3ED-73B4C79B8CC6	ID de la requête.
PriceInfo	Object		Informations sur le prix.
OriginalPrice	Float	2504	Prix initial.
DiscountPrice	Float	0	Remise appliquée.
Currency	String	CNY	Devise.
TradePrice	Float	2504	Prix de transaction (prix initial moins remise).
Coupons	Array of Coupon		Liste des coupons.
Coupon
IsSelected	String	true	Indique si le coupon est sélectionné.
CouponNo	String	123456	ID du coupon.
Name	String	test	Nom du coupon.
Description	String	test	Description du coupon.
RuleIds	Array of String	1001199213	ID de la règle promotionnelle.
ActivityInfo	Object		Informations sur la promotion.
CheckErrMsg	String	Error description	Description de l'erreur.
ErrorCode	String	123456	Code d'erreur renvoyé.
Success	String	Success	Indique si la requête a réussi.
Rules	Array of Rule		Détails de la règle promotionnelle.
Rule
Name	String	Rule1	Nom de la règle promotionnelle.
Description	String	Activity Description	Description de la règle promotionnelle.
RuleId	Long	1020021003939076	ID de la règle promotionnelle.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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>

JSON format

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
  } ]
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidDBInstanceStorage.Format	InvalidDBInstanceStorage.Format	La capacité de stockage n'est pas valide. Vérifiez la configuration.
400	DBNodeParameter.InvalidClassCode	The ClassCode of the item of the specified parameter DBNode is inconsistent.	La configuration ClassCode du paramètre DBNode n'est pas valide.
400	DBNodeParameter.Required	The specified parameter DBNode is required.	Le paramètre DBNode est manquant.
400	DBNodeParameter.TooFewItems	The specified parameter DBNode has too few items.	Le nombre d'éléments configurés pour le paramètre DBNode est insuffisant.
400	DBNodeParameter.TooManyItems	The specified parameter DBNode has too many items.	Le nombre d'éléments configurés pour le paramètre DBNode est trop élevé.
404	InvalidTimeType.NotFound	The parameter timeType does not exist.	La valeur du paramètre TimeType n'est pas valide. Les valeurs acceptées sont Year, Month et Day.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.