文档首页 > > API参考> API> Network> 创建Network

创建Network

分享
更新时间:2020/12/17 GMT+08:00

功能介绍

创建一个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,则可以使用此网段。

安全组ID可以在安全组控制台获取,如下图。
图1 获取安全组ID
VPC ID、子网ID和网络ID可以VPC控制台获取。
图2 获取VPC ID
图3 获取子网ID和网络ID

URI

POST /apis/networking.cci.io/v1beta1/namespaces/{namespace}/networks

表1 Path参数

参数

描述

namespace

Object name and auth scope, such as for teams and projects.

表2 Query参数

参数

是否必选

描述

pretty

No

If 'true', then the output is pretty printed.

请求消息

请求参数

表3 请求参数

参数

是否必选

参数类型

描述

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

表10

Standard object metadata.

其中annotations字段请参见表4

另外必须设置metadata.Namespace=当前操作的namespace

spec

Yes

表5

Specification of the desired behavior of the Network.

status

No

表6

Most recently observed status of the Network.

表4 metadata.annotations必选字段数据结构说明

参数

是否必选

参数类型

描述

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

表5 VPC网络类型

参数

是否必选

参数类型

描述

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”。

表6 status字段数据结构说明

参数

是否必选

参数类型

描述

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"
    }
}

状态码

表7 状态码

状态码

描述

201

This operation succeeds, and a Network resource object is returned.

更多状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问