创建Network_云容器实例 CCI_API参考_API_Network
VIEW CONTENTS
摘要: 创建一个Network对象。Network对象是华为云CCI新增对象,用于定义kubernetes中一个namespace内的网络。目前CCI支持VPC网络,一个VPC网络类型的network对象对应于华为云虚拟私有云服务中的一个子网。CCI的容器网络依 ...
点击领取2000元阿里云代金券,付款抵现金用,云服务器69元/年限时抢>>>    点击咨询成为阿里云VIP客户享永久折扣>>>
点击领取2860元腾讯云代金券,付款抵现金用云服务器88元/年限时抢>>>    点击成为腾讯云VIP客户享永久折扣优惠>>>
点击进入华为云最新优惠活动现场>>>    点击成为华为云VIP客户享永久折扣优惠>>>

功能介绍

创建一个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.

更多状态码请参见状态码


路过

雷人

握手

鲜花

鸡蛋

相关阅读

2021-9-24 12:02| 发布者: xtyly| 查看: 52| 评论: 0



在线客服(工作时间:9:00-22:00)
400-600-6565

内容导航

微信客服

Copyright   ©2015-2019  云服务器社区  Powered by©Discuz!  技术支持:尊托网络     ( 湘ICP备15009499号-1 )