---
title: "创建K8s命名空间"
method: POST
path: "/api/v1/k8s/cluster/{id}/namespaces"
tags: ["K8s命名空间管理"]
---

# 创建K8s命名空间

`POST /api/v1/k8s/cluster/{id}/namespaces`

在指定集群中创建新的命名空间

## Path parameters

- `id` integer, required

## Request body

- ModelCreateNamespaceRequest
  - `annotations` object — 注释
  - `labels` object — 标签
  - `name` string, required — 命名空间名称

## Response `200`

创建成功

- object
  - `code` integer — 状态码
  - `data` object — 返回的数据
    - `annotations` object — 注释
    - `createdAt` string — 创建时间
    - `labels` object — 标签
    - `limitRanges` ModelLimitRangeDetail[] — 默认资源限制列表
      - `createdAt` string — 创建时间
      - `limits` ModelLimitRangeItem[] — 限制项列表
        - `default` object — 默认值
        - `defaultRequest` object — 默认请求值
        - `max` object — 最大限制
        - `maxLimitRequestRatio` object — 最大限制与请求比率
        - `min` object — 最小限制
        - `type` string — 限制类型 Container/Pod/PersistentVolumeClaim
      - `name` string — LimitRange名称
    - `name` string — 命名空间名称
    - `resourceCount` ModelNamespaceResourceCount
      - `configMapCount` integer — ConfigMap数量
      - `podCount` integer — Pod数量
      - `secretCount` integer — Secret数量
      - `serviceCount` integer — Service数量
    - `resourceQuotas` ModelResourceQuotaDetail[] — 资源配额列表
      - `cpuQuota` ModelQuotaInfo
        - `hard` string — 限制值
        - `used` string — 已使用值
      - `createdAt` string — 创建时间
      - `hard` object — 硬限制
      - `memoryQuota` ModelQuotaInfo
        - `hard` string — 限制值
        - `used` string — 已使用值
      - `name` string — ResourceQuota名称
      - `storageQuota` ModelQuotaInfo
        - `hard` string — 限制值
        - `used` string — 已使用值
      - `used` object — 已使用
    - `status` string — 状态 Active/Terminating
  - `message` string — 提示信息

## Other responses

- `400` — 参数错误
- `404` — 集群不存在
- `500` — 服务器错误

---

[API](https://skmtc.net/opsre/apis/devops.md) · [All operations](https://skmtc.net/opsre/apis/devops/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opsre/devops/versions/25cac8835c4c/schema)