Consulte les frais engagés par des opérations telles que la création, la mise à niveau de la configuration ou le renouvellement des instances ApsaraDB for Tair (compatible Redis OSS).
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
kvstore:DescribePrice |
get |
*All Resource
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| RegionId |
string |
Non |
L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour obtenir l'identifiant de la région. |
cn-hangzhou |
| Capacity |
integer |
Non |
La capacité de stockage de l'instance. Unité : Mo. Ce paramètre est utilisé uniquement pour interroger les instances Redis Open-Source Edition déployées en mode classique. Nous vous recommandons d'utiliser le paramètre InstanceClass pour spécifier un type d'instance précis. Remarque
Si vous spécifiez le paramètre InstanceClass, vous n'avez pas besoin de spécifier le paramètre Capacity. |
1024 |
| InstanceClass |
string |
Non |
Le type d'instance.**** Pour consulter le type d'instance, procédez comme suit :
Remarque
Si vous souhaitez interroger de nouvelles instances, en plus des paramètres clés, vous devez également spécifier au moins les paramètres suivants :
|
redis.master.small.default |
| OrderType |
string |
Oui |
Le type de commande. Valeurs valides :
|
BUY |
| ZoneId |
string |
Non |
L'identifiant de la zone. Vous pouvez appeler l'opération DescribeZones pour obtenir l'identifiant de la zone. |
cn-hangzhou-e |
| SecondaryZoneId |
string |
Non |
L'identifiant de la zone secondaire. Vous pouvez appeler l'API DescribeZones pour l'obtenir.\n> Les valeurs spécifiées pour ce paramètre et le paramètre ZoneId doivent être différentes. |
cn-hangzhou-g |
| ChargeType |
string |
Non |
La méthode de facturation. Valeurs valides :
|
PostPaid |
| NodeType |
string |
Non |
Le type de nœud. Valeurs valides :
|
MASTER_SLAVE |
| Period |
integer |
Non |
La durée de l'abonnement. Unité : mois. Valeurs valides : 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24 et 36. |
3 |
| Quantity |
integer |
Non |
Le nombre d'instances que vous souhaitez acheter. Valeurs valides : de 1 à 30. Valeur par défaut : 1. |
1 |
| InstanceId |
string |
Non |
L'identifiant de l'instance. Remarque
Ce paramètre est requis lorsque le paramètre OrderType est défini sur UPGRADE ou RENEW. |
r-bp1zxszhcgatnx**** |
| Instances |
string |
Non |
Si vous souhaitez interroger des instances cloud natives avec répartition en lecture/écriture, des instances basées sur Tair ESSD ou des instances de spécifications différentes, vous devez spécifier ce paramètre sous forme de chaîne JSON. Pour plus d'informations, consultez la section Description supplémentaire du paramètre Instances. |
[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","ShardClass": "tair.scm.with.proxy.standard.2m.8d","ShardCount": "3","Period": "1","Quantity": "1"}] |
| BusinessInfo |
string |
Non |
Les informations complémentaires telles que l'identifiant de l'événement promotionnel et les informations commerciales. |
000000000000 |
| CouponNo |
string |
Non |
Le code de réduction. Valeur par défaut : youhuiquan_promotion_option_id_for_blank. Cette valeur indique qu'aucun code de réduction n'est disponible. |
youhuiquan_promotion_option_id_for_blank |
| ForceUpgrade |
boolean |
Non |
Indique si les configurations de l'instance doivent être modifiées de force. Valeurs valides :
|
true |
| OrderParamOut |
string |
Non |
Indique si les paramètres liés à la commande doivent être renvoyés. Valeurs valides :
|
true |
| ShardCount |
integer |
Non |
Le nombre de fragments de données dans l'instance de cluster cloud natif. |
2 |
| EngineVersion |
string |
Non |
La version du moteur de l'instance. Valeurs valides : 2.8, 4.0 et 5.0. |
5.0 |
Notes supplémentaires sur le paramètre Instances
Les notes suivantes s'appliquent uniquement au paramètre Instances de l'API DescribePrice et ne s'appliquent pas aux autres API.
| Nom | Type | Obligatoire | Valeur d'exemple | Description |
|---|---|---|---|---|
| RegionId | String | Oui | cn-hangzhou | L'identifiant de la région. |
| InstanceId | String | Non | r-7xv4s7q131smyx**** | L'identifiant de l'instance. Ce paramètre est obligatoire lorsque **OrderType** est **UPGRADE** ou **RENEW**. |
| InstanceClass | String | Oui | redis.master.small.default | Le type d'instance pour les instances de l'édition classique. Pour plus d'informations, consultez le Guide de recherche des types d'instances. |
| ShardClass | String | Oui | tair.rdb.2g | Le type d'instance pour les instances de l'édition cloud-native. Pour plus d'informations, consultez le Guide de recherche des types d'instances. Vous devez spécifier soit ce paramètre, soit **InstanceClass**. |
| IzNo | String | Non | cn-hangzhou-b | L'identifiant de la zone. |
| NodeType | String | Non | MASTER_SLAVE | Le type de nœud. Valeurs valides :
|
| Period | Long | Non | 1 | La durée de l'abonnement en mois. Valeurs valides : 1 à 9, 12, 24 et 36. |
| Quantity | String | Non | 1 | Le nombre d'instances à acheter. Valeurs valides : 1 à 30. Valeur par défaut : 1. |
| VPCId | String | Non | vpc-bp1nme44gek34slfc**** | L'identifiant du VPC. |
| VSwitchId | String | Non | vsw-bp1e7clcw529l773d**** | L'identifiant du commutateur virtuel. |
| AutoPay | String | Non | true | Indique si le paiement automatique doit être activé. Valeurs valides :
|
| InstanceName | String | Non | test_123 | Le nom de l'instance. |
| ShardCount | String | Non | 2 | Le nombre de nœuds de fragment. Valeur par défaut : 1. Vous n'avez pas besoin de spécifier ce paramètre lors de l'interrogation d'instances à architecture standard ou à architecture avec répartition en lecture/écriture. Ce paramètre s'applique uniquement aux instances à architecture en cluster de l'édition cloud-native et vous permet de personnaliser le nombre de fragments. |
| ReadOnlyCount | Integer | Non | 2 | Le nombre total de nœuds en lecture seule. Ce paramètre s'applique uniquement à la création d'instances à architecture avec répartition en lecture/écriture de l'édition cloud-native. |
| StorageType | String | Non | essd_pl2 | La classe de stockage pour les instances Tair basées sur des disques ESSD. Valeurs valides : essd_pl0, essd_pl1, essd_pl2 et essd_pl3. Lorsque vous spécifiez ce paramètre, vous devez également définir Capacity sur une capacité de disque personnalisée. Pour plus d'informations, consultez Types d'instances basées sur des disques. |
| Capacity | Long | Non | 512000 | La capacité du disque pour les instances Tair basées sur des disques ESSD. Unité : Mo. |
Exemples de requêtes
Exemple de requête pour consulter le prix d'achat d'une nouvelle instance à architecture en cluster de l'édition cloud native de Tair (dans ce scénario, le paramètre Instances n'est pas requis) :
{
"RegionId": "cn-hangzhou",
"InstanceClass": "tair.rdb.with.proxy.2g",
"OrderType": "BUY",
"ChargeType": "PrePaid",
"Period": 1,
"ShardCount": 3
}
Exemple de requête pour consulter le prix d'achat d'une nouvelle instance basée sur disque ESSD de Tair avec une classe de stockage personnalisée :
{
"RegionId": "cn-hangzhou",
"OrderType": "BUY",
"ChargeType": "PostPaid",
"Instances": "[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-h", "ShardClass": "tair.essd.standard.2xlarge", "ShardCount": "1","Capacity": "512000","StorageType": "essd_pl2"}]"
}
Exemple de requête pour consulter le prix d'achat d'une nouvelle instance à architecture avec séparation lecture/écriture de l'édition cloud native de Tair :
{
"RegionId": "cn-hangzhou",
"InstanceClass": "tair.rdb.with.proxy.2g",
"OrderType": "BUY",
"ChargeType": "PrePaid",
"Period": 1,
"Instances": "[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","ShardClass":"tair.rdb.with.proxy.2g","ReadOnlyCount":"2"}]"
}
Exemple de requête pour consulter le prix d'achat de plusieurs instances :
{
"RegionId": "cn-hangzhou",
"OrderType": "BUY",
"ChargeType": "PrePaid",
"Period": 1,
"Instances": "[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","InstanceClass": "redis.master.small.default"}{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","InstanceClass": "redis.amber.logic.sharding.1g.2db.0rodb.6proxy.multithread"}{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","ShardClass":"tair.rdb.with.proxy.2g","ShardCount":"3"}]"
}
Exemple de requête pour consulter le prix de renouvellement d'une instance à architecture en cluster de l'édition cloud native de Tair (dans ce scénario, le paramètre Instances n'est pas requis) :
{
"RegionId": "cn-hangzhou",
"InstanceClass": "tair.rdb.with.proxy.1g",
"OrderType": "RENEW",
"ChargeType": "PrePaid",
"Period": 12,
"InstanceId": "r-d7****l3v0xmorw1xp",
"ShardCount": 3
}
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| OrderParams |
string |
Les paramètres de la commande. Lorsque OrderParamOut est défini sur true, ce paramètre est renvoyé. |
String |
| RequestId |
string |
L'identifiant de la requête. |
3A40BE4E-1890-4972-889C-FEFA37663635 |
| Order |
object |
Les informations relatives à la commande. |
|
| OriginalAmount |
string |
Le prix initial de la commande. |
0.21 |
| HandlingFeeAmount |
string |
Les frais de service de la commande. |
0.1 |
| Currency |
string |
La devise utilisée pour le paiement. La valeur CNY est utilisée lorsque la commande a été générée sur le site chinois (aliyun.com), et la valeur USD est utilisée lorsque la commande a été générée sur le site international (alibabacloud.com). |
CNY |
| DiscountAmount |
string |
Le montant de la remise de la commande. |
0.21 |
| TradeAmount |
string |
Le prix de transaction de la commande. |
10 |
| Coupons |
object |
||
| Coupon |
array<object> |
Details about coupons. |
|
|
object |
Details about the coupon. |
||
| IsSelected |
string |
Indicates whether the coupon is selected. |
true |
| CouponNo |
string |
The coupon ID. |
youhuiquan_promotion_option_id_for_blank |
| Name |
string |
The coupon name. |
test |
| Description |
string |
The coupon description. |
coupondemo |
| RuleIds |
object |
||
| RuleId |
array |
The rule IDs. |
|
|
string |
The rule ID. |
[202] |
|
| ShowDiscountInfo |
boolean |
Indique si les informations de remise sont affichées. |
|
| DepreciateInfo |
object |
Les informations relatives à l'activité. |
|
| ListPrice |
integer |
The list price. |
1* |
| OriginalStandAmount |
integer |
The original total price displayed on the official website. |
12* |
| CheapStandAmount |
integer |
The new total price displayed on the official website. |
9* |
| CheapRate |
integer |
The price reduction rate. |
30% |
| Differential |
integer |
The promotional offer (displayed in the total order amount). |
** |
| DifferentialName |
string |
The name of the promotional offer. |
XXXXX |
| MonthPrice |
integer |
The monthly price. |
** |
| IsContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
false |
| IsShow |
boolean |
Indicates whether the price reduction rate is displayed. |
true |
| ContractActivity |
object |
The activity information. |
|
| FinalPromFee |
number |
The total discount amount. |
|
| FinalFee |
number |
The preferential price. |
|
| ProdFee |
number |
The original price. |
**** |
| ActivityId |
integer |
The activity ID. |
**** |
| OptionCode |
string |
The promotion code. |
**** |
| ActivityName |
string |
The activity name. |
合同优惠_整单_xxx折 |
| OptionIds |
object |
||
| OptionId |
array |
The promotion IDs. |
|
|
integer |
The promotion ID. |
***** |
|
| StandDiscountPrice |
integer |
La remise. |
**** |
| IsContractActivity |
boolean |
Indique si les conditions d'éligibilité à la remise contractuelle sont remplies. |
false |
| StandPrice |
integer |
Le prix après remise. |
0 |
| Code |
string |
Le code de la commande. |
"" |
| Message |
string |
Les informations relatives à la commande. |
"" |
| Rules |
object |
||
| Rule |
array<object> |
Les détails relatifs aux règles de promotion. |
|
|
object |
|||
| RuleDescId |
integer |
The ID of the rule. |
1111111111 |
| Title |
string |
The title of the rule. |
test |
| Name |
string |
The name of the rule. |
test |
| SubOrders |
object |
||
| SubOrder |
array<object> |
Les commandes correspondant aux coupons. |
|
|
array<object> |
|||
| OriginalAmount |
string |
The original price of the order. |
0.21 |
| InstanceId |
string |
The instance ID. |
r-bp1xxxxxxxxxxxxx |
| DiscountAmount |
string |
The discount amount of the order. |
0.21 |
| TradeAmount |
string |
The transaction price of the order. |
10 |
| RuleIds |
object |
||
| RuleId |
array |
The hit rule IDs. |
|
|
string |
The ID of the hit rule. |
RuleId: 1111111111 |
|
| OptionalPromotions |
object |
||
| OptionalPromotion |
array<object> |
The optional promotions. |
|
|
array<object> |
|||
| Selected |
boolean |
Indicates whether the promotion option is selected. |
false |
| CouponNo |
string |
Indicates whether coupons are used. Valid values:
|
default |
| Name |
string |
The coupon name. |
**** |
| Description |
string |
The description of the coupon. |
**** |
| Show |
boolean |
Indicates whether the discount is displayed. |
False |
| ActivityExtInfo |
object |
The additional activity information. |
**** |
| OptionCode |
string |
The promotion code. |
**** |
| PromotionName |
string |
The promotion name. |
**** |
| PromotionOptionNo |
string |
The promotion ID. |
youhuiquan_promotion_option_id_for_blank |
| CanPromFee |
string |
The amount that can be deducted by using the coupon. |
**** |
| DepreciateInfo |
object |
The price reduction information. |
|
| ListPrice |
integer |
The list price. |
**** |
| OriginalStandAmount |
integer |
The original total price displayed on the official website. |
**** |
| CheapStandAmount |
integer |
The new total price displayed on the official website. |
**** |
| CheapRate |
integer |
The price reduction rate. |
**** |
| Differential |
integer |
The promotional offer (displayed in the total order amount). |
**** |
| DifferentialName |
string |
The name of the promotional offer. |
**** |
| MonthPrice |
integer |
The monthly price. |
**** |
| IsContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
false |
| ContractActivity |
object |
The contract promotion. |
|
| FinalPromFee |
number |
The total discount amount. |
**** |
| FinalFee |
number |
The preferential price. |
**** |
| ProdFee |
number |
The original price. |
**** |
| ActivityId |
integer |
The activity ID. |
1412025702634847 |
| OptionCode |
string |
The promotion ID. |
**** |
| ActivityName |
string |
The activity name. |
**** |
| OptionIds |
object |
||
| OptionId |
array |
The promotion IDs. |
|
|
integer |
The promotion ID. |
|
|
| StartTime |
string |
The start time of the activity. |
2024-11-18T00:00:00Z |
| StandDiscountPrice |
integer |
The discounted price. |
**** |
| IsContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
**** |
| StandPrice |
integer |
The discounted price. |
**** |
| ModuleInstance |
object |
||
| ModuleInstance |
array<object> |
The configuration details for each instance of an order line item. |
|
|
array<object> |
The configuration sub-item of the instance in the order. |
||
| ModuleCode |
string |
The module code. |
**** |
| ModuleId |
string |
The module ID. |
**** |
| StandPrice |
number |
The discounted price. |
**** |
| PricingModule |
boolean |
Indicates whether the item is billed. |
**** |
| ModuleName |
string |
The module name. |
**** |
| DiscountFee |
number |
The discount. |
**** |
| TotalProductFee |
number |
The original price of the instance. |
0.0 |
| NeedOrderPay |
boolean |
Indicates whether the order is paid. |
true |
| PayFee |
number |
The actual amount paid. |
0.0 |
| ModuleAttrs |
object |
||
| moduleAttr |
array<object> |
The module attributes. |
|
|
object |
The module attribute. |
||
| Type |
integer |
The attribute type. |
**** |
| Value |
string |
The attribute value. |
**** |
| Code |
string |
The attribute code. |
**** |
| Name |
string |
The attribute name. |
**** |
| ContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
**** |
| DepreciateInfo |
object |
The price reduction information. |
|
| ListPrice |
number |
The list price. |
**** |
| OriginalStandAmount |
number |
The original total price displayed on the official website. |
**** |
| CheapStandAmount |
number |
The new total price displayed on the official website. |
**** |
| CheapRate |
number |
The price reduction rate. |
****** |
| Differential |
number |
The promotional offer (displayed in the total order amount). |
**** |
| DifferentialName |
string |
The name of the promotional offer. |
**** |
| MonthPrice |
number |
The monthly price. |
**** |
| IsContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
**** |
| IsShow |
boolean |
Indicates whether the price reduction rate is displayed. |
true |
| StartTime |
string |
The start time of the activity. |
2024-09-23T14:00:01Z |
| PromDetailList |
object |
||
| PromDetail |
array<object> |
Details about promotions. |
|
|
array<object> |
Details about the promotion. |
||
| PromotionName |
string |
The promotion name. |
**** |
| PromotionId |
integer |
The promotion ID. |
**** |
| FinalPromFee |
number |
The discount amount. |
**** |
| OptionCode |
string |
The coupon code. |
**** |
| PromType |
string |
The promotion type. |
**** |
| ActivityExtInfo |
object |
The additional activity information. |
**** |
| DerivedPromType |
string |
The derived promotion type. |
**** |
| PromotionCode |
string |
The promotion code. |
**** |
| ContractActivity |
boolean |
Indicates whether eligibility for the contracted discount is met. |
**** |
Exemples
JSON format
{
"OrderParams": "String",
"RequestId": "3A40BE4E-1890-4972-889C-FEFA37663635",
"Order": {
"OriginalAmount": "0.21",
"HandlingFeeAmount": "0.1",
"Currency": "CNY",
"DiscountAmount": "0.21",
"TradeAmount": "10",
"Coupons": {
"Coupon": [
{
"IsSelected": "true",
"CouponNo": "youhuiquan_promotion_option_id_for_blank",
"Name": "test",
"Description": "coupondemo"
}
]
},
"RuleIds": {
"RuleId": [
"[202]"
]
},
"ShowDiscountInfo": false,
"DepreciateInfo": {
"ListPrice": 0,
"OriginalStandAmount": 0,
"CheapStandAmount": 0,
"CheapRate": 0,
"Differential": 0,
"DifferentialName": "XXXXX",
"MonthPrice": 0,
"IsContractActivity": false,
"IsShow": true,
"ContractActivity": {
"FinalPromFee": 0,
"FinalFee": 0,
"ProdFee": 0,
"ActivityId": 0,
"OptionCode": "****",
"ActivityName": "合同优惠_整单_xxx折",
"OptionIds": {
"OptionId": [
0
]
}
}
},
"StandDiscountPrice": 0,
"IsContractActivity": true,
"StandPrice": 0,
"Code": "\"\"\n",
"Message": "\"\""
},
"Rules": {
"Rule": [
{
"RuleDescId": 1111111111,
"Title": "test",
"Name": "test"
}
]
},
"SubOrders": {
"SubOrder": [
{
"OriginalAmount": "0.21",
"InstanceId": "r-bp1xxxxxxxxxxxxx",
"DiscountAmount": "0.21",
"TradeAmount": "10",
"RuleIds": {
"RuleId": [
"RuleId: 1111111111"
]
},
"OptionalPromotions": {
"OptionalPromotion": [
{
"Selected": false,
"CouponNo": "default",
"Name": "****",
"Description": "****",
"Show": true,
"ActivityExtInfo": {
"test": "test",
"test2": 1
},
"OptionCode": "****",
"PromotionName": "****",
"PromotionOptionNo": "youhuiquan_promotion_option_id_for_blank",
"CanPromFee": "****"
}
]
},
"DepreciateInfo": {
"ListPrice": 0,
"OriginalStandAmount": 0,
"CheapStandAmount": 0,
"CheapRate": 0,
"Differential": 0,
"DifferentialName": "****",
"MonthPrice": 0,
"IsContractActivity": false,
"ContractActivity": {
"FinalPromFee": 0,
"FinalFee": 0,
"ProdFee": 0,
"ActivityId": 1412025702634847,
"OptionCode": "****",
"ActivityName": "****",
"OptionIds": {
"OptionId": [
0
]
}
},
"StartTime": "2024-11-18T00:00:00Z"
},
"StandDiscountPrice": 0,
"IsContractActivity": true,
"StandPrice": 0,
"ModuleInstance": {
"ModuleInstance": [
{
"ModuleCode": "****",
"ModuleId": "****",
"StandPrice": 0,
"PricingModule": true,
"ModuleName": "****",
"DiscountFee": 0,
"TotalProductFee": 0,
"NeedOrderPay": true,
"PayFee": 0,
"ModuleAttrs": {
"moduleAttr": [
{
"Type": 0,
"Value": "****",
"Code": "****",
"Name": "****"
}
]
},
"ContractActivity": true,
"DepreciateInfo": {
"ListPrice": 0,
"OriginalStandAmount": 0,
"CheapStandAmount": 0,
"CheapRate": 0,
"Differential": 0,
"DifferentialName": "****",
"MonthPrice": 0,
"IsContractActivity": true,
"IsShow": true,
"StartTime": "2024-09-23T14:00:01Z"
}
}
]
},
"PromDetailList": {
"PromDetail": [
{
"PromotionName": "****",
"PromotionId": 0,
"FinalPromFee": 0,
"OptionCode": "****",
"PromType": "****",
"ActivityExtInfo": {
"test": "test",
"test2": 1
},
"DerivedPromType": "****",
"PromotionCode": "****"
}
]
},
"ContractActivity": true
}
]
}
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | MissingParameter | Period is mandatory for this action. | |
| 400 | InvalidInstances.Format | The Specified parameter Instances is not valid. | The Instances parameter passed in is invalid |
| 400 | AlreadyHadTemporaryBandwidth | This instance have already had temporary bandwidth, please modify instance spec first. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.