.TH "GCLOUD_DOMAINS_REGISTRATIONS_INITIATE\-PUSH\-TRANSFER" 1



.SH "NAME"
.HP
gcloud domains registrations initiate\-push\-transfer \- initiates the push transfer process



.SH "SYNOPSIS"
.HP
\f5gcloud domains registrations initiate\-push\-transfer\fR \fIREGISTRATION\fR [\fB\-\-async\fR] [\fB\-\-tag\fR=\fITAG\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Initiates the \f5Push Transfer\fR process to transfer the domain to another
registrar. The process might complete instantly or might require confirmation or
additional work. Check the emails sent to the email address of the registrant.
The process is aborted after a timeout if it's not completed.

This method is only supported for domains that have the
\f5REQUIRE_PUSH_TRANSFER\fR property in the list of \f5domain_properties\fR. The
domain must also be unlocked before it can be transferred to a different
registrar.



.SH "EXAMPLES"

To initiate a push transfer for \f5\fIexample.co.uk\fR\fR, run:

.RS 2m
$ gcloud domains registrations initiate\-push\-transfer \e
    example.co.uk \-\-tag=NEW_REGISTRY_TAG
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Registration resource \- The domain registration to transfer. 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 \f5registration\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5registration\fR on the command line with a fully
specified name;
.IP "\(em" 2m
location is always global.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIREGISTRATION\fR

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

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


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-tag\fR=\fITAG\fR

The Tag of the new registrar. Can be found at
https://nominet.uk/registrar\-list/


.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 domains registrations initiate\-push\-transfer
.RE

.RS 2m
$ gcloud beta domains registrations initiate\-push\-transfer
.RE