Consulta as taxas incorridas em operações como criação, upgrade ou renovação de instâncias de banco de dados do ApsaraDB for Tair (compatível com Redis OSS).
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
kvstore:DescribePrice |
get |
*All resources.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Não |
O ID da região. Você pode chamar DescribeRegions para consultar os IDs das regiões. |
cn-hangzhou |
| Capacity |
integer |
Não |
A capacidade de armazenamento da instância, que é usada para especificar o tipo de instância. Unidade: MB. Este parâmetro se aplica apenas a instâncias do ApsaraDB for Redis Community Edition no modo de implantação clássico. Recomendamos que você use o parâmetro InstanceClass para especificar um tipo exato de instância. Nota
Se você especificar o parâmetro InstanceClass, não precisará especificar este parâmetro. |
1024 |
| InstanceClass |
string |
Não |
O código do tipo de instância. Para consultar o código InstanceClass, execute as seguintes etapas:
Nota
Por exemplo, para consultar o preço de uma instância recém-adquirida, você deve especificar pelo menos os seguintes parâmetros, além de outros parâmetros chave:
|
redis.master.small.default |
| OrderType |
string |
Sim |
O tipo de pedido. Valores válidos:
|
BUY |
| ZoneId |
string |
Não |
O ID da zona. Você pode chamar DescribeZones para consultar os IDs das zonas. |
cn-hangzhou-e |
| SecondaryZoneId |
string |
Não |
O ID da zona secundária. Você pode chamar DescribeZones para consultar os IDs das zonas. Nota
O valor deste parâmetro deve ser diferente do valor do parâmetro ZoneId. |
cn-hangzhou-g |
| ChargeType |
string |
Não |
O método de faturamento. Valores válidos:
|
PostPaid |
| NodeType |
string |
Não |
O tipo de nó. Valores válidos:
|
MASTER_SLAVE |
| Period |
integer |
Não |
A duração da assinatura. Unidade: meses. Valores válidos: 1 a 9, 12, 24 e 36. |
3 |
| Quantity |
integer |
Não |
O número de instâncias a serem adquiridas. Valores válidos: 1 a 30. Valor padrão: 1. |
1 |
| InstanceId |
string |
Não |
O ID da instância. Nota
Este parâmetro é obrigatório quando o parâmetro OrderType é definido como UPGRADE ou RENEW. |
r-bp1zxszhcgatnx**** |
| Instances |
string |
Não |
As instâncias a serem consultadas. Este parâmetro é obrigatório quando você consulta os preços de instâncias cloud-native em arquitetura de divisão de leitura/gravação, instâncias Tair ESSD ou várias instâncias de diferentes tipos. O valor é uma string JSON. Para mais informações, consulte a descrição suplementar do parâmetro Instances abaixo. |
[{"RegionId": "cn-hangzhou","ZoneId": "cn-hangzhou-b","ShardClass": "tair.scm.with.proxy.standard.2m.8d","ShardCount": "3","Period": "1","Quantity": "1"}] |
| BusinessInfo |
string |
Não |
As informações estendidas, como o ID da atividade e as informações comerciais. |
000000000000 |
| CouponNo |
string |
Não |
O código do cupom. Valor padrão: youhuiquan_promotion_option_id_for_blank, que indica que nenhum código de cupom é usado. |
youhuiquan_promotion_option_id_for_blank |
| ForceUpgrade |
boolean |
Não |
Especifica se as configurações da instância devem ser alteradas à força. Valores válidos:
|
true |
| OrderParamOut |
string |
Não |
Especifica se os parâmetros do pedido devem ser retornados. Valores válidos:
|
true |
| ShardCount |
integer |
Não |
O número de nós de fragmento de dados em uma instância de cluster cloud-native. |
2 |
| EngineVersion |
string |
Não |
A versão do mecanismo de banco de dados da instância Redis. Valores válidos: 2.8, 4.0 e 5.0. |
5.0 |
| NeedUnavailableCoupon |
boolean |
Não |
Especifica se os cupons indisponíveis devem ser retornados. |
Descrição adicional do parâmetro Instances
A descrição a seguir aplica-se apenas ao parâmetro Instances da operação DescribePrice e não se aplica a outras operações.
| Nome | Tipo | Obrigatório | Exemplo | Descrição |
|---|---|---|---|---|
| RegionId | String | Yes | cn-hangzhou | O ID da região. |
| InstanceId | String | No | r-7xv4s7q131smyx**** | O ID da instância. Este parâmetro é obrigatório quando OrderType é definido como UPGRADE ou RENEW. |
| InstanceClass | String | Yes | redis.master.small.default | O tipo de instância de uma instância Classic Edition. Para mais informações, consulte Tipos de instância. |
| ShardClass | String | Yes | tair.rdb.2g | O tipo de instância de uma instância cloud-native. Para mais informações, consulte Tipos de instância. Você deve especificar este parâmetro ou InstanceClass. |
| IzNo | String | No | cn-hangzhou-b | O ID da zona. |
| NodeType | String | No | MASTER_SLAVE | O tipo de nó. Valores válidos:
|
| Period | Long | No | 1 | A duração da assinatura. Unidade: meses. Valores válidos: 1 a 9, 12, 24 e 36. |
| Quantity | String | No | 1 | O número de instâncias a serem adquiridas. Valores válidos: 1 a 30. Valor padrão: 1. |
| VPCId | String | No | vpc-bp1nme44gek34slfc**** | O ID da VPC. |
| VSwitchId | String | No | vsw-bp1e7clcw529l773d**** | O ID do vSwitch. |
| AutoPay | String | No | true | Especifica se o pagamento automático deve ser ativado. Valores válidos:
|
| InstanceName | String | No | test_123 | O nome da instância. |
| ShardCount | String | No | 2 | O número de nós de fragmento. Valor padrão: 1. Este parâmetro não é obrigatório ao consultar o preço de instâncias padrão ou de divisão de leitura/gravação. Este parâmetro aplica-se apenas a instâncias de cluster cloud-native. Você pode usar este parâmetro para especificar um número personalizado de fragmentos. |
| ReadOnlyCount | Integer | No | 2 | O número total de nós somente leitura. Este parâmetro aplica-se apenas a instâncias de divisão de leitura/gravação cloud-native. |
| StorageType | String | No | essd_pl2 | O tipo de armazenamento de instâncias Tair ESSD. Valores válidos: essd_pl0, essd_pl1, essd_pl2 e essd_pl3. Se você especificar este parâmetro, também deverá especificar Capacity para definir uma capacidade de disco personalizada. Para mais informações, consulte Tipos de instância baseados em disco. |
| Capacity | Long | No | 512000 | A capacidade do disco de instâncias Tair ESSD. Unidade: MB. |
Exemplos de solicitação
Exemplo de consulta do preço de uma nova instância de cluster Tair cloud-native (o parâmetro Instances não é obrigatório neste cenário):
{
"RegionId": "cn-hangzhou",
"InstanceClass": "tair.rdb.with.proxy.2g",
"OrderType": "BUY",
"ChargeType": "PrePaid",
"Period": 1,
"ShardCount": 3
}
Exemplo de consulta do preço de uma nova instância Tair ESSD com um tipo de armazenamento personalizado:
{
"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"}]",
}
Exemplo de consulta do preço de uma nova instância de divisão de leitura/gravação Tair cloud-native:
{
"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"}]"
}
Exemplo de consulta do preço de várias novas instâncias:
{
"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"}]"
}
Exemplo de consulta do preço de renovação de uma instância de cluster Tair cloud-native (o parâmetro Instances não é obrigatório neste cenário):
{
"RegionId": "cn-hangzhou",
"InstanceClass": "tair.rdb.with.proxy.1g",
"OrderType": "RENEW",
"ChargeType": "PrePaid",
"Period": 12,
"InstanceId": "r-d7****l3v0xmorw1xp",
"ShardCount": 3
}
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| Order |
object |
As informações do pedido. |
|
| Code |
string |
O código do pedido. |
"" |
| Coupons |
object |
||
| Coupon |
array<object> |
As informações do cupom. |
|
|
array<object> |
As informações do cupom. |
||
| ActivityExtInfo |
object |
As informações de transparência do cupom. |
|
| CouponNo |
string |
O número do cupom. |
youhuiquan_promotion_option_id_for_blank |
| Description |
string |
A descrição do cupom. |
coupondemo |
| Effective |
boolean |
Indica se o cupom está disponível. |
|
| IsSelected |
string |
Indica se o cupom está selecionado. |
true |
| Name |
string |
O nome do cupom. |
test |
| Currency |
string |
A moeda. O valor é CNY para o site da China e USD para o site internacional. |
CNY |
| DepreciateInfo |
object |
As informações da promoção. |
|
| CheapRate |
integer |
A taxa de redução de preço. |
30% |
| CheapStandAmount |
integer |
O preço total oficial do site após a redução de preço. |
9* |
| ContractActivity |
object |
As informações da promoção. |
|
| ActivityId |
integer |
O ID da promoção. |
**** |
| ActivityName |
string |
O nome da promoção. |
Contract discount_Entire order_xxx% off |
| FinalFee |
number |
A taxa com desconto. |
|
| FinalPromFee |
number |
O valor total do desconto. |
|
| OptionCode |
string |
O ID do desconto. |
**** |
| OptionIds |
object |
||
| OptionId |
array |
A lista de IDs de desconto. |
|
|
integer |
O ID do desconto. |
***** |
|
| ProdFee |
number |
O preço original. |
**** |
| Differential |
integer |
O desconto de diferença de preço exibido no preço total do pedido. |
** |
| DifferentialName |
string |
O nome do desconto de diferença de preço. |
XXXXX |
| IsContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
false |
| IsShow |
boolean |
Indica se a taxa de redução de preço é exibida. |
true |
| ListPrice |
integer |
O preço de lista. |
1* |
| MonthPrice |
integer |
O preço mensal equivalente. |
** |
| OriginalStandAmount |
integer |
O preço total oficial original do site. |
12* |
| DiscountAmount |
string |
O valor do desconto do pedido. |
0.21 |
| HandlingFeeAmount |
string |
A taxa de processamento. |
0.1 |
| IsContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
false |
| Message |
string |
As informações do pedido. |
"" |
| OriginalAmount |
string |
O preço original do pedido. |
0.21 |
| RuleIds |
object |
||
| RuleId |
array |
O ID da promoção. |
|
|
string |
O ID da promoção. |
[202] |
|
| ShowDiscountInfo |
boolean |
Indica se as informações de desconto são exibidas. |
|
| StandDiscountPrice |
integer |
O preço com desconto. |
**** |
| StandPrice |
integer |
O preço de desconto. |
0 |
| TradeAmount |
string |
O preço real da transação do pedido. |
10 |
| OrderParams |
string |
Os parâmetros do pedido. Este parâmetro é retornado quando OrderParamOut é definido como true. |
String |
| RequestId |
string |
O ID da solicitação. |
3A40BE4E-1890-4972-889C-FEFA37663635 |
| Rules |
object |
||
| Rule |
array<object> |
As regras da promoção. |
|
|
object |
|||
| Name |
string |
O nome da promoção. |
test |
| RuleDescId |
integer |
O ID da regra. |
1111111111 |
| Title |
string |
O título da regra. |
test |
| SubOrders |
object |
||
| SubOrder |
array<object> |
As regras correspondentes ao cupom. |
|
|
array<object> |
|||
| ContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
**** |
| DepreciateInfo |
object |
As informações de redução de preço. |
|
| CheapRate |
integer |
A taxa de redução de preço. |
**** |
| CheapStandAmount |
integer |
O preço total oficial do site após a redução de preço. |
**** |
| ContractActivity |
object |
O desconto de contrato. |
|
| ActivityId |
integer |
O ID da promoção. |
1412025702634847 |
| ActivityName |
string |
O nome da promoção. |
**** |
| FinalFee |
number |
A taxa com desconto. |
**** |
| FinalPromFee |
number |
O valor total do desconto. |
**** |
| OptionCode |
string |
O ID do desconto. |
**** |
| OptionIds |
object |
||
| OptionId |
array |
A lista de IDs de desconto. |
|
|
integer |
O ID do desconto. |
|
|
| ProdFee |
number |
O preço original. |
**** |
| Differential |
integer |
O desconto de diferença de preço exibido no preço total do pedido. |
**** |
| DifferentialName |
string |
O nome do desconto de diferença de preço. |
**** |
| IsContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
false |
| ListPrice |
integer |
O preço de lista. |
**** |
| MonthPrice |
integer |
O preço mensal equivalente. |
**** |
| OriginalStandAmount |
integer |
O preço total oficial original do site. |
**** |
| StartTime |
string |
A hora de início da promoção. |
2024-11-18T00:00:00Z |
| DiscountAmount |
string |
O valor do desconto do pedido. |
0.21 |
| InstanceId |
string |
O ID da instância. |
r-bp1xxxxxxxxxxxxx |
| IsContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
**** |
| ModuleInstance |
object |
||
| ModuleInstance |
array<object> |
A configuração da instância da linha do pedido. |
|
|
array<object> |
O objeto filho da configuração da instância para a linha do pedido. |
||
| ContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
**** |
| DepreciateInfo |
object |
As informações de redução de preço. |
|
| CheapRate |
number |
A taxa de redução de preço. |
****** |
| CheapStandAmount |
number |
O preço total oficial do site após a redução de preço. |
**** |
| Differential |
number |
O desconto de diferença de preço exibido no preço total do pedido. |
**** |
| DifferentialName |
string |
O nome do desconto de diferença de preço. |
**** |
| IsContractActivity |
boolean |
Indica se um desconto de contrato é aplicado. |
**** |
| IsShow |
boolean |
Indica se a taxa de redução de preço é exibida. |
true |
| ListPrice |
number |
O preço de lista. |
**** |
| MonthPrice |
number |
O preço mensal equivalente. |
**** |
| OriginalStandAmount |
number |
O preço total oficial original do site. |
**** |
| StartTime |
string |
A hora de início da promoção. |
2024-09-23T14:00:01Z |
| DiscountFee |
number |
O valor do desconto. |
**** |
| ModuleAttrs |
object |
||
| moduleAttr |
array<object> |
Os atributos do módulo. |
|
|
object |
Os parâmetros do pedido. |
||
| Code |
string |
O código do atributo. |
**** |
| Name |
string |
O nome do atributo. |
**** |
| Type |
integer |
O tipo do atributo. |
**** |
| Value |
string |
O tipo do atributo. |
**** |
| ModuleCode |
string |
O código do módulo. |
**** |
| ModuleId |
string |
O ID do módulo. |
**** |
| ModuleName |
string |
O nome do módulo. |
**** |
| NeedOrderPay |
boolean |
Especifica se o pagamento é necessário no pedido. |
true |
| PayFee |
number |
O valor real do pagamento. |
0.0 |
| PricingModule |
boolean |
Especifica se o item é faturável. |
**** |
| StandPrice |
number |
O preço de desconto. |
**** |
| TotalProductFee |
number |
O preço original do produto. |
0.0 |
| OptionalPromotions |
object |
||
| OptionalPromotion |
array<object> |
A lista de opções de promoção disponíveis. |
|
|
array<object> |
|||
| ActivityExtInfo |
object |
As informações adicionais sobre a promoção. |
**** |
| CanPromFee |
string |
O valor de desconto disponível. |
**** |
| CouponNo |
string |
Especifica se deve ser usado um cupom. Valores válidos:
|
default |
| Description |
string |
As observações. |
**** |
| Effective |
boolean |
Indica se o cupom está disponível. |
|
| Name |
string |
O nome do cupom. |
**** |
| OptionCode |
string |
As informações adicionais sobre a promoção. |
**** |
| PromotionName |
string |
O nome da promoção. |
**** |
| PromotionOptionNo |
string |
O número da opção de promoção. |
youhuiquan_promotion_option_id_for_blank |
| Selected |
boolean |
Especifica se a opção é selecionada externamente. |
false |
| Show |
boolean |
Especifica se a promoção é exibida. |
False |
| OriginalAmount |
string |
O preço original do pedido. |
0.21 |
| PromDetailList |
object |
||
| PromDetail |
array<object> |
Os detalhes da promoção. |
|
|
array<object> |
As informações da promoção. |
||
| ActivityExtInfo |
object |
As informações adicionais sobre a promoção. |
**** |
| DerivedPromType |
string |
O subtipo da promoção. |
**** |
| FinalPromFee |
number |
O valor do desconto. |
**** |
| OptionCode |
string |
O código do cupom. |
**** |
| PromType |
string |
O subtipo da promoção. |
**** |
| PromotionCode |
string |
O código da promoção. |
**** |
| PromotionId |
integer |
O ID do desconto. |
**** |
| PromotionName |
string |
O nome da atividade de promoção. |
**** |
| RuleIds |
object |
||
| RuleId |
array |
O ID da promoção. |
|
|
string |
O ID da regra correspondente. |
RuleId: 1111111111 |
|
| StandDiscountPrice |
integer |
O preço com desconto. |
**** |
| StandPrice |
integer |
O preço de desconto. |
**** |
| TradeAmount |
string |
O preço real da transação do pedido. |
10 |
Exemplos
Resposta de sucesso
JSON formato
{
"Order": {
"Code": "\"\"\n",
"Coupons": {
"Coupon": [
{
"ActivityExtInfo": {
"test": "test",
"test2": 1
},
"CouponNo": "youhuiquan_promotion_option_id_for_blank",
"Description": "coupondemo",
"Effective": false,
"IsSelected": "true",
"Name": "test"
}
]
},
"Currency": "CNY",
"DepreciateInfo": {
"CheapRate": 0,
"CheapStandAmount": 0,
"ContractActivity": {
"ActivityId": 0,
"ActivityName": "Contract discount_Entire order_xxx% off",
"FinalFee": 0,
"FinalPromFee": 0,
"OptionCode": "****",
"OptionIds": {
"OptionId": [
0
]
},
"ProdFee": 0
},
"Differential": 0,
"DifferentialName": "XXXXX",
"IsContractActivity": false,
"IsShow": true,
"ListPrice": 0,
"MonthPrice": 0,
"OriginalStandAmount": 0
},
"DiscountAmount": "0.21",
"HandlingFeeAmount": "0.1",
"IsContractActivity": true,
"Message": "\"\"",
"OriginalAmount": "0.21",
"RuleIds": {
"RuleId": [
"[202]"
]
},
"ShowDiscountInfo": false,
"StandDiscountPrice": 0,
"StandPrice": 0,
"TradeAmount": "10"
},
"OrderParams": "String",
"RequestId": "3A40BE4E-1890-4972-889C-FEFA37663635",
"Rules": {
"Rule": [
{
"Name": "test",
"RuleDescId": 1111111111,
"Title": "test"
}
]
},
"SubOrders": {
"SubOrder": [
{
"ContractActivity": true,
"DepreciateInfo": {
"CheapRate": 0,
"CheapStandAmount": 0,
"ContractActivity": {
"ActivityId": 1412025702634847,
"ActivityName": "****",
"FinalFee": 0,
"FinalPromFee": 0,
"OptionCode": "****",
"OptionIds": {
"OptionId": [
0
]
},
"ProdFee": 0
},
"Differential": 0,
"DifferentialName": "****",
"IsContractActivity": false,
"ListPrice": 0,
"MonthPrice": 0,
"OriginalStandAmount": 0,
"StartTime": "2024-11-18T00:00:00Z"
},
"DiscountAmount": "0.21",
"InstanceId": "r-bp1xxxxxxxxxxxxx",
"IsContractActivity": true,
"ModuleInstance": {
"ModuleInstance": [
{
"ContractActivity": true,
"DepreciateInfo": {
"CheapRate": 0,
"CheapStandAmount": 0,
"Differential": 0,
"DifferentialName": "****",
"IsContractActivity": true,
"IsShow": true,
"ListPrice": 0,
"MonthPrice": 0,
"OriginalStandAmount": 0,
"StartTime": "2024-09-23T14:00:01Z"
},
"DiscountFee": 0,
"ModuleAttrs": {
"moduleAttr": [
{
"Code": "****",
"Name": "****",
"Type": 0,
"Value": "****"
}
]
},
"ModuleCode": "****",
"ModuleId": "****",
"ModuleName": "****",
"NeedOrderPay": true,
"PayFee": 0,
"PricingModule": true,
"StandPrice": 0,
"TotalProductFee": 0
}
]
},
"OptionalPromotions": {
"OptionalPromotion": [
{
"ActivityExtInfo": {
"test": "test",
"test2": 1
},
"CanPromFee": "****",
"CouponNo": "default",
"Description": "****",
"Effective": false,
"Name": "****",
"OptionCode": "****",
"PromotionName": "****",
"PromotionOptionNo": "youhuiquan_promotion_option_id_for_blank",
"Selected": false,
"Show": true
}
]
},
"OriginalAmount": "0.21",
"PromDetailList": {
"PromDetail": [
{
"ActivityExtInfo": {
"test": "test",
"test2": 1
},
"DerivedPromType": "****",
"FinalPromFee": 0,
"OptionCode": "****",
"PromType": "****",
"PromotionCode": "****",
"PromotionId": 0,
"PromotionName": "****"
}
]
},
"RuleIds": {
"RuleId": [
"RuleId: 1111111111"
]
},
"StandDiscountPrice": 0,
"StandPrice": 0,
"TradeAmount": "10"
}
]
}
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | MissingParameter | Period is mandatory for this action. | |
| 400 | InvalidInstances.Format | The Specified parameter Instances is not valid. | O parâmetro Instances especificado é inválido. |
| 400 | AlreadyHadTemporaryBandwidth | This instance have already had temporary bandwidth, please modify instance spec first. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.