REST Resource: namespaces.domainmappings

Resource: DomainMapping

Resource to hold the state and status of a user's domain mapping. NOTE: This resource is currently in Beta.

JSON representation
{
  "apiVersion": string,
  "kind": string,
  "metadata": {
    object (ObjectMeta)
  },
  "spec": {
    object (DomainMappingSpec)
  },
  "status": {
    object (DomainMappingStatus)
  }
}
Fields
apiVersion

string

The API version for this call such as "domains.cloudrun.com/v1".

kind

string

The kind of resource, in this case "DomainMapping".

metadata

object (ObjectMeta)

Metadata associated with this BuildTemplate.

spec

object (DomainMappingSpec)

The spec for this DomainMapping.

status

object (DomainMappingStatus)

The current status of the DomainMapping.

DomainMappingSpec

The desired state of the Domain Mapping.

JSON representation
{
  "routeName": string,
  "certificateMode": enum (CertificateMode),
  "forceOverride": boolean
}
Fields
routeName

string

The name of the Knative Route that this DomainMapping applies to. The route must exist.

certificateMode

enum (CertificateMode)

The mode of the certificate.

forceOverride

boolean

If set, the mapping will override any mapping set before this spec was set. It is recommended that the user leaves this empty to receive an error warning about a potential conflict and only set it once the respective UI has given such a warning.

CertificateMode

SSL management type. If AUTOMATIC or a type is omitted, a managed certificate is automatically provisioned. If None, the system will not provision a certificate.

Enums
CERTIFICATE_MODE_UNSPECIFIED
NONE Do not provision an HTTPS certificate.
AUTOMATIC Automatically provisions an HTTPS certificate via GoogleCA.

DomainMappingStatus

The current state of the Domain Mapping.

JSON representation
{
  "conditions": [
    {
      object (Condition)
    }
  ],
  "observedGeneration": integer,
  "resourceRecords": [
    {
      object (ResourceRecord)
    }
  ],
  "mappedRouteName": string,
  "url": string
}
Fields
conditions[]

object (Condition)

Array of observed DomainMappingConditions, indicating the current state of the DomainMapping.

observedGeneration

integer

ObservedGeneration is the 'Generation' of the DomainMapping that was last processed by the controller.

Clients polling for completed reconciliation should poll until observedGeneration = metadata.generation and the Ready condition's status is True or False.

resourceRecords[]

object (ResourceRecord)

The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.

mappedRouteName

string

The name of the route that the mapping currently points to.

url

string

Optional. Not supported by Cloud Run.

ResourceRecord

A DNS resource record.

JSON representation
{
  "name": string,
  "rrdata": string,
  "type": enum (RecordType)
}
Fields
name

string

Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.

rrdata

string

Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).

type

enum (RecordType)

Resource record type. Example: AAAA.

RecordType

A resource record type.

Enums
RECORD_TYPE_UNSPECIFIED An unknown resource record.
A An A resource record. Data is an IPv4 address.
AAAA An AAAA resource record. Data is an IPv6 address.
CNAME A CNAME resource record. Data is a domain name to be aliased.

Methods

create

Create a new domain mapping.

delete

Delete a domain mapping.

get

Get information about a domain mapping.

list

List all domain mappings.