Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Workflow] Update Swagger REST API doc #1915

Merged
merged 1 commit into from
Nov 1, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions src/api/rest/docs/docs.go
Original file line number Diff line number Diff line change
Expand Up @@ -930,7 +930,7 @@ const docTemplate = `{
"[Kubernetes] Cluster Management"
],
"summary": "Recommend K8sCluster's Node plan (filter and priority)",
"operationId": "RecommendNode",
"operationId": "RecommendK8sNode",
"parameters": [
{
"description": "Recommend K8sCluster's Node plan (filter and priority)",
Expand Down Expand Up @@ -3213,7 +3213,7 @@ const docTemplate = `{
"required": true
},
{
"description": "Request body to provision K8sCluster dynamically. \u003cbr\u003e Must include commonSpec and commonImage info. \u003cbr\u003e (ex: {name: k8scluster-01, commonImage: azure+koreacentral+ubuntu22.04, commonSpec: azure+koreacentral+Standard_B2s}]}) \u003cbr\u003e You can use /k8sclusterRecommendNode and /k8sclusterDynamicCheckRequest to get it. \u003cbr\u003e Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1570",
"description": "Request body to provision K8sCluster dynamically. \u003cbr\u003e Must include commonSpec and commonImage info. \u003cbr\u003e (ex: {name: k8scluster-01, commonImage: azure+koreacentral+ubuntu22.04, commonSpec: azure+koreacentral+Standard_B2s}]}) \u003cbr\u003e You can use /k8sclusterRecommendNode and /k8sclusterDynamicCheckRequest to get it. \u003cbr\u003e Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1913",
"name": "k8sclusterReq",
"in": "body",
"required": true,
Expand Down Expand Up @@ -11161,7 +11161,7 @@ const docTemplate = `{
"type": "string"
},
"example": [
"azure+koreacentral+Standard_B2s"
"tencent+ap-seoul+S2.MEDIUM4"
]
}
}
Expand Down Expand Up @@ -13195,17 +13195,17 @@ const docTemplate = `{
"commonImage": {
"description": "CommonImage is field for id of a image in common namespace",
"type": "string",
"example": "default, azure+koreacentrall+ubuntu20.04"
"example": "default, tencent+ap-seoul+ubuntu20.04"
},
"commonSpec": {
"description": "CommonSpec is field for id of a spec in common namespace",
"type": "string",
"example": "azure+koreacentral+standard_b2s"
"example": "tencent+ap-seoul+S2.MEDIUM4"
},
"connectionName": {
"description": "if ConnectionName is given, the VM tries to use associtated credential.\nif not, it will use predefined ConnectionName in Spec objects",
"type": "string",
"default": "azure-koreacentral"
"default": "tencent-ap-seoul"
},
"description": {
"type": "string",
Expand Down
12 changes: 6 additions & 6 deletions src/api/rest/docs/swagger.json
Original file line number Diff line number Diff line change
Expand Up @@ -923,7 +923,7 @@
"[Kubernetes] Cluster Management"
],
"summary": "Recommend K8sCluster's Node plan (filter and priority)",
"operationId": "RecommendNode",
"operationId": "RecommendK8sNode",
"parameters": [
{
"description": "Recommend K8sCluster's Node plan (filter and priority)",
Expand Down Expand Up @@ -3206,7 +3206,7 @@
"required": true
},
{
"description": "Request body to provision K8sCluster dynamically. \u003cbr\u003e Must include commonSpec and commonImage info. \u003cbr\u003e (ex: {name: k8scluster-01, commonImage: azure+koreacentral+ubuntu22.04, commonSpec: azure+koreacentral+Standard_B2s}]}) \u003cbr\u003e You can use /k8sclusterRecommendNode and /k8sclusterDynamicCheckRequest to get it. \u003cbr\u003e Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1570",
"description": "Request body to provision K8sCluster dynamically. \u003cbr\u003e Must include commonSpec and commonImage info. \u003cbr\u003e (ex: {name: k8scluster-01, commonImage: azure+koreacentral+ubuntu22.04, commonSpec: azure+koreacentral+Standard_B2s}]}) \u003cbr\u003e You can use /k8sclusterRecommendNode and /k8sclusterDynamicCheckRequest to get it. \u003cbr\u003e Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1913",
"name": "k8sclusterReq",
"in": "body",
"required": true,
Expand Down Expand Up @@ -11154,7 +11154,7 @@
"type": "string"
},
"example": [
"azure+koreacentral+Standard_B2s"
"tencent+ap-seoul+S2.MEDIUM4"
]
}
}
Expand Down Expand Up @@ -13188,17 +13188,17 @@
"commonImage": {
"description": "CommonImage is field for id of a image in common namespace",
"type": "string",
"example": "default, azure+koreacentrall+ubuntu20.04"
"example": "default, tencent+ap-seoul+ubuntu20.04"
},
"commonSpec": {
"description": "CommonSpec is field for id of a spec in common namespace",
"type": "string",
"example": "azure+koreacentral+standard_b2s"
"example": "tencent+ap-seoul+S2.MEDIUM4"
},
"connectionName": {
"description": "if ConnectionName is given, the VM tries to use associtated credential.\nif not, it will use predefined ConnectionName in Spec objects",
"type": "string",
"default": "azure-koreacentral"
"default": "tencent-ap-seoul"
},
"description": {
"type": "string",
Expand Down
12 changes: 6 additions & 6 deletions src/api/rest/docs/swagger.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -688,7 +688,7 @@ paths:
summary: Recommend K8sCluster's Node plan (filter and priority)
description: Recommend K8sCluster's Node plan (filter and priority) Find details
from https://github.com/cloud-barista/cb-tumblebug/discussions/1234
operationId: RecommendNode
operationId: RecommendK8sNode
requestBody:
description: Recommend K8sCluster's Node plan (filter and priority)
content:
Expand Down Expand Up @@ -2435,7 +2435,7 @@ paths:
\ include commonSpec and commonImage info. <br> (ex: {name: k8scluster-01,\
\ commonImage: azure+koreacentral+ubuntu22.04, commonSpec: azure+koreacentral+Standard_B2s}]})\
\ <br> You can use /k8sclusterRecommendNode and /k8sclusterDynamicCheckRequest\
\ to get it. <br> Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1570"
\ to get it. <br> Check the guide: https://github.com/cloud-barista/cb-tumblebug/discussions/1913"
content:
application/json:
schema:
Expand Down Expand Up @@ -8413,7 +8413,7 @@ components:
type: array
description: CommonSpec is field for id of a spec in common namespace
example:
- azure+koreacentral+Standard_B2s
- tencent+ap-seoul+S2.MEDIUM4
items:
type: string
model.K8sClusterDetail:
Expand Down Expand Up @@ -9832,17 +9832,17 @@ components:
commonImage:
type: string
description: CommonImage is field for id of a image in common namespace
example: "default, azure+koreacentrall+ubuntu20.04"
example: "default, tencent+ap-seoul+ubuntu20.04"
commonSpec:
type: string
description: CommonSpec is field for id of a spec in common namespace
example: azure+koreacentral+standard_b2s
example: tencent+ap-seoul+S2.MEDIUM4
connectionName:
type: string
description: |-
if ConnectionName is given, the VM tries to use associtated credential.
if not, it will use predefined ConnectionName in Spec objects
default: azure-koreacentral
default: tencent-ap-seoul
description:
type: string
example: Description
Expand Down