labels page, api as well as integrating labels in the node pool page

This commit is contained in:
allanice001
2025-09-03 21:51:52 +01:00
parent b99a0684fd
commit 816e11dbd4
13 changed files with 3010 additions and 171 deletions

View File

@@ -810,7 +810,7 @@ const docTemplate = `{
"BearerAuth": []
}
],
"description": "Returns node labels for the organization in X-Org-ID. Filters: ` + "`" + `name` + "`" + `, ` + "`" + `value` + "`" + `, and ` + "`" + `q` + "`" + ` (name contains). Add ` + "`" + `include=node_pools` + "`" + ` to include linked node groups.",
"description": "Returns node labels for the organization in X-Org-ID. Filters: ` + "`" + `key` + "`" + `, ` + "`" + `value` + "`" + `, and ` + "`" + `q` + "`" + ` (key contains). Add ` + "`" + `include=node_pools` + "`" + ` to include linked node groups.",
"consumes": [
"application/json"
],
@@ -831,8 +831,8 @@ const docTemplate = `{
},
{
"type": "string",
"description": "Exact name",
"name": "name",
"description": "Exact key",
"name": "key",
"in": "query"
},
{
@@ -843,7 +843,7 @@ const docTemplate = `{
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"description": "Key contains (case-insensitive)",
"name": "q",
"in": "query"
},
@@ -1180,6 +1180,257 @@ const docTemplate = `{
}
}
},
"/api/v1/labels/{id}/node_pools": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "Returns node pools attached to the label. Supports ` + "`" + `q` + "`" + ` (name contains, case-insensitive).",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "List node pools linked to a label (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"name": "q",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/labels.nodePoolBrief"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
"BearerAuth": []
}
],
"description": "Links the label to one or more node pools in the same organization.",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "Attach label to node pools (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"description": "IDs to attach",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/labels.addLabelToPoolRequest"
}
},
{
"type": "string",
"description": "Optional: node_pools",
"name": "include",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/labels.labelResponse"
}
},
"400": {
"description": "invalid id / invalid json / invalid node_pool_ids",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "attach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/labels/{id}/node_pools/{poolId}": {
"delete": {
"security": [
{
"BearerAuth": []
}
],
"description": "Unlinks the label from the specified node pool.",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "Detach label from a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "poolId",
"in": "path",
"required": true
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "detach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools": {
"get": {
"security": [
@@ -1545,6 +1796,242 @@ const docTemplate = `{
}
}
},
"/api/v1/node-pools/{id}/labels": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "List labels attached to a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/nodepools.labelBrief"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "Attach labels to a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Label IDs to attach",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/nodepools.attachLabelsRequest"
}
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id / invalid label_ids",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "attach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools/{id}/labels/{labelId}": {
"delete": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "Detach one label from a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "labelId",
"in": "path",
"required": true
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "detach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools/{id}/servers": {
"get": {
"security": [
@@ -3062,7 +3549,7 @@ const docTemplate = `{
"BearerAuth": []
}
],
"description": "Returns node taints for the organization in X-Org-ID. Filters: ` + "`" + `name` + "`" + `, ` + "`" + `value` + "`" + `, and ` + "`" + `q` + "`" + ` (name contains). Add ` + "`" + `include=node_groups` + "`" + ` to include linked node groups.",
"description": "Returns node taints for the organization in X-Org-ID. Filters: ` + "`" + `key` + "`" + `, ` + "`" + `value` + "`" + `, and ` + "`" + `q` + "`" + ` (key contains). Add ` + "`" + `include=node_groups` + "`" + ` to include linked node groups.",
"consumes": [
"application/json"
],
@@ -3083,8 +3570,8 @@ const docTemplate = `{
},
{
"type": "string",
"description": "Exact name",
"name": "name",
"description": "Exact key",
"name": "key",
"in": "query"
},
{
@@ -3095,7 +3582,7 @@ const docTemplate = `{
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"description": "key contains (case-insensitive)",
"name": "q",
"in": "query"
},
@@ -3433,6 +3920,87 @@ const docTemplate = `{
}
},
"/api/v1/taints/{id}/node_pools": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "Returns node pools attached to the taint. Supports ` + "`" + `q` + "`" + ` (name contains, case-insensitive).",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"taints"
],
"summary": "List node pools linked to a taint (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Taint ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"name": "q",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/taints.nodePoolResponse"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
@@ -3826,6 +4394,17 @@ const docTemplate = `{
"updated_at": {}
}
},
"labels.addLabelToPoolRequest": {
"type": "object",
"properties": {
"node_pool_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"labels.createLabelRequest": {
"type": "object",
"properties": {
@@ -4001,6 +4580,17 @@ const docTemplate = `{
}
}
},
"nodepools.attachLabelsRequest": {
"type": "object",
"properties": {
"label_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"nodepools.attachServersRequest": {
"type": "object",
"properties": {
@@ -4038,6 +4628,20 @@ const docTemplate = `{
}
}
},
"nodepools.labelBrief": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
},
"nodepools.nodePoolResponse": {
"type": "object",
"properties": {
@@ -4325,6 +4929,43 @@ const docTemplate = `{
}
}
},
"taints.nodePoolResponse": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"servers": {
"type": "array",
"items": {
"$ref": "#/definitions/taints.serverBrief"
}
}
}
},
"taints.serverBrief": {
"type": "object",
"properties": {
"hostname": {
"type": "string"
},
"id": {
"type": "string"
},
"ip": {
"type": "string"
},
"role": {
"type": "string"
},
"status": {
"type": "string"
}
}
},
"taints.taintResponse": {
"type": "object",
"properties": {

View File

@@ -806,7 +806,7 @@
"BearerAuth": []
}
],
"description": "Returns node labels for the organization in X-Org-ID. Filters: `name`, `value`, and `q` (name contains). Add `include=node_pools` to include linked node groups.",
"description": "Returns node labels for the organization in X-Org-ID. Filters: `key`, `value`, and `q` (key contains). Add `include=node_pools` to include linked node groups.",
"consumes": [
"application/json"
],
@@ -827,8 +827,8 @@
},
{
"type": "string",
"description": "Exact name",
"name": "name",
"description": "Exact key",
"name": "key",
"in": "query"
},
{
@@ -839,7 +839,7 @@
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"description": "Key contains (case-insensitive)",
"name": "q",
"in": "query"
},
@@ -1176,6 +1176,257 @@
}
}
},
"/api/v1/labels/{id}/node_pools": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "Returns node pools attached to the label. Supports `q` (name contains, case-insensitive).",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "List node pools linked to a label (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"name": "q",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/labels.nodePoolBrief"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
"BearerAuth": []
}
],
"description": "Links the label to one or more node pools in the same organization.",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "Attach label to node pools (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"description": "IDs to attach",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/labels.addLabelToPoolRequest"
}
},
{
"type": "string",
"description": "Optional: node_pools",
"name": "include",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/labels.labelResponse"
}
},
"400": {
"description": "invalid id / invalid json / invalid node_pool_ids",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "attach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/labels/{id}/node_pools/{poolId}": {
"delete": {
"security": [
{
"BearerAuth": []
}
],
"description": "Unlinks the label from the specified node pool.",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"labels"
],
"summary": "Detach label from a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "poolId",
"in": "path",
"required": true
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "detach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools": {
"get": {
"security": [
@@ -1541,6 +1792,242 @@
}
}
},
"/api/v1/node-pools/{id}/labels": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "List labels attached to a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/nodepools.labelBrief"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "Attach labels to a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Label IDs to attach",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/nodepools.attachLabelsRequest"
}
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id / invalid label_ids",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "attach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools/{id}/labels/{labelId}": {
"delete": {
"security": [
{
"BearerAuth": []
}
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"node-pools"
],
"summary": "Detach one label from a node pool (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Node Pool ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Label ID (UUID)",
"name": "labelId",
"in": "path",
"required": true
}
],
"responses": {
"204": {
"description": "No Content",
"schema": {
"type": "string"
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "detach failed",
"schema": {
"type": "string"
}
}
}
}
},
"/api/v1/node-pools/{id}/servers": {
"get": {
"security": [
@@ -3058,7 +3545,7 @@
"BearerAuth": []
}
],
"description": "Returns node taints for the organization in X-Org-ID. Filters: `name`, `value`, and `q` (name contains). Add `include=node_groups` to include linked node groups.",
"description": "Returns node taints for the organization in X-Org-ID. Filters: `key`, `value`, and `q` (key contains). Add `include=node_groups` to include linked node groups.",
"consumes": [
"application/json"
],
@@ -3079,8 +3566,8 @@
},
{
"type": "string",
"description": "Exact name",
"name": "name",
"description": "Exact key",
"name": "key",
"in": "query"
},
{
@@ -3091,7 +3578,7 @@
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"description": "key contains (case-insensitive)",
"name": "q",
"in": "query"
},
@@ -3429,6 +3916,87 @@
}
},
"/api/v1/taints/{id}/node_pools": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "Returns node pools attached to the taint. Supports `q` (name contains, case-insensitive).",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"taints"
],
"summary": "List node pools linked to a taint (org scoped)",
"parameters": [
{
"type": "string",
"description": "Organization UUID",
"name": "X-Org-ID",
"in": "header",
"required": true
},
{
"type": "string",
"description": "Taint ID (UUID)",
"name": "id",
"in": "path",
"required": true
},
{
"type": "string",
"description": "Name contains (case-insensitive)",
"name": "q",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/taints.nodePoolResponse"
}
}
},
"400": {
"description": "invalid id",
"schema": {
"type": "string"
}
},
"401": {
"description": "Unauthorized",
"schema": {
"type": "string"
}
},
"403": {
"description": "organization required",
"schema": {
"type": "string"
}
},
"404": {
"description": "not found",
"schema": {
"type": "string"
}
},
"500": {
"description": "fetch failed",
"schema": {
"type": "string"
}
}
}
},
"post": {
"security": [
{
@@ -3822,6 +4390,17 @@
"updated_at": {}
}
},
"labels.addLabelToPoolRequest": {
"type": "object",
"properties": {
"node_pool_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"labels.createLabelRequest": {
"type": "object",
"properties": {
@@ -3997,6 +4576,17 @@
}
}
},
"nodepools.attachLabelsRequest": {
"type": "object",
"properties": {
"label_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"nodepools.attachServersRequest": {
"type": "object",
"properties": {
@@ -4034,6 +4624,20 @@
}
}
},
"nodepools.labelBrief": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
},
"nodepools.nodePoolResponse": {
"type": "object",
"properties": {
@@ -4321,6 +4925,43 @@
}
}
},
"taints.nodePoolResponse": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"servers": {
"type": "array",
"items": {
"$ref": "#/definitions/taints.serverBrief"
}
}
}
},
"taints.serverBrief": {
"type": "object",
"properties": {
"hostname": {
"type": "string"
},
"id": {
"type": "string"
},
"ip": {
"type": "string"
},
"role": {
"type": "string"
},
"status": {
"type": "string"
}
}
},
"taints.taintResponse": {
"type": "object",
"properties": {

View File

@@ -152,6 +152,13 @@ definitions:
type: string
updated_at: {}
type: object
labels.addLabelToPoolRequest:
properties:
node_pool_ids:
items:
type: string
type: array
type: object
labels.createLabelRequest:
properties:
key:
@@ -267,6 +274,13 @@ definitions:
updated_at:
type: string
type: object
nodepools.attachLabelsRequest:
properties:
label_ids:
items:
type: string
type: array
type: object
nodepools.attachServersRequest:
properties:
server_ids:
@@ -291,6 +305,15 @@ definitions:
type: string
type: array
type: object
nodepools.labelBrief:
properties:
id:
type: string
key:
type: string
value:
type: string
type: object
nodepools.nodePoolResponse:
properties:
id:
@@ -480,6 +503,30 @@ definitions:
name:
type: string
type: object
taints.nodePoolResponse:
properties:
id:
type: string
name:
type: string
servers:
items:
$ref: '#/definitions/taints.serverBrief'
type: array
type: object
taints.serverBrief:
properties:
hostname:
type: string
id:
type: string
ip:
type: string
role:
type: string
status:
type: string
type: object
taints.taintResponse:
properties:
effect:
@@ -1019,7 +1066,7 @@ paths:
consumes:
- application/json
description: 'Returns node labels for the organization in X-Org-ID. Filters:
`name`, `value`, and `q` (name contains). Add `include=node_pools` to include
`key`, `value`, and `q` (key contains). Add `include=node_pools` to include
linked node groups.'
parameters:
- description: Organization UUID
@@ -1027,15 +1074,15 @@ paths:
name: X-Org-ID
required: true
type: string
- description: Exact name
- description: Exact key
in: query
name: name
name: key
type: string
- description: Exact value
in: query
name: value
type: string
- description: Name contains (case-insensitive)
- description: Key contains (case-insensitive)
in: query
name: q
type: string
@@ -1261,6 +1308,171 @@ paths:
summary: Update label (org scoped)
tags:
- labels
/api/v1/labels/{id}/node_pools:
get:
consumes:
- application/json
description: Returns node pools attached to the label. Supports `q` (name contains,
case-insensitive).
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Label ID (UUID)
in: path
name: id
required: true
type: string
- description: Name contains (case-insensitive)
in: query
name: q
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
items:
$ref: '#/definitions/labels.nodePoolBrief'
type: array
"400":
description: invalid id
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: fetch failed
schema:
type: string
security:
- BearerAuth: []
summary: List node pools linked to a label (org scoped)
tags:
- labels
post:
consumes:
- application/json
description: Links the label to one or more node pools in the same organization.
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Label ID (UUID)
in: path
name: id
required: true
type: string
- description: IDs to attach
in: body
name: body
required: true
schema:
$ref: '#/definitions/labels.addLabelToPoolRequest'
- description: 'Optional: node_pools'
in: query
name: include
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/labels.labelResponse'
"400":
description: invalid id / invalid json / invalid node_pool_ids
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: attach failed
schema:
type: string
security:
- BearerAuth: []
summary: Attach label to node pools (org scoped)
tags:
- labels
/api/v1/labels/{id}/node_pools/{poolId}:
delete:
consumes:
- application/json
description: Unlinks the label from the specified node pool.
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Label ID (UUID)
in: path
name: id
required: true
type: string
- description: Node Pool ID (UUID)
in: path
name: poolId
required: true
type: string
produces:
- application/json
responses:
"204":
description: No Content
schema:
type: string
"400":
description: invalid id
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: detach failed
schema:
type: string
security:
- BearerAuth: []
summary: Detach label from a node pool (org scoped)
tags:
- labels
/api/v1/node-pools:
get:
consumes:
@@ -1499,6 +1711,159 @@ paths:
summary: Update node pool (org scoped)
tags:
- node-pools
/api/v1/node-pools/{id}/labels:
get:
consumes:
- application/json
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Node Pool ID (UUID)
in: path
name: id
required: true
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
items:
$ref: '#/definitions/nodepools.labelBrief'
type: array
"400":
description: invalid id
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: fetch failed
schema:
type: string
security:
- BearerAuth: []
summary: List labels attached to a node pool (org scoped)
tags:
- node-pools
post:
consumes:
- application/json
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Node Pool ID (UUID)
in: path
name: id
required: true
type: string
- description: Label IDs to attach
in: body
name: body
required: true
schema:
$ref: '#/definitions/nodepools.attachLabelsRequest'
produces:
- application/json
responses:
"204":
description: No Content
schema:
type: string
"400":
description: invalid id / invalid label_ids
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: attach failed
schema:
type: string
security:
- BearerAuth: []
summary: Attach labels to a node pool (org scoped)
tags:
- node-pools
/api/v1/node-pools/{id}/labels/{labelId}:
delete:
consumes:
- application/json
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Node Pool ID (UUID)
in: path
name: id
required: true
type: string
- description: Label ID (UUID)
in: path
name: labelId
required: true
type: string
produces:
- application/json
responses:
"204":
description: No Content
schema:
type: string
"400":
description: invalid id
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: detach failed
schema:
type: string
security:
- BearerAuth: []
summary: Detach one label from a node pool (org scoped)
tags:
- node-pools
/api/v1/node-pools/{id}/servers:
get:
consumes:
@@ -2483,7 +2848,7 @@ paths:
consumes:
- application/json
description: 'Returns node taints for the organization in X-Org-ID. Filters:
`name`, `value`, and `q` (name contains). Add `include=node_groups` to include
`key`, `value`, and `q` (key contains). Add `include=node_groups` to include
linked node groups.'
parameters:
- description: Organization UUID
@@ -2491,15 +2856,15 @@ paths:
name: X-Org-ID
required: true
type: string
- description: Exact name
- description: Exact key
in: query
name: name
name: key
type: string
- description: Exact value
in: query
name: value
type: string
- description: Name contains (case-insensitive)
- description: key contains (case-insensitive)
in: query
name: q
type: string
@@ -2726,6 +3091,60 @@ paths:
tags:
- taints
/api/v1/taints/{id}/node_pools:
get:
consumes:
- application/json
description: Returns node pools attached to the taint. Supports `q` (name contains,
case-insensitive).
parameters:
- description: Organization UUID
in: header
name: X-Org-ID
required: true
type: string
- description: Taint ID (UUID)
in: path
name: id
required: true
type: string
- description: Name contains (case-insensitive)
in: query
name: q
type: string
produces:
- application/json
responses:
"200":
description: OK
schema:
items:
$ref: '#/definitions/taints.nodePoolResponse'
type: array
"400":
description: invalid id
schema:
type: string
"401":
description: Unauthorized
schema:
type: string
"403":
description: organization required
schema:
type: string
"404":
description: not found
schema:
type: string
"500":
description: fetch failed
schema:
type: string
security:
- BearerAuth: []
summary: List node pools linked to a taint (org scoped)
tags:
- taints
post:
consumes:
- application/json