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
响应示例
无
返回值
请参考通用请求返回值
错误码
请参考异常返回