Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
fix: regenerate 8.6 admin-sm api docs to accommodate updated plugin
Browse files Browse the repository at this point in the history
pepopowitz committed Dec 20, 2024
1 parent b799ae0 commit d0beadb
Showing 6 changed files with 337 additions and 106 deletions.
12 changes: 12 additions & 0 deletions docs/apis-tools/administration-sm-api/specifications/versions.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
[
{
"version": "1",
"label": "Unused but required field",
"baseUrl": "Unused but required field"
},
{
"version": "8.6",
"label": "Unused but required field",
"baseUrl": "Unused but required field"
}
]
Original file line number Diff line number Diff line change
@@ -5,48 +5,162 @@ description: "Returns a list of all automation and management clusters. Each clu
sidebar_label: "Get current clusters"
hide_title: true
hide_table_of_contents: true
api: eJzFV21v2zYQ/iuEvuyLIntvQGEMA7ygKzI0a9E4KLAgH2jpbLGmSJWk6rmG/vvujrIlvyQxsDcgiCXy7uHdcy88bRNbg5NBWXNTJJNkCeFaNz6A80maOPC1NR58Mtkm343H9FOAz52qSQPl361QLLcmgAm0K+taq5zxRp88iWwTn5dQSXpSASrGqh0dG1REbhpV0G/Y1ICYPjhlloh7eNS9UZ8bEKrAo9RCgRN2IUIJIo8GJ22aGFnBy0i/o9QTyr6W+YUILDrEEMoL1xiDCkKZjCB9kKHxp7TdmIJYAi/UQsghQAlSh3IjrBPGBjz42BAwTZVMHpJOEFcaM3xeGbs2ySMqqqBJ8xojaDXc3U6LSplprbK7aBXatwTTRf9ln2clmod/7HHjHIZBfME8wd0dmTvvB6RGzGP/P8I3DkShfEDxRvmStOYQ1gBGyCbYio0S0hSikkYuoaLjOlyfidvTReQcHwsQgxwka2UQMg9iqe1car1BMYTF/xgbraEQnL1/hlRotQLRsUX839oCNLhMTHuD9odJF2P/B8Acjm0gbw6sYOh3XGmQipn0K42+s3vvkJNKfYXsmVj3jOBiz8fzUe7qeEaYGAi0xz9Tg0/EidnrPTlM8WHyd/QxHempq6nIsuc8/Ep6V3NnV5g2afe6RIi1pLSOTQoIoAPkxcgccRJDFXsR8YBPsVGEi6tiWtc7rv5WOxrQdXkLMMcs/7d9oHH6kgYAom7maKW4//D2CXf/pY5ydIoDiUUG3l9m9V78GcMrQP38QsBO+Ek4NvFzoxwUFCMG5LTa50Pk/ICvx32Q7fwT5BR0WRSK9qR+P6jWhdQeXkjlvvcm0jkuolM3uAmh/Qe96nx9n/jEl3Z34w7vzoGHA9/SHQfchv45T6+Pb5rO27Yle38Yf39aeL9aN1cFli0p/XhuqLkDh2l45bG2BThno/OHMh8gNA7Zkj2JWl90db2Webm/8XHLbfgKksr445T3jIKLyonIKvdQufQUgf2ghnR6wAKiZjd52CZzwNvJ4eNji1u1dBgcFsQVTvTSdrNeQtuhxJeRJEqvZK1GeT8AembCMyr3iGQbp7l2MhptS+tDO9nW1oUWhb9Ip+Rcx/uE9iKzC9lofEy0zaXm5XOpSBtmMJdN39+IeDoPUnTGIdyr8avx+RaFok+g9JNoj1OGUJ/FicJnkdp2QPkdyUWnd8TvW0gHzlD03gmk3QOmImYLrv/2ccY5pszCsvphwou7W8EpT2acGDvNc2pt3IRICPMxVh0bjfb3KJQ+XYdFxW+zcTbu5ncckXgU5yCT2R4jvF6vs1xWjSlkltuKKMQ+AfhFQLJx2E7edivpkXJhc7/XVpbfRw4WgH0+h1EH5EfseI3hx2oZwL6BsL8UBhl54Pq2//T4XwsyBpumyFGtUW9wpcbywhFuV17E96BwY508JNvtXHq4d7ptaRlHC7eJ9borK67nlO77got7m6xg04W/Dlx/uuEOePwN1g6r/s3rGbXbhsza5+lRXjL6rp+azQD7p19YQMxwUDM/40a0IdArnoOV8RcY7wHV
api: eJzFV9tu2zgQ/RViXnYXYGzvDSj0ZgRtkUWzKRoHBdbwA02NLdYUqZBUs66gf18MKcvyJYmBvT1ZooaHM2dmDscN2AqdCMqamxwyWGO41rUP6DxwcOgrazx6yBr4aTKhnxy9dKqiHZDB3QY4SGsCmkBfRVVpJSPe+Isnkwa8LLAU9KQClhGrcnRsUAm5rlVOv2FbIWTgg1NmDfzoqAejHmtkKkcT1EqhY3bFQoFMJoeh5WBEia8j/S5KfGazr4S8ECGaDjGY8szVxiizZsqMCNIHEWp/StuNyYkl9EytmBgCFCh0KLbMOmZsAH7iCJq6hGwOnSFwqM3weWPsk4EFh6CCpp3X1nir8f52mpfKTCs1uk9etRzWaLrsvx7zrFCePIwR186hCewrOq+s2ZG5i35AasI8jv8zfueQ5coHZda18gXtWmJ4QjRM1MGW0SkmTM5KYcQaSzquw/Ujdnu6yJSRus6RDWqQvBWBCRnYWtul0HrLFMEyZXwQWmPOYvX+GTjTaoOsY4v4v7U5anQjNt071B8mXMr9H4hLPPaBojnwIkLfxU5DzmbCb7TyIYZ3VwVVqm84eiHXe0aAw56Pl7Pc9fGMMFtOnelf6MFn8hTZ20dyWOLD4u/oi3Tw01A5G41eivAb7btaOrtBB7x7XYuAT4LKOokUEkAHGBcTc8RJSlXSIuIBOCShCBd3xbSqdlz9LTka0HW5BJhjlv9bHaidvkQAkFX1UivJHj59eCbcf0lRjk5xKHJl0PvLvO7NX3C8xOCUvBCwM34WLrr4WCuHOeUoAsay6ushcX7A16JPsl1+QUlJF3mu6JvQHwfduhLa4yulvNdeEM7FJjoNI4qQXR1q1fn+PokpXtrdjTu8OwcRDmLjOw6iDP1zkV4f3zRdtG1L/v4y+fm08d5Zt1R5jjHrv54bau7RfUV35VWODJ2zKfhDm08Yamc8E3sStb7o6norZNHf+GiC28YrSCjjj0veR5RQoHIssRo1VKw9ZaAf1BYcPMrakdhl8waWKBw6yOaLdsGhEk6UGA2z+SIWemG7WQ/ocyggg7EgSq9EpcZyPwD6yISPqFEjoEnTXJuNx01hfWizprIutMDhq3BKLHW6T+hbYnYlah0gA22l0HH5XCnSBzOYy6Yfb1g6PQ5SdMYh3JvJm8l5ibIuPIOyn0T3OEUI1VmcZHwWqW0HlN+TXQp6R3wvIR14hKL3zoB3D++sKwU58dvnWawxZVY2bu8KPta58iF1UXTi+3vUq6s0/+Q/nHg+lZJ0LirS6Wa76gecIQxVVSe8kMGPo8lo0o31QkbaU+4pGp+Nx09PTyMpytrkYiRtScxqJdH4OEGkGRw+dCv8aHNupe93Kxvfxw5X6NBIHHdAfhz5qKwPpTAD2PcY+rtiUKgHJDT7fyT/a5+mGqDhclxpoczgpk1dN4e+64jvQT+n9plD0yyFxwen25aWH2t029TGu26Lbc5pDMhjzzewwW1XCFWIbanrKIzHf83aoRi8fzsjFa7Jrb58j8o1ou9k1mwH2E2TLGZ2g6YlMUhOBHqHdtG27V8VCQwO
sidebar_class_name: "get api-method"
info_path: docs/apis-tools/administration-sm-api/specifications/sm-administration-api
info_path: versioned_docs/version-8.6/apis-tools/administration-sm-api/specifications/administration-api-self-managed
custom_edit_url: null
hide_send_button: true
---

import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<h1 className={"openapi__heading"}>Get current clusters</h1>
<Heading
as={"h1"}
className={"openapi__heading"}
children={"Get current clusters"}
></Heading>

<MethodEndpoint method={"get"} path={"/admin-api/clusters"}></MethodEndpoint>
<MethodEndpoint
method={"get"}
path={"/admin-api/clusters"}
context={"endpoint"}
></MethodEndpoint>

Returns a list of all automation and management clusters. Each cluster entry contains the running apps and their status.

## Request
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
></Heading>

<div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>
<ParamsDetails parameters={[]}></ParamsDetails>

Ok
<RequestSchema title={"Body"} body={undefined}></RequestSchema>

</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"uuid"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Unique identifier of the cluster"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Name of the cluster"}}></SchemaItem><SchemaItem collapsible={false} name={"namespace"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Namespace the cluster is running in."}}></SchemaItem><SchemaItem collapsible={false} name={"status"} required={true} schemaName={"ConsoleSMAdminApi.Status"} qualifierMessage={"**Possible values:** [`healthy`, `unhealthy`, `unknown`]"} schema={{"description":"Indicates if a cluster is healthy or not","type":"string","enum":["healthy","unhealthy","unknown"],"title":"ConsoleSMAdminApi.Status"}}></SchemaItem><SchemaItem collapsible={false} name={"generation"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"This is the current version of the running cluster"}}></SchemaItem><SchemaItem collapsible={false} name={"type"} required={true} schemaName={"ConsoleSMAdminApi.ClusterType"} qualifierMessage={"**Possible values:** [`automation`, `management`]"} schema={{"description":"We're distinguishing between automation and management clusters. Management clusters include applications that act globally in an installed context, like Console or Modeler. Automation clusters are the Zeebe clusters including applications like Operate, Tasklist and Optimize.","type":"string","enum":["automation","management"],"title":"ConsoleSMAdminApi.ClusterType"}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>apps</strong><span className={"openapi-schema__name"}> object[]</span><span className={"openapi-schema__divider"}></span><span className={"openapi-schema__required"}>required</span></span></summary><div style={{"marginLeft":"1rem"}}><div style={{"marginTop":".5rem","marginBottom":".5rem"}}>

The list of applications running in the cluster

</div><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"type"} required={true} schemaName={"ConsoleSMAdminApi.AppType"} qualifierMessage={"**Possible values:** [`zeebe-broker`, `zeebe-gateway`, `operate`, `tasklist`, `optimize`, `modeler`, `console`, `identity`, `unknown`]"} schema={{"description":"What application is running in the cluster, like Zeebe, Operate, Tasklist, ...","type":"string","enum":["zeebe-broker","zeebe-gateway","operate","tasklist","optimize","modeler","console","identity","unknown"],"title":"ConsoleSMAdminApi.AppType"}}></SchemaItem><SchemaItem collapsible={false} name={"id"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"Unique identifier of the application"}}></SchemaItem><SchemaItem collapsible={false} name={"status"} required={true} schemaName={"ConsoleSMAdminApi.Status"} qualifierMessage={"**Possible values:** [`healthy`, `unhealthy`, `unknown`]"} schema={{"description":"Indicates if an application is healthy or not","type":"string","enum":["healthy","unhealthy","unknown"],"title":"ConsoleSMAdminApi.Status"}}></SchemaItem><SchemaItem collapsible={false} name={"url"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The public URL of the application"}}></SchemaItem><SchemaItem collapsible={false} name={"generation"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"This is the current version of the running application"}}></SchemaItem><SchemaItem collapsible={false} name={"readiness"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The readiness URL of the application"}}></SchemaItem><SchemaItem collapsible={false} name={"metrics"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"The metrics URL of the application"}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"[\n {\n \"uuid\": \"string\",\n \"name\": \"string\",\n \"namespace\": \"string\",\n \"status\": \"healthy\",\n \"generation\": \"string\",\n \"type\": \"automation\",\n \"apps\": [\n {\n \"type\": \"zeebe-broker\",\n \"id\": \"string\",\n \"status\": \"healthy\",\n \"url\": \"string\",\n \"generation\": \"string\",\n \"readiness\": \"string\",\n \"metrics\": \"string\"\n }\n ]\n }\n]"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"403"} value={"403"}><div>

Forbidden

</div><div></div></TabItem><TabItem label={"500"} value={"500"}><div>

Server-side error

</div><div></div></TabItem></ApiTabs></div></div>
<StatusCodes
id={undefined}
label={undefined}
responses={{
"200": {
description: "Ok",
content: {
"application/json": {
schema: {
items: {
properties: {
uuid: {
type: "string",
description: "Unique identifier of the cluster",
},
name: { type: "string", description: "Name of the cluster" },
namespace: {
type: "string",
description: "Namespace the cluster is running in.",
},
status: {
description: "Indicates if a cluster is healthy or not",
type: "string",
enum: ["healthy", "unhealthy", "unknown"],
title: "ConsoleSMAdminApi.Status",
},
generation: {
type: "string",
description:
"This is the current version of the running cluster",
},
type: {
description:
"We're distinguishing between automation and management clusters. Management clusters include applications that act globally in an installed context, like Console or Modeler. Automation clusters are the Zeebe clusters including applications like Operate, Tasklist and Optimize.",
type: "string",
enum: ["automation", "management"],
title: "ConsoleSMAdminApi.ClusterType",
},
apps: {
items: {
properties: {
type: {
description:
"What application is running in the cluster, like Zeebe, Operate, Tasklist, ...",
type: "string",
enum: [
"zeebe-broker",
"zeebe-gateway",
"operate",
"tasklist",
"optimize",
"modeler",
"console",
"identity",
"unknown",
],
title: "ConsoleSMAdminApi.AppType",
},
id: {
type: "string",
description: "Unique identifier of the application",
},
status: {
description:
"Indicates if an application is healthy or not",
type: "string",
enum: ["healthy", "unhealthy", "unknown"],
title: "ConsoleSMAdminApi.Status",
},
url: {
type: "string",
description: "The public URL of the application",
},
generation: {
type: "string",
description:
"This is the current version of the running application",
},
readiness: {
type: "string",
description: "The readiness URL of the application",
},
metrics: {
type: "string",
description: "The metrics URL of the application",
},
},
required: ["type", "id", "status", "url", "generation"],
type: "object",
additionalProperties: false,
title: "ConsoleSMAdminApi.App",
},
type: "array",
description:
"The list of applications running in the cluster",
},
},
required: [
"uuid",
"name",
"namespace",
"status",
"generation",
"type",
"apps",
],
type: "object",
additionalProperties: false,
title: "ConsoleSMAdminApi.Cluster",
},
type: "array",
},
},
},
},
"403": { description: "Forbidden" },
"500": { description: "Server-side error" },
}}
></StatusCodes>
Loading

0 comments on commit d0beadb

Please sign in to comment.