创建Network
功能介绍
创建一个Network对象。
Network对象是华为云CCI新增对象，用于定义kubernetes中一个namespace内的网络。目前CCI支持VPC网络，一个VPC网络类型的network对象对应于华为云虚拟私有云服务中的一个子网。
CCI的容器网络依赖于华为云底层VPC网络，因此在创建network对象前，需要先调用虚拟私有云的接口创建或者查询已有子网信息。
此处VPC和子网的网段不能为10.247.0.0/16，10.247.0.0/16是云容器实例预留给Service的网段。如果您使用此网段，后续可能会造成IP冲突，导致负载无法创建或服务不可用；如果您不需要通过Service访问，而是直接访问Pod，则可以使用此网段。
URI
POST /apis/networking.cci.io/v1beta1/namespaces/{namespace}/networks
参数 |
描述 |
|---|---|
namespace |
Object name and auth scope, such as for teams and projects. |
参数 |
是否必选 |
描述 |
|---|---|---|
pretty |
No |
If 'true', then the output is pretty printed. |
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
kind |
Yes |
String |
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. The value of this parameter is Network. |
apiVersion |
Yes |
String |
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values.The value of this parameter is networking.cci.io. |
metadata |
Yes |
Standard object metadata. 其中annotations字段请参见表4。 另外必须设置metadata.Namespace=当前操作的namespace |
|
spec |
Yes |
Specification of the desired behavior of the Network. |
|
status |
No |
Most recently observed status of the Network. |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
network.alpha.kubernetes.io/default-security-group |
Yes |
String |
Network对应子网所属安全组ID。 |
network.alpha.kubernetes.io/project-id |
Yes |
String |
Network所属用户的project-id，获取方法请参见获取项目ID。 |
network.alpha.kubernetes.io/domain-id |
Yes |
String |
Network所属用户的domain-id，获取方法请参见获取账号ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
cidr |
No |
String |
Network对应VPC子网的网段。 说明：
此处VPC和子网的网段不能为10.247.0.0/16，10.247.0.0/16是云容器实例预留给Service的网段。如果您使用此网段，后续可能会造成IP冲突，导致负载无法创建或服务不可用；如果您不需要通过Service访问，而是直接访问Pod，则可以使用此网段。 |
attachedVPC |
Yes |
String |
Network 所在VPC的ID。 |
networkType |
Yes |
String |
Network 网络类型，VPC网络类型取值：underlay_neutron。 |
networkID |
Yes |
String |
Network对应VPC子网的网络ID。 |
subnetID |
Yes |
String |
Network对应VPC子网的子网ID。 |
availableZone |
Yes |
String |
Network对应VPC子网所在可用区。当前支持“华北-北京一”、“华北-北京四”和“华东-上海一”区域，该值可设置为“cn-north-1a”、“cn-north-4a”或“cn-east-3a”。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
state |
No |
String |
Network所处状态，包括Initializing、Active、Pending、Failed、Terminating。 |
Message |
No |
String |
Network对象所处当前状态的原因 |
{
"apiVersion": "networking.cci.io/v1beta1",
"kind": "Network",
"metadata": {
"annotations": {
"network.alpha.kubernetes.io/default-security-group": "security-group-id",
"network.alpha.kubernetes.io/domain-id": "domain-id",
"network.alpha.kubernetes.io/project-id": "project-id"
},
"name": "test-network",
"namespace": "test-ns"
},
"spec": {
"availableZone": "cn-north-1a",
"cidr": "192.168.0.0/24",
"attachedVPC": "vpc-id",
"networkID": "network-id",
"networkType": "underlay_neutron",
"subnetID": "subnet-id"
}
}
响应消息
响应参数
响应参数详情见表3
响应示例
{
"kind": "Network",
"apiVersion": "networking.cci.io/v1beta1",
"metadata": {
"name": "test-network",
"namespace": "test-ns",
"selfLink": "/apis/networking.cci.io/v1beta1/namespaces/test-ns/networks/test-network",
"uid": "f03452ac-a4ea-11e8-8500-c81fbe371a17",
"resourceVersion": "2025736",
"creationTimestamp": "2018-08-21T02:35:59Z",
"annotations": {
"network.alpha.kubernetes.io/default-security-group": "security-group-id",
"network.alpha.kubernetes.io/domain-id": "domain-id",
"network.alpha.kubernetes.io/project-id": "project-id",
"network.alpha.kubernetes.io/type": "underlay_neutron"
},
"enable": true
},
"spec": {
"availableZone": "cn-north-1a",
"cidr": "192.168.0.0/24",
"attachedVPC": "vpc-id",
"networkID": "network-id",
"networkType": "underlay_neutron",
"subnetID": "subnet-id"
},
"status": {
"state": "Initializing"
}
}
状态码
状态码 |
描述 |
|---|---|
201 |
This operation succeeds, and a Network resource object is returned. |
更多状态码请参见状态码。
