Cloudera Docs

Restricted application subdomain names

Do not use the restricted subdomain names.

Do not use the following subdomain names:

  • Subdomains reserved for platform usage

    To prevent routing conflicts between platform-managed listeners (XListenerSets) and user-created applications, the platform reserves specific subdomain names. Users are strictly prohibited from using the reserved subdomains for their applications. The following keywords must not be used as the left-most label of an application hostname.

    • www
    • api
    • models
    • consoles
    • assets
    • livereload
    • grpc
    • rest
    • grpcapi
    • livelog
    • model-metrics
    • modelservice
    • tcp-ingress
    The following hostnames are, for example, prohibited:
    • www.[***WORKBENCH DOMAIN***]
    • api.[***WORKBENCH DOMAIN***]
    • modelservice.[***WORKBENCH DOMAIN***]
    • rest.[***WORKBENCH DOMAIN***]
    • grpc.[***WORKBENCH DOMAIN***]

  • Probable platform component naming

    Using a reserved subdomain for a user application might result in the following issues:

    • The creation of multiple XListenerSets for the same hostname.
    • Routing ambiguities within Istio, which can lead to user workloads encountering 404 Not Found errors or misrouted traffic.

    The following keywords are reserved as they are either currently in use or might be used in the future by essential platform components:

    • Web consoles
    • API endpoints
    • Metrics services
    • Internal ingress/egress paths