# Class Registration (1.14.0)

1.14.0 (latest) 1.13.0 1.12.0 1.11.0 1.10.2 1.9.0 1.8.1 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` | `https://docs.cloud.google.com/python/docs/reference/domains/latest/google.cloud.domains_v1beta1.types.Registration.State` Output only. The state of the `Registration` |
| `issues` | `MutableSequence[https://docs.cloud.google.com/python/docs/reference/domains/latest/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` | `https://docs.cloud.google.com/python/docs/reference/domains/latest/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` | `https://docs.cloud.google.com/python/docs/reference/domains/latest/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` | `https://docs.cloud.google.com/python/docs/reference/domains/latest/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` | `https://docs.cloud.google.com/python/docs/reference/domains/latest/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[https://docs.cloud.google.com/python/docs/reference/domains/latest/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.

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