---
slug: "oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change"
title: "Kubernetes Engine: CreateCluster API requires endpointConfig.subnetId, new clusters must be VCN-native"
summary: "From 30 Sep 2026, any call to the CreateCluster API that does not set the endpointConfig.subnetId attribute fails. The attribute, optional before, is now required, and new Kubernetes clusters must be VCN-native. Oracle's notice prints 28 Oct 2026 as the date in effect."
cloud: "oci"
service: "Kubernetes Engine"
service_slug: "oke"
category: "api_sdk"
type: "breaking_change"
announced_date: "2025-10-08"
effective_date: "2026-09-30"
effective_precision: "day"
replacement: null
affected_versions: []
source_url: "https://docs.oracle.com/en-us/iaas/Content/servicechanges.htm"
extra_source_urls: []
vendor_ref: "servicechanges_topic_oke_v1h_cluster_deprecation"
last_checked_at: "2026-11-15T04:28:20.300Z"
created_at: "2026-11-15T06:02:38.755Z"
updated_at: "2026-11-15T06:02:38.755Z"
url: "https://eolwatch.dev/items/oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change"
short_url: "https://eolwatch.dev/i/fz"
markdown_url: "https://eolwatch.dev/items/oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change.md"
json_url: "https://eolwatch.dev/items/oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change.json"
source_note: null
---

# Kubernetes Engine: CreateCluster API requires endpointConfig.subnetId, new clusters must be VCN-native

From 30 Sep 2026, any call to the CreateCluster API that does not set the endpointConfig.subnetId attribute fails. The attribute, optional before, is now required, and new Kubernetes clusters must be VCN-native. Oracle's notice prints 28 Oct 2026 as the date in effect.

- Effective date: 30 Sep 2026
- Cloud: [OCI](https://eolwatch.dev/cloud/oci.md)
- Service: [Kubernetes Engine](https://eolwatch.dev/services/oci/oke.md)
- Type: Breaking change
- Category: [API or SDK](https://eolwatch.dev/categories/apis-sdks.md)
- Replacement: Not stated by vendor
- Announced: 8 Oct 2025
- Official source: [docs.oracle.com](https://docs.oracle.com/en-us/iaas/Content/servicechanges.htm)
- Last checked: 15 Nov 2026

## What breaks

The change impacts you if you have used the CreateCluster API to create clusters with public Kubernetes API endpoints that are not integrated into your VCN. Before this change, the CLI and the API could create such clusters because the endpointConfig.subnetId attribute was optional. After this change, the endpointConfig.subnetId attribute is required. As a result, you can only create Kubernetes clusters that are completely integrated with your VCN (VCN-native clusters). From 30 Sep 2026, any call to the CreateCluster API that does not set the endpointConfig.subnetId attribute fails because the required attribute is missing. The same notice prints 28 Oct 2026 in its "Date in Effect" field.

## What to do

If you have custom scripts or Terraform scripts that use the CreateCluster API and do not set the endpointConfig.subnetId attribute, update these scripts to set the attribute. Scripts that set the attribute create VCN-native clusters. In a VCN-native cluster, worker nodes, load balancers, and the Kubernetes API endpoint are part of your VCN, and you can configure them as public or private.

## Replacement

Not stated by vendor.

## Sources

- [Official source](https://docs.oracle.com/en-us/iaas/Content/servicechanges.htm) (docs.oracle.com, Official)

Last checked against this source on 15 Nov 2026.

Page: https://eolwatch.dev/items/oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change | JSON: https://eolwatch.dev/items/oci-oke-createcluster-endpointconfig-subnetid-required-breaking-change.json

The text on this page is drafted with AI assistance from the vendor's text, checked against the official source and approved by a person before it is published.
