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
VpcName String 子网所在vpc的名称
VpcCidr String 子网所在vpc的cidr
Cidr String 子网的cidr
VpcStatus String vpc的状态
VpcRoutetableId String vpc的路由表ID
IpVersion String 子网的IP类型
GatewayIp String 子网的网关
EnableDhcp String 子网是否开启dhcp功能
AvailabilityZone String 子网的可用分区标识
DnsIpAddress1 String DNS服务地址1
DnsIpAddress2 String DNS服务地址2
AvailableIpAddressCount String 可用ip数目
IpAddressCount String 子网的ip数目

返回参数

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

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=CreateSubnet
&Name=lyqsubnettest
&VpcId=1105018396101828608
&VpcName=vpc_lyq_rename
&VpcCidr=192.168.0.0/16
&VpcStatus=ACTIVE
&VpcRoutetableId=42b6260e-72d0-4337-b776-25b877ef7d60
&Cidr=192.168.1.0/24
&EnableDhcp=true
&Nonce=911
&Timestamp=1555717904
&Version=2019-01-31

响应示例

<CreateSubnetResponse>
    <Subnet>
        <IsDefault>false</IsDefault>
        <TotalIpAddressCount>250</TotalIpAddressCount>
        <Enable_dhcp>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>
        <Created_at>2019-03-11 09:44:59.247</Created_at>
        <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>
    </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>
            <Enable_dhcp>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>
            <Created_at>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>
            <Gateway_ip>192.168.1.1</Gateway_ip>
            <Id>fcc644b1-e0cf-4249-b7f6-64056b6db2cc</Id>
            <Region>cn-north-3</Region>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <Enable_dhcp>true</Enable_dhcp>
            <DnsContainer>
                <Dns>114.114.114.114</Dns>
                <Dns>100.110.0.1</Dns>
            </DnsContainer>
            <Vpc>
                <Network_id>99bb25ed-d492-4bbe-acd6-5345c9d6e444</Network_id>
                <Name>abcd</Name>
                <Cidr>10.0.0.0/8</Cidr>
                <Id>1087640293521346560</Id>
                <RoutetableId>7b529abb-4b4a-4f8a-8611-e229f5d13c8a</RoutetableId>
            </Vpc>
            <Created_at>2019-01-22 09:18:41</Created_at>
            <IsDefault>false</IsDefault>
            <TotalIpAddressCount>58</TotalIpAddressCount>
            <AvailableIpAddressCount>58</AvailableIpAddressCount>
            <Name>abcd</Name>
            <Cidr>10.221.5.192/26</Cidr>
            <Gateway_ip>10.221.5.193</Gateway_ip>
            <Id>6d257fec-9509-4103-a4bb-60c329bed411</Id>
            <Region>cn-north-3</Region>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <Enable_dhcp>true</Enable_dhcp>
            <DnsContainer></DnsContainer>
            <Vpc>
                <Network_id>a9d06ffb-cf06-4172-b51a-a2f9289a0d32</Network_id>
                <Name>vpc-smy001</Name>
                <Cidr>192.168.0.0/16</Cidr>
                <Id>1075560141660254208</Id>
                <RoutetableId>528f933a-485c-4056-9b93-10b60c04bac8</RoutetableId>
            </Vpc>
            <Created_at>2018-12-20 09:19:07</Created_at>
            <IsDefault>false</IsDefault>
            <TotalIpAddressCount>65530</TotalIpAddressCount>
            <AvailableIpAddressCount>65529</AvailableIpAddressCount>
            <Name>subnet-smy001</Name>
            <Cidr>192.168.0.0/16</Cidr>
            <Gateway_ip>192.168.0.1</Gateway_ip>
            <Id>6bd179c2-f98b-4573-bbda-f6710c6908b7</Id>
            <Region>cn-north-3</Region>
            <Status>ACTIVE</Status>
        </DataList>
        <DataList>
            <Enable_dhcp>true</Enable_dhcp>
            <DnsContainer></DnsContainer>
            <Vpc>
                <Network_id>7d7f5cb6-6217-45ce-a0e8-367955a6df70</Network_id>
                <Name>vpc-lvs01</Name>
                <Cidr>192.168.0.0/16</Cidr>
                <Id>1075321910939250688</Id>
                <RoutetableId>5a841f1e-944c-4330-a0a6-fd34d0a2cd23</RoutetableId>
            </Vpc>
            <Created_at>2018-12-19 17:29:47</Created_at>
            <IsDefault>false</IsDefault>
            <TotalIpAddressCount>65530</TotalIpAddressCount>
            <AvailableIpAddressCount>65529</AvailableIpAddressCount>
            <Name>subnet-lvs01</Name>
            <Cidr>192.168.0.0/16</Cidr>
            <Gateway_ip>192.168.0.1</Gateway_ip>
            <Id>36297cbb-e842-4912-a43e-e477000528a7</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>
        <Availability_zone>cn-north-3</Availability_zone>
        <Enable_dhcp>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>
        <Created_at>2019-03-11 09:44:59</Created_at>
        <IsDefault>false</IsDefault>
        <TotalIpAddressCount>250</TotalIpAddressCount>
        <AvailableIpAddressCount>250</AvailableIpAddressCount>
        <Ip_version>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 String 路由策略的目的地址
NexthopTpye String 路由策略的下一跳的类型
Nexthop String 路由策略的下一跳地址
VpcId String 路由表所在vpc的ID

返回参数

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

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=AddRouter
&RouterId=42b6260e-72d0-4337-b776-25b877ef7d60
&Destination=1.1.1.1/16
&NexthopType=ECS&Nexthop=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 String 路由策略的目的地址
NexthopTpye String 路由策略的下一跳的类型
Nexthop String 路由策略的下一跳地址

返回参数

示例

请求示例

http://vpc.cn-north-3.inspurcloudapi.com/?Action=DeleteRouter
&RouterId=42b6260e-72d0-4337-b776-25b877ef7d60
&Destination=1.1.1.1/16
&NexthopTpye=ECS
&Nexthop=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>
    <Security_group>
        <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>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>10.0.0.0/8</Remote_ip_prefix>
                <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>172.16.0.0/12</Remote_ip_prefix>
                <Id>10f9bad3-5d84-4219-a2fc-373752b0f083</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>443</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>20c8feee-5758-41b1-a5bc-5ed784270979</Id>
                <Direction>ingress</Direction>
                <Port_range_min>443</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>null</Remote_ip_prefix>
                <Id>549afc45-c519-42c8-acd7-339a99a49c4a</Id>
                <Direction>egress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>80</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>8d3a0b48-1d48-4a29-8e0a-eae4839ba7c9</Id>
                <Direction>ingress</Direction>
                <Port_range_min>80</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>22</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>904fc5e8-c0ad-4203-891a-80bb5135c37a</Id>
                <Direction>ingress</Direction>
                <Port_range_min>22</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>192.168.0.0/16</Remote_ip_prefix>
                <Id>cb752ca6-d268-444c-976f-fe11fb37a0cb</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>3389</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>dab8fb73-d2a2-44c9-bd8c-d1ac8e976caf</Id>
                <Direction>ingress</Direction>
                <Port_range_min>3389</Port_range_min>
            </Security_group_rules>
        </Security_group_rulesContainer>
    </Security_group>
</CreateSecurityGroupResponse

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组列表

请求参数

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

返回参数

名称 位置 类型 描述
security_groups 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>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Name>default</Name>
            <Description>Default security group</Description>
            <Created_at/>
            <Id>056b8298-0403-401e-9a30-4d8251f955ed</Id>
            <Isdefault>true</Isdefault>
            <Security_group_rulesContainer>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>01af1a16-69a0-460e-bbb6-56336c3b4015</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>icmp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>1643f2d5-6ee0-46b1-adf5-3f3823d554cd</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>22</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>1db82587-03ca-4eed-bc8d-1b3a28b3b3c1</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>22</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>8080</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>60e0ccdd-bac6-4e80-bd98-07b6f915d2bf</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>8080</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv6</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>6986317b-6afb-46bb-9b6b-50cafe19c570</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv6</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>90fbf9a8-8647-4b77-8ba7-85e0d8deeb02</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>icmp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>d19e4911-ecf3-4c03-b19d-df052ca4ef4c</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>056b8298-0403-401e-9a30-4d8251f955ed</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>f9fe03d6-00c2-49f5-8557-db31f899b303</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
            </Security_group_rulesContainer>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Name>aeqeq</Name>
            <Description>qq</Description>
            <Created_at/>
            <Id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Id>
            <Isdefault>false</Isdefault>
            <Security_group_rulesContainer>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>22</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>081a361d-48da-4a5d-8e69-592dfa2a1494</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>22</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>10.0.0.0/8</Remote_ip_prefix>
                    <Id>1a3c7c57-e71f-417b-9e8c-cd9cbf06b7c9</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>80</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>2af72ef5-df84-4fc9-a03e-fefda583e279</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>80</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>3389</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>303218df-2f3b-45f9-875f-bddd9460759d</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>3389</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>335b164e-6e01-42ed-9256-e5108ca4abe2</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>172.16.0.0/12</Remote_ip_prefix>
                    <Id>408e50f8-0beb-4556-932c-e8b3b8376294</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>192.168.0.0/16</Remote_ip_prefix>
                    <Id>41ecfddb-63fc-43fe-a316-c162aed95d9a</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>173e9fe5-84ff-475b-abe9-79ce0659f6c7</Security_group_id>
                    <Port_range_max>443</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>469e1e73-9d82-4626-b563-6d42f0a79684</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>443</Port_range_min>
                </Security_group_rules>
            </Security_group_rulesContainer>
        </DataList>
        <DataList>
            <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>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>10.0.0.0/8</Remote_ip_prefix>
                    <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>172.16.0.0/12</Remote_ip_prefix>
                    <Id>10f9bad3-5d84-4219-a2fc-373752b0f083</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>443</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>20c8feee-5758-41b1-a5bc-5ed784270979</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>443</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>549afc45-c519-42c8-acd7-339a99a49c4a</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>80</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>8d3a0b48-1d48-4a29-8e0a-eae4839ba7c9</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>80</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>22</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>904fc5e8-c0ad-4203-891a-80bb5135c37a</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>22</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>192.168.0.0/16</Remote_ip_prefix>
                    <Id>cb752ca6-d268-444c-976f-fe11fb37a0cb</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                    <Port_range_max>3389</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>dab8fb73-d2a2-44c9-bd8c-d1ac8e976caf</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>3389</Port_range_min>
                </Security_group_rules>
            </Security_group_rulesContainer>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Name>aaa</Name>
            <Description/>
            <Created_at/>
            <Id>d5dfddef-de9a-4cbb-a199-43f1d92f507d</Id>
            <Isdefault>false</Isdefault>
            <Security_group_rulesContainer>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>tcp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>d5dfddef-de9a-4cbb-a199-43f1d92f507d</Security_group_id>
                    <Port_range_max>80</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>ac32b791-d7a2-40f2-9d3e-d7e326b033f8</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>8</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>null</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>d5dfddef-de9a-4cbb-a199-43f1d92f507d</Security_group_id>
                    <Port_range_max>null</Port_range_max>
                    <Remote_ip_prefix>null</Remote_ip_prefix>
                    <Id>e0ae6854-abdf-4a90-9611-a05ad5370327</Id>
                    <Direction>egress</Direction>
                    <Port_range_min>null</Port_range_min>
                </Security_group_rules>
                <Security_group_rules>
                    <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                    <Remote_group_id>null</Remote_group_id>
                    <Protocol>udp</Protocol>
                    <Ethertype>IPv4</Ethertype>
                    <Security_group_id>d5dfddef-de9a-4cbb-a199-43f1d92f507d</Security_group_id>
                    <Port_range_max>333</Port_range_max>
                    <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                    <Id>e6a78d54-1d6f-46e1-b5db-5654972b6c48</Id>
                    <Direction>ingress</Direction>
                    <Port_range_min>333</Port_range_min>
                </Security_group_rules>
            </Security_group_rulesContainer>
        </DataList>
    </DataListContainer>
    <PageSize>5</PageSize>
    <CurrentPage>1</CurrentPage>
</ListSecurityGroupsResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查询一个安全组详情

请求参数

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

返回参数

名称 位置 类型 描述
security_group 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>
    <Security_group>
        <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>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>10.0.0.0/8</Remote_ip_prefix>
                <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>172.16.0.0/12</Remote_ip_prefix>
                <Id>10f9bad3-5d84-4219-a2fc-373752b0f083</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>443</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>20c8feee-5758-41b1-a5bc-5ed784270979</Id>
                <Direction>ingress</Direction>
                <Port_range_min>443</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>null</Remote_ip_prefix>
                <Id>549afc45-c519-42c8-acd7-339a99a49c4a</Id>
                <Direction>egress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>80</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>8d3a0b48-1d48-4a29-8e0a-eae4839ba7c9</Id>
                <Direction>ingress</Direction>
                <Port_range_min>80</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>22</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>904fc5e8-c0ad-4203-891a-80bb5135c37a</Id>
                <Direction>ingress</Direction>
                <Port_range_min>22</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>null</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>null</Port_range_max>
                <Remote_ip_prefix>192.168.0.0/16</Remote_ip_prefix>
                <Id>cb752ca6-d268-444c-976f-fe11fb37a0cb</Id>
                <Direction>ingress</Direction>
                <Port_range_min>null</Port_range_min>
            </Security_group_rules>
            <Security_group_rules>
                <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
                <Remote_group_id>null</Remote_group_id>
                <Protocol>tcp</Protocol>
                <Ethertype>IPv4</Ethertype>
                <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
                <Port_range_max>3389</Port_range_max>
                <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
                <Id>dab8fb73-d2a2-44c9-bd8c-d1ac8e976caf</Id>
                <Direction>ingress</Direction>
                <Port_range_min>3389</Port_range_min>
            </Security_group_rules>
        </Security_group_rulesContainer>
    </Security_group>
</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

返回参数

名称 位置 类型 描述
security_group_rule 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>
    <Security_group_rule>
        <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <Remote_group_id>null</Remote_group_id>
        <Protocol>tcp</Protocol>
        <Ethertype>IPv4</Ethertype>
        <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
        <Port_range_max>94</Port_range_max>
        <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
        <Description/>
        <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
        <Direction>ingress</Direction>
        <Port_range_min>80</Port_range_min>
    </Security_group_rule>
</CreateSecurityGroupsRuleResponse>

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组规则列表

请求参数

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

返回参数

名称 位置 类型 描述
security_groups_rules 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
&Limit=5

响应示例

<ListSecurityGroupsRuleResponse>
    <TotalSize>13</TotalSize>
    <Star>0</Star>
    <TotalPage>3</TotalPage>
    <RequestId>6ff054d2-086f-48c9-92d3-0e93d15c1956</RequestId>
    <DataListContainer>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Remote_group_id>null</Remote_group_id>
            <Protocol>null</Protocol>
            <Ethertype>IPv4</Ethertype>
            <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <Port_range_max>null</Port_range_max>
            <Remote_ip_prefix>10.0.0.0/8</Remote_ip_prefix>
            <Description/>
            <Id>01594f63-f2ae-424e-9f8d-2f881f99e78e</Id>
            <Direction>ingress</Direction>
            <Port_range_min>null</Port_range_min>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Remote_group_id>null</Remote_group_id>
            <Protocol>tcp</Protocol>
            <Ethertype>IPv4</Ethertype>
            <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <Port_range_max>94</Port_range_max>
            <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
            <Description/>
            <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
            <Direction>ingress</Direction>
            <Port_range_min>80</Port_range_min>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Remote_group_id>null</Remote_group_id>
            <Protocol>null</Protocol>
            <Ethertype>IPv4</Ethertype>
            <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <Port_range_max>null</Port_range_max>
            <Remote_ip_prefix>172.16.0.0/12</Remote_ip_prefix>
            <Description/>
            <Id>10f9bad3-5d84-4219-a2fc-373752b0f083</Id>
            <Direction>ingress</Direction>
            <Port_range_min>null</Port_range_min>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Remote_group_id>null</Remote_group_id>
            <Protocol>tcp</Protocol>
            <Ethertype>IPv4</Ethertype>
            <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <Port_range_max>91</Port_range_max>
            <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
            <Description/>
            <Id>1afef057-6ec9-436e-bc0e-8ee8f21438ce</Id>
            <Direction>ingress</Direction>
            <Port_range_min>80</Port_range_min>
        </DataList>
        <DataList>
            <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
            <Remote_group_id>null</Remote_group_id>
            <Protocol>tcp</Protocol>
            <Ethertype>IPv4</Ethertype>
            <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
            <Port_range_max>443</Port_range_max>
            <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
            <Description/>
            <Id>20c8feee-5758-41b1-a5bc-5ed784270979</Id>
            <Direction>ingress</Direction>
            <Port_range_min>443</Port_range_min>
        </DataList>
    </DataListContainer>
    <PageSize>5</PageSize>
    <CurrentPage>1</CurrentPage>
</ListSecurityGroupsRuleResponse

返回值

请参考通用请求返回值

错误码

请参考异常返回

查看安全组规则详情

请求参数

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

返回参数

名称 位置 类型 描述
security_group_rule 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>
    <Security_group_rule>
        <Tenant_id>f30f66009a5540f6a08d0a165229ae60</Tenant_id>
        <Remote_group_id>null</Remote_group_id>
        <Protocol>tcp</Protocol>
        <Ethertype>IPv4</Ethertype>
        <Security_group_id>594a8325-a701-4483-b710-da6378b63f82</Security_group_id>
        <Port_range_max>94</Port_range_max>
        <Remote_ip_prefix>0.0.0.0/0</Remote_ip_prefix>
        <Description/>
        <Id>0883d54d-1aeb-46f0-81e8-338df319b743</Id>
        <Direction>ingress</Direction>
        <Port_range_min>80</Port_range_min>
    </Security_group_rule>
</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

响应示例

返回值

请参考通用请求返回值

错误码

请参考异常返回