Class Registration (1.6.0)

Version 1.6.0

• 1.8.1 (latest)
• 1.8.0
• 1.7.5
• 1.6.0
• 1.5.2
• 1.4.1
• 1.3.0
• 1.2.3
• 1.1.3
• 1.0.0
• 0.4.3
• 0.3.0
• 0.2.3
• 0.1.0

Registration(mapping=None, *, ignore_unknown_fields=False, **kwargs)

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.

Attributes
Name	Description
name	str Output only. Name of the Registration resource, in the format projects/*/locations/*/registrations/.
domain_name	str Required. Immutable. The domain name. Unicode domain names must be expressed in Punycode format.
create_time	google.protobuf.timestamp_pb2.Timestamp Output only. The creation timestamp of the Registration resource.
expire_time	google.protobuf.timestamp_pb2.Timestamp Output only. The expiration timestamp of the Registration.
state	google.cloud.domains_v1beta1.types.Registration.State Output only. The state of the Registration
issues	MutableSequence[google.cloud.domains_v1beta1.types.Registration.Issue] Output only. The set of issues with the Registration that require attention.
labels	MutableMapping[str, str] Set of labels associated with the Registration.
management_settings	google.cloud.domains_v1beta1.types.ManagementSettings 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.
dns_settings	google.cloud.domains_v1beta1.types.DnsSettings Settings controlling the DNS configuration of the Registration. You cannot update these with the UpdateRegistration method. To update these settings, use the ConfigureDnsSettings method.
contact_settings	google.cloud.domains_v1beta1.types.ContactSettings 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.
pending_contact_settings	google.cloud.domains_v1beta1.types.ContactSettings 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.
supported_privacy	MutableSequence[google.cloud.domains_v1beta1.types.ContactPrivacy] Output only. Set of options for the contact_settings.privacy field that this Registration supports.

Classes

Issue

Issue(value)

Possible issues with a Registration that require attention.

Values: ISSUE_UNSPECIFIED (0): The issue is undefined. CONTACT_SUPPORT (1): Contact the Cloud Support team to resolve a problem with this domain. UNVERIFIED_EMAIL (2): ICANN <https://icann.org/>__ requires verification of the email address in the Registration's contact_settings.registrant_contact field. To verify the email address, follow the instructions in the email the registrant_contact receives following registration. If you do not complete email verification within 15 days of registration, the domain is suspended. To resend the verification email, call ConfigureContactSettings and provide the current registrant_contact.email.

LabelsEntry

LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
Name	Description
kwargs	dict Keys and values corresponding to the fields of the message.
mapping	Union[dict, .Message] A dictionary or message to be used to determine the values for this message.
ignore_unknown_fields	Optional(bool) If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.

State

State(value)

Possible states of a Registration.

Values: STATE_UNSPECIFIED (0): The state is undefined. REGISTRATION_PENDING (1): The domain is being registered. REGISTRATION_FAILED (2): The domain registration failed. You can delete resources in this state to allow registration to be retried. TRANSFER_PENDING (3): The domain is being transferred from another registrar to Cloud Domains. TRANSFER_FAILED (4): The attempt to transfer the domain from another registrar to Cloud Domains failed. You can delete resources in this state and retry the transfer. ACTIVE (6): The domain is registered and operational. The domain renews automatically as long as it remains in this state. SUSPENDED (7): The domain is suspended and inoperative. For more details, see the issues field. EXPORTED (8): The domain is no longer managed with Cloud Domains. It may have been transferred to another registrar or exported for management in Google Domains <https://domains.google/>__. You can no longer update it with this API, and information shown about it may be stale. Domains in this state are not automatically renewed by Cloud Domains.