.TH "GCLOUD_PUBSUB_TOPICS_PUBLISH" 1



.SH "NAME"
.HP
gcloud pubsub topics publish \- publishes a message to the specified topic



.SH "SYNOPSIS"
.HP
\f5gcloud pubsub topics publish\fR \fITOPIC\fR [\fB\-\-attribute\fR=[\fIATTRIBUTE\fR,...]] [\fB\-\-message\fR=\fIMESSAGE\fR] [\fB\-\-ordering\-key\fR=\fIORDERING_KEY\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Publishes a message to the specified topic name for testing and troubleshooting.
Use with caution: all associated subscribers must be able to consume and
acknowledge any message you publish, otherwise the system will continuously
re\-attempt delivery of the bad message for 7 days.



.SH "EXAMPLES"

To publish messages in a batch to a specific Cloud Pub/Sub topic, run:

.RS 2m
$ gcloud pubsub topics publish mytopic \-\-message="Hello World!" \e
    \-\-attribute=KEY1=VAL1,KEY2=VAL2
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Topic resource \- Name of the topic to publish messages to. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5topic\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fITOPIC\fR

ID of the topic or fully qualified identifier for the topic.

To set the \f5topic\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5topic\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-attribute\fR=[\fIATTRIBUTE\fR,...]

Comma\-separated list of attributes. Each ATTRIBUTE has the form name="value".
You can specify up to 100 attributes.

.TP 2m
\fB\-\-message\fR=\fIMESSAGE\fR

The body of the message to publish to the given topic name. Information on
message formatting and size limits can be found at:
https://cloud.google.com/pubsub/docs/publisher#publish

.TP 2m
\fB\-\-ordering\-key\fR=\fIORDERING_KEY\fR

The key for ordering delivery to subscribers. All messages with the same
ordering key are sent to subscribers in the order that Pub/Sub receives them.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha pubsub topics publish
.RE

.RS 2m
$ gcloud beta pubsub topics publish
.RE