Todos os produtos
Search

Este produto

    :CreateCenBandwidthPackage

    Central de documentação

    :CreateCenBandwidthPackage

    Última atualização: Jul 03, 2026

    Cria um plano de largura de banda.

    Observações de uso

    • Especifique as áreas a serem conectadas ao criar um plano de largura de banda. Cada área contém uma ou mais regiões da Alibaba Cloud. Ao selecionar as áreas do plano, verifique se elas incluem as regiões que você deseja conectar. Para obter mais informações sobre as áreas e regiões compatíveis, consulte Comprar um plano de largura de banda.

    • Para obter detalhes sobre as regras de faturamento, consulte Faturamento.

    • A operação CreateCenBandwidthPackage é assíncrona. Após o envio da solicitação, o sistema retorna o ID do plano de largura de banda, mas a execução continua em segundo plano. Chame a operação DescribeCenBandwidthPackages para consultar o status do plano. A criação é considerada concluída quando o plano atinge o estado Idle ou InUse.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. Essa ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    ParâmetroTipoObrigatórioExemploDescrição
    ActionStringSimCreateCenBandwidthPackage

    Operação a ser executada. Defina o valor como CreateCenBandwidthPackage.

    ClientTokenStringNão02fb3da4-130e-11e9-8e44-001****

    Token de cliente usado para garantir a idempotência da solicitação.

    Gere o token no cliente e garanta que seja único entre diferentes solicitações. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

    NameStringNãonametest

    Nome do plano de largura de banda.

    Deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Precisa começar com uma letra e não pode iniciar com http:// ou https://.

    DescriptionStringNãonamedesc

    Descrição do plano de largura de banda.

    BandwidthIntegerSim2

    Valor máximo de largura de banda do plano. Unidade: Mbit/s. Valores válidos: de 2 a 10000.

    GeographicRegionAIdStringSimChina

    Área onde a instância de rede está implantada. Valores válidos:

    • China: China continental
    • North-America: América do Norte
    • Asia-Pacific: Ásia-Pacífico
    • Europe: Europa
    • Australia: Austrália
    GeographicRegionBIdStringSimChina

    Área onde a outra instância de rede está implantada. Valores válidos:

    • China: China continental
    • North-America: América do Norte
    • Asia-Pacific: Ásia-Pacífico
    • Europe: Europa
    • Australia: Austrália
    BandwidthPackageChargeTypeStringNãoPREPAY

    Método de faturamento do plano de largura de banda. Valor válido: PREPAY, que indica pagamento conforme o uso.

    PeriodIntegerNão1

    Duração da assinatura do plano de largura de banda. Valor padrão: 1.

    • Se PricingCycle estiver definido como Month, defina Period com um valor de 1 a 3 ou 6.
    • Se PricingCycle estiver definido como Year, defina Period com um valor de 1 a 3.
    Nota Este parâmetro é obrigatório quando BandwidthPackageChargeType está definido como PREPAY.
    PricingCycleStringNãoMonth

    Ciclo de faturamento do plano de largura de banda. Valores válidos:

    • Month (padrão): faturamento mensal.
    • Year: faturamento anual.
    AutoPayBooleanNãofalse

    Define se o pagamento do plano de largura de banda será concluído automaticamente. Valores válidos:

    • true: sim
    • false (padrão): não

    Se definir o parâmetro como false, acesse o Billing Management para concluir o pagamento após chamar esta operação. A instância só será criada após a confirmação do pagamento.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    CenBandwidthPackageId

    String

    cenbwp-4c2zaavbvh5fx****

    ID do plano de largura de banda.

    CenBandwidthPackageOrderId

    String

    20156420004****

    ID do pedido do plano de largura de banda.

    RequestId

    String

    E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B

    ID da solicitação.

    Exemplos

    Exemplos de solicitações

    http(s)://[Endpoint]/?Action=CreateCenBandwidthPackage
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&Name=nametest
&Description=namedesc
&Bandwidth=2
&GeographicRegionAId=China 
&GeographicRegionBId=China 
&BandwidthPackageChargeType=PREPAY
&Period=1
&PricingCycle=Month
&AutoPay=false
&AutoRenew=false
&Common request parameters

    Exemplos de respostas de sucesso

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCenBandwidthPackageResponse>
    <RequestId>E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B</RequestId>
    <CenBandwidthPackageOrderId>20156420004****</CenBandwidthPackageOrderId>
    <CenBandwidthPackageId> cenbwp-4c2zaavbvh5fx****</CenBandwidthPackageId>
</CreateCenBandwidthPackageResponse>

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B",
  "CenBandwidthPackageOrderId" : "20156420004****",
  "CenBandwidthPackageId" : "cenbwp-4c2zaavbvh5fx****"
}

    Códigos de erro

    HttpCode

    Código de erro

    Mensagem de erro

    Descrição

    400

    UnSupported.ChargeType

    The charge type is not supported.

    Mensagem retornada porque o método de faturamento especificado não é compatível.

    Para obter uma lista de códigos de erro, visite o API Error Center.