Route

string

.apiVersion

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
string

.kind

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
object

.metadata
object

.spec

Spec holds the desired state of the Route (from the client).
array

.spec .traffic

Traffic specifies how to distribute traffic over a collection of revisions and configurations.
string

.spec .traffic[] .configurationName

ConfigurationName of a configuration to whose latest revision we will send this portion of traffic. When the “status.latestReadyRevisionName” of the referenced configuration changes, we will automatically migrate traffic from the prior “latest ready” revision to the new one. This field is never set in Route’s status, only its spec. This is mutually exclusive with RevisionName.
boolean

.spec .traffic[] .latestRevision

LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
integer

.spec .traffic[] .percent
Percent indicates that percentage based routing should be used and the value indicates the percent of traffic that is be routed to this Revision or Configuration. 0 (zero) mean no traffic, 100 means all traffic. When percentage based routing is being used the follow rules apply:
- the sum of all percent values must equal 100
- when not specified, the implied value for percent is zero for that particular Revision or Configuration
string

.spec .traffic[] .revisionName

RevisionName of a specific revision to which to send this portion of traffic. This is mutually exclusive with ConfigurationName.
string

.spec .traffic[] .tag

Tag is optionally used to expose a dedicated url for referencing this target exclusively.
string

.spec .traffic[] .url

URL displays the URL for accessing named traffic targets. URL is displayed in status, and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, but may not contain anything else (e.g. basic auth, url path, etc.)
object

.status

Status communicates the observed state of the Route (from the controller).
object

.status .address

Address holds the information needed for a Route to be the target of an event.
string

.status .address .CACerts

CACerts is the Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468.
string

.status .address .audience

Audience is the OIDC audience for this address.
string

.status .address .name

Name is the name of the address.
string

.status .address .url
object

.status .annotations

Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
array

.status .conditions

Conditions the latest available observations of a resource’s current state.
string

.status .conditions[] .lastTransitionTime

LastTransitionTime is the last time the condition transitioned from one status to another. We use VolatileTime in place of metav1.Time to exclude this from creating equality.Semantic differences (all other things held constant).
string

.status .conditions[] .message

A human readable message indicating details about the transition.
string

.status .conditions[] .reason

The reason for the condition’s last transition.
string

.status .conditions[] .severity

Severity with which to treat failures of this type of condition. When this is not specified, it defaults to Error.
string required

.status .conditions[] .status

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

.status .conditions[] .type

Type of condition.
integer

.status .observedGeneration

ObservedGeneration is the ‘Generation’ of the Service that was last processed by the controller.
array

.status .traffic

Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.
string

.status .traffic[] .configurationName

ConfigurationName of a configuration to whose latest revision we will send this portion of traffic. When the “status.latestReadyRevisionName” of the referenced configuration changes, we will automatically migrate traffic from the prior “latest ready” revision to the new one. This field is never set in Route’s status, only its spec. This is mutually exclusive with RevisionName.
boolean

.status .traffic[] .latestRevision

LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
integer

.status .traffic[] .percent
Percent indicates that percentage based routing should be used and the value indicates the percent of traffic that is be routed to this Revision or Configuration. 0 (zero) mean no traffic, 100 means all traffic. When percentage based routing is being used the follow rules apply:
- the sum of all percent values must equal 100
- when not specified, the implied value for percent is zero for that particular Revision or Configuration
string

.status .traffic[] .revisionName

RevisionName of a specific revision to which to send this portion of traffic. This is mutually exclusive with ConfigurationName.
string

.status .traffic[] .tag

Tag is optionally used to expose a dedicated url for referencing this target exclusively.
string

.status .traffic[] .url

URL displays the URL for accessing named traffic targets. URL is displayed in status, and is disallowed on spec. URL must contain a scheme (e.g. http://) and a hostname, but may not contain anything else (e.g. basic auth, url path, etc.)
string

.status .url

URL holds the url that will distribute traffic over the provided traffic targets. It generally has the form http[s]://{route-name}.{route-namespace}.{cluster-level-suffix}