Class Registration (1.34.0)

public final class Registration extends GeneratedMessageV3 implements RegistrationOrBuilder

The Registration resource facilitates managing and configuring domain name registrations.

There are several ways to create a new Registration resource:

To create a new Registration resource, find a suitable domain name by calling the SearchDomains method with a query to see available domain name options. After choosing a name, call RetrieveRegisterParameters to ensure availability and obtain information like pricing, which is needed to build a call to RegisterDomain.

Another way to create a new Registration is to transfer an existing domain from another registrar. First, go to the current registrar to unlock the domain for transfer and retrieve the domain's transfer authorization code. Then call RetrieveTransferParameters to confirm that the domain is unlocked and to get values needed to build a call to TransferDomain.

Protobuf type google.cloud.domains.v1.Registration

Static Fields

CONTACT_SETTINGS_FIELD_NUMBER

public static final int CONTACT_SETTINGS_FIELD_NUMBER
Field Value
TypeDescription
int

CREATE_TIME_FIELD_NUMBER

public static final int CREATE_TIME_FIELD_NUMBER
Field Value
TypeDescription
int

DNS_SETTINGS_FIELD_NUMBER

public static final int DNS_SETTINGS_FIELD_NUMBER
Field Value
TypeDescription
int

DOMAIN_NAME_FIELD_NUMBER

public static final int DOMAIN_NAME_FIELD_NUMBER
Field Value
TypeDescription
int

EXPIRE_TIME_FIELD_NUMBER

public static final int EXPIRE_TIME_FIELD_NUMBER
Field Value
TypeDescription
int

ISSUES_FIELD_NUMBER

public static final int ISSUES_FIELD_NUMBER
Field Value
TypeDescription
int

LABELS_FIELD_NUMBER

public static final int LABELS_FIELD_NUMBER
Field Value
TypeDescription
int

MANAGEMENT_SETTINGS_FIELD_NUMBER

public static final int MANAGEMENT_SETTINGS_FIELD_NUMBER
Field Value
TypeDescription
int

NAME_FIELD_NUMBER

public static final int NAME_FIELD_NUMBER
Field Value
TypeDescription
int

PENDING_CONTACT_SETTINGS_FIELD_NUMBER

public static final int PENDING_CONTACT_SETTINGS_FIELD_NUMBER
Field Value
TypeDescription
int

STATE_FIELD_NUMBER

public static final int STATE_FIELD_NUMBER
Field Value
TypeDescription
int

SUPPORTED_PRIVACY_FIELD_NUMBER

public static final int SUPPORTED_PRIVACY_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static Registration getDefaultInstance()
Returns
TypeDescription
Registration

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static Registration.Builder newBuilder()
Returns
TypeDescription
Registration.Builder

newBuilder(Registration prototype)

public static Registration.Builder newBuilder(Registration prototype)
Parameter
NameDescription
prototypeRegistration
Returns
TypeDescription
Registration.Builder

parseDelimitedFrom(InputStream input)

public static Registration parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Registration parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static Registration parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Registration parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Registration parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Registration parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Registration parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Registration parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static Registration parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Registration parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static Registration parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Registration parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Registration
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<Registration> parser()
Returns
TypeDescription
Parser<Registration>

Methods

containsLabels(String key)

public boolean containsLabels(String key)

Set of labels associated with the Registration.

map<string, string> labels = 9;

Parameter
NameDescription
keyString
Returns
TypeDescription
boolean

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getContactSettings()

public ContactSettings getContactSettings()

Required. Settings for contact information linked to the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureContactSettings method.

.google.cloud.domains.v1.ContactSettings contact_settings = 12 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
ContactSettings

The contactSettings.

getContactSettingsOrBuilder()

public ContactSettingsOrBuilder getContactSettingsOrBuilder()

Required. Settings for contact information linked to the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureContactSettings method.

.google.cloud.domains.v1.ContactSettings contact_settings = 12 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
ContactSettingsOrBuilder

getCreateTime()

public Timestamp getCreateTime()

Output only. The creation timestamp of the Registration resource.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Timestamp

The createTime.

getCreateTimeOrBuilder()

public TimestampOrBuilder getCreateTimeOrBuilder()

Output only. The creation timestamp of the Registration resource.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TimestampOrBuilder

getDefaultInstanceForType()

public Registration getDefaultInstanceForType()
Returns
TypeDescription
Registration

getDnsSettings()

public DnsSettings getDnsSettings()

Settings controlling the DNS configuration of the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureDnsSettings method.

.google.cloud.domains.v1.DnsSettings dns_settings = 11;

Returns
TypeDescription
DnsSettings

The dnsSettings.

getDnsSettingsOrBuilder()

public DnsSettingsOrBuilder getDnsSettingsOrBuilder()

Settings controlling the DNS configuration of the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureDnsSettings method.

.google.cloud.domains.v1.DnsSettings dns_settings = 11;

Returns
TypeDescription
DnsSettingsOrBuilder

getDomainName()

public String getDomainName()

Required. Immutable. The domain name. Unicode domain names must be expressed in Punycode format.

string domain_name = 2 [(.google.api.field_behavior) = REQUIRED, (.google.api.field_behavior) = IMMUTABLE];

Returns
TypeDescription
String

The domainName.

getDomainNameBytes()

public ByteString getDomainNameBytes()

Required. Immutable. The domain name. Unicode domain names must be expressed in Punycode format.

string domain_name = 2 [(.google.api.field_behavior) = REQUIRED, (.google.api.field_behavior) = IMMUTABLE];

Returns
TypeDescription
ByteString

The bytes for domainName.

getExpireTime()

public Timestamp getExpireTime()

Output only. The expiration timestamp of the Registration.

.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Timestamp

The expireTime.

getExpireTimeOrBuilder()

public TimestampOrBuilder getExpireTimeOrBuilder()

Output only. The expiration timestamp of the Registration.

.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
TimestampOrBuilder

getIssues(int index)

public Registration.Issue getIssues(int index)

Output only. The set of issues with the Registration that require attention.

repeated .google.cloud.domains.v1.Registration.Issue issues = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
Registration.Issue

The issues at the given index.

getIssuesCount()

public int getIssuesCount()

Output only. The set of issues with the Registration that require attention.

repeated .google.cloud.domains.v1.Registration.Issue issues = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The count of issues.

getIssuesList()

public List<Registration.Issue> getIssuesList()

Output only. The set of issues with the Registration that require attention.

repeated .google.cloud.domains.v1.Registration.Issue issues = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<Issue>

A list containing the issues.

getIssuesValue(int index)

public int getIssuesValue(int index)

Output only. The set of issues with the Registration that require attention.

repeated .google.cloud.domains.v1.Registration.Issue issues = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
int

The enum numeric value on the wire of issues at the given index.

getIssuesValueList()

public List<Integer> getIssuesValueList()

Output only. The set of issues with the Registration that require attention.

repeated .google.cloud.domains.v1.Registration.Issue issues = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<Integer>

A list containing the enum numeric values on the wire for issues.

getLabels() (deprecated)

public Map<String,String> getLabels()

Use #getLabelsMap() instead.

Returns
TypeDescription
Map<String,String>

getLabelsCount()

public int getLabelsCount()

Set of labels associated with the Registration.

map<string, string> labels = 9;

Returns
TypeDescription
int

getLabelsMap()

public Map<String,String> getLabelsMap()

Set of labels associated with the Registration.

map<string, string> labels = 9;

Returns
TypeDescription
Map<String,String>

getLabelsOrDefault(String key, String defaultValue)

public String getLabelsOrDefault(String key, String defaultValue)

Set of labels associated with the Registration.

map<string, string> labels = 9;

Parameters
NameDescription
keyString
defaultValueString
Returns
TypeDescription
String

getLabelsOrThrow(String key)

public String getLabelsOrThrow(String key)

Set of labels associated with the Registration.

map<string, string> labels = 9;

Parameter
NameDescription
keyString
Returns
TypeDescription
String

getManagementSettings()

public ManagementSettings getManagementSettings()

Settings for management of the Registration, including renewal, billing, and transfer. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureManagementSettings method.

.google.cloud.domains.v1.ManagementSettings management_settings = 10;

Returns
TypeDescription
ManagementSettings

The managementSettings.

getManagementSettingsOrBuilder()

public ManagementSettingsOrBuilder getManagementSettingsOrBuilder()

Settings for management of the Registration, including renewal, billing, and transfer. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureManagementSettings method.

.google.cloud.domains.v1.ManagementSettings management_settings = 10;

Returns
TypeDescription
ManagementSettingsOrBuilder

getName()

public String getName()

Output only. Name of the Registration resource, in the format projects/*/locations/*/registrations/<domain_name>.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
String

The name.

getNameBytes()

public ByteString getNameBytes()

Output only. Name of the Registration resource, in the format projects/*/locations/*/registrations/<domain_name>.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ByteString

The bytes for name.

getParserForType()

public Parser<Registration> getParserForType()
Returns
TypeDescription
Parser<Registration>
Overrides

getPendingContactSettings()

public ContactSettings getPendingContactSettings()

Output only. Pending contact settings for the Registration. Updates to the contact_settings field that change its registrant_contact or privacy fields require email confirmation by the registrant_contact before taking effect. This field is set only if there are pending updates to the contact_settings that have not been confirmed. To confirm the changes, the registrant_contact must follow the instructions in the email they receive.

.google.cloud.domains.v1.ContactSettings pending_contact_settings = 13 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ContactSettings

The pendingContactSettings.

getPendingContactSettingsOrBuilder()

public ContactSettingsOrBuilder getPendingContactSettingsOrBuilder()

Output only. Pending contact settings for the Registration. Updates to the contact_settings field that change its registrant_contact or privacy fields require email confirmation by the registrant_contact before taking effect. This field is set only if there are pending updates to the contact_settings that have not been confirmed. To confirm the changes, the registrant_contact must follow the instructions in the email they receive.

.google.cloud.domains.v1.ContactSettings pending_contact_settings = 13 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
ContactSettingsOrBuilder

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getState()

public Registration.State getState()

Output only. The state of the Registration

.google.cloud.domains.v1.Registration.State state = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
Registration.State

The state.

getStateValue()

public int getStateValue()

Output only. The state of the Registration

.google.cloud.domains.v1.Registration.State state = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The enum numeric value on the wire for state.

getSupportedPrivacy(int index)

public ContactPrivacy getSupportedPrivacy(int index)

Output only. Set of options for the contact_settings.privacy field that this Registration supports.

repeated .google.cloud.domains.v1.ContactPrivacy supported_privacy = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
ContactPrivacy

The supportedPrivacy at the given index.

getSupportedPrivacyCount()

public int getSupportedPrivacyCount()

Output only. Set of options for the contact_settings.privacy field that this Registration supports.

repeated .google.cloud.domains.v1.ContactPrivacy supported_privacy = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The count of supportedPrivacy.

getSupportedPrivacyList()

public List<ContactPrivacy> getSupportedPrivacyList()

Output only. Set of options for the contact_settings.privacy field that this Registration supports.

repeated .google.cloud.domains.v1.ContactPrivacy supported_privacy = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<ContactPrivacy>

A list containing the supportedPrivacy.

getSupportedPrivacyValue(int index)

public int getSupportedPrivacyValue(int index)

Output only. Set of options for the contact_settings.privacy field that this Registration supports.

repeated .google.cloud.domains.v1.ContactPrivacy supported_privacy = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
int

The enum numeric value on the wire of supportedPrivacy at the given index.

getSupportedPrivacyValueList()

public List<Integer> getSupportedPrivacyValueList()

Output only. Set of options for the contact_settings.privacy field that this Registration supports.

repeated .google.cloud.domains.v1.ContactPrivacy supported_privacy = 14 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
List<Integer>

A list containing the enum numeric values on the wire for supportedPrivacy.

hasContactSettings()

public boolean hasContactSettings()

Required. Settings for contact information linked to the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureContactSettings method.

.google.cloud.domains.v1.ContactSettings contact_settings = 12 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
boolean

Whether the contactSettings field is set.

hasCreateTime()

public boolean hasCreateTime()

Output only. The creation timestamp of the Registration resource.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the createTime field is set.

hasDnsSettings()

public boolean hasDnsSettings()

Settings controlling the DNS configuration of the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureDnsSettings method.

.google.cloud.domains.v1.DnsSettings dns_settings = 11;

Returns
TypeDescription
boolean

Whether the dnsSettings field is set.

hasExpireTime()

public boolean hasExpireTime()

Output only. The expiration timestamp of the Registration.

.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the expireTime field is set.

hasManagementSettings()

public boolean hasManagementSettings()

Settings for management of the Registration, including renewal, billing, and transfer. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureManagementSettings method.

.google.cloud.domains.v1.ManagementSettings management_settings = 10;

Returns
TypeDescription
boolean

Whether the managementSettings field is set.

hasPendingContactSettings()

public boolean hasPendingContactSettings()

Output only. Pending contact settings for the Registration. Updates to the contact_settings field that change its registrant_contact or privacy fields require email confirmation by the registrant_contact before taking effect. This field is set only if there are pending updates to the contact_settings that have not been confirmed. To confirm the changes, the registrant_contact must follow the instructions in the email they receive.

.google.cloud.domains.v1.ContactSettings pending_contact_settings = 13 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
boolean

Whether the pendingContactSettings field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

internalGetMapFieldReflection(int number)

protected MapFieldReflectionAccessor internalGetMapFieldReflection(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
com.google.protobuf.MapFieldReflectionAccessor
Overrides
com.google.protobuf.GeneratedMessageV3.internalGetMapFieldReflection(int)

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public Registration.Builder newBuilderForType()
Returns
TypeDescription
Registration.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Registration.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
Registration.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public Registration.Builder toBuilder()
Returns
TypeDescription
Registration.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException