REST Resource: namespaces.domainmappings

Resource: DomainMapping

Resource to hold the state and status of a user's domain mapping.

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/v1alpha1".

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 LetsEncrypt.

DomainMappingStatus

The current state of the Domain Mapping.

JSON representation
{
  "conditions": [
    {
      object (DomainMappingCondition)
    }
  ],
  "observedGeneration": number,
  "resourceRecords": [
    {
      object (ResourceRecord)
    }
  ],
  "mappedRouteName": string
}
Fields
conditions[]

object (DomainMappingCondition)

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

observedGeneration

number

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.

DomainMappingCondition

DomainMappingCondition contains state information for a DomainMapping.

JSON representation
{
  "type": string,
  "status": string,
  "reason": string,
  "message": string,
  "lastTransitionTime": string,
  "severity": string
}
Fields
type

string

Type of domain mapping condition.

status

string

Status of the condition, one of True, False, Unknown.

reason

string

One-word CamelCase reason for the condition's current status. +optional

message

string

Human readable message indicating details about the current status. +optional

lastTransitionTime

string (Timestamp format)

Last time the condition transitioned from one status to another. +optional

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

severity

string

How to interpret failures of this condition, one of Error, Warning, Info +optional

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

Creates a new domain mapping.

delete

Rpc to delete a domain mapping.

get

Rpc to get information about a domain mapping.

list

Rpc to list domain mappings.
Kunde den här sidan hjälpa dig? Berätta:

Skicka feedback om ...