.TH "GCLOUD_ALPHA_PUBSUB_TOPICS_PUBLISH" 1



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



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



.SH "DESCRIPTION"

\fB(ALPHA)\fR 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 alpha pubsub topics publish mytopic \e
    \-\-message="Hello World!" \-\-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
.sp
.TP 2m
[\fIMESSAGE_BODY\fR]

(DEPRECATED) 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

Positional argument \f5MESSAGE_BODY\fR is deprecated. Please use
\f5\-\-message\fR instead.


.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"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud pubsub topics publish
.RE

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