{
  "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",
  "impact": "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.",
  "migration_path": "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": 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",
  "estate_check": null,
  "source_note": null
}
