c0cb6133ea
## Summary Connected to https://github.com/elastic/kibana/issues/146945 This PR updates API docs for Description | Limit | Done? | Documented? | UI? -- | -- | -- | -- | -- Total assignees per case | 10 | ✅ | Yes | ✅ Maximum number of cases/user actions/comments returned from the API | 10.000 | ✅ | Yes | N/A Total number of cases by alert ID returned from the API | 10.000 | ✅ | Yes | N/A Total number of tags returned from the API | 10.000 | ✅ | Yes | N/A Total number of reporters returned from the API | 10.000 | ✅ | Yes | N/A ### Checklist Delete any items that are not applicable to this PR. - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials ### For maintainers - [x] This was checked for breaking API changes and was [labeled appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process) --------- Co-authored-by: lcawl <lcawley@elastic.co> |
||
|---|---|---|
| .. | ||
| cases | ||
| connectors | ||
| machine-learning | ||
| rules | ||
| template | ||
| README.md | ||
OpenAPI (Experimental)
Open API specifications (OAS) exist in JSON or YAML format for some Kibana features, though they are experimental and may be incomplete or change later.
A preview of the API specifications can be added to the Kibana Guide by using the following process:
. Install OpenAPI Generator, or a similar tool that can generate HTML output from OAS.
. Optionally validate the specifications by using the commands listed in the appropriate readmes.
. Generate HTML output. For example:
openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/alerting/docs/openapi/bundled.yaml -o $GIT_HOME/kibana/docs/api-generated/rules -t $GIT_HOME/kibana/docs/api-generated/template
openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/cases/docs/openapi/bundled.yaml -o $GIT_HOME/kibana/docs/api-generated/cases -t $GIT_HOME/kibana/docs/api-generated/template
openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/actions/docs/openapi/bundled.yaml -o $GIT_HOME/kibana/docs/api-generated/connectors -t $GIT_HOME/kibana/docs/api-generated/template
openapi-generator-cli generate -g html -i $GIT_HOME/kibana/x-pack/plugins/ml/common/openapi/ml_apis_v3.yaml -o $GIT_HOME/kibana/docs/api-generated/machine-learning -t $GIT_HOME/kibana/docs/api-generated/template
. Rename the output files. For example:
mv $GIT_HOME/kibana/docs/api-generated/rules/index.html $GIT_HOME/kibana/docs/api-generated/rules/rule-apis-passthru.asciidoc
mv $GIT_HOME/kibana/docs/api-generated/cases/index.html $GIT_HOME/kibana/docs/api-generated/cases/case-apis-passthru.asciidoc
mv $GIT_HOME/kibana/docs/api-generated/connectors/index.html $GIT_HOME/kibana/docs/api-generated/connectors/connector-apis-passthru.asciidoc
mv $GIT_HOME/kibana/docs/api-generated/machine-learning/index.html $GIT_HOME/kibana/docs/api-generated/machine-learning/ml-apis-passthru.asciidoc
. If you're creating a new set of API output, you will need to have a page that incorporates the output by using passthrough blocks. For more information, refer to Asciidoctor docs
. Verify the output by building the Kibana documentation. At this time, the output is added as a technical preview in the appendix.
Known issues
- Some OAS 3.0 features such as
anyOf,oneOf, andallOfmight not display properly in the preview. These are on the Short-term roadmap at this time.