.TH "GCLOUD_ALPHA_TRANSFER_APPLIANCES_ORDERS_CREATE" 1



.SH "NAME"
.HP
gcloud alpha transfer appliances orders create \- create an order for a transfer appliance



.SH "SYNOPSIS"
.HP
\f5gcloud alpha transfer appliances orders create\fR \fINAME\fR \fB\-\-country\fR=\fICOUNTRY\fR [\fB\-\-submit\fR] [\fB\-\-clone\fR=\fICLONE\fR\ :\ \fB\-\-clone\-region\fR=\fICLONE_REGION\fR] [[\fB\-\-model\fR=\fIMODEL\fR\ :\ \fB\-\-cmek\fR=\fICMEK\fR\ \fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR\ \fB\-\-internet\-enabled\fR\ \fB\-\-offline\-export\fR=[\fImanifest\fR=\fIMANIFEST\fR],[\fIsource\fR=\fISOURCE\fR]\ \fB\-\-offline\-import\fR=\fIOFFLINE_IMPORT\fR\ \fB\-\-online\-import\fR=\fIONLINE_IMPORT\fR]] [\fB\-\-address\fR=[\fIadministrative\-area\fR=\fIADMINISTRATIVE\-AREA\fR],[\fIlines\fR=\fILINES\fR],[\fIlocality\fR=\fILOCALITY\fR],[\fIpostal\-code\fR=\fIPOSTAL\-CODE\fR]\ \fB\-\-delivery\-notes\fR=\fIDELIVERY_NOTES\fR\ \fB\-\-order\-contact\fR=[\fIbusiness\fR=\fIBUSINESS\fR],[\fIemails\fR=\fIEMAILS\fR],[\fIname\fR=\fINAME\fR],[\fIphone\fR=\fIPHONE\fR]\ \fB\-\-shipping\-contact\fR=[\fIbusiness\fR=\fIBUSINESS\fR],[\fIemails\fR=\fIEMAILS\fR],[\fIname\fR=\fINAME\fR],[\fIphone\fR=\fIPHONE\fR]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR \fBgcloud alpha transfer appliances orders create\fR facilitates
the creation of Transfer Appliance orders. When an order is created, an
appliance record is created as well.



.SH "EXAMPLES"

To order a rackable appliance with 40 TB of storage, named \f5my\-appliance\fR,
a Cloud Storage destination of \f5my\-bucket\fR and the minimum amount of
contact information.

.RS 2m
$ gcloud alpha transfer appliances orders create my\-appliance \e
    \-\-model=TA40_RACKABLE \e
    \-\-shipping\-contact="name=Jane \e
Doe,emails=[jane@example.com],phone=12345678910" \e
    \-\-offline\-import=gs://my\-bucket \e
    \-\-order\-contact="name=John \e
Doe,phone=123456578910,emails=[john@example.com]" \-\-country=US \e
    \-\-address="lines=['1600 Amphitheatre \e
Parkway'],locality=Mountain \e
View,administrative\-area=CA,postal\-code=94043"
.RE

To clone an appliance order with the ID \f5my\-appliance\fR and location
\f5us\-central1\fR, only changing the name and Cloud Storage destination:

.RS 2m
$ gcloud alpha transfer appliances orders create \e
    my\-other\-appliance \-\-country=US \-\-clone=my\-appliance \e
    \-\-clone\-region=us\-central1 \-\-offline\-import=my\-other\-bucket
.RE

To use a flags file to create an appliance rather than provide a long list of
flags:

.RS 2m
$ gcloud alpha transfer appliances orders create my\-appliance \e
    \-\-flags\-file=FLAGS_FILE
.RE

Example file with all possible flags set:

.RS 2m
\-\-address:
  lines:
  \- 1600 Amphitheatre Parkway
  locality: Mountain View
  administrative\-area: California
  postal\-code: 94043
\-\-cmek: projects/p/locations/global/keyRings/kr/cryptoKeys/ck
\-\-country: US
\-\-delivery\-notes: None
\-\-display\-name: test
\-\-internet\-enabled:
\-\-model: TA40_RACKABLE
\-\-offline\-export:
  source: gs://my\-bucket/path
  manifest: gs://my\-other\-bucket/manifest
\-\-offline\-import: gs://my\-bucket/path
\-\-online\-import: gs://my\-bucket/path
\-\-order\-contact:
  business: Google
  name: Jane Doe
  phone: 1234567890
  emails:
  \- janedoe@example.com
\-\-shipping\-contact:
  business: Google
  name: John Doe
  phone: 1234567890
  emails:
  \- johndoe@example.com
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

Immutable ID that will uniquely identify the appliance.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-country\fR=\fICOUNTRY\fR

Country where the appliance will be shipped. Note that this cannot be changed.
To ship the appliance to a different country, clone the order instead and set a
different country and delivery address. To view a complete list of country codes
and names see https://support.google.com/business/answer/6270107. \fICOUNTRY\fR
must be one of: \fBUS\fR, \fBAT\fR, \fBBE\fR, \fBBG\fR, \fBHR\fR, \fBCY\fR,
\fBCZ\fR, \fBDK\fR, \fBEE\fR, \fBFI\fR, \fBFR\fR, \fBDE\fR, \fBGR\fR, \fBHU\fR,
\fBIE\fR, \fBIT\fR, \fBLV\fR, \fBLT\fR, \fBLU\fR, \fBMT\fR, \fBNL\fR, \fBPL\fR,
\fBPT\fR, \fBRO\fR, \fBSK\fR, \fBSI\fR, \fBES\fR, \fBSE\fR, \fBGB\fR, \fBCA\fR,
\fBNO\fR, \fBCH\fR, \fBSG\fR.


.RE
.sp

.SH "FLAGS"

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

When specified the order will be submitted immediately. By default, orders are
created in a draft state. Use \f5gcloud alpha transfer appliances orders update
\-\-submit\fR to submit the order later.

.TP 2m

Order resource \- The order to clone. The arguments in this group can be used to
specify the attributes of this 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 \f5\-\-clone\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


.RS 2m
.TP 2m
\fB\-\-clone\fR=\fICLONE\fR

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

To set the \f5order\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-clone\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\-\-clone\-region\fR=\fICLONE_REGION\fR

The region affiliated with the order.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-clone\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-clone\-region\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "APPLIANCE FLAGS"

.RS 2m
.TP 2m
\fB\-\-model\fR=\fIMODEL\fR

Model of the appliance to order. \fIMODEL\fR must be one of:
\fBTA40_RACKABLE\fR, \fBTA40_STANDALONE\fR, \fBTA300_RACKABLE\fR,
\fBTA300_STANDALONE\fR, \fBTA7\fR, \fBEA_STORAGE_7\fR, \fBEA_GPU_T4\fR.

.TP 2m
\fB\-\-cmek\fR=\fICMEK\fR

Customer\-managed key which will add additional layer of security. By default
data is encrypted with a Google\-managed key.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

A mutable, user\-settable name for both the appliance and the order.

.TP 2m
\fB\-\-internet\-enabled\fR

Gives the option to put the appliance into online mode, allowing it to transfer
data and/or remotely report progress to the cloud over the network. When
disabled only offline transfers are possible.

.TP 2m
\fB\-\-offline\-export\fR=[\fImanifest\fR=\fIMANIFEST\fR],[\fIsource\fR=\fISOURCE\fR]

Configuration for an offline export transfer, where data is downloaded onto the
appliance at Google and copied from the appliance at the customer site.

.RS 2m
.TP 2m
\fBsource\fR
The Cloud Storage bucket or folder where the data is located, in the form of
\f5gs://my\-bucket/path/to/folder/\fR.

.TP 2m
\fBmanifest\fR
Specifies the path to the manifest in Cloud Storage. An example path is
\f5gs://bucket_name/path/manifest.csv\fR. The paths in the manifest file are
relative to bucketname. For example, to export \f5SOURCE_PATH/object1.pdf\fR,
manifest will have \f5object1.pdf\fR in the first column, followed by object
version (optional). For more information see
https://cloud.google.com/storage\-transfer/docs/manifest#object_storage_transfers.

.RE
.sp
.TP 2m
\fB\-\-offline\-import\fR=\fIOFFLINE_IMPORT\fR

Destination for a offline import, where data is loaded onto the appliance at the
customer site and ingested at Google. Should be in the form of
\f5gs://my\-bucket/path/to/folder/\fR.

.TP 2m
\fB\-\-online\-import\fR=\fIONLINE_IMPORT\fR

Destination for a online import, where data is loaded onto the appliance and
automatically transferred to Cloud Storage whenever it has an internet
connection. Should be in the form of \f5gs://my\-bucket/path/to/folder/\fR.


.RE
.sp

.SH "DELIVERY FLAGS"

.RS 2m
.TP 2m
\fB\-\-address\fR=[\fIadministrative\-area\fR=\fIADMINISTRATIVE\-AREA\fR],[\fIlines\fR=\fILINES\fR],[\fIlocality\fR=\fILOCALITY\fR],[\fIpostal\-code\fR=\fIPOSTAL\-CODE\fR]

Address where the appliance will be shipped. All fields (or list items) have a
maximum of 80 characters. For more information see
https://support.google.com/business/answer/6397478.

.RS 2m
.TP 2m
\fBlines\fR
Line of the postal address that doesn't fit in the other fields. For most
countries/regions, the first line will include a street number and street name.
You can have up to 5 address lines.

.TP 2m
\fBlocality\fR
Generally refers to the city/town portion of the address.

.TP 2m
\fBadministrative_area\fR
The state or province where the business is located. Enter the full name (e.g.
"California"), common postal abbreviation (e.g. "CA"), or subdivision (ISO
3166\-2) code (e.g. "US\-CA").

.TP 2m
\fBpostal_code\fR
The postal code of the address.

.RE
.sp
.TP 2m
\fB\-\-delivery\-notes\fR=\fIDELIVERY_NOTES\fR

Add any additional details about your order, such as site details and a
preference date when the appliance should be delivered.

.TP 2m
\fB\-\-order\-contact\fR=[\fIbusiness\fR=\fIBUSINESS\fR],[\fIemails\fR=\fIEMAILS\fR],[\fIname\fR=\fINAME\fR],[\fIphone\fR=\fIPHONE\fR]

.RS 2m
.TP 2m
\fBbusiness\fR
Name of the business, if applicable.

.TP 2m
\fBname\fR
Name of the primary contact.

.TP 2m
\fBphone\fR
The phone number of the primary contact. Should be given in E.164 format
consisting of the country calling code (1 to 3 digits) and the subscriber
number, with no additional spaces or formatting, e.g. \f515552220123\fR.

.TP 2m
\fBemails\fR
The email of the primary contact along with any additional email addresses to
include with all correspondence.

.RE
.sp
.TP 2m
\fB\-\-shipping\-contact\fR=[\fIbusiness\fR=\fIBUSINESS\fR],[\fIemails\fR=\fIEMAILS\fR],[\fIname\fR=\fINAME\fR],[\fIphone\fR=\fIPHONE\fR]

.RS 2m
.TP 2m
\fBbusiness\fR
Name of the business, if applicable.

.TP 2m
\fBname\fR
Name of the primary contact.

.TP 2m
\fBphone\fR
The phone number of the primary contact. Should be given in E.164 format
consisting of the country calling code (1 to 3 digits) and the subscriber
number, with no additional spaces or formatting, e.g. \f515552220123\fR.

.TP 2m
\fBemails\fR
The email of the primary contact along with any additional email addresses to
include with all correspondence.


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