GetSubscriptionPrice - : Central de Documentação do Alibaba Cloud

GetSubscriptionPrice

Visão geral

Use esta operação para consultar o preço de assinatura de um produto específico. A Alibaba Cloud oferece diversos produtos com parâmetros de configuração complexos que determinam o preço. Combine esta API com outras para obter os atributos adequados:

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Descrição
ProductCode	String	Sim	Código do produto especificado.
ProductType	String	Não	Tipo do produto especificado.
SubscriptionType	String	Sim	Tipo de assinatura. Valores válidos: Subscription
OrderType	String	Sim	Tipo do pedido especificado. Valores válidos: NewOrder: novo pedido, Renewal: pedido de renovação, Upgrade: pedido de upgrade.
ServicePeriodQuantity	Integer	Sim	Validade do serviço especificado.
ServicePeriodUnit	String	Sim	Unidade de validade do serviço especificado. Valores válidos: Year: ano, Month: mês
Region	String	Não	ID da região onde a instância especificada está localizada. Consulte o ID em Referência comum de IDs de região
InstanceId	String	Não	ID da instância especificada. Este parâmetro é obrigatório em pedidos de upgrade para recuperar as configurações anteriores à atualização.
ModuleList.n.Config	String	Sim	Configuração do n-ésimo ModuleList. Valores válidos de n: [1,50]. Formato: “AA:aa,BB:bb”. AA e BB representam o configCode especificado do ModuleList. aa e bb correspondem aos valores desse configCode. Chame a API DescribePricingModule para obter o módulo de preços.
ModuleList.n.ModuleCode	String	Sim	moduleCode especificado do n-ésimo ModuleList.
ModuleList.n.ModuleStatus	Integer	Não	Especifique o valor de status se a configuração do ModuleList for alterada durante um upgrade. O ModuleStatus indica o status da atualização. Valores válidos: 1 - módulo adicionado, 2 - módulo atualizado. Valor padrão: 1.
ModuleList.n.Tag	Integer	Não	Alguns produtos exigem a especificação de uma tag durante upgrades. Essa tag identifica recursos nomeados específicos. Por exemplo, use a tag para indicar o disco a ser atualizado por meio de seu ID.

Parâmetros de resposta

Nome	Tipo	Obrigatório
OriginalPrice	Double	Preço de lista do produto especificado.
DiscountPrice	Double	Desconto aplicado ao produto especificado.
TradePrice	Double	Preço final do produto especificado após o desconto. O TradePrice representa o valor efetivo a pagar. TradePrice = OriginalPrice - DiscountPrice
Currency	String	Moeda usada para pagamento. Valores válidos: CNY, USD, JPY
ModuleDetails	ModuleDetail	Detalhes de preços do ModuleList. Para mais informações, consulte o Dicionário de dados.
PromotionDetails	PromotionDetail	Detalhes da promoção. Para mais informações, consulte o Dicionário de dados.

Códigos de erro

Código de erro	Descrição	Código de status HTTP	Descrição
NotApplicable	Esta API não se aplica ao chamador.	400	Mensagem de erro retornada quando você não tem autorização para usar a API.
MissingParameter	O parâmetro xx especificado é obrigatório para esta solicitação.	400	Mensagem de erro retornada quando o parâmetro xx não é especificado.
InvalidParameter	O parâmetro xx especificado não é válido.	400	Mensagem de erro retornada quando o parâmetro xx é inválido.
InvalidModuleCode	O moduleCode especificado não é válido.	400	Mensagem de erro retornada quando o parâmetro moduleCode especificado é inválido.
InvalidConfigCode	O configCode especificado não é válido.	400	Mensagem de erro retornada quando o parâmetro configCode especificado é inválido.
InvalidOwner	O proprietário especificado não pertence ao chamador.	400	Mensagem de erro retornada quando o proprietário especificado não pertence ao chamador.
InvalidCaller	O chamador especificado não existe.	400	Mensagem de erro retornada quando o chamador é inválido.
InternalError	O processamento da solicitação falhou devido a um erro, exceção ou falha desconhecida.	400	Mensagem de erro retornada quando ocorre um erro interno desconhecido.
ProductNotFind	Não foi possível encontrar o produto consultado; ele pode não existir.	400	Mensagem de erro retornada quando o produto especificado é inválido.

Exemplos de solicitações

https://business.ap-southeast-1.aliyuncs.com/?Action=GetSubscriptionPrice
&ModuleList. 1. ModuleCode=ExtBandwidth
&ModuleList. 1. Config=ExtBandwidth%3A50
&ModuleList. 2. ModuleCode=PackageCode
&ModuleList. 2. Config=PackageCode3Aversion_1
&OrderType=NewOrder
&ProductCode=waf
&Quantity=1
&Region=cn
&ServicePeriodQuantity=1
&ServicePeriodUnit=Month
&SubscriptionType=Subscription

Exemplos de respostas

"Data": {
    "Quantity": 1,
    "DiscountPrice": 900,
    "ModuleDetails": {
      "ModuleDetail": [
        {
          "ModuleCode": "ExtBandwidth",
          "UnitPrice": 0,
          "CostAfterDiscount": 0,
          "OriginalCost": 800,
          "InvoiceDiscount": 800
        },
        {
          "ModuleCode": "PackageCode",
          "UnitPrice": 0,
          "CostAfterDiscount": 0,
          "OriginalCost": 100,
          "InvoiceDiscount": 100
        }
      ]
    },
    "PromotionDetails": {
      "PromotionDetail": [
        {
          "PromotionId": 1001199213,
          "PromotionName": "Internal settlement does not incur fees"
        }
      ]
    },
    "OriginalPrice": 900,
    "TradePrice": 0,
    "Currency": "CNY"

Dicionário de dados

ModuleDetail

Nome	Tipo	Descrição
ModuleCode	String	ModuleCode do ModuleList.
UnitPrice	Double	Preço unitário do produto especificado.
OriginalCost	Double	Preço original do produto especificado.
InvoiceDiscount	Double	Desconto aplicado ao produto especificado.
CostAfterDiscount	Double	Preço do produto especificado após o desconto.

PromotionDetail

Nome	Tipo	Descrição
PromotionName	String	Nome da promoção especificada.
PromotionDesc	Double	Descrição da promoção especificada.
PromotionId	Long	ID da promoção especificada.

Nota: Para preços de ECS, use opcionalmente a API DescribePrice para obter o preço atualizado e a API DescribeRenewalPrice para consultar o preço de renovação da assinatura.