ConnectorClass[connectors.katanomi.dev/v1alpha1]

connectors.alauda.io group

ConnectorClass is the Schema for the connectorclasses API

v1alpha1 version
spec object

Spec defines the desired state of ConnectorClass

address object

Address indicates address param constraints for this ConnectorClass of connectors we only support string param type

default object

Default is the value a parameter takes if no input value is supplied.

arrayVal []string required
objectVal object required
stringVal string required
type string required

ParamType indicates the type of an input parameter; Used to distinguish between a single string and an array of strings.

description string

Description is a user-facing description of the parameter that may be used to populate a UI.

enum []string

Enum declares a set of allowed param input values. If Enum is not set, no input validation is performed for the param.

name string required

Name declares the name by which a parameter is referenced.

properties object

Properties is the JSON Schema properties to support key-value pairs parameter.

type string

Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.

api object

API defines connectorclass plugin api address api.ref can be address of plugin api, it should be a kubernetes svc api.uri can be an absolute URL(non-empty scheme and non-empty host) pointing to the target or a relative URI. Relative URIs will be resolved using the base URI retrieved from Ref. api.CACerts and api.audience is not implemented now

CACerts string

CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.

audience string

Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.

ref object

Ref points to an Addressable.

address string

Address points to a specific Address Name.

apiVersion string

API version of the referent.

group string

Group of the API, without the version of the group. This can be used as an alternative to the APIVersion, and then resolved using ResolveGroup. Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5086

kind string required
name string required
namespace string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.

uri string

URI can be an absolute URL(non-empty scheme and non-empty host) pointing to the target or a relative URI. Relative URIs will be resolved using the base URI retrieved from Ref.

auth object

Auth indicates authentication constraints for this ConnectorClass of connectors

types []object

ConnectorClassAuthType represent the authentication types supported by connectors of the current connectorclass type

generator object

Generator specifies how to generate authentication data dynamically. Can be used to implement custom authentication logic.

rego string

Rego contains the Rego policy script that will be evaluated to generate authentication data. The script must define an 'auth' object that matches the following rules:

  1. Define its rules under the 'proxy' package
  2. Produce an 'auth' object containing AuthInjection structure.
name string required

Name of the AuthType Must be unique within the ConnectorClass.

optional boolean

Optional indicates whether the authentication information is optional for this ConnectorClass of connectors the default value is false

params []object

ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources).

default object

Default is the value a parameter takes if no input value is supplied.

arrayVal []string required
objectVal object required
stringVal string required
type string required

ParamType indicates the type of an input parameter; Used to distinguish between a single string and an array of strings.

description string

Description is a user-facing description of the parameter that may be used to populate a UI.

enum []string

Enum declares a set of allowed param input values. If Enum is not set, no input validation is performed for the param.

name string required

Name declares the name by which a parameter is referenced.

properties object

Properties is the JSON Schema properties to support key-value pairs parameter.

type string

Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.

secretType string

SecretType represents the secret type of the current authentication information follow k8s secret type definition. eg.kubernetes.io/basic-auth, kubernetes.io/ssh-auth, kubernetes.io/opaque

authProbes []object

ConnectorClassAuthProbe represents network the detection configuration

authName string required

AuthName corresponds to spec.auth.types[].name, indicating the way to check for the corresponding authentication type

params []object

ParamSpec defines arbitrary parameters needed beyond typed inputs (such as resources).

default object

Default is the value a parameter takes if no input value is supplied.

arrayVal []string required
objectVal object required
stringVal string required
type string required

ParamType indicates the type of an input parameter; Used to distinguish between a single string and an array of strings.

description string

Description is a user-facing description of the parameter that may be used to populate a UI.

enum []string

Enum declares a set of allowed param input values. If Enum is not set, no input validation is performed for the param.

name string required

Name declares the name by which a parameter is referenced.

properties object

Properties is the JSON Schema properties to support key-value pairs parameter.

type string

Type is the user-specified type of the parameter. The possible types are currently "string", "array" and "object", and "string" is the default.

probe object

Probe represents current detection configuration

http object

Http represents the network detection using the http get method More Info: TODO:

disableRedirect boolean

DisableRedirect indicates whether the probe should follow redirects, default is false

host string

Host represents the tool address for the current detection. usually, it would be empty, it will use the spec.address of connector

httpHeaders []object

HTTPHeader describes a custom header to be used in HTTP probes

name string required

The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.

value string required

The header field value

method string

Method represents the HTTP method to use for the probe, support method: GET, POST. default is GET

path string required

Path represents the API address accessed during the current detection

configurations []object

ConnectorClassConfiguration defines connectorclass configuration

annotations object

Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations

data object

Data contains the configuration data. Each key must consist of alphanumeric characters, '-', '_' or '.'.

name string

Name of the configuration

livenessProbe object

LivenessProbe defines liveness probe for this ConnectorClass of connectors

http object

Http represents the network detection using the http get method More Info: TODO:

disableRedirect boolean

DisableRedirect indicates whether the probe should follow redirects, default is false

host string

Host represents the tool address for the current detection. usually, it would be empty, it will use the spec.address of connector

httpHeaders []object

HTTPHeader describes a custom header to be used in HTTP probes

name string required

The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.

value string required

The header field value

method string

Method represents the HTTP method to use for the probe, support method: GET, POST. default is GET

path string required

Path represents the API address accessed during the current detection

proxy object

Proxy defines the proxy configuration for this ConnectorClass. Specifies how network traffic should be routed through a proxy server.

CACerts string

CACerts are Certification Authority (CA) certificates in PEM format according to https://www.rfc-editor.org/rfc/rfc7468. If set, these CAs are appended to the set of CAs provided by the Addressable target, if any.

audience string

Audience is the OIDC audience. This need only be set, if the target is not an Addressable and thus the Audience can't be received from the Addressable itself. In case the Addressable specifies an Audience too, the Destinations Audience takes preference.

ref object

Ref points to an Addressable.

address string

Address points to a specific Address Name.

apiVersion string

API version of the referent.

group string

Group of the API, without the version of the group. This can be used as an alternative to the APIVersion, and then resolved using ResolveGroup. Note: This API is EXPERIMENTAL and might break anytime. For more details: https://github.com/knative/eventing/issues/5086

kind string required
name string required
namespace string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ This is optional field, it gets defaulted to the object holding it if left out.

uri string

URI can be an absolute URL(non-empty scheme and non-empty host) pointing to the target or a relative URI. Relative URIs will be resolved using the base URI retrieved from Ref.

status object

Status defines the actual state of ConnectorClass

annotations object

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.

api object

API represents status of connectorclass api it will resolved based on spec.api if spec.api is empty or invalid, it will not be set if current field is empty, the connectorclass cannot provides any api service.

address object

Address is a single Addressable address.

CACerts string

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

audience string

Audience is the OIDC audience for this address.

name string

Name is the name of the address.

url string
conditions []object

Condition defines a readiness condition for a Knative resource. See: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties

lastProbeTime string

Last time we probed the condition.

lastTransitionTime string

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

message string

A human readable message indicating details about the transition.

reason string

The reason for the condition's last transition.

severity string

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

status string required

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

type string required

Type of condition.

observedGeneration integer

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

proxy object

Proxy represents status of connectorclass proxy it will resolved based on spec.proxy if spec.proxy is empty or invalid, it will not be set if current field is empty, the connectorclass cannot provides any proxy service.

httpAddress object

HttpAddress is a single Addressable address.

CACerts string

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

audience string

Audience is the OIDC audience for this address.

name string

Name is the name of the address.

url string