public sealed class Registration : IMessage<Registration>, IEquatable<Registration>, IDeepCloneable<Registration>, IBufferMessage, IMessage
Reference documentation and code samples for the Cloud Domains v1 API class Registration.
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.
public ContactSettings ContactSettings { get; set; }
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.
Settings controlling the DNS configuration of the Registration. You
cannot update these with the UpdateRegistration method. To update these
settings, use the ConfigureDnsSettings method.
public ManagementSettings ManagementSettings { get; set; }
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.
public ContactSettings PendingContactSettings { get; set; }
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eRegistration\u003c/code\u003e class in the Cloud Domains v1 API is used to manage domain name registrations, providing functionalities for creating, transferring, and configuring domains.\u003c/p\u003e\n"],["\u003cp\u003eNew \u003ccode\u003eRegistration\u003c/code\u003e resources can be created by searching for available domain names and registering them, or by transferring an existing domain from another registrar.\u003c/p\u003e\n"],["\u003cp\u003eThe class offers various properties to manage domain settings, including contact information (\u003ccode\u003eContactSettings\u003c/code\u003e), DNS configuration (\u003ccode\u003eDnsSettings\u003c/code\u003e), management details (\u003ccode\u003eManagementSettings\u003c/code\u003e), and the domain's name and state.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eRegistration\u003c/code\u003e resource also provides details on the domain's creation and expiration timestamps, along with any issues that may require attention.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the API is 2.4.0, with other versions available dating back to 1.0.0, and it implements several interfaces including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Cloud Domains v1 API - Class Registration (2.4.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.4.0 (latest)](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.Registration)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.Domains.V1/2.3.0/Google.Cloud.Domains.V1.Registration)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.Domains.V1/2.2.0/Google.Cloud.Domains.V1.Registration)\n- [2.1.0](/dotnet/docs/reference/Google.Cloud.Domains.V1/2.1.0/Google.Cloud.Domains.V1.Registration)\n- [2.0.0](/dotnet/docs/reference/Google.Cloud.Domains.V1/2.0.0/Google.Cloud.Domains.V1.Registration)\n- [1.0.0](/dotnet/docs/reference/Google.Cloud.Domains.V1/1.0.0/Google.Cloud.Domains.V1.Registration) \n\n public sealed class Registration : IMessage\u003cRegistration\u003e, IEquatable\u003cRegistration\u003e, IDeepCloneable\u003cRegistration\u003e, IBufferMessage, IMessage\n\nReference documentation and code samples for the Cloud Domains v1 API class Registration.\n\nThe `Registration` resource facilitates managing and configuring domain name\nregistrations.\n\nThere are several ways to create a new `Registration` resource:\n\nTo create a new `Registration` resource, find a suitable domain name by\ncalling the `SearchDomains` method with a query to see available domain name\noptions. After choosing a name, call `RetrieveRegisterParameters` to\nensure availability and obtain information like pricing, which is needed to\nbuild a call to `RegisterDomain`.\n\nAnother way to create a new `Registration` is to transfer an existing\ndomain from another registrar. First, go to the current registrar to unlock\nthe domain for transfer and retrieve the domain's transfer authorization\ncode. Then call `RetrieveTransferParameters` to confirm that the domain is\nunlocked and to get values needed to build a call to `TransferDomain`. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e Registration \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[Registration](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.Registration), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[Registration](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.Registration), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[Registration](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.Registration), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.Domains.V1](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.Domains.V1.dll\n\nConstructors\n------------\n\n### Registration()\n\n public Registration()\n\n### Registration(Registration)\n\n public Registration(Registration other)\n\nProperties\n----------\n\n### ContactSettings\n\n public ContactSettings ContactSettings { get; set; }\n\nRequired. Settings for contact information linked to the `Registration`. You cannot\nupdate these with the `UpdateRegistration` method. To update these\nsettings, use the `ConfigureContactSettings` method.\n\n### CreateTime\n\n public Timestamp CreateTime { get; set; }\n\nOutput only. The creation timestamp of the `Registration` resource.\n\n### DnsSettings\n\n public DnsSettings DnsSettings { get; set; }\n\nSettings controlling the DNS configuration of the `Registration`. You\ncannot update these with the `UpdateRegistration` method. To update these\nsettings, use the `ConfigureDnsSettings` method.\n\n### DomainName\n\n public string DomainName { get; set; }\n\nRequired. Immutable. The domain name. Unicode domain names must be expressed in Punycode format.\n\n### ExpireTime\n\n public Timestamp ExpireTime { get; set; }\n\nOutput only. The expiration timestamp of the `Registration`.\n\n### Issues\n\n public RepeatedField\u003cRegistration.Types.Issue\u003e Issues { get; }\n\nOutput only. The set of issues with the `Registration` that require attention.\n\n### Labels\n\n public MapField\u003cstring, string\u003e Labels { get; }\n\nSet of labels associated with the `Registration`.\n\n### ManagementSettings\n\n public ManagementSettings ManagementSettings { get; set; }\n\nSettings for management of the `Registration`, including renewal, billing,\nand transfer. You cannot update these with the `UpdateRegistration`\nmethod. To update these settings, use the `ConfigureManagementSettings`\nmethod.\n\n### Name\n\n public string Name { get; set; }\n\nOutput only. Name of the `Registration` resource, in the format\n`projects/*/locations/*/registrations/\u003cdomain_name\u003e`.\n\n### PendingContactSettings\n\n public ContactSettings PendingContactSettings { get; set; }\n\nOutput only. Pending contact settings for the `Registration`. Updates to the\n`contact_settings` field that change its `registrant_contact` or `privacy`\nfields require email confirmation by the `registrant_contact`\nbefore taking effect. This field is set only if there are pending updates\nto the `contact_settings` that have not been confirmed. To confirm the\nchanges, the `registrant_contact` must follow the instructions in the\nemail they receive.\n\n### RegistrationName\n\n public RegistrationName RegistrationName { get; set; }\n\n[RegistrationName](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.RegistrationName)-typed view over the [Name](/dotnet/docs/reference/Google.Cloud.Domains.V1/latest/Google.Cloud.Domains.V1.Registration#Google_Cloud_Domains_V1_Registration_Name) resource name property.\n\n### State\n\n public Registration.Types.State State { get; set; }\n\nOutput only. The state of the `Registration`\n\n### SupportedPrivacy\n\n public RepeatedField\u003cContactPrivacy\u003e SupportedPrivacy { get; }\n\nOutput only. Set of options for the `contact_settings.privacy` field that this\n`Registration` supports."]]