Skip to main content
Version: v0.5

OpenAPI

Informations​

Version​

1.0

Contact​

Content negotiation​

URI Schemes​

  • http

Consumes​

  • application/json
  • multipart/form-data
  • text/plain

Produces​

  • application/json
  • text/plain

All endpoints​

cluster​

MethodURINameSummary
DELETE/rest-api/v1/cluster/{clusterName}delete rest API v1 cluster cluster nameDelete removes a cluster resource by name.
GET/rest-api/v1/cluster/{clusterName}get rest API v1 cluster cluster nameGet returns a cluster resource by name.
GET/rest-api/v1/clustersget rest API v1 clustersList lists all cluster resources.
POST/rest-api/v1/cluster/{clusterName}post rest API v1 cluster cluster nameCreate creates a cluster resource.
POST/rest-api/v1/cluster/config/filepost rest API v1 cluster config fileUpload kubeConfig file for cluster
POST/rest-api/v1/cluster/config/validatepost rest API v1 cluster config validateValidate KubeConfig
PUT/rest-api/v1/cluster/{clusterName}put rest API v1 cluster cluster nameUpdate updates the cluster metadata by name.

debug​

MethodURINameSummary
GET/endpointsget endpointsList all available endpoints

insight​

MethodURINameSummary
GET/rest-api/v1/insight/auditget rest API v1 insight auditAudit based on resource group.
GET/rest-api/v1/insight/detailget rest API v1 insight detailGetDetail returns a Kubernetes resource by name, namespace, cluster, apiVersion and kind.
GET/rest-api/v1/insight/eventsget rest API v1 insight eventsGetEvents returns events for a Kubernetes resource by name, namespace, cluster, apiVersion and kind.
GET/rest-api/v1/insight/scoreget rest API v1 insight scoreScoreHandler calculates a score for the audited manifest.
GET/rest-api/v1/insight/statsget rest API v1 insight statsGet returns a global statistics info.
GET/rest-api/v1/insight/summaryget rest API v1 insight summaryGet returns a Kubernetes resource summary by name, namespace, cluster, apiVersion and kind.
GET/rest-api/v1/insight/topologyget rest API v1 insight topologyGetTopology returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind.

resourcegroup​

MethodURINameSummary
GET/rest-api/v1/resource-groups/{resourceGroupRuleName}get rest API v1 resource groups resource group rule nameList lists all ResourceGroups by rule name.

resourcegrouprule​

MethodURINameSummary
DELETE/rest-api/v1/resource-group-rule/{resourceGroupRuleName}delete rest API v1 resource group rule resource group rule nameDelete removes a ResourceGroupRule by name.
GET/rest-api/v1/resource-group-rule/{resourceGroupRuleName}get rest API v1 resource group rule resource group rule nameGet returns a ResourceGroupRule by name.
GET/rest-api/v1/resource-group-rulesget rest API v1 resource group rulesList lists all ResourceGroupRules.
POST/rest-api/v1/resource-group-rulepost rest API v1 resource group ruleCreate creates a ResourceGroupRule.
PUT/rest-api/v1/resource-group-ruleput rest API v1 resource group ruleUpdate updates the ResourceGroupRule metadata by name.
MethodURINameSummary
GET/rest-api/v1/searchget rest API v1 searchSearchForResource returns an array of Kubernetes runtime Object matched using the query from context.

Paths​

Delete removes a cluster resource by name. (DeleteRestAPIV1ClusterClusterName)​

DELETE /rest-api/v1/cluster/{clusterName}

This endpoint deletes the cluster resource by name.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
clusterNamepathstringstring✓The name of the cluster

All responses​

CodeStatusDescriptionHas headersSchema
200OKOperation statusschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Operation status​

Status: OK

Schema​
400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Delete removes a ResourceGroupRule by name. (DeleteRestAPIV1ResourceGroupRuleResourceGroupRuleName)​

DELETE /rest-api/v1/resource-group-rule/{resourceGroupRuleName}

This endpoint deletes the ResourceGroupRule by name.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
resourceGroupRuleNamepathstringstring✓The name of the resource group rule

All responses​

CodeStatusDescriptionHas headersSchema
200OKOperation statusschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Operation status​

Status: OK

Schema​
400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

List all available endpoints (GetEndpoints)​

GET /endpoints

List all registered endpoints in the router

Consumes​

  • text/plain

Produces​

  • text/plain

All responses​

CodeStatusDescriptionHas headersSchema
200OKEndpoints listed successfullyschema

Responses​

200 - Endpoints listed successfully​

Status: OK

Schema​

Get returns a cluster resource by name. (GetRestAPIV1ClusterClusterName)​

GET /rest-api/v1/cluster/{clusterName}

This endpoint returns a cluster resource by name.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
clusterNamepathstringstring✓The name of the cluster
formatquerystringstringThe format of the response. Either in json or yaml

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

List lists all cluster resources. (GetRestAPIV1Clusters)​

GET /rest-api/v1/clusters

This endpoint lists all cluster resources.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
descendingquerybooleanboolWhether to sort the list in descending order. Default to false
orderByquerystringstringThe order to list the cluster. Default to order by name
summaryquerybooleanboolWhether to display summary or not. Default to false

All responses​

CodeStatusDescriptionHas headersSchema
200OKList of cluster objectsschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - List of cluster objects​

Status: OK

Schema​

[][UnstructuredUnstructured](#unstructured-unstructured)

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Audit based on resource group. (GetRestAPIV1InsightAudit)​

GET /rest-api/v1/insight/audit

This endpoint audits based on the specified resource group.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
forceNewquerybooleanboolSwitch for forced scanning, default is 'false'
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKAudit resultsschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Audit results​

Status: OK

Schema​

ScannerAuditData

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

GetDetail returns a Kubernetes resource by name, namespace, cluster, apiVersion and kind. (GetRestAPIV1InsightDetail)​

GET /rest-api/v1/insight/detail

This endpoint returns a Kubernetes resource by name, namespace, cluster, apiVersion and kind.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'. Should be percent-encoded
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
formatquerystringstringThe format of the response. Either in json or yaml. Default to json
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

GetEvents returns events for a Kubernetes resource by name, namespace, cluster, apiVersion and kind. (GetRestAPIV1InsightEvents)​

GET /rest-api/v1/insight/events

This endpoint returns events for a Kubernetes resource YAML by name, namespace, cluster, apiVersion and kind.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'. Should be percent-encoded
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKList of eventsschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - List of events​

Status: OK

Schema​

[][UnstructuredUnstructured](#unstructured-unstructured)

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

ScoreHandler calculates a score for the audited manifest. (GetRestAPIV1InsightScore)​

GET /rest-api/v1/insight/score

This endpoint calculates a score for the provided manifest based on the number and severity of issues detected during the audit.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
forceNewquerybooleanboolSwitch for forced compute score, default is 'false'
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKScore calculation resultschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Score calculation result​

Status: OK

Schema​

InsightScoreData

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Get returns a global statistics info. (GetRestAPIV1InsightStats)​

GET /rest-api/v1/insight/stats

This endpoint returns a global statistics info.

Produces​

  • application/json

All responses​

CodeStatusDescriptionHas headersSchema
200OKGlobal statistics infoschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Global statistics info​

Status: OK

Schema​

InsightStatistics

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Get returns a Kubernetes resource summary by name, namespace, cluster, apiVersion and kind. (GetRestAPIV1InsightSummary)​

GET /rest-api/v1/insight/summary

This endpoint returns a Kubernetes resource summary by name, namespace, cluster, apiVersion and kind.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'. Should be percent-encoded
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKResource Summaryschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Resource Summary​

Status: OK

Schema​

InsightResourceSummary

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

GetTopology returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind. (GetRestAPIV1InsightTopology)​

GET /rest-api/v1/insight/topology

This endpoint returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
apiVersionquerystringstringThe specified apiVersion, such as 'apps/v1'. Should be percent-encoded
clusterquerystringstringThe specified cluster name, such as 'example-cluster'
forceNewquerybooleanboolForce re-generating the topology, default is 'false'
kindquerystringstringThe specified kind, such as 'Deployment'
namequerystringstringThe specified resource name, such as 'foo'
namespacequerystringstringThe specified namespace, such as 'default'

All responses​

CodeStatusDescriptionHas headersSchema
200OKmap from string to resource.ResourceTopologyschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - map from string to resource.ResourceTopology​

Status: OK

Schema​

map of InsightResourceTopology

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Get returns a ResourceGroupRule by name. (GetRestAPIV1ResourceGroupRuleResourceGroupRuleName)​

GET /rest-api/v1/resource-group-rule/{resourceGroupRuleName}

This endpoint returns a ResourceGroupRule by name.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
resourceGroupRuleNamepathstringstring✓The name of the resource group rule

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

List lists all ResourceGroupRules. (GetRestAPIV1ResourceGroupRules)​

GET /rest-api/v1/resource-group-rules

This endpoint lists all ResourceGroupRules.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
descendingquerybooleanboolWhether to sort the list in descending order. Default to false
orderByquerystringstringThe order to list the resourceGroupRule. Default to order by name
summaryquerybooleanboolWhether to display summary or not. Default to false

All responses​

CodeStatusDescriptionHas headersSchema
200OKList of resourceGroupRule objectsschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - List of resourceGroupRule objects​

Status: OK

Schema​

[][UnstructuredUnstructured](#unstructured-unstructured)

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

List lists all ResourceGroups by rule name. (GetRestAPIV1ResourceGroupsResourceGroupRuleName)​

GET /rest-api/v1/resource-groups/{resourceGroupRuleName}

This endpoint lists all ResourceGroups.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
resourceGroupRuleNamepathstringstring✓The name of the resource group rule

All responses​

CodeStatusDescriptionHas headersSchema
200OKList of resourceGroup objectsschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - List of resourceGroup objects​

Status: OK

Schema​

[][UnstructuredUnstructured](#unstructured-unstructured)

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

SearchForResource returns an array of Kubernetes runtime Object matched using the query from context. (GetRestAPIV1Search)​

GET /rest-api/v1/search

This endpoint returns an array of Kubernetes runtime Object matched using the query from context.

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
pagequerystringstringThe current page to fetch. Default to 1
pageSizequerystringstringThe size of the page. Default to 10
patternquerystringstring✓The search pattern. Can be either sql or dsl. Required
queryquerystringstring✓The query to use for search. Required

All responses​

CodeStatusDescriptionHas headersSchema
200OKArray of runtime.Objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Array of runtime.Object​

Status: OK

Schema​

[][interface{}](#interface)

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Create creates a cluster resource. (PostRestAPIV1ClusterClusterName)​

POST /rest-api/v1/cluster/{clusterName}

This endpoint creates a new cluster resource using the payload.

Consumes​

  • application/json
  • text/plain

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
clusterNamepathstringstring✓The name of the cluster
requestbodyClusterClusterPayloadmodels.ClusterClusterPayload✓cluster to create (either plain text or JSON format)

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Upload kubeConfig file for cluster (PostRestAPIV1ClusterConfigFile)​

POST /rest-api/v1/cluster/config/file

Uploads a KubeConfig file for cluster, with a maximum size of 2MB.

Consumes​

  • multipart/form-data

Produces​

  • text/plain

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
descriptionformDatastringstring✓cluster description
displayNameformDatastringstring✓cluster display name
fileformDatafileio.ReadCloser✓Upload file with field name 'file'
nameformDatastringstring✓cluster name

All responses​

CodeStatusDescriptionHas headersSchema
200OKReturns the content of the uploaded KubeConfig file.schema
400Bad RequestThe uploaded file is too large or the request is invalid.schema
500Internal Server ErrorInternal server error.schema

Responses​

200 - Returns the content of the uploaded KubeConfig file.​

Status: OK

Schema​

ClusterUploadData

400 - The uploaded file is too large or the request is invalid.​

Status: Bad Request

Schema​
500 - Internal server error.​

Status: Internal Server Error

Schema​

Validate KubeConfig (PostRestAPIV1ClusterConfigValidate)​

POST /rest-api/v1/cluster/config/validate

Validates the provided KubeConfig using cluster manager methods.

Consumes​

  • application/json
  • text/plain

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
requestbodyClusterValidatePayloadmodels.ClusterValidatePayload✓KubeConfig payload to validate

All responses​

CodeStatusDescriptionHas headersSchema
200OKVerification passed server versionschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Verification passed server version​

Status: OK

Schema​
400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Create creates a ResourceGroupRule. (PostRestAPIV1ResourceGroupRule)​

POST /rest-api/v1/resource-group-rule

This endpoint creates a new ResourceGroupRule using the payload.

Consumes​

  • application/json
  • text/plain

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
requestbodyResourcegroupruleResourceGroupRulePayloadmodels.ResourcegroupruleResourceGroupRulePayload✓resourceGroupRule to create (either plain text or JSON format)

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Update updates the cluster metadata by name. (PutRestAPIV1ClusterClusterName)​

PUT /rest-api/v1/cluster/{clusterName}

This endpoint updates the display name and description of an existing cluster resource.

Consumes​

  • application/json
  • text/plain

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
clusterNamepathstringstring✓The name of the cluster
requestbodyClusterClusterPayloadmodels.ClusterClusterPayload✓cluster to update (either plain text or JSON format)

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Update updates the ResourceGroupRule metadata by name. (PutRestAPIV1ResourceGroupRule)​

PUT /rest-api/v1/resource-group-rule

This endpoint updates the display name and description of an existing ResourceGroupRule.

Consumes​

  • application/json
  • text/plain

Produces​

  • application/json

Parameters​

NameSourceTypeGo typeSeparatorRequiredDefaultDescription
requestbodyResourcegroupruleResourceGroupRulePayloadmodels.ResourcegroupruleResourceGroupRulePayload✓resourceGroupRule to update (either plain text or JSON format)

All responses​

CodeStatusDescriptionHas headersSchema
200OKUnstructured objectschema
400Bad RequestBad Requestschema
401UnauthorizedUnauthorizedschema
404Not FoundNot Foundschema
405Method Not AllowedMethod Not Allowedschema
429Too Many RequestsToo Many Requestsschema
500Internal Server ErrorInternal Server Errorschema

Responses​

200 - Unstructured object​

Status: OK

Schema​

UnstructuredUnstructured

400 - Bad Request​

Status: Bad Request

Schema​
401 - Unauthorized​

Status: Unauthorized

Schema​
404 - Not Found​

Status: Not Found

Schema​
405 - Method Not Allowed​

Status: Method Not Allowed

Schema​
429 - Too Many Requests​

Status: Too Many Requests

Schema​
500 - Internal Server Error​

Status: Internal Server Error

Schema​

Models​

cluster.ClusterPayload​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
descriptionstringstringClusterDescription is the description of cluster to be created
displayNamestringstringClusterDisplayName is the display name of cluster to be created
kubeconfigstringstringClusterKubeConfig is the kubeconfig of cluster to be created

cluster.UploadData​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
contentstringstring
fileNamestringstring
fileSizeintegerint64
sanitizedClusterContentstringstring

cluster.ValidatePayload​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
kubeConfigstringstring

entity.ResourceGroup​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
annotationsmap of stringmap[string]string
apiVersionstringstring
clusterstringstring
kindstringstring
labelsmap of stringmap[string]string
namestringstring
namespacestringstring

insight.ResourceSummary​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
creationTimestampstringstring
resourceEntityResourceGroupEntityResourceGroup
resourceVersionstringstring
uidstringstring

insight.ResourceTopology​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
children[]string[]string
parents[]string[]string
resourceGroupEntityResourceGroupEntityResourceGroup

insight.ScoreData​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
issuesTotalintegerint64IssuesTotal is the total count of all issues found during the audit.
This count can be used to understand the overall number of problems
that need to be addressed.
resourceTotalintegerint64ResourceTotal is the count of unique resources audited during the scan.
scorenumberfloat64Score represents the calculated score of the audited manifest based on
the number and severity of issues. It provides a quantitative measure
of the security posture of the resources in the manifest.
severityStatisticmap of integermap[string]int64SeverityStatistic is a mapping of severity levels to their respective
number of occurrences. It allows for a quick overview of the distribution
of issues across different severity categories.

insight.Statistics​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
clusterCountintegerint64
resourceCountintegerint64
resourceGroupRuleCountintegerint64

resourcegrouprule.ResourceGroupRulePayload​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
descriptionstringstring
fields[]string[]string
namestringstring

scanner.AuditData​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
bySeveritymap of integermap[string]int64
issueGroups[][ScannerIssueGroup](#scanner-issue-group)[]*ScannerIssueGroup
issueTotalintegerint64
resourceTotalintegerint64

scanner.Issue​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
messagestringstringMessage provides a detailed human-readable description of the issue.
scannerstringstringScanner is the name of the scanner that discovered the issue.
severityintegerint64Severity indicates how critical the issue is, using the IssueSeverityLevel constants.
titlestringstringTitle is a brief summary of the issue.

scanner.IssueGroup​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
issueScannerIssueScannerIssue
resourceGroups[][EntityResourceGroup](#entity-resource-group)[]*EntityResourceGroup

unstructured.Unstructured​

Properties

NameTypeGo typeRequiredDefaultDescriptionExample
objectinterface{}interface{}Object is a JSON compatible map with string, float, int, bool, []interface{}, or
map[string]interface{}
children.