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
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.