1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/pubsub/schemas/create
2024-07-31 09:35:16 +00:00

75 lines
2.5 KiB
Text

NAME
gcloud pubsub schemas create - create a Pub/Sub schema
SYNOPSIS
gcloud pubsub schemas create SCHEMA --type=TYPE
(--definition=DEFINITION | --definition-file=PATH_TO_FILE)
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Create a new Pub/Sub schema.
EXAMPLES
To create a PROTOCOL_BUFFER schema called "key-schema" that requires
exactly one string field named "key", run: $ gcloud pubsub schemas create key-schema \
--definition="syntax = 'proto3'; message Message { optional \
string key = 1; }" --type=PROTOCOL_BUFFER
To create an equivalent AVRO schema, run: $ gcloud pubsub schemas create key-schema \
--definition='{ "type": "record", "namespace": "my.ns", "name":
"KeyMsg", "fields": [ { "name": "key", "type": "string" } ] }' \
--type=AVRO
POSITIONAL ARGUMENTS
Schema resource - Pub/Sub schema to create. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument schema on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
SCHEMA
ID of the schema or fully qualified identifier for the schema.
To set the schema attribute:
▸ provide the argument schema on the command line.
REQUIRED FLAGS
--type=TYPE
Type of the schema. TYPE must be one of: avro, protocol-buffer.
Schema definition.
Exactly one of these must be specified:
--definition=DEFINITION
Inline schema definition.
--definition-file=PATH_TO_FILE
File containing schema definition. Use a full or relative path to a
local file containing the value of definition_file.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the pubsub/v1 API. The full documentation for this API
can be found at: https://cloud.google.com/pubsub/docs
NOTES
These variants are also available:
$ gcloud alpha pubsub schemas create
$ gcloud beta pubsub schemas create