.TH "GCLOUD_ALPHA_PUBSUB_MESSAGE\-TRANSFORMS_TEST" 1



.SH "NAME"
.HP
gcloud alpha pubsub message\-transforms test \- tests message transforms against a given message



.SH "SYNOPSIS"
.HP
\f5gcloud alpha pubsub message\-transforms test\fR (\fB\-\-attribute\fR=[\fIATTRIBUTE\fR,...]\ \fB\-\-message\fR=\fIMESSAGE\fR) (\fB\-\-message\-transforms\-file\fR=\fIMESSAGE_TRANSFORMS_FILE\fR\ |\ \fB\-\-subscription\fR=\fISUBSCRIPTION\fR\ |\ [\fB\-\-topic\fR=\fITOPIC\fR\ :\ \fB\-\-topic\-project\fR=\fITOPIC_PROJECT\fR]) [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Tests message transforms against a given message.



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Message to test the message transforms against.

At least one of these must be specified:


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

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

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

Message body to test the message transforms against.

.RE
.sp
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-message\-transforms\-file\fR=\fIMESSAGE_TRANSFORMS_FILE\fR

Path to YAML or JSON file containing message transforms.

.TP 2m

Subscription resource \- Name of the subscription from which the message
transforms are taken to be applied to the message. 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 "\(bu" 2m
provide the argument \f5\-\-subscription\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-subscription\fR=\fISUBSCRIPTION\fR

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

To set the \f5subscription\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-subscription\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m

Topic resource \- Name of the topic from which the message transforms are taken
to be applied to the message. The arguments in this group can be used to specify
the attributes of this resource.


.RS 2m
.TP 2m
\fB\-\-topic\fR=\fITOPIC\fR

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

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

This flag argument must be specified if any of the other arguments in this group
are specified.

.TP 2m
\fB\-\-topic\-project\fR=\fITOPIC_PROJECT\fR

Project ID of the Google Cloud project for the topic.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-topic\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-topic\-project\fR on the command line;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp


.RE
.RE
.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 message\-transforms test
.RE

.RS 2m
$ gcloud beta pubsub message\-transforms test
.RE