You need to enable JavaScript to run this app.
文档中心
公网IP

公网IP

复制全文
下载 pdf
公网IP
DescribeEipAddressAttributes - 查询公网IP详细信息
复制全文
下载 pdf
DescribeEipAddressAttributes - 查询公网IP详细信息
调用 DescribeEipAddressAttributes 接口,查看指定公网IP的详情。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeEipAddressAttributes​
要执行的操作,取值:DescribeEipAddressAttributes。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
AllocationId String 必选 示例值:eip-2ze7ujxscd****​
要查询的公网IP的ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
AllocationId String 示例值:eip-2ze7ujxscd****​
公网IP的ID。​
​
EipAddress String 示例值:10.XX.XX.50​
公网IP地址。​
​
Name String 示例值:eip-1​
公网IP的名称。​
​
Description String 示例值:This is an eip​
公网IP的描述信息。​
​
DirectMode Boolean 示例值:false​
是否开启直通模式。​
  • true:是。​
  • false:否。​
​
ISP String 示例值:BGP​
线路类型。​
  • BGP:BGP(多线)。​
  • ChinaMobile:中国移动静态单线。​
  • ChinaTelecom:中国电信静态单线。​
  • ChinaUnicom:中国联通静态单线。​
  • SingleLine_BGP:BGP单线。​
  • Fusion_BGP:融合BGP。​
  • ChinaMobile_Value:中国移动惠选型静态单线。​
  • ChinaUnicom_Value:中国联通惠选型静态单线。​
  • ChinaTelecom_Value:中国电信惠选型静态单线。​
​
BillingType Integer 示例值:2​
公网IP计费方式。​
  • 1:包年包月。​
  • 2:按量计费-按带宽上限计费。​
  • 3:按量计费-按实际流量计费。​
​
Bandwidth Integer 示例值:5​
公网IP的带宽上限,单位为Mbps。​
​
SecurityProtectionTypes String[] 示例值:["AntiDDoS_Enhanced"]​
防护类型。​
  • AntiDDoS_Enhanced:增强防护类型的公网IP,可以加入到DDoS原生防护(企业版)实例。​
  • 空值:默认防护类型的公网IP。​
说明​
此功能正在邀测中,如需试用,请联系客户经理。​
​
ProjectName String 示例值:Project_1​
公网IP所属项目的名称。​
​
Tags Object[] 示例值:-​
公网IP的标签信息。​
Key String 示例值:k1​
标签键。​
​
Value String 示例值:v1​
标签值。​
​
​
InstanceType String 示例值:EcsInstance​
当前绑定的实例类型。​
  • Nat:公网NAT网关。​
  • NetworkInterface: 弹性网卡。​
  • ClbInstance: 负载均衡。​
  • Albinstance:应用型负载均衡。​
  • EcsInstance:云服务器。​
  • HaVip:高可用虚拟IP。​
  • IpAddress:私网IP 地址。​
说明​
公网IP绑定IP地址功能正在邀测中,如需试用,请联系客户经理申请。​
​
InstanceId String 示例值:i-2zebbhyczzaweeval****​
当前绑定的实例ID。​
​
IpAddressPoolId String 示例值:eip-2zeerra***​
IP地址池的ID。​
​
IsBlocked Boolean 示例值:true​
是否被封禁。​
  • true:是。​
  • false:否。​
​
ReleaseWithInstance Boolean 示例值:true​
是否随云服务器实例删除。仅按量计费公网IP有效。开启后,当云服务器实例被系统自动回收(退订24小时后、到期回收、欠费回收)或被调用DeleteInstances接口时,公网IP随其一同释放。​
  • true:是。​
  • false:否。​
​
BandwidthPackageId String 示例值:bwp-2zeo05qre24nhrqpy****​
共享带宽包实例ID。​
​
Status String 示例值:Attaching​
公网IP的状态。​
  • Attaching:绑定中。​
  • Detaching:解绑中。​
  • Attached:已绑定。​
  • Available:可用。​
  • Deleting:删除中。​
​
BusinessStatus String 示例值:FinancialLocked​
公网IP是否被锁定。​
  • Normal: 正常。​
  • FinancialLocked: 被锁定。​
​
LockReason String 示例值:financial​
公网IP被锁定的原因。​
  • financial: 因欠费被锁定。​
  • unlock: 欠费关停后充值恢复过程中。​
  • 空值 : 没有被锁定。​
​
VpcId String 示例值:vpc-257gqcdfvx6n****​
与公网IP绑定的VPC ID。​
仅当公网IP的 InstanceType 参数取值为 IpAddress 时返回该参数。​
​
AllocationTime String 示例值:2021-07-15T21:46:15+08:00​
公网IP的创建时间。​
​
UpdatedAt String 示例值:2021-07-23T11:55:12+08:00​
更新公网IP的时间。​
​
ExpiredTime String 示例值:2021-05-07 23:59:59​
公网IP的到期时间。​
  • 包年包月,返回值为到期时间。​
  • 按量计费,返回值为空。​
​
OverdueTime String 示例值:2021-04-29 01:00:00​
资源冻结时间。仅当资源因为欠费冻结,此参数才会有返回值。​
​
DeletedTime String 示例值:2021-04-30 01:00:00​
预期资源强制回收时间。​
  • 包年包月公网IP,此参数有返回值。​
  • 按量计费公网IP,仅欠费冻结时,此参数有返回值。​
​
​
​
请求示例​
​
GET /?Action=DescribeEipAddressAttributes&Version=2020-04-01&AllocationId=eip-2ze7ujxscd**** HTTP/1.1​
Host: open.volcengineapi.com​
Service: vpc​
Region: cn-beijing​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeEipAddressAttributes",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-north-1"​
},​
"Result": {​
"AllocationId": "eip-2ze7ujxscd****",​
"AllocationTime": "2021-07-15T21:46:15+08:00",​
"Bandwidth": 5,​
"BandwidthPackageId": "bwp-2zeo05qre24nhrqpy****",​
"BillingType": 2,​
"BusinessStatus": "FinancialLocked",​
"DeletedTime": "2021-04-30 01:00:00",​
"Description": "This is an eip",​
"DirectMode": true,​
"EipAddress": "10.XX.XX.50",​
"ExpiredTime": "2021-05-07 23:59:59",​
"ISP": "BGP",​
"InstanceId": "i-2zebbhyczzaweeval****",​
"InstanceType": "EcsInstance",​
"IpAddressPoolId": "eip-2zeerra***",​
"IsBlocked": true,​
"LockReason": "financial",​
"Name": "eip-1",​
"OverdueTime": "2021-04-29 01:00:00",​
"ProjectName": "Project_1",​
"ReleaseWithInstance": true,​
"RequestId": "2021062415303301022514515207C4****",​
"SecurityProtectionTypes": [​
"AntiDDoS_Enhanced"​
],​
"Status": "Attaching",​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"UpdatedAt": "2021-07-23T11:55:12+08:00",​
"VpcId": "vpc-257gqcdfvx6n****"​
}​
}​
​
错误码​
公共错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
IdempotentParameterMismatch​
Arguments on this idempotent request are inconsistent with arguments used in previous request(s).​
此幂等请求的参数与前一个请求中使用的参数不一致。​
400​
InvalidParameter.ClientTokenMalformed​
The specified parameter ClientToken is malformed.​
指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。​
400​
MissingParameter​
The request is missing a required parameter.​
该请求缺少必要参数。​
409​
InvalidOperation.Conflict​
The specified resource operation conflicts.​
指定的资源操作冲突。​
412​
IdempotentProcessing​
The request uses the same client token as a previous one that is still in process.​
幂等请求处理中。​
500​
InternalError​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.01.23 15:56:39
这个页面对您有帮助吗?
有用
有用
无用
无用