--- title: "Returns all datacenters for the specified seed." method: GET path: "/api/v1/seed/{seed_name}/dc" tags: ["datacenter"] --- # Returns all datacenters for the specified seed. `GET /api/v1/seed/{seed_name}/dc` ## Request - The document declares no server URL. - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `seed_name` string, required ## Response `200` Datacenter - Datacenter[] - `metadata` DatacenterMeta - `name` string - `spec` DatacenterSpec - `alibaba` DatacenterSpecAlibaba - `region` string: Region to use, for a full list of regions see https://www.alibabacloud.com/help/doc-detail/40654.htm - `anexia` DatacenterSpecAnexia - `location_id` string: LocationID the location of the region - `aws` DatacenterSpecAWS: DatacenterSpecAWS describes an AWS datacenter - `images` ImageList: ImageList defines a map of operating system and the image to use - `region` string: The AWS region to use, e.g. "us-east-1". For a list of available regions, see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html - `azure` DatacenterSpecAzure: DatacenterSpecAzure describes an Azure cloud datacenter - `location` string: Region to use, for example "westeurope". A list of available regions can be found at https://azure.microsoft.com/en-us/global-infrastructure/locations/ - `bringyourown` DatacenterSpecBringYourOwn: DatacenterSpecBringYourOwn describes a datacenter our of bring your own nodes - `country` string: Optional: Country of the seed as ISO-3166 two-letter code, e.g. DE or UK. It is used for informational purposes. - `digitalocean` DatacenterSpecDigitalocean: DatacenterSpecDigitalocean describes a DigitalOcean datacenter - `region` string: Datacenter location, e.g. "ams3". A list of existing datacenters can be found at https://www.digitalocean.com/docs/platform/availability-matrix/ - `enforceAuditLogging` boolean: EnforceAuditLogging enforces audit logging on every cluster within the DC, ignoring cluster-specific settings. - `enforcePodSecurityPolicy` boolean: EnforcePodSecurityPolicy enforces pod security policy plugin on every clusters within the DC, ignoring cluster-specific settings - `fake` DatacenterSpecFake: DatacenterSpecFake describes a fake datacenter - `fake_property` string - `gcp` DatacenterSpecGCP: DatacenterSpecGCP describes a GCP datacenter - `region` string: Region to use, for example "europe-west3", for a full list of regions see https://cloud.google.com/compute/docs/regions-zones/ - `regional` boolean: Optional: Regional clusters spread their resources across multiple availability zones. Refer to the official documentation for more details on this: https://cloud.google.com/kubernetes-engine/docs/concepts/regional-clusters - `zone_suffixes` string[]: List of enabled zones, for example [a, c]. See the link above for the available zones in your chosen region. - `hetzner` DatacenterSpecHetzner: DatacenterSpecHetzner describes a Hetzner cloud datacenter - `datacenter` string: Datacenter location, e.g. "nbg1-dc3". A list of existing datacenters can be found at https://wiki.hetzner.de/index.php/Rechenzentren_und_Anbindung/en - `location` string: Optional: Detailed location of the datacenter, like "Hamburg" or "Datacenter 7". For informational purposes only. - `network` string: Network is the pre-existing Hetzner network in which the machines are running. While machines can be in multiple networks, a single one must be chosen for the HCloud CCM to work. - `kubevirt` DatacenterSpecKubevirt - `dns_config` PodDNSConfig: PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy. - `nameservers` string[]: A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy. Duplicated nameservers will be removed. +optional - `options` PodDNSConfigOption[]: A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Duplicated entries will be removed. Resolution options given in Options will override those that appear in the base DNSPolicy. +optional - `name` string: Required. - `value` string: +optional - `searches` string[]: A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy. Duplicated search paths will be removed. +optional - `dns_policy` string: DNSPolicy represents the dns policy for the pod. Valid values are 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' or 'None'. Defaults to "ClusterFirst". DNS parameters given in DNSConfig will be merged with the policy selected with DNSPolicy. - `location` string: Optional: Detailed location of the cluster, like "Hamburg" or "Datacenter 7". It is used for informational purposes. - `node` NodeSettings: NodeSettings are node specific flags which can be configured on datacenter level - `http_proxy` string - `hyperkube_image` string: Optional: The hyperkube image to use. Currently only Flatcar makes use of this option. - `insecure_registries` string[]: Optional: These image registries will be configured as insecure on the container runtime. - `no_proxy` string - `pause_image` string: Optional: Translates to --pod-infra-container-image on the kubelet. If not set, the kubelet will default it. - `registry_mirrors` string[]: Optional: These image registries will be configured as registry mirrors on the container runtime. - `openstack` DatacenterSpecOpenstack: DatacenterSpecOpenstack describes an OpenStack datacenter - `auth_url` string - `availability_zone` string - `dns_servers` string[]: Used for automatic network creation - `enabled_flavors` string[]: Optional: List of enabled flavors for the given datacenter - `enforce_floating_ip` boolean: Optional - `ignore_volume_az` boolean: Optional - `images` ImageList: ImageList defines a map of operating system and the image to use - `manage_security_groups` boolean: Optional: Gets mapped to the "manage-security-groups" setting in the cloud config. See https://kubernetes.io/docs/concepts/cluster-administration/cloud-providers/#load-balancer This setting defaults to true. - `node_size_requirements` OpenstackNodeSizeRequirements - `minimum_memory` integer: MinimumMemory is the minimum required amount of memory, measured in MB - `minimum_vcpus` integer: VCPUs is the minimum required amount of (virtual) CPUs - `region` string - `trust_device_path` boolean: Optional: Gets mapped to the "trust-device-path" setting in the cloud config. See https://kubernetes.io/docs/concepts/cluster-administration/cloud-providers/#block-storage This setting defaults to false. - `use_octavia` boolean: Optional: Gets mapped to the "use-octavia" setting in the cloud config. use-octavia is enabled by default in CCM since v1.17.0, and disabled by default with the in-tree cloud provider. - `packet` DatacenterSpecPacket: DatacenterSpecPacket describes a Packet datacenter - `facilities` string[]: The list of enabled facilities, for example "ams1", for a full list of available facilities see https://support.packet.com/kb/articles/data-centers - `provider` string: Name of the datacenter provider. Extracted based on which provider is defined in the spec. It is used for informational purposes. - `requiredEmailDomain` string: Deprecated. Automatically migrated to the RequiredEmailDomains field. - `requiredEmailDomains` string[] - `seed` string: Name of the seed this datacenter belongs to. - `vsphere` DatacenterSpecVSphere: DatacenterSpecVSphere describes a vSphere datacenter - `allow_insecure` boolean: If set to true, disables the TLS certificate check against the endpoint. - `cluster` string: Optional: The name of the vSphere cluster to use. Cluster is deprecated and may be removed in future releases as it is currently ignored. The cluster hosting the VMs will be the same VM used as a template is located. - `datacenter` string: The name of the datacenter to use. - `datastore` string: The default Datastore to be used for provisioning volumes using storage classes/dynamic provisioning and for storing virtual machine files in case no `Datastore` or `DatastoreCluster` is provided at Cluster level. - `endpoint` string: Endpoint URL to use, including protocol, for example "https://vcenter.example.com". - `infra_management_user` VSphereCredentials: VSphereCredentials credentials represents a credential for accessing vSphere - `password` string - `username` string - `root_path` string: Optional: The root path for cluster specific VM folders. Each cluster gets its own folder below the root folder. Must be the FQDN (for example "/datacenter-1/vm/all-kubermatic-vms-in-here") and defaults to the root VM folder: "/datacenter-1/vm" - `storage_policy` string: The name of the storage policy to use for the storage class created in the user cluster. - `templates` ImageList: ImageList defines a map of operating system and the image to use ## Other responses - `401`: EmptyResponse is a empty response - `403`: EmptyResponse is a empty response - `default`: errorResponse --- [API](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api.md) - [All operations](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/revisions/815b9bf19db5?raw)