参数vpc

专有网络VPC开发指南开发指南API参考简介用户可以使用本文档介绍的API对VPC服务进行相关操作.
请确保在使用这些接口前,已充分了解了VPC产品说明、使用协议和收费方式.
术语表术语全称中文说明VPCVirtualPrivateCloud专有网络专有网络是用户基于阿里云创建的自定义私有网络,不同的专有网络之间彻底逻辑隔离,用户可以在自己创建的专有网络内创建和管理云产品实例,比如ECS,IntranetSLB,RDS等.
Region地域代表资源所在的地域,每个地域包含一组可用区.
ZoneAvailabilityZone可用区同一地域内,电力和网络互相独立的物理区域.
同一可用区内的ECS实例网络延时更小.
在同一地域内可用区与可用区之间内网互通,可用区之间能做到故障隔离.
VRouter路由器路由器,是VPC网络的枢纽,它可以连接VPC内的各个交换机专有网络VPC开发指南1业务限制资源规格限制说明在VPC中,对每个用户可拥有的VPC、EIP等资源的数量均有限制.
在VPC中可容纳的交换机个数、VPC中可容纳的ECS实例个数、EIP的带宽可选范围等规格方面也有限制.
在使用VPCOpenAPI时,请点此参考官网上最新的业务限制规则和资源规格限制.
在接口说明部分,凡出现对参数可选值、可用规格方面与官网上给出的资源规格限制发生矛盾时,均以官网上,同时也是连接VPC与其他网络的网关设备.
它会根据具体的路由条目的设置来转发网络流量.
VSwitch交换机交换机,是组成VPC网络的基础网络设备.
它可以连接不同的云产品实例.
在VPC网络内创建云产品实例的时候,必须指定云产品实例所在的交换机.
EIPElasticIPAddress弹性公网IP地址由一个公网IP和一份公网带宽组成.
可由用户单独购买或释放;可以与ECS实例进行灵活的绑定和解绑.
CIDRClasslessInter-DomainRouting无类别域间路由选择是互联网中一种新的寻址方式,与传统的A类、B类和C类寻址模式相比,CIDR在IP地址分配方面更为高效.
例如IP号段是125.
203.
96.
0-125.
203.
127.
255,转化cidr格式就是找相同的前十九位:125.
203.
01100000.
00000000到125.
203.
01111111.
11111111可以写成125.
203.
96.
0/19RouteTable路由表路由表,是指路由器上管理路由条目的列表.
RouteEntry路由条目路由表中的每一项成为一条路由条目,路由条目定义了通向指定目标网段的网络流量的下一跳地址,路由条目包括系统路由和自定义路由两种类型.
专有网络VPC开发指南21.
2.
3.
4.
给出的值为准.
调用方式概述调用方式对VPCAPI接口调用是通过向VPCAPI的服务端地址发送HTTPGET请求,并按照接口说明在请求中加入相应请求参数来完成的;根据请求的处理情况,系统会返回处理结果.
请求结构公共参数返回结果签名机制请求接口请求结构服务地址VPCAPI的服务接入地址为:vpc.
aliyuncs.
com通信协议支持通过HTTP或HTTPS通道进行请求通信.
为了获得更高的安全性,推荐您使用HTTPS通道发送请求.
专有网络VPC开发指南3请求方法支持HTTPGET方法发送请求,这种方式下请求参数需要包含在请求的URL中.
请求参数每个请求都需要指定要执行的操作,即Action参数(例如CreateVpc),以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数.
字符编码请求及返回结果都使用UTF-8字符集进行编码.
公共参数公共请求参数公共请求参数是指每个接口都需要使用到的请求参数.
名称类型是否必须描述FormatString否返回值的类型,支持JSON与XML.
默认为XML.
VersionString是API版本号,为日期形式:YYYY-MM-DD,本版本对应为2016-04-28.
AccessKeyIdString是阿里云颁发给用户的访问服务所用的密钥ID.
SignatureString是签名结果串,关于签名的计算方法,请参见.
SignatureMethodString是签名方式,目前支持HMAC-SHA1.
TimestampString是请求的时间戳.
日期格式按照ISO8601标准表示,并需要使用UTC时间.
格式为:YYYY-MM-DDThh:mm:ssZ例如,2014-05-26T12:00:00Z(为北京时间专有网络VPC开发指南4示例公共返回参数用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId给用户.
示例XML示例:2014年5月26日20点0分0秒).
SignatureVersionString是签名算法版本,目前版本是1.
0.
SignatureNonceString是唯一随机数,用于防止网络重放攻击.
用户在不同请求间要使用不同的随机数值ResourceOwnerAccountString否本次API请求访问到的资源拥有者账户,即登录用户名.
此参数的使用方法,详见VPC资源访问>,(只能在RAM中可对VPC资源进行授权的Action中才能使用此参数,否则访问会被拒绝)https://vpc.
aliyuncs.
com/Format=xml&Version=2016-04-28&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D&SignatureMethod=HMAC-SHA1&SignatureNonce=15215528852396&SignatureVersion=1.
0&AccessKeyId=key-test&Timestamp=2016-06-01T12:00:00Z…4C467B38-3910-447D-87BC-AC049166F216专有网络VPC开发指南5JSON示例:返回结果调用API服务后返回数据采用统一格式,返回的HTTP状态码为2xx,代表调用成功;返回4xx或5xx的HTTP状态码代表调用失败.
调用成功返回的数据格式主要有XML和JSON两种,外部系统可以在请求时传入参数来制定返回的数据格式,默认为XML格式.
本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果是没有进行换行、缩进等处理的.
成功结果XML示例:JSON示例:错误结果调用接口出错后,将不会返回结果数据.
调用方可根据每个接口对应的错误码以及下述2.
3.
3的公共错误码来定位错误原因.
当调用出错时,HTTP请求返回一个4xx或5xx的HTTP状态码.
返回的消息体中是具体的错{"RequestId":"4C467B38-3910-447D-87BC-AC049166F216",/*返回结果数据*/}4C467B38-3910-447D-87BC-AC049166F216{"RequestId":"4C467B38-3910-447D-87BC-AC049166F216",/*返回结果数据*/}专有网络VPC开发指南6误代码及错误信息.
另外还包含一个全局唯一的请求ID:RequestId和一个您该次请求访问的站点ID:HostId.
在调用方找不到错误原因时,可以联系阿里云客服,并提供该HostId和RequestId,以便我们尽快帮您解决问题.
XML示例:JSON示例:公共错误码8906582E-6722-409A-A6C4-0E7863B733A5vpc.
aliyuncs.
comUnsupportedOperationThespecifiedactionisnotsupported.
{"RequestId":"8906582E-6722-409A-A6C4-0E7863B733A5","HostId":"vpc.
aliyuncs.
com","Code":"UnsupportedOperation","Message":"Thespecifiedactionisnotsupported.
"}错误代码描述Http状态码语义MissingParameterTheinputparameter"Action"thatismandatoryforprocessingthisrequestisnotsupplied400缺少Action字段MissingParameterTheinputparameter"AccessKeyId"thatismandatoryforprocessingthisrequestisnotsupplied400缺少AccessKeyId字段MissingParameterAninputparameter"Signature"thatismandatoryforprocessingtherequestisnotsupplied.
400缺少Signature字段MissingParameterTheinputparameter"TimeStamp"that400缺少Timestamp字段专有网络VPC开发指南7ismandatoryforprocessingthisrequestisnotsuppliedMissingParameterTheinputparameter"Version"thatismandatoryforprocessingthisrequestisnotsupplied400缺少Version字段InvalidParameterThespecifiedparameter"ActionorVersion"isnotvalid.
400无效的Action值(该API不存在)InvalidAccessKeyId.
NotFoundTheAccessKeyIDprovideddoesnotexistinourrecords.
400无效的AccessKeyId值(该key不存在)Forbidden.
AccessKeyDisabledTheAccessKeyisdisabled.
403该AccessKey处于禁用状态IncompleteSignatureTherequestsignaturedoesnotconformtoAliyunstandards.
400无效的Signature取值(签名结果错误)InvalidParamaterThespecifiedparameter"SignatureMethod"isnotvalid.
400无效的SignatureMethod取值InvalidParamaterThespecifiedparameter"SignatureVersion"isnotvalid.
400无效的SignatureVersion取值IllegalTimestampTheinputparameter"Timestamp"thatismandatoryforprocessingthisrequestisnotsupplied.
400无效的Timestamp取值(Timestamp与服务器时间相差超过了1个小时)SignatureNonceUsedTherequestsignaturenoncehasbeenused.
400无效的SignatureNonce(该SignatureNonce值已被使用过)InvalidParameterThespecifiedparameter"ActionorVersion"isnotvalid.
400无效的Version取值InvalidOwnerIdThespecifiedOwnerIdisnotvalid.
400无效的OwnerId取值InvalidOwnerAccountThespecifiedOwnerAccountis400无效的OwnerAccount取值专有网络VPC开发指南8notvalid.
InvalidOwnerOwnerIdandOwnerAccountcan'tbeusedatoneAPIaccess.
400同时使用了OwnerId和OwnerAccountThrottlingRequestwasdeniedduetorequestthrottling.
400因系统流控拒绝访问ThrottlingRequestwasdeniedduetorequestthrottling.
400该key的调用quota已用完InvalidActionSpecifiedactionisnotvalid.
403该key无权调用该APIUnsupportedHTTPMethodThishttpmethodisnotsupported.
403用户使用了不支持的HttpMethod(当前TOP只支持post和get)ServiceUnavailableTherequesthasfailedduetoatemporaryfailureoftheserver.
500服务不可用UnsupportedParameterTheparameter""isnotsupported.
400使用了无效的参数InternalErrorTherequestprocessinghasfailedduetosomeunknownerror,exceptionorfailure.
500其他情况MissingParameterTheinputparameterOwnerId,OwnerAccountthatismandatoryforprocessingthisrequestisnotsupplied.
403调用该接口没有指定OwnerIdForbidden.
SubUserThespecifiedactionisnotavailableforyou.
403无权调用订单类接口UnsupportedParameterTheparameter""isnotsupported.
400该参数无权使用Forbidden.
InstanceNotFoundThespecifiedInstanceisnotfound,sowecann'tgetenoughinformationtocheck404使用了RAM授权子账号进行资源访问,但是本次访问涉及到的Instance不存在专有网络VPC开发指南9permissioninRAM.
Forbidden.
DiskNotFoundThespecifiedDiskisnotfound,sowecann'tgetenoughinformationtocheckpermissioninRAM.
404使用了RAM授权子账号进行资源访问,但是本次访问涉及到的Disk不存在Forbidden.
SecurityGroupNotFoundThespecifiedSecurityGroupisnotfound,sowecann'tgetenoughinformationtocheckpermissioninRAM.
404使用了RAM授权子账号进行资源访问,但是本次访问涉及到的SecurityGroup不存在Forbidden.
SnapshotNotFoundThespecifiedSnapshotisnotfound,sowecann'tgetenoughinformationtocheckpermissioninRAM.
404使用了RAM授权子账号进行资源访问,但是本次访问涉及到的Snapshot不存在Forbidden.
ImageNotFoundThespecifiedImageisnotfound,sowecann'tgetenoughinformationtocheckpermissioninRAM.
404使用了RAM授权子账号进行资源访问,但是本次访问涉及到的Image不存在Forbidden.
RAMUsernotauthorizedtooperatethespecifiedresource,orthisAPIdoesn'tsupportRAM.
403使用了RAM授权子账号进行资源访问,但是本次操作没有被正确的授权Forbidden.
NotSupportRAMThisactiondoesnotsupportaccessedbyRAMmode.
403该接口不允许使用RAM方式进行访问InsufficientBalanceYouraccountdoesnothaveenoughbalance.
400余额不足IdempotentParameterMismatchRequestusesaclienttokeninapreviousrequestbutisnotidenticaltothatrequest.
400使用了一个已经使用过的ClientToken,但此次请求内容却又与上一次使用该Token的request不一样.
RealNameAuthenticationErrorYouraccounthasnotpassedthereal-nameauthenticationyet.
403用户未进行实名认证InvalidIdempotenceParameter.
MismatchThespecifiedparametersaredifferentfrombefore403幂等参数不匹配LastTokenProcessingThelasttokenrequestisprocessing403上一次请求还在处理中专有网络VPC开发指南10签名机制VPC服务会对每个访问的请求进行身份验证,所以无论使用HTTP还是HTTPS协议提交请求,都需要在请求中包含签名(Signature)信息.
VPC通过使用AccessKeyID和AccessKeySecret进行对称加密的方法来验证请求的发送者身份.
AccessKeyID和AccessKeySecret由阿里云官方颁发给访问者(可以通过阿里云官方网站申请和管理),其中AccessKeyID用于标识访问者的身份;AccessKeySecret是用于加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密,只有阿里云和用户知道.
用户在访问时,按照下面的方法对请求进行签名处理:使用请求参数构造规范化的请求字符串(CanonicalizedQueryString)(a)参数排序.
按照参数名称的字典顺序对请求中所有的请求参数(包括"公共请求参数"和接口的自定义参数,但不能包括"公共请求参数"中提到的Signature参数本身)进行排序.
注:当使用GET方法提交请求时,这些参数就是请求URI中的参数部分(即URI中""之后由"&"连接的部分).
(b)参数编码.
对排序之后的请求参数的名称和值分别用UTF-8字符集进行URL编码.
编码的规则如下:注:该编码方式和一般采用的"application/x-www-form-urlencoded"MIME格式编码算法(比如Java标准库中的java.
net.
URLEncoder的实现)相似,但又有所不同.
实现时,可以先用标准库的方式进行编码,然后把编码后的字符串中加号(+)替换成%20、星号(*)替换成%2A、%7E替换回波浪号(~),即可得到上述规则描述的编码字符串.
这个算法可以用下面的percentEncode方法来实现:InvalidParameterThespecifiedparameterisnotvalid400参数校验失败i.
对于字符A-Z、a-z、0-9以及字符"不编码;ii.
对于其他字符编码成"%XY"的格式,其中XY是字符对应ASCII码的16进制表示.
比如英文的双引号(")对应的编码就是%22iii.
对于扩展的UTF-8字符,编码成"%XY%ZA…"的格式;iv.
需要说明的是英文空格()要被编码是%20,而不是加号(+).
privatestaticfinalStringENCODING="UTF-8";privatestaticStringpercentEncode(Stringvalue)throwsUnsupportedEncodingException{returnvalue!
=nullURLEncoder.
encode(value,ENCODING).
replace("+","%20").
replace("*","%2A").
replace("%7E"null;}专有网络VPC开发指南11(c)将编码后的参数名称和值用英文等号(=)进行连接.
(d)将等号连接得到的参数组合按步骤(a)排好的顺序依次使用&符号连接,即得到规范化请求字符串.
将上一步构造的规范化字符串按照下面的规则构造成待签名的字符串:其中HTTPMethod是提交请求用的HTTP方法,比如GET.
percentEncode("/")是按照1.
b中描述的URL编码规则对字符"/"进行编码得到的值,即"%2F".
percentEncode(CanonicalizedQueryString)是对第1步中构造的规范化请求字符串按1.
b中描述的URL编码规则编码后得到的字符串.
按照RFC2104的定义,计算待签名字符串StringToSign的HMAC值.
注意:计算签名时使用的Key就是用户持有的AccessKeySecret并加上一个"&"字符(ASCII:38),使用的哈希算法是SHA1.
按照Base64编码规则把上面的HMAC值编码成字符串,即得到签名值(Signature).
将得到的签名值作为Signature参数添加到请求参数中,即完成对请求签名的过程.
注意:得到的签名值在作为最后的请求参数值提交给VPC服务器的时候,要和其他参数一样,按照RFC3986的规则进行URL编码.
以DescribeRegions为例,假设使用的AccessKeyId是"testid",AccessKeySecret是"testsecret".
那么签名前的请求URL为:而计算得到的待签名字符串StringToSign为:StringToSign=HTTPMethod+"&"+percentEncode(percentEncode(CanonicalizedQueryString)http://vpc.
aliyuncs.
com/TimeStamp=2016-02-23T12:46:24Z&Format=XML&AccessKeyId=testid&Action=DescribeRegions&SignatureMethod=HMAC-SHA1&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2014-05-26&SignatureVersion=1.
0GET&%2F&AccessKeyId%3Dtestid&Action%3DDescribeRegions&Format%3DXML&SignatureMethod%3DHMAC-SHA1&SignatureNonce%3D3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&SignatureVersion%3D1.
0&TimeStamp%3D2016-02-23T12%253A46%253A24Z&Version%3D2014-05-26专有网络VPC开发指南12------因为AccessKeySecret是"testsecret",所以用于计算HMAC的Key为"testsecret&",计算得到的签名值是:将签名作为Signature参数加入到URL请求中,得到最后的URL为:关于如何进行签名并提交请求的详细示例,请参见附录:如何调用接口.
借助RAM实现子账号对主账号的VPC资源访问专有网络新建专有网络描述在指定的地域创建1个VPCVPC只能指定1个CidrBlock,CidrBlock的范围包括10.
0.
0.
0/8、172.
16.
0.
0/12和192.
168.
0.
0/16及它们的子网,CidrBlock的掩码为8-24位,默认为172.
16.
0.
0/12VPC创建后无法修改CidrBlock每个VPC包含的云产品实例不能分布在不同地域,可以分布在同一地域的不同可用区内每个VPC包含的云产品实例数量不超过10000个创建VPC时,会自动创建1个虚拟路由器和1个路由表.
每个VPC只允许有1个虚拟路由器和1个路由表每个VPC,支持3个用户侧网络的网段UserCidr;如果多个用户侧网段之间存在互相包含(比如CT9X0VtwR86fNWSnsc6v8YGOjuE=http://vpc.
aliyuncs.
com/SignatureVersion=1.
0&Action=DescribeRegions&Format=XML&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2014-05-26&AccessKeyId=testid&Signature=CT9X0VtwR86fNWSnsc6v8YGOjuE%3D&SignatureMethod=HMAC-SHA1&TimeStamp=2016-02-23T12%3A46%3A24Z专有网络VPC开发指南1310.
0.
0.
0/8和10.
1.
0.
0/16,以10.
0.
0.
0/8实际生效)请求参数返回参数名称类型是否必须描述ActionString是系统规定参数,取值:CreateVpcRegionIdString是新建的VPC所在的地域CidrBlockString否可选值10.
0.
0.
0/8、172.
16.
0.
0/12和192.
168.
0.
0/16及它们包含的子网.
默认是172.
16.
0.
0/12VpcNameString否VPC名称,不填则为空,默认值为空.
长度范围为2~128个字节.
支持英文或中文字符,必须以大小写字母或中文开头,可包含数字,"_"或"-",不能以"http://"或"https://"开头DescriptionString否对新建VPC的描述,不填则为空,默认值为空.
长度范围为2~256个字节.
支持英文或中文字符,不能以"http://"或"https://"开头ClientTokenString否用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符,具体参见如何保证幂等性UserCidrString否用户侧网络的网段,如需定义多个网段请使用用半角逗号字符隔开,最多支持3个网段名称类型描述VpcIdString系统分配的专有网络IDVRouterIdString路由器IdRouteTableIdString路由表Id专有网络VPC开发指南14错误码示例请求示例错误代码描述Http状态码语义InvalidRegionId.
NotFoundSpecifiedvalueof"RegionId"isnotsupported.
404指定的Region不存在InvalidParameterSpecifiedCIDRblockisnotvalid.
400指定的网段不正确ResourceNotAvailableResourceyourequestedisnotavailableinthisregionorzone.
400指定的Region或Zone不支持VPCInvalidVpcName.
MalformedSpecifiedVPCnameisnotvalid.
400VPC名称格式不正确InvalidVpcDiscription.
MalformedSpecifiedVPCdescriptionisnotvalid.
400指定的VPC描述信息不正确ForbbidenUsernotauthorizedtooperateonthespecifiedresource.
403用户没有指定资源的操作权限QuotaExceeded.
VpcVPCquotaexceeded.
400用户名下的VPC数量达到配额上限InvalidParameterSpecifiedUserCidrinvalidformat.
400指定的UserCidr格式不合法InvalidParameterSpecifiedUserCidrSubnetmaskisnotvalid.
400指定的UserCidr子网掩码不合法InvalidUserCidr.
QuotaSpecifiedUserCidrnumberisgreaterthan3.
400指定的UserCidr个数大于3InvalidUserCidr.
MalformedSpecifiedUserCidroverlappinginof100.
64.
0.
0/10.
400指定的UserCidr与100.
64.
0.
0/10网段重叠https://vpc.
aliyuncs.
com/Action=CreateVpc&RegionID=cn-beijing&专有网络VPC开发指南15--返回示例XML格式JSON格式删除专有网络描述删除指定的VPC删除VPC之前,需要先释放或移走VPC内的所有资源(包括VSwitch,ECSInstance,Connection,HaVip等)只有Available状态的VPC可以删除请求参数461D0C42-D5D1-4009-9B6A-B3D5888A19A9,vtb-25wm68mnhvrt-25bezkd03vpc-257gq642n{"RequestId":"461D0C42-D5D1-4009-9B6A-B3D5888A19A9","RouteTableId":"vtb-25wm68mnh","VRouterId":"vrt-25bezkd03","VpcId":"vpc-257gq642n"}名称类型是否必须描述ActionString是系统规定参数,取值:DeleteVpcVpcIdString是需要删除的VPC的Id专有网络VPC开发指南16返回参数全是公共返回参数,详见公共返回参数错误码示例请求示例返回示例XML格式JSON格式错误代码描述Http状态码语义IncorrectVpcStatusCurrentVPCstatusdoesnotsupportthisoperation.
400当前VPC的状态无法支持这个操作DependencyViolation.
RouteEntrySpecifiedobjecthasdependentresources400当前VPC还存在未删除的自定义路由规则,VPC删除失败DependencyViolation.
InstanceSpecifiedobjecthasdependentresources400当前VPC还存在未删除的云产品实例,VPC删除失败DependencyViolation.
VSwitchSpecifiedobjecthasdependentresources400当前VPC还存在未删除的VSwitch,VPC删除失败DependencyViolation.
SecurityGroupSpecifiedobjecthasdependentresources400当前VPC还存在未删除的安全组,VPC删除失败https://vpc.
aliyuncs.
com/Action=DeleteVpc&VpcId=vpc-25eq58pl3&606998F0-B94D-48FE-8316-ACA81BB230DA专有网络VPC开发指南17查询专有网络列表描述查询指定地域的专有网络列表.
此接口支持分页查询,每页的数量默认为10条.
该接口只会校验参数的合法性,不会校验参数之间的依赖关系,返回结果是所有条件的"交集".
请求参数返回参数{"RequestId":"606998F0-B94D-48FE-8316-ACA81BB230DA"}名称类型是否必须描述ActionString是系统规定参数,取值:DescribeVpcsVpcIdString否需要查询的Vpc的IdRegionIdString是查询指定地域的VPCIsDefaultBoolean否是否为指定Region下的默认VPC,可选值:true——是false——否当不填写此参数时返回所有指定Region下的VPCPageNumberInteger否实例状态列表的页码,起始值为1,默认值为1PageSizeInteger否分页查询时设置的每页行数,最大值50行,默认为10名称类型描述VpcsVpcTypeVpc详情VpcSetType组成的集合TotalCountString列表条条目数专有网络VPC开发指南18错误码示例请求示例返回示例XML格式PageNumberInteger当前页码PageSizeInteger当前分页包含多少条目错误代码描述Http状态码语义Forbidden.
RegionNotFoundSpecifiedregionisnotfoundduringaccessauthentication.
404指定Region不存在https://vpc.
aliyuncs.
com/Action=DescribeVpcs&RegionId=cn-beijing&DA1DAE87-43FA-472F-98BB-4FDBAA4A688Dvpc-257gq642ncn-beijingvrt-25bezkd03Available172.
16.
0.
0/162014-10-29T13:30:19Z专有网络VPC开发指南19JSON格式修改专有网络属性描述修改指定VPC的属性请求参数{"PageNumber":1,"PageSize":10,"RequestId":"DA1DAE87-43FA-472F-98BB-4FDBAA4A688D","TotalCount":1,"Vpcs":{"Vpc":{"CidrBlock":"172.
16.
0.
0/16","CreationTime":"2014-10-29T13:30:19Z","Description":"","RegionId":"cn-beijing","Status":"Available","UserCidrs":{"UserCidr":[]},"VRouterId":"vrt-25bezkd03","VSwitchIds":{"VSwitchId":[]},"VpcId":"vpc-257gq642n","VpcName":""}}}名称类型是否必须描述ActionString是系统规定参数,取值:ModifyVpcAttributeVpcIdString是需要修改的VPC的IdVpcNameString否修改后的名字,不填则为空,默认值为空,[2,128]英文或中文字符专有网络VPC开发指南20返回参数全是公共返回参数,详见公共返回参数错误码示例,必须以大小字母或中文开头,可包含数字,"_"或"-",这个值会展示在控制台.
不能以http://和https://开头.
DescriptionString否修改后的描述,不填则为空,默认值为空,[2,256]英文或中文字符,不能以http://和https://开头.
错误代码描述Http状态码语义InvalidVpcId.
NotFoundSpecifiedVPCdoesnotexist.
404指定的VPC不存在InvalidVpcName.
MalformedSpecifiedVPCnameisnotvalid.
400指定的VPC名字的格式不符合要求InvalidVpcDiscription.
MalformedSpecifiedVPCdescriptionisnotvalid.
400指定的VPC描述的格式不符合要求InvalidParameterSpecifiedUserCidrinvalidformat.
400指定的UserCidr格式不合法InvalidParameterSpecifiedUserCidrSubnetmaskisnotvalid.
400指定的UserCidr子网掩码不合法InvalidUserCidr.
QuotaSpecifiedUserCidrnumberisgreaterthan3.
400指定的UserCidr个数大于3InvalidUserCidr.
MalformedSpecifiedUserCidroverlappinginof100.
64.
0.
0/10.
400指定的UserCidr与100.
64.
0.
0/10网段重叠InvalidUserCidr.
MalformedSpecifiedUserCirdstatusiswrong,donotallowoperation400指定的UserCidr不允许修改专有网络VPC开发指南21请求示例返回示例XML格式JSON格式路由器查询路由器列表查询路由器列表描述查询指定地域的路由器列表.
此接口支持分页查询,每页的数量默认为10条.
https://vpc.
aliyuncs.
com/Action=ModifyVpcAttribute&VpcId=vpc-257gq642n&VpcName=Vpc02&5741F353-AD13-41A2-83C7-19E49BD9AE30{"RequestId":"5741F353-AD13-41A2-83C7-19E49BD9AE30"}专有网络VPC开发指南22请求参数返回参数错误码示例请求示例名称类型是否必须描述ActionString是系统规定参数,取值:DescribeVRoutersVRouterIdString否需要查询的VRouter的IdRegionIdString是查询指定地域的VRouterPageNumberInteger否实例状态列表的页码,起始值为1,默认值为1PageSizeInteger否分页查询时设置的每页行数,最大值50行,默认为10名称类型描述VRoutersVRouterSetTypeVRouter详情VRouterSetType组成的集合TotalCountInteger列表条条目数PageNumberInteger当前页码PageSizeInteger当前分页包含多少条目错误代码描述Http状态码语义Forbidden.
RegionNotFoundSpecifiedregionisnotfoundduringaccessauthentication.
404指定的Region不存在https://vpc.
aliyuncs.
com/Action=DescribeVRouters&RegionId=cn-beijing专有网络VPC开发指南23返回示例XML格式JSON格式&C2C6EF61-53B7-4071-A87D-B42F1F17FA5Avpc-257gq642nvrt-25bezkd03vtb-25wm68mnh2014-10-29T13:30:19Z{"PageNumber":1,"PageSize":10,"RequestId":"C2C6EF61-53B7-4071-A87D-B42F1F17FA5A","TotalCount":1,"VRouters":{"VRouter":[{"CreationTime":"2014-10-29T13:30:19Z","Description":"","RegionId":"cn-beijing","RouteTableIds":{"RouteTableId":["vtb-25wm68mnh"]},"VRouterId":"vrt-25bezkd03","VRouterName":"","VpcId":"vpc-257gq642n"}]}}专有网络VPC开发指南24修改路由器属性描述修改指定VRouter的属性请求参数返回参数全是公共返回参数,详见公共返回参数错误码名称类型是否必须描述ActionString是系统规定参数,取值:ModifyVRouterAttributeVRouterIdString是需要修改的VRouter的IDVRouterNameString否修改后的VRouter名字,不填则为空,默认值为空,[2,128]英文或中文字符,必须以大小字母或中文开头,可包含数字,"_"或"-",这个值会展示在控制台.
不能以http://和https://开头.
DescriptionString否修改后的VRouter描述,不填则为空,默认值为空,[2,256]英文或中文字符,不能以http://和https://开头.
错误代码描述Http状态码语义InvalidVRouterId.
NotFoundSpecifiedvirtualrouterdoesnotexist.
404指定的路由器不存在InvalidVRouterName.
MalformedSpecifiedvirtualrouternameisnot400指定的路由器名字格式不符合要求专有网络VPC开发指南25示例请求示例返回示例XML格式JSON格式交换机新建交换机valid.
InvalidVRouterDiscription.
MalformedSpecifiedvirtualrouterdescriptionisnotvalid.
400指定的路由器描述信息格式不符合要求https://vpc.
aliyuncs.
com/Action=ModifyVRouterAttribute&VRouterId=vrt-25bezkd03&VRouterName=VRouter&CEF72CEB-54B6-4AE8-B225-F876FF7BA984{"RequestId":"E0AAA98E-8E3C-4C11-95F3-5E2B8AD51703"}专有网络VPC开发指南26------------描述在指定VPC内创建一个新的VSwitch.
VSwitch下的云产品实例不能分布在不同可用区.
每个VPC的VSwitch数量不允许超过24个.
每个VSwitch的掩码为16-29位,可以提供8-65535个IP地址.
每个VSwitch的第1个和最后3个IP地址为系统保留(以192.
168.
1.
0/24为例,192.
168.
1.
0和192.
168.
1.
255以及192.
168.
1.
253-254这些地址是系统保留地址).
VSwitch不支持组播和广播.
VSwitch的CIDRBlock,必须从属于所在VPC的CIDRBlock.
VSwitch的CIDRBlock可以与所在VPC的CIDRBlock相同,但这意味着您的VPC只能拥有1个VSwitch.
VSwitch的CIDRBlock,不能与所在VPC当前RouteEntry的DestCIDRBlock相同.
VSwitch的CIDRBlock,不能包含所在VPC当前RouteEntry的DestCIDRBlock,但可以是当前RouteEntry的DestCIDRBlock的子集.
VSwitch创建成功后,CidrBlock无法修改.
VSwitch下的云产品实例数量不允许超过VPC剩余的可用云产品实例数量(10000-当前云产品实例数量).
1个云产品实例只能属于1个VSwitch.
请求参数名称类型是否必须描述ActionString是系统规定参数,取值:CreateVSwitchZoneIdString是可用区IdCidrBlockString是指定VSwitch的网段VpcIdString是指定VSwitch所在的VPCVSwitchNameString否VSwitch名称,不填则为空,默认值为空,[2,128]英文或中文字符,必须以大小字母或中文开头,可包含数字,"_"或"-",这个值会展示在控制台.
不能以http://和https://开头DescriptionString否VSwitch描述,不填则为空,默认值为空,[2,256]英文或中文字符,不能以http://和https://开头ClientTokenString否用于保证请求的幂等性专有网络VPC开发指南27返回参数错误码.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符名称类型描述VSwitchIdString系统分配的VSwitchID错误代码描述Http状态码语义InvalidZoneId.
NotFoundSpecifiedzonedoesnotexist.
404指定的可用区不存在InvalidVpcId.
NotFoundSpecifiedVPCdoesnotexist.
404指定的VPC不存在InvalidCidrBlock.
MalformedSpecifiedCIDRblockisnotvalid.
400指定的CIDR格式不正确InvalidVSwitchName.
MalformedSpecifiedvirtualswitchnameisnotvalid.
400指定的VSwitch名字格式不正确InvalidVSwitchDiscription.
MalformedSpecifiedvirtualswitchdescriptionisnotvalid.
400指定的VSwitch描述信息格式不正确ResourceNotAvailableResourceyourequestedisnotavailableinthisregionorzone.
400指定的Region或者可用区不支持VPCInvalidParameterSpecifiedCIDRblockisnotvalidinVPC.
400指定的CIDR不正确InvalidCidrBlock.
OverlappedSpecifiedCIDRblockoverlappedwithothersubnets.
400指定的CIDR与其他VSwitch的CIDR重叠InvalidCidrBlock.
OverlappedSpecifiedCIDRblockoverlappedwithotherentry400指定的CIDR与已有的自定义路由的CIDR重叠QuotaExceeded.
VSwitchVirtualswitchquotaexceeded.
400VSwitch数量达到配额上限IncorretRouteEntryStatusSomerouteentrystatusblockedthisoperation.
400部分自定义路由处于pending状态,创建VSwitch失败IncorretVSwitchStatSomevirtualswitch400部分VSwitch处于专有网络VPC开发指南28示例请求示例返回示例XML格式JSON格式删除交换机usismodifyingwithinthesameVPC.
pending状态,创建VSwitch失败InvalidCirdrBlock.
MaskLengthSpecifiedCIDRblockisnotvalid.
400指定的CIDR网段格式不正确IncorrectVpcStatusCurrentVPCstatusdoesnotsupportthisoperation.
400指定的VPC处于pending状态,创建VSwitch失败https://vpc.
aliyuncs.
com/Action=CreateVSwitch&CidrBlock=172.
16.
1.
0/24&VpcId=vpc-257gq642n&ZoneId=cn-beijing-a&861E6630-AEC0-4B2D-B214-6CB5E44B7F04vsw-25naue4gz{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","VSwitchId":"vsw-25naue4gz"}专有网络VPC开发指南29----描述删除指定的VSwitch只允许删除Available状态下的VSwitch删除VSwitch之前,需要先释放或移走VSwitch下的所有产品实例,比如ECS实例指定RouteTable所在的VPC正在创建/删除VSwitch或正在创建/删除RouteEntry操作时,无法进行删除VSwitch操作删除VSwitch之前,需要先释放该VSwitch下所有的HaVip实例请求参数返回参数全是公共返回参数,详见公共返回参数错误码名称类型是否必须描述ActionString是系统规定参数,取值:DeleteVSwitchVSwitchIdString是需要删除的VSwitch的Id错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在IncorrectVSwitchStatusThecurrentvirtualswitchstatusdoesnotsupportthisoperation.
400指定的VSwitch处于pending状态,无法删除DependencyViolationSpecifiedobjecthasdependentresources.
400指定的VSwitch还有资源未释放,无法删除DependencyViolation.
HaVipVSwitchcannotbedeletedwhentherearesomeHaVipdependentwithit.
400指定的VSwitch还有HaVip资源未释放,无法删除IncorretRouteEntryStatusSomerouteentrystatusblockedthisoperation.
400部分自定义路由条目处于pending状态,无法删除专有网络VPC开发指南30示例请求示例返回示例XML格式JSON格式查询交换机列表描述查询用户的VSwitch列表.
此接口支持分页查询,每页的数量默认为10条.
该接口只会校验参数的合法性,不会校验参数之间的依赖关系,返回结果是所有条件的"交集".
请求参数https://vpc.
aliyuncs.
com/Action=DeleteVSwitch&VSwitchId=vsw-25naue4gz&AF083E3D-7E29-4B77-A937-1F129802D5F3{"RequestId":"AF083E3D-7E29-4B77-A937-1F129802D5F3"}名称类型是否必须描述ActionString是系统规定参数,取值:DescribeVSwitchesRegionIdString是地域ID专有网络VPC开发指南31返回参数错误码示例请求示例VpcIdString否VPCIDVSwitchIdString否需要查询的VSwitch的IdZoneIdString否可用区IdIsDefaultBoolean否是否为所属可用区下的默认交换机,可选值:true——是false——否不填写该参数时返回所有交换机IdPageNumberInteger否实例状态列表的页码,起始值为1,默认值为1PageSizeInteger否分页查询时设置的每页行数,最大值50行,默认为10名称类型描述VSwitchesVSwitchTypeVSwitch详情VSwitchSetType组成的集合TotalCountInteger列表条条目数PageNumberInteger当前页码PageSizeInteger当前分页包含多少条目错误代码描述Http状态码语义Forbidden.
VpcNotFoundSpecifiedVPCisnotfoundduringaccessauthentication.
404指定的VPC不存在https://vpc.
aliyuncs.
com/Action=DescribeVSwitches&VpcId=vpc-25eq58pl3&专有网络VPC开发指南32返回示例XML格式JSON格式9A572171-4E27-40D1-BD36-D26C9E71E29Evsw-25b7pv15tAvailable172.
16.
1.
0/24cn-beijing-a246vpc-257gq642n2014-10-29T15:21:02Z{"PageNumber":1,"PageSize":10,"RequestId":"9A572171-4E27-40D1-BD36-D26C9E71E29E","TotalCount":1,"VSwitches":{"VSwitch":[{"AvailableIpAddressCount":246,"CidrBlock":"172.
16.
1.
0/24","CreationTime":"2014-10-29T15:21:02Z","Description":"","Status":"Available","VSwitchId":"vsw-25b7pv15t","VSwitchName":"","VpcId":"vpc-257gq642n","ZoneId":"cn-beijing-a"}]}}专有网络VPC开发指南33修改交换机属性描述修改指定VSwitch的属性请求参数返回参数全是公共返回参数,详见公共返回参数错误码名称类型是否必须描述ActionString是系统规定参数,取值:ModifyVSwitchAttributeVSwitchIdString是需要修改的VSwitch的IDVSwitchNameString否VSwitch名称,不填则为空,默认值为空,[2,128]英文或中文字符,必须以大小字母或中文开头,可包含数字,"_"或"-",这个值会展示在控制台.
不能以http://和https://开头.
DescriptionString否修改后的VSwitch描述,不填则为空,默认值为空,[2,256]英文或中文字符,不能以http://和https://开头.
错误代码描述Http状态码语义InvalidVSwitchId.
NotFoundThespecifiedvirtualswitchdoesnotexists.
404指定的VSwitch不存在InvalidVSwitchName.
MalformedSpecifiedvirtualswitchnameisnot400指定的VSwitch名字格式不正确专有网络VPC开发指南34示例请求示例返回示例XML格式JSON格式路由表新建自定义路由描述valid.
InvalidVSwitchDiscription.
MalformedSpecifiedvirtualswitchdescriptionisnotvalid.
400指定的VSwitch描述内容格式不正确https://vpc.
aliyuncs.
com/Action=ModifyVSwitchAttribute&VSwitchId=vpc-257gq642n&C0FD0EED-F90D-4479-803D-DD62335357E5{"RequestId":"C0FD0EED-F90D-4479-803D-DD62335357E5"}专有网络VPC开发指南35------------------新建RouteEntry支持在专有网络中的路由器(VRouter)和高速通道中的边界路由器(VBR)上的路由表(RouteTable)里,新建RouteEntry在专有网络中的路由器上的RouteTable中创建RouteEntry:同一个路由表中自定义路由条目不能超过48条RouteEntry的DestinationCidrBlock不允许和VPC内VSwitch的CIDRBlock相同,也不允许包含VSwitch的CIDRBlock或者被VSwitch的CIDRBlock包含RouteEntry的DestCidrBlock网段不允许指向100.
64.
0.
0/10,也不允许被100.
64.
0.
0/10包含同一RouteTable下RouteEntry的DestCidrBlock不允许相同如果指定的DestinationCidrBlock是一个IP地址,会按照掩码为32位来处理多条RouteEntry允许指向同一个InstanceIdRouteEntry指定的下一跳InstanceId,必须属于所在的VPC一个VPC内,指向HaVip的路由条目最多可以同时存在5条;支持通过NextHopList参数配置ECMP路由在边界路由器上的RouteTable中新建RouteEntry同一个路由表中自定义路由条目不能超过48条不支持NextHopList参数RouteEntry的DestCidrBlock网段不允许指向100.
64.
0.
0/10,也不允许被100.
64.
0.
0/10包含同一RouteTable下RouteEntry的DestCidrBlock不允许相同如果指定的DestinationCidrBlock是一个IP地址,会按照掩码为32位来处理多条RouteEntry允许指向同一个InstanceIdRouteEntry指定的下一跳InstanceId,必须属于所在的VBRRouteEntry的下一跳类型仅支持RouterInterface只允许在VBR状态是Active,而且对应的物理专线状态是Enabled且没有被欠费锁定的情况下在VBR上新建RouteEntry请求参数名称类型是否必须描述ActionString是系统规定参数,取值:CreateRouteEntryRouteTableIdString是RouteTableIdDestinationCidrBlockString是RouteEntry的目的网段NextHopTypeString否下一跳的类型,可选值为Instance|Tunnel|HaVip|RouterInterface,默认值为Instance,即ECS实例NextHopIdString否路由条目的下一跳实例专有网络VPC开发指南36返回参数全是公共返回参数,详见公共返回参数错误码ID,非ECMP路由NextHopListNextHopListType否路由条目的下一跳列表如果指定了NextHopList,则该路由为ECMP类路由,NextHopList包含了ECMP方式的多个下一跳.
此时NextHopType和NextHopId必须为空,NextHopList支持包含有2-4个下一跳.
只支持VRouter上的路由指定NextHopList,而且下一跳只能是从VRouter连往VBR方向的RouterInterface如果没有指定NextHopList,则该路由为非ECMP类路由.
由NextHopType和NextHopId指定下一跳.
ClientTokenString否用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
具体参见附录:如何保证幂等性.
错误代码描述Http状态码语义MissingParameterMissmandatoryparameter.
400缺少必要参数参数InvalidCidrBlock.
MalformedSpecifiedCIDRblockisnotvalid.
400指定的网段不合法InvalidNextHopId.
NotFoundSpecifiednexthopdoesnotexist.
404指定的NextHopId不存在InvalidInstanceId.
NotFoundSpecifiedinstancedoesnotexist.
404指定的ECS实例不存在(实例不在该vpc下)InvalidRouteTableId.
NotFoundSpecifiedroutetabledoesnotexist.
404指定的虚拟路由表不存在专有网络VPC开发指南37InvalidCIDRBlock.
DuplicateSpecifiedCIDRblockisalreadyexists.
400指定的网段已经在该路由表中存在IncorrectVpcStatusCurrentVPCstatusdoesnotsupportthisoperation.
400所指定的VPC未创建完成QuotaExceededRouteentryquotaexceededinthisroutetable.
400同一个路由表中自定义路由条目不能超过48条IncorretRouteEntryStatusSomerouteentrystatusblockedthisoperation.
400同一个vpc下面的路由表中的任一个路由条目/VSwitch处在中间状态(添加中,修改中,删除中),不能创建路由条目InvalidCidrBlockSpecifiedCIDRblockisnotvalid.
4001.
该用户不在10.
0.
0.
0/8的路由网段的白名单中,不能使用该网段.
2.
添加的自定义路由目标网段不能从属于同一个vpc下面所有vswitch的网段.
3.
网段不能是:100.
64.
0.
0/10.
InvalidNextHop.
NotFoundSpecifiednexthopdoesnotexist.
404指定的nexthop不存在InvalidNexthopTypeAndList.
BothNullbothnexthopTypeandnextHopListarenull.
400NexthopType和NextHopList不能同时为空InvalidHaViNpId.
NotFoundThespecifiedHaVipdoesnotexistinthespecifiedVPC.
404指定的HaVip不存在,或者不属于当前RouterTable所在的VPC.
InvalidRouterInterfaceinvalidrouterinterface.
400指定的RouterInterface不合法InvalidOppositeRouterTypenexthoplistcannotonlycontainrouterinterfacewhoseoppositerouterinterfaceisonvbr.
400NextHopList只能包含对端路由器接口在VBR上的路由器接口InvalidNexthopListSizenexthopsizeisillegal.
Mustbebetween2and4.
400NextHopList中需要包含2-4个下一跳CountLimitExceed.
HaVipRouteEntryTherecanbe5routeentrytoHaVipatmostinoneroutetable.
400一个VPC内,指向HaVip对象的路由最多同时只能存在五条.
IncorrectHaVipStatuThisoperationis400只有当HaVip的状态为专有网络VPC开发指南38示例请求示例返回示例XML格式JSON格式sdeniedbecausesatusofthespecifiedHaVipisneitherAvailablenorInUse.
Available或者InUse时,创建指向这个HaVip的路由.
InvalidVBRStatusinvalidvirtualborderrouterstatus.
400VBR状态不合法InvalidPhysicalConnectionBusinessStatusinvalidphysicalconnectionbusinessstatus.
400物理专线业务状态被锁定InvalidRouterTypeCannotspecifynexthoplistinvbr'sroutetable.
400不能在VBR的路由表中指定NextHopListInvalidRouteEntry.
DuplicateTherouteentryalreadyexist.
400该路由条目已经存在IncorrectInstanceStatusThecurrentstatusoftheresourcedoesnotsupportthisoperation.
403指定实例的状态不支持当前操作https://vpc.
aliyuncs.
com/Action=CreateRouteEntry&VpcId=vpc-257gq642n&RouteTableId=vrt-5citwfp6a&DestinationCidrBlock=0.
0.
0.
0/0&NextHopId=i-25skktcp4&NextHopType=Instance&12D086F6-8F31-4658-84C1-006DED011A85专有网络VPC开发指南39----删除自定义路由描述删除专有网络中的路由器(VRouter)和高速通道中的边界路由器(VBR)上的路由表(RouteTable)里指定的RouteEntry删除专有网络中的路由器上的RouteTable中的RouteEntry:只允许删除状态为Available的RouteEntryRouteTable所在的VPC正在进行创建/删除VSwitch或创建/删除RouteEntry操作时,无法进行删除RouteEntry删除边界路由器上RouteTable中的RouteEntry:只允许删除状态为Available的RouteEntry当RouteTable正在进行创建/删除RouteEntry操作时,无法进行删除RouteEntry请求参数{"RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"}名称类型是否必须描述ActionString是系统规定参数,取值:DeleteRouteEntryRouteTableIdString是RouteEntry所在的RouteTableId,支持VPC路由器和边界路由器上的RouteTableDestinationCidrBlockString否RouteEntry的目标网段NextHopIdString否RouteEntry指向的下一跳实例的Id,非ECMP类路由必须指定NextHopId而且必须与被删除路由的NextHopId匹配NextHopListNextHopListType否路由条目的下一跳列表ECMP类路由必须指定专有网络VPC开发指南40返回参数全是公共返回参数,详见公共返回参数错误码示例请求示例返回示例NextHopList而且必须与被删除路由的NextHopList匹配.
错误代码描述Http状态码语义IncorrectRouteEntryStatusSomerouteentrystatusblockedthisoperation.
4001.
同一个VPC下面的路由表中的任一个路由条目处在中间状态(添加中,修改中,删除中),不能删除路由条目.
2.
同一个VPC下的VSwitch处在中间状态(创建中,删除中),不能再删除路由条目.
MissingParameterMissmandatoryparameter.
400缺少必要参数InvalidCidrBlock.
MalformedSpecifiedCIDRblockisnotvalid.
400CidrBlock输入格式有误InvalidRouteTableId.
NotFoundSpecifiedroutetabledoesnotexist.
404RouteTableId不存在OperationDeniedSpecifiedoperationisdeniedasrouteentrytypeissystem.
400不允许删除System的路由项https://vpc.
aliyuncs.
com/Action=DeleteRouteEntry&RouterTableId=vtb-25vtxl5ct&DestinationCidrBlock=192.
168.
1.
0/24&NextHopId=i-25skktcp4&专有网络VPC开发指南41--XML格式JSON格式查询路由表列表描述支持查询专有网络中的路由器(VRouter)和高速通道中的边界路由器(VBR)上的路由表(RouteTable)查询用户名下路由表的列表.
此接口支持分页查询,每页的数量默认为10条.
该接口只会校验参数的合法性,不会校验参数之间的依赖关系,返回结果是所有条件的"交集".
请求参数4357FA74-F9F3-46E7-8890-AA30EC4F8D4F{"RequestId":"4357FA74-F9F3-46E7-8890-AA30EC4F8D4F"}名称类型是否必须描述ActionString是系统规定参数,取值:DescribeRouteTablesRouterTypeString否所属的路由器类型.
可选值:VRouter,VBRRouterIdString否所属的路由器ID.
VRouterID或VBRID.
VRouterIdString否所属专有网络路由器ID.
指定VRouterId自动指定RouterType为VRouter.
RouteTableIdString否RouteTableIdPageNumberInteger否实例状态列表的页码专有网络VPC开发指南42返回参数错误码示例请求示例返回示例XML格式,起始值为1,默认值为1PageSizeInteger否分页查询时设置的每页行数,最大值50行,默认为10名称类型描述RouteTablesRouteTableSetTypeRouteTable详情RouteTableSetType的集合TotalCountInteger列表条条目数PageNumberInteger当前页码PageSizeInteger当前分页包含多少条目https://vpc.
aliyuncs.
com/Action=DescribeRouteTables&VRouterId=vrt-25u5f8u2q&913F8774-681A-4857-95D8-ACBAF044D453routetable01192.
168.
10.
1/32Customi-25skktcp4Availablevtb-25vtxl5ct专有网络VPC开发指南43JSON格式192.
168.
1.
0/24vtb-25vtxl5ctAvailableSystem100.
64.
0.
0/10vtb-25vtxl5ctAvailableSystem10.
0.
0.
0/8vtb-25vtxl5ctAvailableSystemvtb-25vtxl5ctSystemvrt-25u5f8u2q2014-09-11T04:52:53Z{"PageNumber":1,"PageSize":10,"RequestId":"913F8774-681A-4857-95D8-ACBAF044D453","RouteTables":{"RouteTable":[{"CreationTime":"2014-09-11T04:52:53Z","RouteEntrys":{"RouteEntry":[{"DestinationCidrBlock":"192.
168.
10.
1/32","InstanceId":"i-25skktcp4","RouteTableId":"vtb-25vtxl5ct","Status":"Available","Type":"Custom"},{"DestinationCidrBlock":"192.
168.
1.
0/24","InstanceId":"","RouteTableId":"vtb-25vtxl5ct","Status":"Available","Type":"System"专有网络VPC开发指南44---弹性公网IP申请弹性公网IP申请弹性公网IP描述申请EIP,新申请的EIP状态为Available.
EIP目前只能绑定到相同地域的VPC类型的ECS实例.
每次申请会在指定的Region内随机分配一个EIP.
EIP目前只支持ICMP,TCP,UDP3种协议,不支持IGMP,SCTP等传输层协议.
},{"DestinationCidrBlock":"100.
64.
0.
0/10","InstanceId":"","RouteTableId":"vtb-25vtxl5ct","Status":"Available","Type":"System"},{"DestinationCidrBlock":"10.
0.
0.
0/8","InstanceId":"","RouteTableId":"vtb-25vtxl5ct","Status":"Available","Type":"System"}]},"RouteTableId":"vtb-25vtxl5ct","RouteTableType":"System","VRouterId":"vrt-25u5f8u2q"}]},"TotalCount":1}专有网络VPC开发指南45请求参数返回参数错误码名称类型是否必须描述ActionString是系统规定参数,取值:AllocateEipAddressRegionIdString是申请的弹性公网IP所在的地域BandwidthString否弹性公网IP的限速,如果不指定,默认为5Mbps.
InternetChargeTypeString否PayByBandwidth和PayByTraffic,默认是PayByBandwidthClientTokenString否用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
具体参见附录名称类型描述EipAddressString分配的弹性公网IPAllocationIdString弹性公网IP的实例Id错误代码描述Http状态码语义ForbbidenUsernotauthorizedtooperateonthespecifiedresource.
403用户没有使用EIP产品的权限,请提交工单申请QuotaExceeded.
EipElasticIPaddressquotaexceeded.
400EIP的个数超过额度限制InvalidRegionId.
NotFoundSpecifiedvalueof"RegionId"isnotsupported.
404指定的RegionId不存在InvalidParameterSpecifiedvalueof"InternetChargeType"isnotvalid400指定的InternetChargeType参数不合法InvalidParameterSpecifiedvalueof"Bandwidth"is400指定的Bandwidth参数不合法专有网络VPC开发指南46示例请求示例返回示例XML格式JSON格式绑定弹性公网IP描述将EIP绑定到相同地域的云服务实例或HaVip实例上notvalid.
InsufficientEipCapacityInsufficientEIPcapacitytofulfillyourrequest.
500指定Region的EIP库存不足InsufficientBalanceYouraccountdoesnothaveenoughbalance.
400账户余额不足,无法申请EIPhttps://vpc.
aliyuncs.
com/Action=AllocateEipAddress&RegionId=cn-beijing&eip-25877c70x123.
56.
0.
206B6B9F518-60F8-4D81-9242-1207B356754D{"AllocationId":"eip-25877c70x","EipAddress":"123.
56.
0.
206","RequestId":"B6B9F518-60F8-4D81-9242-1207B356754D"}专有网络VPC开发指南47---------目前EIP只支持绑定到ECS实例和HaVip实例上只有Available状态的EIP才能够进行绑定操作EIP绑定成功后立刻生效,不需要重启云服务器实例EIP目前只能被绑定到相同地域的专有网络类型云服务器实例上每个云服务器实例或HaVip实例只能同时绑定一个EIP每个EIP同一时间只能绑定一个云产品实例只有处于运行中和已停止状态的云服务器实例可以绑定弹性公网IP只有处于Available或者InUse状态的HaVip可以绑定弹性公网IP因为安全原因被锁定的EIP无法进行绑定和解绑操作请求参数返回参数全是公共返回参数,详见公共返回参数错误码名称类型是否必须描述ActionString是系统规定参数,取值:AssociateEipAddressAllocationIdString是需要进行绑定操作的EIP的申请Id,申请Id是EIP的唯一标识InstanceTypeString否绑定的对象类型.
取值范围:EcsInstance|HaVip默认值:EcsInstanceInstanceIdString是需要进行绑定操作的实例id.
若InstanceType为EcsInstance,则此处填写ECS实例Id;若InstanceType为HaVip,则此处填写HaVipId;错误代码描述Http状态码语义InvalidAssociation.
DuplicatedSpecifiedinstancealreadyisassociated.
400指定的ECS实例已绑定EIP,不能再绑定.
OperationDeniedSpecifiedinstanceisnotinVPC.
400指定的ECS实例不是VPC类型实例,绑定失败.
专有网络VPC开发指南48示例请求示例InvalidParameter.
MismatchSpecifiedelasticIPaddressandECSinstancearenotinthesameregion.
400指定ECS实例和EIP不属于同一个regionIncorrectEipStatusCurrentelasticIPstatusdoesnotsupportthisoperation.
400指定的EIP状态不支持此操作InvalidAllocationId.
NotFoundSpecifiedallocationIDisnotfound.
404指定的EIP的申请ID不存在,绑定失败InvalidInstanId.
NotFoundSpecifiedinstancedoesnotexist.
404指定的ECS实例不存在,绑定失败IncorrectInstanceStatusCurrentinstancestatusdoesnotsupportthisoperation.
400指定的ECS实例状态为非stop和running,绑定EIP失败InvalidInstanceType.
ValueNotSupportedThespecifiedvalueofInstanceTypeisnotsupported.
400InstanceType的输入值不合法InvalidHaVip.
NotFoundThespecifiedHaVipdoesnotexist.
404InstanceType为HaVip,且InstanceId并不是一个真实存在的有效HaVipId.
CountLimitExceeded.
EIPOnECSInstanceOneECSInstancecanbeassociatedwithonlyoneEIP.
400ECS实例上允许绑定的EIP数量已经达到上限CountLimitExceed.
EIPOnHaVipOneHaVipcanbeassociatedwithonlyoneEIP.
400HaVip上允许绑定的EIP数量已经达到上限IncorrectHaVipStatusHaVipcanbeoperatedbythisactiononlywhenit'sstatusisAvailableorInUse.
400HaVip状态不符合要求https://vpc.
aliyuncs.
com/Action=AssociateEipAddress&AllocationId=eip-25877c70x&InstanceId=i-25skktcp4&专有网络VPC开发指南49--返回示例XML格式JSON格式解绑弹性公网IP描述解除一个EIP的绑定状态.
若EIP当前的绑定对象为ECS实例,则只有状态为运行中或已停止的ECS实例,才能够执行解绑操作.
若EIP当前的绑定对象为HaVip实例,则只有状态为InUse的HaVip实例,才能够执行解绑操作.
请求参数CEF72CEB-54B6-4AE8-B225-F876FF7BA984{"RequestId":"C0FD0EED-F90D-4479-803D-DD62335357E5"}名称类型是否必须描述ActionString是系统规定参数,取值:UnassociateEipAddressAllocationIdString是EIP实例IdInstanceTypeString否绑定的对象类型.
取值范围:ECSInstance|HaVip默认值:ECSInstanceInstanceIdString是需要进行解绑操作的具体对象Id.
专有网络VPC开发指南50返回参数全是公共返回参数,详见公共返回参数错误码示例请求示例错误代码描述Http状态码语义IncorrectEipStatusCurrentelasticIPstatusdoesnotsupportthisoperation.
400指定的EIP的当前状态不支持解绑操作.
InvalidAllocationId.
NotFoundSpecifiedallocationIDisnotfound.
404指定的EIP的申请Id不存在,解绑失败.
InvalidInstanceId.
NotFoundSpecifiedinstancedoesnotexist.
400指定的ECS实例不存在,解绑失败.
IncorrectInstanceStatusThecurrentstatusofinstancedoesnotsupportthisoperation.
400指定ECS实例当前状态不支持解绑操作,解绑操作失败.
InvalidInstanceType.
ValueNotSupportedThespecifiedvalueofInstanceTypeisnotsupported.
400InstanceType的输入值不合法InvalidHaVip.
NotFoundThespecifiedHaVipdoesnotexist.
404InstanceType为HaVip,且InstanceId并不是一个真实存在的有效HaVipId.
ResourceNotAssociatedThespecifiedresourcesarenotassociated.
400指定的要解绑定的资源并没有绑定在一起.
IncorrectHaVipStatusThisoperationisdeniedbecausesatusofthespecifiedHaVipisneitherAvailablenorInUse.
400只有当HaVip的状态为Available或者InUse时,才允许将一个EIP与一个HaVip解绑.
https://vpc.
aliyuncs.
com/Action=UnassociateEipAddress&AllocationId=eip-2578g5v5a专有网络VPC开发指南51-返回示例XML格式JSON格式查询弹性公网IP列表描述查询指定地域的EIP列表.
此接口支持分页查询,每页的数量默认为10条.
此接口不会校验参数之间的依赖关系,返回结果是所有条件的"交集".
请求参数&InstanceId=i-25skktcp4&220F3179-5238-47F0-A0CA-1272AA2BC41F{"RequestId":"220F3179-5238-47F0-A0CA-1272AA2BC41F"}名称类型是否必须描述ActionString是系统规定参数,取值:DescribeEipAddressesRegionIdString是需要查询的地域StatusString否Eip状态,包括Associating|Unassociating|InUse|AvailableEipAddressString否EIP专有网络VPC开发指南52返回参数错误码AllocationIdString否申请IdAssociatedInstanceTypeString否绑定的资源的类型;这是一个过滤器性质的参数,若不指定,则表示不使用该条件对结果进行过滤.
取值范围:EcsInstance|HaVipAssociatedInstanceIdString否绑定的资源的Id.
这是一个过滤器性质的参数,若不指定,则表示不适用该条件对结果进行过滤.
如果要使用该过滤器,必须同时使用AssociatedInstanceType.
如果AssociatedInstanceType是HaVipId,则该参数填写HaVipId;若AssociatedInstanceType是EcsInstance,则该参数填写EcsInstancdId.
PageNumberInteger否实例状态列表的页码,起始值为1,默认值为1PageSizeInteger否分页查询时设置的每页行数,最大值50行,默认为10名称类型描述EipAddressesEipAddressSetType弹性IP地址详情EipAddressSetType组成的集合TotalCountInteger列表条条目数PageNumberInteger当前页码PageSizeInteger当前分页包含多少条目错误代码描述Http状态码语义Forbidden.
RegionNotFoundSpecifiedregionisnotfoundduring404指定的region不存在专有网络VPC开发指南53示例请求示例返回示例XML格式JSON格式accessauthentication.
InvalidIAssociatedInstanceType.
ValueNotSupportedThespecifiedvalueofAssociatedInstanceTypeisnotsupported.
400AssociatedInstanceType的输入值不合法.
https://vpc.
aliyuncs.
com/Action=DescribeEipAddresses&RegionId=cn-hangzhou-1&51BE7822-4121-428A-88F3-262AE4FD868Dcn-beijingeip-2578g5v5a123.
56.
0.
36Available5PayByBandwidth2014-05-28T03:03:16Z{"EipAddresses":{"EipAddress":[{"AllocationId":"eip-2578g5v5a",专有网络VPC开发指南54-修改弹性公网IP属性修改弹性公网IP属性描述修改指定EIP的属性,目前主要用于修改EIP的带宽限速EIP的带宽限速可以无限次修改,新配置即时生效.
请求参数"AllocationTime":"2014-05-28T03:03:16Z","Bandwidth":"1","InstanceId":"","InternetChargeType":"PayByBandwidth","IpAddress":"123.
56.
0.
36","OperationLocks":{"LockReason":[]},"RegionId":"cn-beijing","Status":"Available"}]},"PageNumber":1,"PageSize":10,"RequestId":"51BE7822-4121-428A-88F3-262AE4FD868D","TotalCount":1}名称类型是否必须描述ActionString是系统规定参数,取值:ModifyEipAddressAttributeAllocationIdString是申请IdBandwidthString是修改后的弹性IP地址带宽,带宽以Mbps计算.
专有网络VPC开发指南55返回参数全是公共返回参数,详见公共返回参数错误码示例请求示例返回示例XML格式JSON格式错误代码描述Http状态码语义InvalidParameterSpecifiedvalueof"Bandwidth"isnotsupported.
400指定带宽值不合法InsufficientBalanceYouraccountdoesnothaveenoughbalance.
400账号已欠费,修改EIP的带宽操作失败.
InvalidAllocationId.
NotFoundSpecifiedallocationIDisnotfound.
404指定的EIP的申请Id不存在.
https://vpc.
aliyuncs.
com/Action=ModifyEipAddressAttribute&AllocationId=eip-25877c70x&Bandwidth=1&2C63EA73-A1E7-4C46-B8BC-E7C2E543E5E8{"RequestId":"2C63EA73-A1E7-4C46-B8BC-E7C2E543E5E8"}专有网络VPC开发指南56-释放弹性公网IP描述释放EIP,释放后的IP地址,不再属于您的名下只有Available状态的EIP才可以释放请求参数返回参数全是公共返回参数,详见公共返回参数错误码示例请求示例名称类型是否必须描述ActionString是系统规定参数,取值:ReleaseEipAddressAllocationIdString是要执行释放操作的EIP对应的申请Id错误代码描述Http状态码语义IncorrectEipStatusCurrentelasticIPstatusdoesnotsupportthisoperation.
400指定的EIP的当前状态不支持释放,释放操作失败.
https://vpc.
aliyuncs.
com/Action=ReleaseEipAddress&AllocationId=eip-25877c70x&专有网络VPC开发指南57返回示例XML格式JSON格式查询公网IP地址段注意:本API目前仅供白名单中的阿里云合作伙伴调用.
调用本API前请联系您的阿里云销售经理或商业经理来将您的帐户加入到白名单中.
相关SDK将在数周后发布.
关于如何调用API,请参见请求结构.
概述查询指定地域的公网IP地址段.
请求参数748C38F6-9A3D-482E-83FB-DB6C39C68AEA{"RequestId":"748C38F6-9A3D-482E-83FB-DB6C39C68AEA"}名称类型是否必需描述ActionString是系统规定参数,取值:DescribePublicIpAddressRegionIdString是指定查询的地域,详情参见地域与可用区.
PageNumberInteger否公网IP地址列表的页码,起始值为1.
默认值:1专有网络VPC开发指南58返回参数错误码示例请求示例返回示例PageSizeInteger否分页查询时设置的每页行数.
默认值:100名称类型描述PublicIpAddressString指定地域的公网IP地址范围.
TotalCountString列表条目数.
PageNumberInteger当前页码.
PageSizeInteger当前分页包含多少条目.
错误码错误信息HTTP状态码说明Forbidden.
RegionNotFoundSpecifiedregionisnotfoundduringaccessauthentication.
404指定的地域不存在.
请参考地域和可用区,以查找每个地域的ID.
Forbidden.
Usernotauthorizedtooperateonthespecifiedresource.
403您没有操作指定资源的权限.
请参考API授权,以获取授权.
https://vpc.
aliyuncs.
com/Action=DescribePublicIpAddress&RegionId=cn-beijing&{"RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710","Code":200,"Success":"true/false","PublicIpAddress":["110.
11.
1.
0/24"],"RegionId":"cn-beijing",专有网络VPC开发指南59API授权当调用本API时,请确认您已为API授权.
授权可以通过调用API或RAM控制台添加以下策略来实现为API授权.
详情参见授权策略管理.
物理专线"PageNumber":1,"PageSize":100,"TotalCount":1000}{"Version":"1","Statement":[{"Action":["vpc:DescribePublicIpAddress*",],"Resource":"*","Effect":"Allow"}]}专有网络VPC开发指南60---申请物理专线接入描述客户申请专线接入,在同一时间,处于enabled状态之外的物理专线不得超过5条.
若用户名下有物理专线处于欠费状态,则不允许新建更多的物理专线.
新创建的物理专线为Initial状态.
请求参数名称类型是否必须描述ActionString是系统规定参数,取值:CreatePhysicalConnectionRegionIdString是所在地域(管理实例的RegionID)AccessPointIdString是申请接入物理专线所在的接入点ID,所选择的接入点必须存在且处于可接入的状态.
TypeString否专线类型,默认值:VPC;可选值:VPC-VPC类型专线CircuitCodeString否专线侧接口对应运营商的电路编码.
LineOperatorString是提供接入物理线路的运营商,可选值:CT-中国电信-CU-中国联通-CM-中国移动-CO-中国其他-Equinix-Equinix-Other-境外其他-PeerLocationString是专线对端所在物理位置(地址).
[2,256]个字专有网络VPC开发指南61符,不能以http://和https://开头.
BandwidthString否物理专线接入接口带宽,单位Mbps,默认值:100,可选值:[2-10000]PortTypeString否物理专线接入端口类型,默认为1000Base-T,如不清楚可以不填写,可选值:100Base-T-百兆电口-1000Base-T-千兆电口-1000Base-LX-千兆单模光口(10千米)-10GBase-T-万兆电口-10GBase-LR-万兆单模光口(10千米)-RedundantPhysicalConnectionIdString否互为冗余的物理专线Id(在建立第二条物理专线连接时,如果传入需要冗余的物理专线ID,阿里云将为其分配尽量独立的AD设备,以提供更高的高可用性).
传入对应的物理专线必须存在,而且处于Allocated/Confirmed/Enabled状态之一.
NameString否物理专线名字.
[2,128]个字符.
不能以http://和https://开头.
DescriptionString否物理专线描述信息.
[2,256]个字符,不能以http://和https://开头.
ClientTokenString是用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
专有网络VPC开发指南62返回参数错误码名称类型描述PhysicalConnectionIdString申请成功物理专线ID,状态为initial错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidAccessPointId.
NotFoundTheAccessPointIdprovideddoesnotexistinourrecords.
404指定的AccessPointId不存在InvalidAccessPointId.
NotEnabledThespecifiedAccessPointIdisnotinEnabledstate.
400指定的AccessPointId不在Enabled状态InvalidType.
MalformdTheTypeprovidedwasinvalid.
400指定的Type值不合法InvalidPeerLocation.
MalformdThePeerLocationprovidedwasinvalid.
400指定的PeerLocation不合法InvalidLineOperator.
MalformdTheLineOperatorprovidedwasinvalid.
400指定的LineOperator值不合法InvalidPortType.
MalformdThePortTypeprovidedwasinvalid.
400指定的PortType值不合法InvalidDescription.
MalformedThespecifiedDescriptionisnotvalid.
400指定的专线描述不合法InvalidRedundantPhysicalConnectionId.
NotFoundThespecifiedRedundantPhysicalConnectionIdisnotfound.
404指定的冗余专线不存在InvalidName.
MalformedThespecifiedNameisnotvalid.
400指定的专线名称不合法QuotaExceeded.
pConnPerAPPhysicalconnectioncountperapquotaexceed.
400接入点接入专线总数超过配额InvalidBandwidthinvalidphysicalconnectionbanwidth.
400指定的Bandwidth不合法专有网络VPC开发指南63--取消物理专线接入描述在物理专线开通前取消物理专线接入只允许取消当前处在Initial,Approved,Allocated,Confirmed状态(都属于未开通状态)的物理专线取消后进入Canceled状态请求参数返回参数全是公共返回参数,详见公共返回参数InvalidRedundantPhysicalConnectionredundantphysicalconnectiondoesn'tbelongtocurrentuser.
400指定的RedundantPhysicalConnection不属于调用者InvalidRedundantPhysicalConnectionStatusinvalidredundantphysicalconnectionstatus.
400指定的RedundantPhysicalConnection状态不合法InvalidCircuitCode.
MalformedcircuitCodeisillegal.
400指定的circuitCode不合法QuotaExceeded.
freePconnPerAPfreephysicalconnectionscountexcceeded.
400未创建边界路由器的物理专线数量超过配额名称类型是否必须描述ActionString是系统规定参数,取值:CancelPhysicalConnectionRegionIdString是所在地域PhysicalConnectionIdString是物理专线ID专有网络VPC开发指南64--错误码查询物理专线列表描述查看路由器接口列表可通过各种Filter对结果进行过滤;目前支持的Filter包括:PhysicalConnectionId、AccessPointId、Type、LineOperator、Spec、Status、Name一个Filter的多个值之间是"or"关系(只要与其中一个值吻合则视为符合该Filter的过滤条件);各个Filter之间为"and"逻辑关系(符合所有Filter的过滤条件,才会进入最终查询结果中).

请求参数错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidPhysicalConnectionId.
NotFoundThePhysicalConnectionIdprovideddoesnotexistinourrecords.
404指定的PhysicalConnectionId不存在Forbidden.
NotAllowedInStateTherequestdoesnotallowinthisstate.
400当前状态不支持该操作名称类型是否必须描述ActionString是系统规定参数,取值:DescribePhysicalConnectionsRegionIdString是所在地域(管理实例的RegionID)Filter.
n.
KeyString否第n个过滤器的类型.
N从1开始,不大于5.
Filter.
n.
Value.
mString否第n个过滤器的第m个值.
M从1开始,不大于5.
专有网络VPC开发指南65返回参数全是公共返回参数,详见公共返回参数错误码修改物理专线属性描述修改物理专线属性PageNumberInteger否查询结果的页码;不指定时,默认为1;取值范围:正整数;若PageNumber大于实际结果的最大页码,则返回最后一页的内容.
PageSizeInteger否查询结果的分页大小.
取值范围为[1,50],默认为10名称类型描述PhysicalConnectionSetPhysicalConnectionSetType物理专线信息PhysicalConnectionSetType组成的集合TotalCountInteger实例总个数PageNumberInteger实例列表的页码PageSizeInteger输入时设置的每页行数错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidFilterKey.
ValueNotSupportedSpecifiedfilterkeyisnotsupported:Filter.
X.
key404指定的筛选字段不支持专有网络VPC开发指南66---处于Rejected状态修改信息后进入Initial状态Spec,RedundantPhysicalConnectionId只允许Initial/Rejected状态修改在Canceled,Allocating,AllocationFailed,Terminated状态不允许修改任何属性请求参数名称类型是否必须描述ActionString是系统规定参数,取值:ModifyPhysicalConnectionAttributeRegionIdString是所在地域PhysicalConnectionIdString是需要修改属性的物理专线IdLineOperatorString否提供接入物理线路的运营商,可选值:CT-中国电信-CU-中国联通-CM-中国移动-CO-中国其他-Equinix-Equinix-Other-境外其他-bandwidthString否物理专线接入接口带宽,单位Mbps,可选值:[2-10240]PeerLocationString否专线对端所在物理位置(地址)PortTypeString否物理专线接入端口类型,可选值:E1-2M同步电口-100Base-T-百兆电口-1000Base-T-千兆电口-1000Base-LX-千兆单模光口(10千米)-10GBase-T-万兆电口-10GBase-LR--专有网络VPC开发指南67返回参数全是公共返回参数,详见公共返回参数错误码万兆单模光口(10千米)Other-未列明-RedundantPhysicalConnectionIdString否互为冗余的物理专线IdCircuitCodeString否专线侧接口对应运营商的电路编码NameString否物理专线名字DescriptionString否物理专线描述信息ClientTokenString否用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
具体参见附录:如何保证幂等性.
错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidPhysicalConnectionId.
NotFoundThePhysicalConnectionIdprovideddoesnotexistinourrecords.
404指定的PhysicalConnectionId不存在InvalidLineOperator.
MalformdTheLineOperatorprovidedwasinvalid.
400指定的专线运营商不正确InvalidPeerLocation.
MalformdThePeerLocationprovidedwasinvalid.
400指定的PeerLocation不合法InvalidPortType.
MalformdThePortTypeprovidedwasinvalid.
400指定的PortType不合法InvalidDescription.
MalformedThespecifidDescriptionisnot400输入的Description不合法专有网络VPC开发指南68----物理专线接入终止描述在物理专线开通后终止物理专线接入只允许开通当前处在Enabled状态的物理专线如果还存在VBRowner是物理专线owner自己的VBR,则不允许终止物理专线(物理专线owner必须先把属于自己的VBR删除)如果还存在VBRowner不是物理专线owner自己的而且状态不是Terminated状态的VBR,则不允许终止物理专线(物理专线owner必须先把未被其他用户接受的VBR删除,并把已被其他用户接受的VBR终止,后者不允许跨用户删除但可以终止)终止开始后进入Terminating状态,完成后进入Terminated状态请求参数valid.
InvalidRedundantPhysicalConnectionId.
NotFoundThespecifiedRedundantPhysicalConnectionIdisnotfound.
404指定的冗余专线ID不存在InvalidName.
MalformedThespecifiedNameisnotvalid.
400指定专线名称不合法InvalidStatusinvalidphysicalconnectionstatus.
400物理专线状态不合法InvalidBandwidthinvalidphysicalconnectionbanwidth.
400物理专线Bandwidth不合法InvalidRedundantPhysicalConnectionredundantphysicalconnectiondoesn'tbelongtocurrentuser.
400指定的RedundantPhysicalConnection不属于调用方InvalidRedundantPhysicalConnectionStatusinvalidredundantphysicalconnectionstatus.
400指定的RedundantPhysicalConnection状态不合法InvalidCircuitCode.
MalformedcircuitCodeisillegal.
400指定的CircuitCode不合法名称类型是否必须描述专有网络VPC开发指南69--返回参数全是公共返回参数,详见公共返回参数.
错误码开通物理专线描述只允许开通当前处在Confirmed状态的物理专线开通后进入Enabled状态ActionString是系统规定参数,取值:TerminatePhysicalConnectionRegionIdString是所在地域(管理实例的RegionID)PhysicalConnectionIdString是物理专线Id错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidPhysicalConnectionId.
NotFoundThePhysicalConnectionIdprovideddoesnotexistinourrecords.
404指定的物理专线(PhysicalConnectionId)不存在Forbidden.
NotAllowedInStateTherequestdoesnotallowinthisstate.
400指定的物理专线未处于正常(Enabled)状态Forbidden.
VbrAttachedcannotterminatephysicalconnectionwhenvirtualborderroutersarestillattached.
400当前物理专线上还有关联的边界路由器专有网络VPC开发指南70请求参数返回参数全是公共返回参数,详见公共返回参数错误码删除物理专线描述删除物理专线名称类型是否必须描述ActionString是系统规定参数,取值:EnablePhysicalConnectionRegionIdString是所在地域PhysicalConnectionIdString是物理专线IDClientTokenString是用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidPhysicalConnectionId.
NotFoundThePhysicalConnectionIdprovideddoesnotexistinourrecords.
404指定的物理专线(PhysicalConnectionId)不存在Forbidden.
NotAllowedInStateTherequestdoesnotallowinthisstate.
400指定的物理专线未处于Confirmed状态.
专有网络VPC开发指南71-只允许删除当前处在Rejected,Canceled,AllocationFailed,Terminated状态的物理专线请求参数返回参数全是公共返回参数,详见公共返回参数错误码路由器接口名称类型是否必须描述ActionString是系统规定参数,取值:DeletePhysicalConnectionRegionIdString是所在地域(管理实例的RegionID)PhysicalConnectionIdString是物理专线ID错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidPhysicalConnectionId.
NotFoundThePhysicalConnectionIdprovideddoesnotexistinourrecords.
404指定的物理专线(PhysicalConnectionId)不存在Forbidden.
NotAllowedInStateTherequestdoesnotallowinthisstate.
400指定的物理专线未处于可删除(Rejected,Canceled,AllocationFailed,Terminated)状态Forbidden.
VBRExistsphysicalconnectionowner'svbrstillexists.
400该物理专线下仍有为专线所有者创建的VBRForbidden.
VBRExistsvbrowner'svbrstillexists.
400该物理专线下仍有为其他用户创建的VBR专有网络VPC开发指南72----------qqqq-新建路由器接口描述创建一个路由器接口(RouterInterface).
该API仅用于生成一个RouterInterface,并未触发连接动作.
若要真的实现路由器接口的互联,需要使用后面的"发起路由器接口连接"操作.
路由器接口之间的"互连",表示两个路由器通过一根虚拟的"链路"连接起来.
若要在链路上正确的实现消息的传递,还需要在两边的路由器上正确地配置路由表,以及在实际通信的对象上正确的配置访问控制规则;任意两个路由器之间,最多只能存在一对互连的RouterInterface.
一个路由器上可以最多创建5个路由器接口.
一个用户名下最多可以同时拥有5个路由器接口.
若用户名下有RI处于欠费状态,则不允许新建更多的路由器接口.
OppositeRouterType、OppositeRouterId、OppositeInterfaceId、OppositeInterfaceOwnerId四个参数,用于两个路由器接口互连时进行校验.
在发起连接时必须事先填好.
所以,您可以选择在创建时就填好,或者创建出路由器接口之后调用ModifyRouterInterfaceAttribute来修改.
对于创建本端或对端是VBR上的RouterInterface时:增加AccessPointId和OppositeAccessPointId参数,描述和限制见以下参数表新增HealthCheckSourceIp和HealthCheckTargetIp参数,描述和限制见以下参数表VBR只能是发起端,此时对端(接收端)只能是VRouter,具体的限制如下:如果RouterType(本端)是VBR,Role必须是InitiatingSide,而且OppositeRouterType只能是VRouter并且不能修改对端是VBR的RouterInterface只能是接收端,在创建时必须指定对端的RouterType(VBR)和AccessPointId,而且创建后不能修改这两个属性,具体的限制如下:OppositeRouterType不允许从其他值(VRouter或空)改为VBR,或从VBR改为其他值(VRouter或空)OppositeRouterType是VBR时Role(本端)必须是AcceptingSide,而且OppositeAccessPointId是必填并且不可改在VBR上创建RouterInterface要求VBR必须当时必须处于Active状态请求参数名称类型是否必须描述专有网络VPC开发指南73ActionString是操作接口名,系统规定参数,取值:CreateRouterInterfaceRegionIdString是实例所在的地域RouterTypeString是所属的路由器类型.
可选值:VRouter,VBRAccessPointIdString否所属的接入点ID.
在RouterType是VBR时必填,而且创建后不允许修改.
在RouterType是VRouter时不能填.
RouterIdString是所属的路由器Id,在RouterType是VBR时RouterId所指定的VBR必须在AccessPointId所指定的接入点内.
RoleString是连接中扮演的角色,即,是连接发起端还是连接接受端.
可选值:InitiatingSide|AcceptingSide;SpecString是规格,详见阿里云文档-网络产品-高速通道-地域、规格与价格OppositeRegionIdString是要连接的对端所在的Region.
OppositeAccessPointIdString否对端所属的接入点ID.
在OppositeRouterType是VBR时必填,而且创建后不允许修改.
在OppositeRouterType是VRouter时不能填.
在OppositeRouterType是VBR时OppositeRouterId所指定的VBR必须在OppositeAccessPointId所指定的接入点内.
在创建/修改RouterInterface时不会做对端OppositeRouterId,OppositeAccessPointId等的校验,在进行连接操作时会出错.
OppositeRouterTypString否要连接的对端路由器接专有网络VPC开发指南74e口所属的路由器类型.
可选值:VRouter,VBR;缺省为VRouter类型.
OppositeRouterIdString否要连接的对端的路由器的ID.
在OppositeRouterType是VBR时OppositeRouterId所指定的VBR必须在OppositeAccessPointId所指定的接入点内.
在创建/修改RouterInterface时不会做对端OppositeRouterId,OppositeAccessPointId等的校验,在进行连接操作时会出错.
OppositeInterfaceIdString否要连接的对端RouterInterface的IdOppositeInterfaceOwnerIdString否连接对端路由器接口的持有者账号ID.
您可以登录阿里云官网以后,在控制台-用户中心-账号管理中看到您的账号ID.
NameString否实例的显示名称,[2,128]英文或中文字符,必须以大小字母或中文开头,可包含数字,".
","_"或"-".
实例名称会显示在控制台.
如果没有指定该参数,默认值为实例的InstanceId不能以http://和https://开头.
DescriptionString否自定义描述[[2,256]个字符,实例描述会显示在控制台.
不填则为空,默认为空.
不能以http://和https://开头HealthCheckSourceIpString否专线容灾和ECMP场景下用来做专线HealthCheck的Packet的SourceIP.
只对本端是VRouter而且对端是VBR的RouterInterface有效.
必须是本端VRouter所在的VPC内的一个未被使用专有网络VPC开发指南75返回参数错误码的IP.
HealthCheckSourceIp与HealthCheckTargetIp必须同时指定或同时不指定.
HealthCheckTargetIpString否专线容灾和ECMP场景下用来做专线HealthCheck的Packet的TargetIP.
只对本端是VRouter而且对端是VBR的RouterInterface有效.
通常可以用专线用户端CPE的IP(也就是对端RI所在的VBR上的PeerGatewayIp),用户也可以指定专线用户端的其他可以用来做HealthCheckTarget的IP.
HealthCheckSourceIp与HealthCheckTargetIp必须同时指定或同时不指定.
ClientTokenString否用于保证请求的幂等性.
由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符.
具体参见附录:如何保证幂等性.
名称类型描述RouterInterfaceIdString路由器接口的实例ID,由系统生成,全局唯一.
是操作路由器接口实例的唯一标识错误代码描述Http状态码语义InvalidRegionId.
NotFoundTheRegionIdprovideddoesnotexistinourrecords.
404指定的RegionId不存在InvalidOppositeRegionId.
NotFoundTheOppositeRegionIdprovideddoesnot404用户填写的OppositeRegionId是一个不存在的专有网络VPC开发指南76existinourrecords.
regionIdInvalidRegionPair.
NotReachableThespecifiedOppositeRegionisnotreachablebyExpressConnectfromthatregionspecifiedby'RegionId'400用户指定的两个region是无法通过高速通道产品进行连接的.
InvalidRole.
ValueNotSupportedThespecifiedRoleisnotvalid.
400指定的Role不合法InvalidSpec.
ValudNotSupportedThespecifiedSpecisnotsupported.
400指定的Spec不支持InvalidRouterType.
ValueNotSupportedThespecifiedRouterTypeisnotvalid400指定的RouterType不合法InvalidRouterId.
NotFoundThespecifiedRouterIddoesnotexistinourrecored.
404指定的RouterId不存在InvalidOppositeRouterType.
ValueNotSupportedThespecifiedOppositeRouterTypeisnotvalid.
400指定的OppositeRouterType不合法ParameterMismatch.
Role-SpecThespecifiedSpecandRolemismatch.
400指定的Spec和Role不匹配ParameterMismatch.
RegionId-OppositeRegionId-SpecThespecifiedSpecisnotsupportedbetweenthespecifiedRegionIdandOppositeRegionId.
400该规格在这两个Region之间不支持.
InvalidName.
MalformedThespecified'Name'isnotvalid.
400指定的Name不合法InvalidDescription.
MalformedThespecifid'Description'isnotvalid.
400指定的Description不合法Forbidden.
BillsOutstandingYoucannotcreatemoreRouterInterfacebecauseyouhavebillsoutstanding.
400有未结清的账单,因而拒绝创建更多的后付费资源;QuotaExceed.
RouterInterfaceLivingRouterInterfacequotaexceeded.
400已有路由器接口数量超过配额LimitationExceed.
InterfaceNumberOnRouterTotalnumberofRouterInterfacesonaRouterexceeded.
400单个路由器上存在的路由器接口数量超过配额Forbidden.
NotInRouNotinrouter500帐号不在创建路由器接专有网络VPC开发指南77qqqqqqqq查询路由器接口列表描述查看路由器接口列表.
可通过各种Filter对结果进行过滤.
目前支持的Filter包括:RouterInterfaceIdRouterIdRouterTypeRouterInterfaceOwnerIdOppositeInterfaceIdOppositeRouterTypeOppositeRouterIdOppositeInterfaceOwnerIdterInterfaceCreateWhitelistinterfacecreatewhitelist.
的白名单中RI_CREATE_ONE_LIMIT_BY_SYNCCreaterionlyonelimitbysync.
500InvalidAccessPoint.
ValueNotAllowedThenon-vbrrouterinterfacecannothaveaccesspointconfigured.
500非VBR路由器接口不能指定接入点信息InvalidAccessPoint.
ValueNotAllowedThenon-vbroppositerouterinterfacecannothaveoppositeaccesspointconfigured.
500非VBR对端路由器接口不能指定接入点信息InvalidParam.
NotFoundParametermustnotbenull,uid,bid,regionNo,remoteRegionNoorrouterId400'uid','bid','regionNo','remoteRegionNo'或者'routerId'不能为空InvalidAccessPoint.
NotMatchTheaccessPointidisnotmatched400接入点Id不匹配InvalidAccessPoint.
NotExistTheaccessPointnotexit400接入点Id不存在专有网络VPC开发指南78qqStatusName一个Filter的多个值之间是"or"关系(只要与其中一个值吻合则视为符合该Filter的过滤条件);各个Filter之间为"and"逻辑关系(符合所有Filter的过滤条件,才会进入最终查询结果中).
请求参数返回参数错误码名称类型是否必须描述Actionstring是系统规定参数,取值:DescribeRouterInterfacesRegionIdstring是实例所在的地域Filter.
n.
Keystring否第n个过滤器的类型.
N从1开始,不大于5;Filter.
n.
Value.
mstring否第n个过滤器的第m个值.
M从1开始,不大于5PageNumberint否查询结果的页码;不指定时,默认为1;取值范围:正整数;若PageNumber大于实际结果的最大页码,则返回最后一页的内容.
PageSizeint否查询结果的分页大小.
取值范围为[1,100],默认为10名称类型描述TotalCountInteger实例总个数PageNumberInteger实例列表的页码PageSizeInteger输入时设置的每页行数InstancesRouterInterfaceSetType由RouterInterfaceSetType组成的数组格式,返回实例的信息错误代码描述Http状态码语义专有网络VPC开发指南79----------发起路由器接口连接描述发起开放路由器接口互联请求,将一个发起端RouterInterface与其对端RouterInterface进行连接.
关于功能的说明:只允许对Role为InitiatingSide的RouterInterface进行该操作;对于一个Role为AcceptingSide的RouterInterface来说,只能将连接对端信息设置好后,等待对方发起连接操作.

只有当对端RouterInterface也将连接对端设置为该RouterInterface,发起连接操作才能成功完成.
这是一个异步操作,API调用返回成功,意味着连接搭建工作已经开始,RouterInterface的Status进入Connecting状态(AcceptingSide的RouterInterface进入AcceptingConnect状态);当RouterInterface进入Active状态时,连接才真正搭建起来.