Todos os produtos
Search
Central de documentação

:ModifyCommonBandwidthPackageIpBandwidth

Última atualização: Jul 04, 2026

Defina a largura de banda máxima de um elastic IP address (EIP) associado a um plano de largura de banda de EIP.

Observações de uso

Use a operação ModifyCommonBandwidthPackageIpBandwidth para definir a largura de banda máxima de um EIP associado a um plano de largura de banda de EIP. Isso impede que um único EIP esgote os recursos de largura de banda do plano.

Por exemplo, suponha que dois EIPs estejam associados a um plano de largura de banda de EIP com capacidade máxima de 800 Mbit/s. Nesse caso, defina a largura de banda máxima do primeiro EIP como 500 Mbit/s e a do segundo como 400 Mbit/s. Após a configuração, o primeiro EIP não consumirá mais que 500 Mbit/s, e o segundo ficará limitado a 400 Mbit/s.

Ao chamar esta operação, observe os seguintes pontos:

  • Esta operação aplica-se apenas a EIPs associados a instâncias do Elastic Compute Service (ECS). Ela não é válida para EIPs vinculados a instâncias do Server Load Balancer (SLB), gateways NAT, interfaces de rede elásticas secundárias (ENIs) ou endereços IP virtuais de alta disponibilidade (HAVIPs).

  • Este recurso está em preview público. A definição da largura de banda máxima via API funciona somente quando os EIPs estão associados a um plano de largura de banda de EIP. O console não oferece suporte a essa funcionalidade.

  • Não chame esta operação repetidamente para ajustar a largura de banda máxima de um mesmo EIP dentro de um curto período.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior conveniência, recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ModifyCommonBandwidthPackageIpBandwidth

A operação a ser executada. Defina o valor como ModifyCommonBandwidthPackageIpBandwidth.

RegionId

String

Sim

cn-hangzhou

O ID da região do plano de largura de banda de EIP. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

BandwidthPackageId

String

Sim

cbwp-2zep6hw5d6y8exscd****

O ID do plano de largura de banda de EIP.

EipId

String

Sim

eip-2zewysoansu0svfbg****

O ID do EIP associado ao plano de largura de banda de EIP.

Bandwidth

String

Sim

500

A largura de banda máxima para o EIP. Este valor não pode exceder a largura de banda máxima do plano de largura de banda de EIP. Unidade: Mbit/s.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

63D187BF-A30A-4DD6-B68D-FF182C96D8A2

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://vpc.aliyuncs.com/?Action=ModifyCommonBandwidthPackageIpBandwidth
&Bandwidth=500
&BandwidthPackageId=cbwp-2zep6hw5d6y8exscd****
&EipId=eip-2zewysoansu0svfbg****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyCommonBandwidthPackageIpBandwidth>
	<RequestId>63D187BF-A30A-4DD6-B68D-FF182C96D8A2</RequestId>
</ModifyCommonBandwidthPackageIpBandwidth>

Formato JSON

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

{
  "RequestId" : "63D187BF-A30A-4DD6-B68D-FF182C96D8A2"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

404

InvalidRegionId.NotFound

The specified RegionId does not exist in our records.

A mensagem de erro retornada porque o ID da região especificado não existe.

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