You need to enable JavaScript to run this app.
导航
ModifyEipAddressAttributes
最近更新时间:2024.04.18 17:01:12首次发布时间:2021.07.31 07:47:47

调用 ModifyEipAddressAttributes 接口,修改公网IP的名称、 描述、带宽上限。

调用说明

  • 降低带宽上限,可能会影响业务流量造成丢包,请充分评估可能对业务产生的影响,并谨慎操作。
  • 以下可选参数如不配置,则保持不变。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringModifyEipAddressAttributes要执行的操作,取值:ModifyEipAddressAttributes。
VersionString2020-04-01API的版本信息,当前版本为2020-04-01。

AllocationId

String

eip-2zb7u8xscd****

公网IP的ID。
您可以调用 DescribeEipAddresses 接口,查询公网IP的ID。

Name

String

eip-1

公网IP的名称。

  • 长度限制为1 ~ 128个字符。
  • 需要以字母、中文或数字开头,可包含点号(.)、下划线(_)和短划线(-)。

Description

String

This is an eip

公网IP的描述。

  • 长度限制为0~ 255个字符。
  • 需要以字母、中文或数字开头。可包含英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。)。

Bandwidth

Integer

10

公网IP的带宽上限,单位为Mbps。

  • 按量计费-按实际流量计费:取值范围1 ~ 200。
  • 按量计费-按带宽上限计费:取值范围1 ~ 1000。
  • 包年包月计费:取值范围1 ~ 1000。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。

请求示例

GET /?Action=ModifyEipAddressAttributes&Version=2020-04-01&AllocationId=eip-2zb7uj8xscd****&Bandwidth=10 HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "ModifyEipAddressAttributes",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },    
    "Result":{
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

公共错误码,请参见 公共错误码 。

HttpCode
错误码
错误信息
描述
400InvalidBandwidth.MalformedThe specified bandwidth is malformed.Ensure that bandwidth is not smaller than 1.指定的带宽不合法。如果指定带宽,请确保不小于1。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法。描述长度不能超过255个字符。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法。请修复描述格式后重试。
400InvalidEip.InvalidStatusThe specified elastic ip is not in the correct status for the request. The specified elastic ip is in freeze.指定的公网IP或私有网络所处的状态无法响应该请求。当前公网IP被冻结。
400InvalidName.MalformedThe specified name is malformed. Ensure the maximum length of name is 128.指定的名称格式不合法。名称长度不能超过128个字符。
400InvalidName.MalformedThe specified name is malformed.指定的名称格式不合法。请修复名称格式后重试。
400LimitExceeded.BandwidthPerEipYou've reached the limit on the bandwidth of elastic ip that you can create.已达到EIP带宽上限。
400OrderErrorFailed to create an order in one step.创建订单并支付失败。
400UnsupportedOperationThe request on the specified instance is denied due to the account in arrears status.因账户处于欠费状态,对于该实例的操作请求被拒绝。
400UnsupportedOperationThe request on the specified instance is denied due to the account balance and available vouchers are less than 100 yuan in total.因账户余额及可用代金券共不足100元,对于该实例的操作请求被拒绝。
403Forbidden.PurchaseLimitedThe account is not authorized to purchase the resource.此账户无权限购买资源。
404InvalidEip.GetInstanceDetailGet instance detail failed.获取实例信息失败。
404InvalidEip.NotFoundThe specified EIP does not exist.指定的EIP不存在。