mirror of
https://github.com/ceph/ceph-csi.git
synced 2024-12-22 13:00:19 +00:00
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
|
# disco
|
||
|
|
||
|
This directory contains a tool for working with Google's Discovery API and Discovery Format,
|
||
|
including the ability to convert Discovery Format descriptions to OpenAPI.
|
||
|
|
||
|
Installation:
|
||
|
|
||
|
go get github.com/googleapis/gnostic
|
||
|
go install github.com/googleapis/gnostic/apps/disco
|
||
|
|
||
|
|
||
|
Usage:
|
||
|
|
||
|
disco help
|
||
|
|
||
|
Prints a list of commands and options.
|
||
|
|
||
|
disco list [--raw]
|
||
|
|
||
|
Calls the Google Discovery API and lists available APIs.
|
||
|
The `--raw` option prints the raw results of the Discovery List APIs call.
|
||
|
|
||
|
disco get [<api>] [<version>] [--raw] [--openapi2] [--openapi3] [--features] [--schemas] [--all]
|
||
|
|
||
|
Gets the specified API and version from the Google Discovery API.
|
||
|
`<version>` can be omitted if it is unique.
|
||
|
The `--raw` option saves the raw Discovery Format description.
|
||
|
The `--openapi2` option rewrites the API description in OpenAPI v2.
|
||
|
The `--openapi3` option rewrites the API description in OpenAPI v3.
|
||
|
The `--features` option displays the contents of the `features` sections of discovery documents.
|
||
|
The `--schemas` option displays information about the schemas defined for the API.
|
||
|
The `--all` option runs the other associated operations for all of the APIs available from the Discovery Service.
|
||
|
When `--all` is specified, `<api>` and `<version>` should be omitted.
|
||
|
|
||
|
disco <file> [--openapi2] [--openapi3] [--features] [--schemas]
|
||
|
|
||
|
Applies the specified operations to a local file. See the `get` command for details.
|
||
|
|