- NAME
-
- gcloud domains registrations register - register a new domain
- SYNOPSIS
-
-
gcloud domains registrations register
REGISTRATION
[--contact-data-from-file
=CONTACT_DATA_FILE_NAME
] [--contact-privacy
=CONTACT_PRIVACY
] [--validate-only
] [--cloud-dns-zone
=CLOUD_DNS_ZONE
|--name-servers
=NAME_SERVER
,…,[…] |--use-google-domains-dns
] [--async
] [--disable-dnssec
] [--labels
=[KEY
=VALUE
,…]] [--notices
=[NOTICE
,…]] [--yearly-price
=YEARLY_PRICE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
Create a new Cloud Domains registration resource by registering a new domain.
The new resource's ID will be equal to the domain name.
After this command executes, the resource will be in state REGISTRATION_PENDING. The registration process should complete in less than 5 minutes. After that the resource will be in state ACTIVE. In rare cases this process can take much longer due, for example, to a downtime of the domain registry.
Also in rare cases, the domain may end up in state REGISTRATION_FAILED. In that case, delete the registration resource and try again.
When using Cloud DNS Zone DNSSEC will be enabled by default whenever the Zone is DNSSEC signed. You can choose to not enable DNSSEC by using the --disable-dnssec flag.
- EXAMPLES
-
To register
interactively, run:example.com
gcloud domains registrations register example.com
To register
using contact data from a YAML fileexample.com
, run:contacts.yaml
gcloud domains registrations register example.com --contact-data-from-file=contacts.yaml
To register
with interactive prompts disabled, provide --contact-data-from-file, --contact-privacy, --yearly-price flags and one of the flags for setting authoritative name servers. Sometimes also --notices flag is required. For example, run:example.com
gcloud domains registrations register example.com --contact-data-from-file=contacts.yaml --contact-privacy=private-contact-data --yearly-price="12.00 USD" --cloud-dns-zone=example-com --quiet
- POSITIONAL ARGUMENTS
-
-
Registration resource - The domain name to register. 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
project
attribute:-
provide the argument
registration
on the command line with a fully specified name; -
provide the argument
--project
on the command line; -
set the property
core/project
.
To set the
location
attribute:-
provide the argument
registration
on the command line with a fully specified name; - location is always global.
This must be specified.
REGISTRATION
-
ID of the registration or fully qualified identifier for the registration.
To set the
registration
attribute:-
provide the argument
registration
on the command line.
-
provide the argument
-
provide the argument
-
Registration resource - The domain name to register. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.
- COMMONLY USED FLAGS
-
--contact-data-from-file
=CONTACT_DATA_FILE_NAME
-
A YAML file containing the contact data for the domain's three contacts:
registrant, admin, and technical.
The file can either specify a single set of contact data with label 'allContacts', or three separate sets of contact data with labels 'adminContact' and 'technicalContact'.
Each contact data must contain values for all required fields: email, phoneNumber and postalAddress in google.type.PostalAddress format.
For more guidance on how to specify postalAddress, please see: https://support.google.com/business/answer/6397478
Examples of file contents:
allContacts: email: 'example@example.com' phoneNumber: '+1.8005550123' postalAddress: regionCode: 'US' postalCode: '94043' administrativeArea: 'CA' locality: 'Mountain View' addressLines: ['1600 Amphitheatre Pkwy'] recipients: ['Jane Doe']
registrantContact: email: 'registrant@example.com' phoneNumber: '+1.8005550123' postalAddress: regionCode: 'US' postalCode: '94043' administrativeArea: 'CA' locality: 'Mountain View' addressLines: ['1600 Amphitheatre Pkwy'] recipients: ['Registrant Jane Doe'] adminContact: email: 'admin@example.com' phoneNumber: '+1.8005550123' postalAddress: regionCode: 'US' postalCode: '94043' administrativeArea: 'CA' locality: 'Mountain View' addressLines: ['1600 Amphitheatre Pkwy'] recipients: ['Admin Jane Doe'] technicalContact: email: 'technical@example.com' phoneNumber: '+1.8005550123' postalAddress: regionCode: 'US' postalCode: '94043' administrativeArea: 'CA' locality: 'Mountain View' addressLines: ['1600 Amphitheatre Pkwy'] recipients: ['Technic Jane Doe']
--contact-privacy
=CONTACT_PRIVACY
-
The contact privacy mode to use. Supported privacy modes depend on the domain.
CONTACT_PRIVACY
must be one of:private-contact-data
- (DEPRECATED) Your contact info won't be available to the public. To help protect your info and prevent spam, a third party provides alternate (proxy) contact info for your domain in the public directory at no extra cost. They will forward received messages to you. The private-contact-data option is deprecated; See https://cloud.google.com/domains/docs/deprecations/feature-deprecations.
public-contact-data
- All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value public-contact-data-acknowledgement or agree to the notice interactively.
redacted-contact-data
- Limited personal information will be available to the public. The actual information redacted depends on the domain. For more information see https://support.google.com/domains/answer/3251242.
--validate-only
- Don't actually create registration. Only validate arguments.
-
Set the authoritative name servers for the given domain.
At most one of these can be specified:
--cloud-dns-zone
=CLOUD_DNS_ZONE
- The name of the Cloud DNS managed-zone to set as the name server for the domain. If it's in the same project, you can use short name. If not, use the full resource name, e.g.: --cloud-dns-zone=projects/example-project/managedZones/example-zone. If the zone is signed, DNSSEC will be enabled by default unless you pass --disable-dnssec.
--name-servers
=NAME_SERVER
,…,[…]- List of DNS name servers for the domain.
--use-google-domains-dns
-
(REMOVED) Use free name servers provided by Google Domains. If the zone is
signed, DNSSEC will be enabled by default unless you pass --disable-dnssec.
Flag --use-google-domains-dns has been removed.
- OTHER FLAGS
-
--async
- Return immediately, without waiting for the operation in progress to complete.
--disable-dnssec
- Use this flag to disable DNSSEC, or to skip enabling it when switching to a Cloud DNS Zone or Google Domains nameservers.
--labels
=[KEY
=VALUE
,…]-
List of label KEY=VALUE pairs to add.
Keys must start with a lowercase character and contain only hyphens (
-
), underscores (_
), lowercase characters, and numbers. Values must contain only hyphens (-
), underscores (_
), lowercase characters, and numbers. --notices
=[NOTICE
,…]-
Notices about special properties of certain domains or contacts.
NOTICE
must be one of:public-contact-data-acknowledgement
- By sending this notice you acknowledge that using public-contact-data contact privacy makes all the data from contact config publicly available.
hsts-preloaded
- By sending this notice you acknowledge that the domain is preloaded on the HTTP Strict Transport Security list in browsers. Serving a website on such domain will require an SSL certificate. See https://support.google.com/domains/answer/7638036 for details.
--yearly-price
=YEARLY_PRICE
- Accept the domain's yearly price in the interactive flow or by using this flag. Use a number followed by a currency code, for example, "12.00 USD". Get the price using the get-register-parameters command.
- 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
$ gcloud help
for details. - NOTES
-
These variants are also available:
gcloud alpha domains registrations register
gcloud beta domains registrations register
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-11 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"lastModified": "Last updated 2024-06-11 UTC.",
"confidential": False
}