.TH "GCLOUD_ALPHA_AUTH_PRINT\-ACCESS\-TOKEN" 1



.SH "NAME"
.HP
gcloud alpha auth print\-access\-token \- print an access token for the specified account



.SH "SYNOPSIS"
.HP
\f5gcloud alpha auth print\-access\-token\fR [\fIACCOUNT\fR] [\fB\-\-lifetime\fR=\fILIFETIME\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Print an access token for the specified account. See RFC6749
(https://tools.ietf.org/html/rfc6749) for more information about access tokens.

Note that token itself may not be enough to access some services. If you use the
token with curl or similar tools, you may see permission errors similar to "API
has not been used in project 32555940559 before or it is disabled.". If it
happens, you may need to provide a quota project in the "X\-Goog\-User\-Project"
header. For example,

.RS 2m
$ curl \-H "X\-Goog\-User\-Project: your\-project" \e
    \-H "Authorization: Bearer $(gcloud auth print\-access\-token)" \e
    foo.googleapis.com
.RE

The identity that granted the token must have the serviceusage.services.use
permission on the provided project. See
https://cloud.google.com/apis/docs/system\-parameters for more information.



.SH "EXAMPLES"

To print access tokens:

.RS 2m
$ gcloud alpha auth print\-access\-token
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
[\fIACCOUNT\fR]

Account to get the access token for. If not specified, the current active
account will be used.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-lifetime\fR=\fILIFETIME\fR

Access token lifetime. The default access token lifetime is 3600 seconds, but
you can use this flag to reduce the lifetime or extend it up to 43200 seconds
(12 hours). The org policy constraint
\f5constraints/iam.allowServiceAccountCredentialLifetimeExtension\fR must be set
if you want to extend the lifetime beyond 3600 seconds. Note that this flag is
for service account impersonation only, so it must be used together with the
\f5\-\-impersonate\-service\-account\fR flag.


.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 auth print\-access\-token
.RE

.RS 2m
$ gcloud beta auth print\-access\-token
.RE