VPC相关接口

创建VPC

在一个指定区域创建一个虚拟私有网络（VPC）。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：CreateVpc
Name	String	是	vpc的名称
Cidr	String	是	vpc的Cidr

返回参数

名称	位置	类型	描述
vpc	body	VPC	VPC对象。

示例

请求示例

https://vpc.cn-north-3.inspurcloudapi.com/?Action=CreateVpc
&Name=vpclyqtest20190311
&Cidr=192.168.0.0/16
&Nonce=8923
&Timestamp=1852291720&Version=1

响应示例

<CreateVpcResponse>
    <RequestId>a2c5105d-f5e3-410e-8ddc-3f4b9c0aa4f7</RequestId>
    <Vpc>
        <IsDefault>false</IsDefault>
        <Network_id>248bb64f-833a-4d03-bc25-d37ba4a097e3</Network_id>
        <Name>vpclyqtest20190311</Name>
        <Created_at>2019-03-11 08:11:30</Created_at>
        <Cidr>192.168.0.0/16</Cidr>
        <Id>1105018396101828608</Id>
        <Region>cn-north-3</Region>
        <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
        <Status>ACTIVE</Status>
    </Vpc>
</CreateVpcResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询虚拟私有网络列表

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ListVpc
CurrentPage	String	否	vpc列表分页后的当前页数，默认为1
Limit	String	否	vpc列表分页后每一页展示的数目，默认为10

返回参数

名称	位置	类型	描述
vpcs	body	List<VPC>	VPC对象列表。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ListVpc
&Limit=
&Nonce=43
&Timestamp=1555717904
&Version=2019-01-31
&CurrentPage=1

响应示例

<ListVpcResponse>
    <TotalPage>3</TotalPage>
    <RequestId>a25ff554-810b-4260-963e-d476baf5507c</RequestId>
    <DataListContainer>
        <DataList>
            <IsDefault>false</IsDefault>
            <Network_id>ac7ec42e-56f5-44fb-992c-f174c02ff6b7</Network_id>
            <Name>就很乖回复</Name>
            <Created_at>2018-10-07 11:56:04</Created_at>
            <Cidr>10.0.0.0/8</Cidr>
            <SubnetsContainer>
                <Subnets>2bbff31f-444d-467e-a7ed-d173e5f972e5</Subnets>
            </SubnetsContainer>
            <Id>vpc0000000188</Id>
            <Region>cn-north-3</Region>
            <RoutetableId>8aeafde1-84c6-407f-8a29-2bb747feec10</RoutetableId>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <IsDefault>true</IsDefault>
            <Network_id>b8f193d7-10e2-4c55-8856-3143b08b2635</Network_id>
            <Name>vxlan_0000000056</Name>
            <Created_at>2018-08-21 14:59:47</Created_at>
            <Cidr>192.168.38.0/24</Cidr>
            <SubnetsContainer>
                <Subnets>782b85fa-735a-4fbf-b78d-bc41344e6341</Subnets>
            </SubnetsContainer>
            <Id>78</Id>
            <Region>cn-north-3</Region>
            <RoutetableId>003e2299-d8b3-4ef4-a3f7-2ef038c260ac</RoutetableId>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <IsDefault>false</IsDefault>
            <Network_id>248bb64f-833a-4d03-bc25-d37ba4a097e3</Network_id>
            <Name>vpclyqtest20190311</Name>
            <Created_at>2019-03-11 08:11:31</Created_at>
            <Cidr>192.168.0.0/16</Cidr>
            <SubnetsContainer></SubnetsContainer>
            <Id>1105018396101828608</Id>
            <Region>cn-north-3</Region>
            <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <IsDefault>false</IsDefault>
            <Network_id>99bb25ed-d492-4bbe-acd6-5345c9d6e444</Network_id>
            <Name>abcd</Name>
            <Created_at>2019-01-22 09:17:08</Created_at>
            <Cidr>10.0.0.0/8</Cidr>
            <SubnetsContainer>
                <Subnets>6d257fec-9509-4103-a4bb-60c329bed411</Subnets>
            </SubnetsContainer>
            <Id>1087640293521346560</Id>
            <Region>cn-north-3</Region>
            <RoutetableId>7b529abb-4b4a-4f8a-8611-e229f5d13c8a</RoutetableId>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <IsDefault>false</IsDefault>
            <Network_id>3506ba69-b1da-41be-a427-e3a210b29574</Network_id>
            <Name>aaa</Name>
            <Created_at>2019-01-04 02:50:59</Created_at>
            <Cidr>192.168.0.0/16</Cidr>
            <SubnetsContainer></SubnetsContainer>
            <Id>1081020132961574912</Id>
            <Region>cn-north-3</Region>
            <RoutetableId>55f8f157-c8aa-44a9-a9cb-462d73697d44</RoutetableId>
            <Status>ACTIVE</Status>
        </DataList>
    </DataListContainer>
    <PageSize>5</PageSize>
    <CurrentPage>1</CurrentPage>
    <TotalCount>14</TotalCount>
</ListVpcResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询虚拟私有网络详情

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：GetVpc
VpcId	String	是	vpc的ID

返回参数

名称	位置	类型	描述
vpc	body	VPC	VPC对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=GetVpc
&VpcId=1105018396101828608
&Nonce=9211
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<GetVpcResponse>
    <RequestId>72cf3082-3071-440c-997e-9fcf6d029ac3</RequestId>
    <Vpc>
        <IsDefault>false</IsDefault>
        <Network_id>248bb64f-833a-4d03-bc25-d37ba4a097e3</Network_id>
        <Name>vpclyqtest20190311</Name>
        <Created_at>2019-03-11 08:11:31</Created_at>
        <Cidr>192.168.0.0/16</Cidr>
        <SubnetsContainer></SubnetsContainer>
        <Id>1105018396101828608</Id>
        <Region>cn-north-3</Region>
        <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
        <Status>ACTIVE</Status>
    </Vpc>
</GetVpcResponse

返回值

请参考通用请求返回值

错误码

请参考异常返回

更新虚拟私有网络名称

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：UpdateVpc
VpcId	String	是	vpc的ID
Name	String	是	vpc更改后的名称

返回参数

名称	位置	类型	描述
vpc	body	VPC	VPC对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=UpdateVpc
&VpcId=1105018396101828608
&Name=vpc_lyq_rename
&Nonce=791
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<UpdateVpcResponse>
    <RequestId>9c47b6b9-a26c-460c-b2e3-d7079cc546c8</RequestId>
    <Vpc>
        <Network_id>248bb64f-833a-4d03-bc25-d37ba4a097e3</Network_id>
        <Name>vpc_lyq_rename</Name>
        <Created_at>2019-03-11 08:11:31.0</Created_at>
        <Cidr>192.168.0.0/16</Cidr>
        <SubnetsContainer></SubnetsContainer>
        <Id>1105018396101828608</Id>
        <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
    </Vpc>
</UpdateVpcResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

删除虚拟私有网络

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：DeleteVpc
VpcId	String	是	vpc的ID

返回参数

无

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteVpc
&VpcId=1088357315922427904
&Nonce=21
&Timestamp=1555717904
&Version=2019-01-31

响应示例

无

返回值

请参考通用请求返回值

错误码

请参考异常返回

子网相关接口

创建子网

在一个指定VPC下创建一个子网。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：CreateSubnet
Name	String	是	子网的名称
VpcId	String	是	子网所在vpc的ID
AvailabilityZone	String	是	子网的可用域
Cidr	String	是	子网的cidr
Dns.N	String	否	子网的cidr，最多填2个

返回参数

名称	类型	描述
subnet	Subnet	子网对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=CreateSubnet
&Name=lyqsubnettest
&VpcId=1105018396101828608
&AvailabilityZone=cn-north-3a
&Cidr=192.168.1.0/24
&EnableDhcp=true
&Nonce=911
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<CreateSubnetResponse>
    <Subnet>
        <IsDefault>false</IsDefault>
        <TotalIpAddressCount>250</TotalIpAddressCount>
        <EnableDhcp>true</Enable_dhcp>
        <AvailableIpAddressCount>250</AvailableIpAddressCount>
        <Name>lyqsubnettest</Name>
        <Vpc>
            <Name>vpc_lyq_rename</Name>
            <Cidr>192.168.0.0/16</Cidr>
            <Id>1105018396101828608</Id>
            <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
            <Status>ACTIVE </Status>
        </Vpc>
        <CreatedTime>2019-03-11 09:44:59.247</Created_at>
        <Cidr>192.168.1.0/24</Cidr>
        <GatewayIp>192.168.1.1</Gateway_ip>
        <Id>fcc644b1-e0cf-4249-b7f6-64056b6db2cc</Id>
        <Status>ACTIVE</Status>
    </Subnet>
    <RequestId>04e796a0-b5ed-4dab-9a82-f1d317b365f8</RequestId>
</CreateSubnetResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询子网列表

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ListSubnet
CurrentPage	String	否	子网列表分页后的当前页数，默认为1
Limit	String	否	子网列表分页后每一页展示的数目，默认为10

返回参数

名称	类型	描述
subnet	List<Subnet>	子网对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ListSubnet
&Limit=4&Nonce=
&Timestamp=1555717904
&Version=2019-01-31
&CurrentPage=1

响应示例

<ListSubnetResponse>
    <TotalPage>3</TotalPage>
    <RequestId>71b01a0d-e827-4eae-b5f3-55e44df74193</RequestId>
    <DataListContainer>
        <DataList>
            <EnableDhcp>true</Enable_dhcp>
            <DnsContainer>
                <Dns>114.114.114.114</Dns>
                <Dns>100.110.0.1</Dns>
            </DnsContainer>
            <Vpc>
                <Network_id>248bb64f-833a-4d03-bc25-d37ba4a097e3</Network_id>
                <Name>vpc_lyq_rename</Name>
                <Cidr>192.168.0.0/16</Cidr>
                <Id>1105018396101828608</Id>
                <RoutetableId>42b6260e-72d0-4337-b776-25b877ef7d60</RoutetableId>
            </Vpc>
            <CreatedTime>2019-03-11 09:44:59</Created_at>
            <IsDefault>false</IsDefault>
            <TotalIpAddressCount>250</TotalIpAddressCount>
            <AvailableIpAddressCount>250</AvailableIpAddressCount>
            <Name>lyqsubnettest</Name>
            <Cidr>192.168.1.0/24</Cidr>
            <GatewayIp>192.168.1.1</Gateway_ip>
            <Id>fcc644b1-e0cf-4249-b7f6-64056b6db2cc</Id>
            <Region>cn-north-3</Region>
            <Status>ACTIVE</Status>
        </DataList>
    </DataListContainer>
    <PageSize>4</PageSize>
    <CurrentPage>1</CurrentPage>
    <TotalCount>10</TotalCount>
</ListSubnetResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询子网详情

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：GetSubnet
SubnetId	String	是	子网ID

返回参数

名称	位置	类型	描述
subnet	body	Subnet	子网对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=GetSubnet
&SubnetId=fcc644b1-e0cf-4249-b7f6-64056b6db2cc
&Nonce=521
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<GetSubnetResponse>
    <RequestId>e1cbae8b-ed20-4329-86c5-e98c976f69e6</RequestId>
    <Subnets>
        <AvailabilityZone>cn-north-3</Availability_zone>
        <EnableDhcp>true</Enable_dhcp>
        <DnsContainer>
            <Dns>114.114.114.114</Dns>
            <Dns>100.110.0.1</Dns>
        </DnsContainer>
        <Vpc>
            <Name>vpc_lyq_rename</Name>
            <Cidr>192.168.0.0/16</Cidr>
            <Id>1105018396101828608</Id>
        </Vpc>
        <CreatedTime>2019-03-11 09:44:59</Created_at>
        <IsDefault>false</IsDefault>
        <TotalIpAddressCount>250</TotalIpAddressCount>
        <AvailableIpAddressCount>250</AvailableIpAddressCount>
        <IpVersion>4</Ip_version>
        <Name>lyqsubnettest</Name>
        <Cidr>192.168.1.0/24</Cidr>
        <Gateway_ip>192.168.1.1</Gateway_ip>
        <Id>fcc644b1-e0cf-4249-b7f6-64056b6db2cc</Id>
        <Status>ACTIVE</Status>
    </Subnets>
</GetSubnetResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

更新子网名称

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：UpdateSubnet
SubnetId	String	是	子网ID
Name	String	是	子网更新后的名称

返回参数

名称	位置	类型	描述
subnet	body	Subnet	子网对象。

示

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=UpdateSubnet
&SubnetId=fcc644b1-e0cf-4249-b7f6-64056b6db2cc
&Name=lyqnewName111
&Nonce=
&Timestamp=1555717904
&Version=2019-01-31

相应示例

<UpdateSubnetResponse>
    <Subnet>
        <DnsContainer>
            <Dns>114.114.114.114</Dns>
            <Dns>100.110.0.1</Dns>
        </DnsContainer>
        <Name>lyqnewName111</Name>
        <Cidr>192.168.1.0/24</Cidr>
        <Id>fcc644b1-e0cf-4249-b7f6-64056b6db2cc</Id>
        <Status>ACTIVE</Status>
    </Subnet>
    <RequestId>83f56020-cee2-4d1a-ae41-2db562787737</RequestId>
</UpdateSubnetResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

删除子网

删除一个子网。子网必须没有绑定任何资源的情况下才可以删除。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：DeleteSubnet
SubnetId	String	是	子网ID

返回参数

无

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteSubnet
&SubnetId=319b1622-c5e4-4551-b935-a7d4a6a37070
&Nonce=11
&Timestamp=1555717904
&Version=2019-01-31

响应示例

无

返回值

请参考通用请求返回值

错误码

请参考异常返回

路由表相关接口

查询路由表列表

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ListRouter
Page	String	否	分页查询路由表的起始页
Limit	String	否	分页查询路由表的每页显示的数目

返回参数

名称	类型	描述
routers	List<Router>	路由表对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ListRouter&Nonce=954111&Timestamp=1555717904&Version=2019-01-31&Page=1&Limit=4

响应示例

<ListRouterResponse>
    <TotalPage>4</TotalPage>
    <RequestId>65c14eb1-4c44-4c05-94de-b81d7cee5545</RequestId>
    <PageSize>4</PageSize>
    <CurrentPage>1</CurrentPage>
    <TotalCount>15</TotalCount>
    <RoutersContainer>
        <Routers>
            <RoutesContainer>
                <Routes>
                    <NexthopTpye>ECS</NexthopTpye>
                    <Destination>192.0.0.0/8</Destination>
                    <Nexthop>192.168.38.4</Nexthop>
                </Routes>
            </RoutesContainer>
            <VpcName>vxlan_0000000056</VpcName>
            <VpcId>78</VpcId>
            <Name>vxlan_0000000056</Name>
            <Created_at/>
            <Id>003e2299-d8b3-4ef4-a3f7-2ef038c260ac</Id>
            <VpcCidr>192.168.38.0/24</VpcCidr>
            <RouteType>system</RouteType>
        </Routers>
        <Routers>
            <RoutesContainer></RoutesContainer>
            <VpcName>hhh</VpcName>
            <VpcId>1078665077428649984</VpcId>
            <Name>router-hhh</Name>
            <Created_at/>
            <Id>05211923-655f-4d01-a62a-60429c341b93</Id>
            <VpcCidr>192.168.0.0/16</VpcCidr>
            <RouteType>system</RouteType>
        </Routers>
        <Routers>
            <RoutesContainer></RoutesContainer>
            <VpcName>yaoyifei</VpcName>
            <VpcId>1072824632596676608</VpcId>
            <Name>router-yaoyifei</Name>
            <Created_at/>
            <Id>08c1221c-322d-4a00-8ff8-416cd6bfee8c</Id>
            <VpcCidr>192.168.0.0/16</VpcCidr>
            <RouteType>system</RouteType>
        </Routers>
        <Routers>
            <RoutesContainer></RoutesContainer>
            <VpcName>vpc_lyq_rename</VpcName>
            <VpcId>1105018396101828608</VpcId>
            <Name>router-vpclyqtest20190311</Name>
            <Created_at/>
            <Id>42b6260e-72d0-4337-b776-25b877ef7d60</Id>
            <VpcCidr>192.168.0.0/16</VpcCidr>
            <RouteType>system</RouteType>
        </Routers>
    </RoutersContainer>
</ListRouterResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询路由表详情

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：GetRouter
RouterId	String	是	路由表的ID

返回参数

名称	位置	类型	描述
router	body	Router	路由表对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=GetRouter
&RouterId=42b6260e-72d0-4337-b776-25b877ef7d60&Nonce=911
&Timestamp=
&Version=2019-01-31

响应示例

<GetRouterResponse>
    <Router>
        <RoutesContainer></RoutesContainer>
        <VpcName>vpc_lyq_rename</VpcName>
        <VpcId>1105018396101828608</VpcId>
        <Name>router-vpclyqtest20190311</Name>
        <Created_at/>
        <Id>42b6260e-72d0-4337-b776-25b877ef7d60</Id>
        <VpcCidr>192.168.0.0/16</VpcCidr>
        <RouteType>system</RouteType>
    </Router>
    <RequestId>a3251d47-67f4-4256-b32a-cbb291e40b83</RequestId>
</GetRouterResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

添加路由策略

在一个路由表中添加一条路由策略。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：AddRouter
RouterId	String	是	路由表的ID
Destination.N	String	是	路由策略的目的地址
NexthopTpye.N	String	是	路由策略的下一跳的类型
Nexthop.N	String	是	路由策略的下一跳地址

返回参数

名称	位置	类型	描述
router	body	Route	路由表对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=AddRouter
&RouterId=42b6260e-72d0-4337-b776-25b877ef7d60
&Destination.1=1.1.1.1/16
&NexthopType.1=ECS&Nexthop.1=192.168.1.10
&Nonce=923
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<AddRouterResponse>
    <Router>
        <RoutesContainer>
            <Routes>
                <NexthopTpye>ECS</NexthopTpye>
                <Destination>1.1.1.1/16</Destination>
                <Nexthop>192.168.1.10</Nexthop>
            </Routes>
        </RoutesContainer>
        <VpcName>vpc_lyq_rename</VpcName>
        <VpcId>1105018396101828608</VpcId>
        <Name>router-vpclyqtest20190311</Name>
        <Created_at/>
        <Id>42b6260e-72d0-4337-b776-25b877ef7d60</Id>
        <VpcCidr>192.168.0.0/16</VpcCidr>
        <RouteType>system</RouteType>
    </Router>
    <RequestId>a8894091-4d44-4209-bb29-6d13643d9760</RequestId>
</AddRouterResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

删除路由策略

在一个路由表中删除一条路由策略。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：DeleteRouter
RouterId	String	是	路由表的ID
Destination.N	String	是	路由策略的目的地址
NexthopTpye.N	String	是	路由策略的下一跳的类型
Nexthop.N	String	是	路由策略的下一跳地址

返回参数

无

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteRouter
&RouterId=42b6260e-72d0-4337-b776-25b877ef7d60
&Destination.1=1.1.1.1/16
&NexthopTpye.1=ECS
&Nexthop.1=192.168.1.10
&Nonce=915121
&Timestamp=1555717904
&Version=2019-01-31

响应示例

无

返回值

请参考通用请求返回值

错误码

请参考异常返回

安全组

创建安全组

创建一个安全组，目前一个客户在一个区域的安全组配额为100个。

创建完安全组，其中安全组规则与默认安全组相同。

入规则是允许22，3389，443，80端口的TCP数据报文通过，ICMP，以及10.0.0.0/8，172.16.0.0/12,192.168.0.0/16三个VPC的内网互通流量；
出规则是允许所有端口数据报文通过。

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：CreateSecurityGroup
Name	String	是	安全的名称
Description	String	是	安全组的描述

返回参数

名称	类型	描述
security_group	SecurityGroup	安全组对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=CreateSecurityGroup
&Name=LyqCreatedAt20190312
&Description=
&Nonce=342
&Timestamp=1555717904
&Version=2019-01-31

返回示例

<CreateSecurityGroupResponse>
    <RequestId>dd1086a0-612f-4e01-a2ec-b29bc333fba9</RequestId>
    <SecurityGroup>
        <TenantId>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <Name>LyqCreatedAt20190312</Name>
        <Description>20190312</Description>
        <Id>594a8325-a701-4483-b710-da6378b63f82</Id>
        <Isdefault>false</Isdefault>
        <Security_group_rulesContainer>
            <SecurityGroupRules>
                <TenantId>f30f66009a5540f6a08d0a165229ae60</TenantId>
                <RemoteGroupId>null</RemoteGroupId>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</SecurityGroupId>
                <PortRangeMax>null</PortRangeMax>
                <RemoteIpPrefix>10.0.0.0/8</RemoteIpPrefix>
                <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                <Direction>ingress</Direction>
                <PortRangeMin>null</PortRangeMin>
            </SecurityGroupRules>
        </Security_group_rulesContainer>
    </SecurityGroup>
</CreateSecurityGroupResponse

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组列表

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ListSecurityGroups
Limit	String	否	分页展示安全组，每一页展示的数目
CurrentPage	String	否	分页展示安全组的当前页

返回参数

名称	位置	类型	描述
securityGroups	body	List<SecurityGroup>	安全组对象列表。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ListSecurityGroups
&Nonce=342
&Timestamp=1555717904
&Version=2019-01-31
&CurrentPage=1
&Limit=5

响应示例

<ListSecurityGroupsResponse>
    <TotalSize>4</TotalSize>
    <Star>0</Star>
    <TotalPage>1</TotalPage>
    <RequestId>1ac07366-6c5e-458b-b91c-862c5456e954</RequestId>
    <DataListContainer>
        <DataList>
            <TenantId>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Name>default</Name>
            <Description>Default security group</Description>
            <Id>056b8298-0403-401e-9a30-4d8251f955ed</Id>
            <Isdefault>true</Isdefault>
            <Security_group_rulesContainer>
              <SecurityGroupRules>
                  <TenantId>f30f66009a5540f6a08d0a165229ae60</TenantId>
                  <RemoteGroupId>null</RemoteGroupId>
                  <Protocol>null</Protocol>
                  <Ethertype>IPv4</Ethertype>
                  <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</     SecurityGroupId>
                  <PortRangeMax>null</PortRangeMax>
                  <RemoteIpPrefix>10.0.0.0/8</RemoteIpPrefix>
                  <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                  <Direction>ingress</Direction>
                  <PortRangeMin>null</PortRangeMin>
              </SecurityGroupRules>
            </Security_group_rulesContainer>
        </DataList>
    </DataListContainer>
    <PageSize>5</PageSize>
    <CurrentPage>1</CurrentPage>
</ListSecurityGroupsResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询一个安全组详情

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ShowSecurityGroups
SecurityGroupId	String	是	安全组的ID

返回参数

名称	位置	类型	描述
securityGroup	body	SecurityGroup	安全组对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ShowSecurityGroups
&Nonce=342
&Timestamp=1555717904
&Version=2019-01-31
&SecurityGroupId=594a8325-a701-4483-b710-da6378b63f82

响应示例

<ShowSecurityGroupsResponse>
    <RequestId>b2ad3236-0001-416e-9114-e2f3dd6944c5</RequestId>
    <SecurityGroup>
        <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <Name>LyqCreatedAt20190312</Name>
        <Description>20190312</Description>
        <Created_at/>
        <Id>594a8325-a701-4483-b710-da6378b63f82</Id>
        <Isdefault>false</Isdefault>
        <Security_group_rulesContainer>
            <SecurityGroupRules>
                <TenantId>f30f66009a5540f6a08d0a165229ae60</TenantId>
                <RemoteGroupId>null</RemoteGroupId>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</SecurityGroupId>
                <PortRangeMax>null</PortRangeMax>
                <RemoteIpPrefix>10.0.0.0/8</RemoteIpPrefix>
                <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                <Direction>ingress</Direction>
                <PortRangeMin>null</PortRangeMin>
            </SecurityGroupRules>
        </Security_group_rulesContainer>
    </SecurityGroup>
</ShowSecurityGroupsResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

删除安全组

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：DeleteSecurityGroups
SecurityGroupId	String	是	安全组的ID

返回参数

不涉及

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteSecurityGroups
&Nonce=342
&Timestamp=1555717904
&Version=2019-01-31
&SecurityGroupId=594a8325-a701-4483-b710-da6378b63f82

响应示例

无

返回值

请参考通用请求返回值

错误码

请参考异常返回

创建安全组规则

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：CreateSecurityGroupsRule
SecurityGroupId	String	是	安全组的ID
Direction	String	是	出入控制方向。取值范围：egress，ingress
PortRangeMin	String	是	最小端口值。取值范围：1-65535，不能大于port_range_max的值，为空表示所有端口
PortRangeMax	String	是	最大端口值。取值范围：1-65535，不能小于port_range_max的值，为空表示所有端口
RemoteIpPrefix	String	是	远端IP地址，当direction是egress时为虚拟机访问端的地址，当direction是ingress时为访问虚拟机的地址。取值范围：IP地址，或者cidr格式
Protocol	String	是	协议类型。取值范围：icmp，tcp，udp...为null表示支持所有协议
Ethertype	String	否	IP协议类型。取值范围：IPv4,IPv6，默认值：IPV4

返回参数

名称	位置	类型	描述
securityRroupRule	body	SecurityGroupRule	安全组规则对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=CreateSecurityGroupsRule
&Nonce=111
&Timestamp=1555717904
&Version=2019-01-31
&SecurityGroupId=594a8325-a701-4483-b710-da6378b63f82
&Direction=ingress
&PortRangeMin=80
&PortRangeMax=94
&RemoteIpPrefix=0.0.0.0/0
&Protocol=tcp

返回示例

<CreateSecurityGroupsRuleResponse>
    <RequestId>1b8b8994-6b65-49c4-a7e0-5b9121bfd334</RequestId>
    <SecurityGroupRule>
        <TenantId>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <RemoteGroupId>null</Remote_group_id>
        <Protocol>tcp</Protocol>
        <Ethertype>IPv4</Ethertype>
        <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
        <PortRangeMax>94</Port_range_max>
        <RemoteIPrefix>0.0.0.0/0</Remote_ip_prefix>
        <Description/>
        <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
        <Direction>ingress</Direction>
        <PortRangeMin>80</Port_range_min>
    </SecurityRroupRule>
</CreateSecurityGroupsRuleResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组规则列表

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ListSecurityGroupsRule
Security_group_id	String	是	安全组的ID
CurrentPage	String	否	分页展示安全组规则的当前页
Limit	String	否	分页展示安全组规则，每页展示的数目
Direction	String	是	安全组规则的出入方向，取值范围：egress，ingress

返回参数

名称	位置	类型	描述
securityRroupsRules	body	List<SecurityGroupRule>	安全组规则对象列表。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ListSecurityGroupsRule
&Nonce=12
&Timestamp=1555717904
&Version=2019-01-31
&Security_group_id=594a8325-a701-4483-b710-da6378b63f82
&CurrentPage=1
&Direction=ingress
&Limit=5

响应示例

<ListSecurityGroupsRuleResponse>
    <TotalSize>13</TotalSize>
    <Star>0</Star>
    <TotalPage>3</TotalPage>
    <RequestId>6ff054d2-086f-48c9-92d3-0e93d15c1956</RequestId>
    <DataListContainer>
        <DataList>
            <TenantId>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <RemoteGroupId>null</Remote_group_id>
            <Protocol>tcp</Protocol>
            <Ethertype>IPv4</Ethertype>
            <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <PortRangeMax>94</Port_range_max>
            <RemoteIPrefix>0.0.0.0/0</Remote_ip_prefix>
            <Description/>
            <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
            <Direction>ingress</Direction>
            <PortRangeMin>80</Port_range_min>
        </DataList>
    </DataListContainer>
    <PageSize>5</PageSize>
    <CurrentPage>1</CurrentPage>
</ListSecurityGroupsRuleResponse

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组规则详情

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：ShowSecurityGroupsRule
SecurityGroupRuleId	String	是	安全组规则的ID

返回参数

名称	位置	类型	描述
securityGroupRule	body	SecurityGroupRule	安全组规则对象。

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=ShowSecurityGroupsRule
&Nonce=12
&Timestamp=1555717904
&Version=2019-01-31
&SecurityGroupRuleId=0883d54d-1aeb-46f0-81e8-338df319b743

响应示例

<ShowSecurityGroupsRuleResponse>
    <RequestId>549a1129-0c39-4e7b-b2fc-7977824b0546</RequestId>
    <SecurityGroupRule>
        <TenantId>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <RemoteGroupId>null</Remote_group_id>
        <Protocol>tcp</Protocol>
        <Ethertype>IPv4</Ethertype>
        <SecurityGroupId>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
        <PortRangeMax>94</Port_range_max>
        <RemoteIPrefix>0.0.0.0/0</Remote_ip_prefix>
        <Description/>
        <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
        <Direction>ingress</Direction>
        <PortRangeMin>80</Port_range_min>
    </SecurityRroupRule>
</ShowSecurityGroupsRuleResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

删除一个安全组规则

请求参数

名称	类型	是否必须	描述
Action	String	是	公共参数，取值：DeleteSecurityGroupsRule
SecurityGroupRuleId	String	是	安全组规则的ID

返回参数

无

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteSecurityGroupsRule
&Nonce=12
&Timestamp=1555717904
&Version=2019-01-31
&SecurityGroupRuleId=0883d54d-1aeb-46f0-81e8-338df319b743

响应示例

无

返回值

请参考通用请求返回值

错误码

请参考异常返回