ProductConfig [alauda.io/v1alpha1]

Description
ProductConfig is the Schema for the productconfigs API
Type
object

Specification

PropertyTypeDescription
apiVersionstring

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

kindstring

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

metadataObjectMeta

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

specobject

ProductConfigSpec defines the desired state of ProductConfig

statusobject

ProductConfigStatus defines the observed state of ProductConfig

.spec

Description
ProductConfigSpec defines the desired state of ProductConfig
Type
object
Required
availableVersionbriefdescriptiondisplayNamedisplayUIConfiginstallUIConfiglogoplatformVersionMatchproductResourcetype
PropertyTypeDescription
availableVersionstring

AvailableVersion stands for the available version to deploy

briefobject

Brief stands for the product's brief

chartVersionsarray

ChartVersions stands for the charts when deploying, they are optional and will be added to the Prouct CR

commonConfigRefarray

CommonConfigRef stands for the reference from CommonConfig to Product CR

descriptionobject

Description stands for the product's description

displayNameobject

DisplayName stands for the product's display name

displayUIConfigobject

DisplayUIConfig stands for the web UI type when showing product's detail information

installUIConfigobject

InstallUIConfig stands for the web UI config when deploying product

isDisplayboolean

IsDisplay stands for if the product displaying on the products list

logostring

Logo stands for the product logo with base64 encoded data uri

platformVersionMatchstring

PlatformVersionMatch stands for the product need match the platform version

productResourceobject

ProductResource defines the target product CRD type

singleAppobject

SingleAppConfig stands for the config for SignleApp type

subAppobject

SubApp stands for the config for SubApp type

typestring

Type stands for the product's type

upgradeUIConfigarray

UpgradeUIConfig stands for the web UI config when upgrading product

upgradeableVersionsarray

UpgradeableVersions stands for the versions can upgrade from

.spec.brief

Description
Brief stands for the product's brief
Type
object
PropertyTypeDescription
enstring

EN stands for text with English

zhstring

ZH stands for text with Simple Chinese

.spec.chartVersions

Description
ChartVersions stands for the charts when deploying, they are optional and will be added to the Prouct CR
Type
array

.spec.chartVersions[]

Description
ChartVersion stands for chart version
Type
object
Required
nameversion
PropertyTypeDescription
namestring

Name stands for the chart's name

versionstring

Version stands for the chart's version

.spec.commonConfigRef

Description
CommonConfigRef stands for the reference from CommonConfig to Product CR
Type
array

.spec.commonConfigRef[]

Description
KeysRef stands for key references with specified version
Type
object
Required
keysversionMatch
PropertyTypeDescription
keysarray

Keys stands for a set of keys

versionMatchstring

VersionMatch stands for the target version

.spec.commonConfigRef[].keys

Description
Keys stands for a set of keys
Type
array

.spec.commonConfigRef[].keys[]

Description
KeyRef stands for key reference
Type
object
Required
refKeytargetKey
PropertyTypeDescription
refKeystring

RefKey stands for source key

targetKeystring

TargetKey stands for target key

.spec.description

Description
Description stands for the product's description
Type
object
PropertyTypeDescription
enstring

EN stands for text with English

zhstring

ZH stands for text with Simple Chinese

.spec.displayName

Description
DisplayName stands for the product's display name
Type
object
PropertyTypeDescription
enstring

EN stands for text with English

zhstring

ZH stands for text with Simple Chinese

.spec.displayUIConfig

Description
DisplayUIConfig stands for the web UI type when showing product's detail information
Type
object
Required
type
PropertyTypeDescription
schemeobject

Scheme defines the dynamic form, used when Type is DynamicForm

typestring

Type defines the web UI type, [InUnderlord is DEPRECATED, use SubApp instead]

.spec.displayUIConfig.scheme

Description
Scheme defines the dynamic form, used when Type is DynamicForm
Type
object

.spec.installUIConfig

Description
InstallUIConfig stands for the web UI config when deploying product
Type
object
Required
type
PropertyTypeDescription
schemeobject

Scheme defines the dynamic form, used when Type is DynamicForm

typestring

Type defines the web UI type, [InUnderlord is DEPRECATED, use SubApp instead]

.spec.installUIConfig.scheme

Description
Scheme defines the dynamic form, used when Type is DynamicForm
Type
object

.spec.productResource

Description
ProductResource defines the target product CRD type
Type
object
Required
groupnamesversion
PropertyTypeDescription
groupstring

Group stands for the target product's CRD Group

namesobject

Names stands for the target product's CRD's kind name

versionstring

Version stands for the target product's CRD version

.spec.productResource.names

Description
Names stands for the target product's CRD's kind name
Type
object
Required
kindplural
PropertyTypeDescription
categoriesarray

categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like kubectl get all.

kindstring

kind is the serialized kind of the resource. It is normally CamelCase and singular. Custom resource instances will use this value as the kind attribute in API calls.

listKindstring

listKind is the serialized kind of the list for this resource. Defaults to "kindList".

pluralstring

plural is the plural name of the resource to serve. The custom resources are served under /apis/<group>/<version>/.../<plural>. Must match the name of the CustomResourceDefinition (in the form <names.plural>.<group>). Must be all lowercase.

shortNamesarray

shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like kubectl get <shortname>. It must be all lowercase.

singularstring

singular is the singular name of the resource. It must be all lowercase. Defaults to lowercased kind.

.spec.productResource.names.categories

Description
categories is a list of grouped resources this custom resource belongs to (e.g. 'all'). This is published in API discovery documents, and used by clients to support invocations like `kubectl get all`.
Type
array

.spec.productResource.names.categories[]

Type
string

.spec.productResource.names.shortNames

Description
shortNames are short names for the resource, exposed in API discovery documents, and used by clients to support invocations like `kubectl get <shortname>`. It must be all lowercase.
Type
array

.spec.productResource.names.shortNames[]

Type
string

.spec.singleApp

Description
SingleAppConfig stands for the config for SignleApp type
Type
object
Required
entrypoint
PropertyTypeDescription
entrypointstring

Entrypoint stands for the entrypoint of standalone app

.spec.subApp

Description
SubApp stands for the config for SubApp type
Type
object
Required
entrypointname
PropertyTypeDescription
entrypointstring

Entrypoint stands for the entrypoint of sub app

namestring

Name stands for the name of sub app

.spec.upgradeUIConfig

Description
UpgradeUIConfig stands for the web UI config when upgrading product
Type
array

.spec.upgradeUIConfig[]

Description
VersionedUIConfig stands for the web UI type with special version
Type
object
Required
typeversionMatch
PropertyTypeDescription
schemeobject

Scheme defines the dynamic form, used when Type is DynamicForm

typestring

Type defines the web UI type, [InUnderlord is DEPRECATED, use SubApp instead]

versionMatchstring

VersionMatch stands for the target version

.spec.upgradeUIConfig[].scheme

Description
Scheme defines the dynamic form, used when Type is DynamicForm
Type
object

.spec.upgradeableVersions

Description
UpgradeableVersions stands for the versions can upgrade from
Type
array

.spec.upgradeableVersions[]

Type
string

.status

Description
ProductConfigStatus defines the observed state of ProductConfig
Type
object
Required
messagephasereason
PropertyTypeDescription
messagestring

Message contains the detail messages about the status

phasestring

Phase stands for the ProductConfig's status

reasonstring

Reason explain why the ProductCongfig in this status

API Endpoints

The following API endpoints are available:

  • /apis/alauda.io/v1alpha1/productconfigs
    • DELETE: delete collection of ProductConfig
    • GET: list objects of kind ProductConfig
    • POST: create a new ProductConfig
  • /apis/alauda.io/v1alpha1/productconfigs/{name}
    • DELETE: delete the specified ProductConfig
    • GET: read the specified ProductConfig
    • PATCH: partially update the specified ProductConfig
    • PUT: replace the specified ProductConfig
  • /apis/alauda.io/v1alpha1/productconfigs/{name}/status
    • GET: read status of the specified ProductConfig
    • PATCH: partially update status of the specified ProductConfig
    • PUT: replace status of the specified ProductConfig

/apis/alauda.io/v1alpha1/productconfigs

HTTP method
DELETE
Description
delete collection of ProductConfig
HTTP responses
HTTP codeResponse body
200 - OKStatus schema
401 - UnauthorizedEmpty
HTTP method
GET
Description
list objects of kind ProductConfig
HTTP responses
HTTP codeResponse body
200 - OKProductConfigList schema
401 - UnauthorizedEmpty
HTTP method
POST
Description
create a new ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
Body parameters
ParameterTypeDescription
bodyProductConfig schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
201 - CreatedProductConfig schema
202 - AcceptedProductConfig schema
401 - UnauthorizedEmpty

/apis/alauda.io/v1alpha1/productconfigs/{name}

HTTP method
DELETE
Description
delete the specified ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
HTTP responses
HTTP codeResponse body
200 - OKStatus schema
202 - AcceptedStatus schema
401 - UnauthorizedEmpty
HTTP method
GET
Description
read the specified ProductConfig
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
401 - UnauthorizedEmpty
HTTP method
PATCH
Description
partially update the specified ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
401 - UnauthorizedEmpty
HTTP method
PUT
Description
replace the specified ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
Body parameters
ParameterTypeDescription
bodyProductConfig schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
201 - CreatedProductConfig schema
401 - UnauthorizedEmpty

/apis/alauda.io/v1alpha1/productconfigs/{name}/status

HTTP method
GET
Description
read status of the specified ProductConfig
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
401 - UnauthorizedEmpty
HTTP method
PATCH
Description
partially update status of the specified ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
401 - UnauthorizedEmpty
HTTP method
PUT
Description
replace status of the specified ProductConfig
Query parameters
ParameterTypeDescription
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
Body parameters
ParameterTypeDescription
bodyProductConfig schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKProductConfig schema
201 - CreatedProductConfig schema
401 - UnauthorizedEmpty