ceph-csi/vendor/github.com/googleapis/gnostic/apps/disco/README.md
2018-12-19 15:29:25 +01:00

1.5 KiB

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.