---
title: "List Split-Horizon DNS Config instances."
method: GET
path: "/namespaces/{namespace}/engine-features/split-horizon-dns-configs"
tags: ["SplitHorizonDNSConfig"]
---

# List Split-Horizon DNS Config instances.

`GET /namespaces/{namespace}/engine-features/split-horizon-dns-configs`

This API lists all Split-Horizon DNS Config instances in a given namespace.

## Path parameters

- `namespace` string, required

## Response `200`

Successful operation

- SplitHorizonDNSConfigList — SplitHorizonDNSConfigList is an object that contains the list of the existing split-horizon dns configs.
  - `apiVersion` string — 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
  - `kind` string — 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
  - `items` SplitHorizonDNSConfig[]
    - `apiVersion` string — 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
    - `kind` string — 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
    - `metadata` object
    - `spec` object, required — Spec defines the desired state of SplitHorizonDNSConfig
      - `baseDomainNameSuffix` string, required — BaseDomainNameSuffix is the base domain name suffix for generating domain names for each Pod in ReplicaSet. It should be a valid domain name suffix.
      - `tls` object, required — TLS is the TLS configuration for the split-horizon DNS configuration.
        - `certificate` object — Certificate is the TLS certificate and key for the split-horizon DNS configuration.
          - `ca.crt` string, required — CACert is based64 encoded ca.pem file content. It is provided as a write-only input field for convenience. When this field is set, a webhook writes this value in the Secret specified by `.spec.tls.secretName` and empties this field. This field is not stored in the API.
          - `ca.key` string, required — CA Private Key is based64 encoded ca-key.pem file content. It is provided as a write-only input field for convenience. When this field is set, a webhook writes this value in the Secret specified by `.spec.tls.secretName` and empties this field. This field is not stored in the API.
        - `secretName` string, required — SecretName is the name of the secret containing the TLS certificate and key for the split-horizon DNS configuration.
    - `status` object — Status defines the observed state of SplitHorizonDNSConfig
      - `inUse` boolean — InUse is a flag that indicates if the config is used by any DB cluster.
      - `lastObservedGeneration` integer — LastObservedGeneration is the most recent generation observed for this SplitHorizonDNSConfig.
  - `metadata` object

## Other responses

- `400` — Unsuccessful operation
- `500` — Internal server error

---

[API](https://skmtc.net/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.net/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openeverest/openeverest-schema/revisions/46b19e13670b/schema)