2024-07-26 08:32:36 +00:00
|
|
|
---
|
|
|
|
layout: page
|
|
|
|
parent: CRD reference
|
|
|
|
title: ArangoRoute V1Alpha1
|
|
|
|
---
|
|
|
|
|
|
|
|
# API Reference for ArangoRoute V1Alpha1
|
|
|
|
|
|
|
|
## Spec
|
|
|
|
|
|
|
|
### .spec.deployment
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec.go#L27)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
2024-09-01 11:26:51 +00:00
|
|
|
Deployment specifies the ArangoDeployment object name
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-06 13:36:51 +00:00
|
|
|
### .spec.destination.authentication.passMode
|
2024-09-03 15:50:59 +00:00
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination_authentication.go#L32)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
PassMode define authorization details pass mode when authorization was successful
|
|
|
|
|
|
|
|
Possible Values:
|
|
|
|
* `"override"` (default) - Generates new token for the user
|
|
|
|
* `"pass"` - Pass token provided by the user
|
|
|
|
* `"remove"` - Removes authorization details from the request
|
2024-09-03 15:50:59 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-06 13:36:51 +00:00
|
|
|
### .spec.destination.authentication.type
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination_authentication.go#L37)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
Type of the authentication
|
|
|
|
|
|
|
|
Possible Values:
|
|
|
|
* `"optional"` (default) - Authentication is header is validated and passed to the service. In case if is unauthorized, requests is still passed
|
|
|
|
* `"required"` - Authentication is header is validated and passed to the service. In case if is unauthorized, returns 403
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.endpoints.checksum
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L61)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
UID keeps the information about object Checksum
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.endpoints.name
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L52)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
Name of the object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.endpoints.namespace
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L55)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
Namespace of the object. Should default to the namespace of the parent object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.endpoints.port
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `intstr.IntOrString` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination_endpoint.go#L36)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
Port defines Port or Port Name used as destination
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.endpoints.uid
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L58)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
UID keeps the information about object UID
|
2024-09-06 13:36:51 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-01 11:26:51 +00:00
|
|
|
### .spec.destination.path
|
|
|
|
|
2024-11-29 09:27:30 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination.go#L46)</sup>
|
2024-09-01 11:26:51 +00:00
|
|
|
|
|
|
|
Path defines service path used for overrides
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-11-29 09:27:30 +00:00
|
|
|
### .spec.destination.protocol
|
|
|
|
|
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination.go#L40)</sup>
|
|
|
|
|
|
|
|
Protocol defines http protocol used for the route
|
|
|
|
|
|
|
|
Possible Values:
|
|
|
|
* `"http1"` (default) - HTTP 1.1 Protocol
|
|
|
|
* `"http2"` - HTTP 2 Protocol
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-07-26 08:32:36 +00:00
|
|
|
### .spec.destination.schema
|
|
|
|
|
2024-11-29 09:27:30 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination.go#L35)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Schema defines HTTP/S schema used for connection
|
|
|
|
|
2024-11-29 09:27:30 +00:00
|
|
|
Possible Values:
|
|
|
|
* `"http"` (default) - HTTP Connection
|
|
|
|
* `"https"` - HTTPS Connection (HTTP with TLS)
|
|
|
|
|
2024-07-26 08:32:36 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.service.checksum
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L61)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
UID keeps the information about object Checksum
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.service.name
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L52)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Name of the object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.service.namespace
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L55)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Namespace of the object. Should default to the namespace of the parent object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.service.port
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `intstr.IntOrString` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination_service.go#L35)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Port defines Port or Port Name used as destination
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.service.uid
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L58)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
UID keeps the information about object UID
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.destination.tls.insecure
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_destination_tls.go#L25)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Insecure allows Insecure traffic
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-11-05 11:05:21 +00:00
|
|
|
### .spec.options.upgrade\[int\].enabled
|
|
|
|
|
2024-12-10 22:40:39 +00:00
|
|
|
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_options_upgrade.go#L50)</sup>
|
2024-11-05 11:05:21 +00:00
|
|
|
|
|
|
|
Enabled defines if upgrade option is enabled
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .spec.options.upgrade\[int\].type
|
|
|
|
|
2024-12-10 22:40:39 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_options_upgrade.go#L47)</sup>
|
2024-11-05 11:05:21 +00:00
|
|
|
|
|
|
|
Type defines type of the Upgrade
|
|
|
|
|
|
|
|
Possible Values:
|
|
|
|
* `"websocket"` (default) - HTTP WebSocket Upgrade type
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-07-26 08:32:36 +00:00
|
|
|
### .spec.route.path
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_spec_route.go#L29)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Path specifies the Path route
|
|
|
|
|
|
|
|
## Status
|
|
|
|
|
|
|
|
### .status.conditions
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `api.Conditions` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status.go#L31)</sup>
|
2024-07-26 08:32:36 +00:00
|
|
|
|
|
|
|
Conditions specific to the entire extension
|
|
|
|
|
2024-08-01 12:53:48 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .status.deployment.checksum
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L61)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
|
|
|
UID keeps the information about object Checksum
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .status.deployment.name
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L52)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
|
|
|
Name of the object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .status.deployment.namespace
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L55)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
|
|
|
Namespace of the object. Should default to the namespace of the parent object
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .status.deployment.uid
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/shared/v1/object.go#L58)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
|
|
|
UID keeps the information about object UID
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-06 13:36:51 +00:00
|
|
|
### .status.target.authentication.passMode
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_authentication.go#L27)</sup>
|
2024-09-06 13:36:51 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-03 15:50:59 +00:00
|
|
|
### .status.target.authentication.type
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_authentication.go#L26)</sup>
|
2024-09-03 15:50:59 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-01 11:26:51 +00:00
|
|
|
### .status.target.destinations\[int\].host
|
2024-08-01 12:53:48 +00:00
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_destination.go#L38)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
2024-09-01 11:26:51 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .status.target.destinations\[int\].port
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_destination.go#L39)</sup>
|
2024-08-01 12:53:48 +00:00
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-12-10 22:40:39 +00:00
|
|
|
### .status.target.options.upgrade\[int\].enabled
|
|
|
|
|
|
|
|
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_options_upgrade.go#L43)</sup>
|
|
|
|
|
|
|
|
Enabled defines if upgrade option is enabled
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
### .status.target.options.upgrade\[int\].type
|
|
|
|
|
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_options_upgrade.go#L40)</sup>
|
|
|
|
|
|
|
|
Type defines type of the Upgrade
|
|
|
|
|
|
|
|
Possible Values:
|
|
|
|
* `"websocket"` (default) - HTTP WebSocket Upgrade type
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-09-01 11:26:51 +00:00
|
|
|
### .status.target.path
|
|
|
|
|
2024-12-10 22:40:39 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target.go#L49)</sup>
|
2024-09-01 11:26:51 +00:00
|
|
|
|
|
|
|
Path specifies request path override
|
|
|
|
|
|
|
|
***
|
2024-08-01 12:53:48 +00:00
|
|
|
|
2024-11-29 09:27:30 +00:00
|
|
|
### .status.target.protocol
|
|
|
|
|
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target.go#L40)</sup>
|
|
|
|
|
|
|
|
Protocol defines http protocol used for the route
|
|
|
|
|
|
|
|
***
|
|
|
|
|
2024-12-10 22:40:39 +00:00
|
|
|
### .status.target.tls.insecure
|
2024-09-01 11:26:51 +00:00
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target_tls.go#L27)</sup>
|
2024-09-01 11:26:51 +00:00
|
|
|
|
|
|
|
Insecure allows Insecure traffic
|
2024-08-01 12:53:48 +00:00
|
|
|
|
2024-09-13 11:43:51 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
### .status.target.type
|
|
|
|
|
2024-10-14 14:35:16 +00:00
|
|
|
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/networking/v1alpha1/route_status_target.go#L34)</sup>
|
2024-09-13 11:43:51 +00:00
|
|
|
|
|
|
|
Type define destination type
|
|
|
|
|