Todos os produtos
Search
Central de documentação

Edge Security Acceleration:PurchaseRatePlan

Última atualização: Jun 29, 2026

Adquire um plano chamando PurchaseRatePlan.

Descrição da operação

  1. Obtenha o nome do plano e o código do plano chamando a operação DescribeRatePlanPrice.

  2. Se a região de aceleração não estiver definida como overseas, o site deve ter um registro ICP (China Internet Content Provider) válido.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

esa:PurchaseRatePlan

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

PlanName

string

Não

O nome do plano.

Site da China

  • Edição Gratuita: entranceplan

  • Básico: basic

  • Padrão: medium

  • Premium: high

Site internacional

  • Entrada: entranceplan_intl

  • Pro: basicplan_intl

  • Premium: vipplan_intl

Nota

Nota: Para planos da Enterprise Edition, o nome do plano é fornecido após a configuração de backend.

basic

PlanCode

string

Não

O código do plano.

Site da China

  • Edição Gratuita: entranceplan

  • Básico: basicplan

  • Padrão: standardplan

  • Premium: advancedplan

Site internacional

  • Entrada: entranceplan

  • Pro: standardplan

  • Premium: advancedpla.

basicplan

SiteName

string

Não

O nome do site.

test.com

Coverage

string

Não

A região de aceleração. Valores válidos:

  • domestic: apenas a China continental.

  • global: global.

  • overseas: global (exceto a China continental).

domestic

Type

string

Não

O tipo de acesso ao site. Valores válidos:

  • NS: acesso NS.

  • CNAME: acesso CNAME.

Valores válidos:

  • NS :

    Acesso NS.

  • CNAME :

    Acesso CNAME.

CNAME

AutoRenew

boolean

Não

Especifica se a renovação automática deve ser ativada. Valores válidos:

  • true: A renovação automática está ativada.

  • false: A renovação automática está desativada.

true

Period

integer

Não

O período de compra, em meses. Este parâmetro é obrigatório quando você chama diretamente esta operação.

1

ChargeType

string

Não

O método de cobrança. Valores válidos:

  • PREPAY: assinatura.

  • POSTPAY: pay-as-you-go. Defina este parâmetro como PREPAY quando você chamar diretamente esta operação.

Valores válidos:

  • POSTPAY :

    Pós-pago.

  • PREPAY :

    Pay-as-you-go.

PREPAY

AutoPay

boolean

Não

Especifica se o pagamento automático deve ser ativado. Defina este parâmetro como true quando você chamar diretamente esta operação.

true

Amount

integer

Não

O número de planos a serem adquiridos.

1

Channel

string

Não

O campo do canal.

xxxWodkxxx

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A estrutura da resposta.

RequestId

string

O ID da solicitação.

30423A7F-A83D-1E24-B80E-86DD25790758

OrderId

string

O ID do pedido.

123123

InstanceId

string

O ID da instância.

esa-site-ads11w

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "30423A7F-A83D-1E24-B80E-86DD25790758",
  "OrderId": "123123",
  "InstanceId": "esa-site-ads11w"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 CheckOrderFailed Invalid order parameter. Invalid order parameter.
400 InternalError An internal exception occurred, please try again later. An inner exception was triggered. Please try again later.
400 InvalidSiteICP The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again. The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again.
400 InvalidSiteName Invalid website name. Check and try again. Invalid website name. Check and try again.
400 SYSTEM.NoSpecificCodeFailed Invalid subscription duration. Check and try again. Invalid subscription duration. Check and try again.
400 CheckPlanFailed Invalid plan name or code. Check and try again. Invalid plan name or code. Check and try again.
400 SubSiteUnavailable Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA. Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA.
400 InsufficientAvailableQuota Your account balance is insufficient. Your account is in arrears, please pay the arrears before purchasing.
400 InsufficientBalance Your account balance is insufficient. Your account balance is insufficient, please recharge before purchasing.
400 InvalidComponent The order parameters is invalid. The order parameters is invalid.
400 RamAuthFailed The sub-account has no operation permission.
400 BuyWithSiteAmountErr Site-based purchase plans do not support bulk purchasing. Site-based purchase plans do not support bulk purchasing.
400 EnterpriseAmountErr Enterprise plans do not support bulk purchase. Enterprise plans do not support bulk purchase.
400 TrialService.HasOpened You have already activated the trial service. You have activated the trial service and cannot activate it again.
400 UserQuantityExceed Your current purchase quantity exceeds the available quantity. Please select a new quantity. Your current purchase quantity exceeds the available quantity. Please select a new quantity.
400 BASIC_INFO_UNCOMPLETED You have not completed your personal basic information. Please complete the information and try again. You have not completed your basic personal information. Please complete the information and re-operate. (If the current account is a managed sub-account, please contact the main account and click this link to complete the information.) 400 NoRealNameAuthentication You have not completed real-name authentication. You have not completed real-name authentication.
400 NoAvaliablePaymentMethod No payment method is specified for your account. We recommend that you add a payment method. No payment method has been specified for your account. We recommend that you add a payment method.
400 CloudUserCannotBuyNotInnerCommodity No group cloud product label, can not be purchased. No group cloud product label, can not be purchased.
400 AccountStatusIllegal The account status is illegal. The account status is illegal.
400 ContainForbiddenLabelError Placing an order is blocked due to an applied restriction label. There is a label that prohibits placing an order and cannot place an order.
400 AmountExceed.Entranceplan The parameter Amount exceeds the number of entrance plan that can be purchased. The parameter Amount exceeds the number of free versions that can be purchased.
400 QuotaExceed.FreePlan Your account has reached the maximum allowed quota for free plan purchases. Your account has reached the maximum allowed quota for free plan purchases.
400 PlanOrderUnpaid You have an unpaid ESA order. Please complete or void the order at the User Center before placing another order. You have an unpaid ESA order. Please complete or void the order at the User Center before placing another order.
400 NotInternationalRealIdentity Real-name registration is required for services offered in Mainland China. You have not passed real-name verification. According to the regulations issued by MIIT, you must pass real-name verification if you want to purchase information services in the Chinese mainland.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.