文档首页 > > API参考> Kubernetes API> Namespace> 创建Namespace

创建Namespace

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

功能介绍

创建一个Namespace。

当前云容器实例提供“通用计算型”“GPU加速型”两种类型的资源,创建命名空间时需要选择资源类型,后续创建的负载中容器就运行在此类型的集群上。调用接口时必须指定metadata.annotations中namespace.kubernetes.io/flavor字段为如下值。

  • general-computing:通用计算型,基本水平的计算、存储和网络资源,适用于通用工作负载场景。
  • gpu-accelerated:GPU加速型,突出的图形计算能力,适用于AI等高性能场景。

Namespace下必须要创建一个Network,用于定义kubernetes中一个namespace内的网络与华为云虚拟私有云服务的子网和vpc的映射关系,具体请参见创建Network

URI

POST /api/v1/namespaces

表1 Query描述

参数

是否必选

描述

pretty

No

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

请求消息

请求参数:

表2 Namespace v1数据结构说明

参数

是否必选

参数类型

描述

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. In CamelCase.

The value of this parameter is Namespace.

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 v1.

metadata

Yes

Object

Standard object metadata. 详情请参见表10

其中,annotations、labels字段请参见表3表4

spec

No

Object

Spec defines the behavior of the Namespace. 详情请参见表5

status

No

Object

Status describes the current status of a Namespace. 详情请参见表7

表3 metadata.annotations字段说明

参数

是否必选

参数类型

描述

namespace.kubernetes.io/flavor

Yes

String

用于指定namespace所属集群的flavor类型,目前支持GPU加速型(gpu-accelerated)、通用计算型(general-computing)两种类型。

namespace.kubernetes.io/allowed-on-shared-node

No

String

用于指定是否开启弹性调度,可设置为true或false。默认取值为false,不开启时不需要指定该参数值。

弹性调度:指当专属资源用尽时,可自动弹性创建CCI按需实例。

表4 metadata.labels字段说明

参数

是否必选

参数类型

描述

sys_enterprise_project_id

No

String

用于指定企业项目的ID。

表5 namespace spec字段数据结构说明

参数

是否必选

参数类型

描述

finalizers

No

Array of objects

Finalizers is an opaque list of values that must be empty to permanently remove object from storage. 详情请参见表6

表6 FinalizerName取值说明

名称

FinalizerKubernetes

kubernetes

表7 namespace status字段数据结构说明

参数

是否必选

参数类型

描述

phase

No

String

Phase is the current lifecycle phase of the namespace.

Namespace的状态有2个:

- Active: means the namespace is available for use in the system

- Terminating: means the namespace is undergoing graceful termination

请求示例:
{
    "apiVersion": "v1",
    "kind": "Namespace",
    "metadata": {
        "name": "namespace-test",
        "annotations": {
            "namespace.kubernetes.io/flavor": "gpu-accelerated"
        },
        "labels": {
            "sys_enterprise_project_id": "0503dda897000fed2f78c00909158a4d"
    },
    "spec": {
        "finalizers": [
            "kubernetes"
        ]
    }
}
}

响应消息

响应参数:

响应参数的详细描述请参见表2

表8 metadata.annotations字段说明

参数

参数类型

描述

pv.kubernetes.io/enable-dynamic-provisioning

String

是否支持动态创建存储。

tenant.kubernetes.io/domain-id

String

用户的账号ID。

tenant.kubernetes.io/domain-name

String

用户的账号名。

tenant.kubernetes.io/project-id

String

用户的项目ID。

tenant.kubernetes.io/project-name

String

用户的项目名称。

响应示例:

{
    "metadata": {
        "name": "namespace-test",
        "selfLink": "/api/v1/namespaces/namespace-test",
        "uid": "68a68c5a-af6b-11e8-8f17-c81fbe371a17",
        "resourceVersion": "5016746",
        "creationTimestamp": "2018-09-03T11:20:48Z",
        "annotations": {
            "namespace.kubernetes.io/flavor": "gpu-accelerated",
            "pv.kubernetes.io/enable-dynamic-provisioning": "true",
            "tenant.kubernetes.io/domain-id": "aadb43c0b14c4cafbccfff483d075987",
            "tenant.kubernetes.io/domain-name": "cci",
            "tenant.kubernetes.io/project-id": "51bf52609f2a49c68bfda3398817b376",
            "tenant.kubernetes.io/project-name": "southchina"
        },
        "enable": true,
        "labels": {
            "sys_enterprise_project_id": "0503dda897000fed2f78c00909158a4d"
        }
    },
    "spec": {
        "finalizers": [
            "kubernetes"
        ]
    },
    "status": {
        "phase": "Active"
    }
}

状态码

表9描述API的状态码。

表9 状态码

状态码

描述

201

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

更多状态码请参见状态码

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问