API Evangelist conversational phrasing for Kubernetes Engine Container Engine API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kubernetes Engine Container Engine API
  version: 1.0.0
extends: openapi/oracle-cloud-containerengine-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 50
- target: $.paths['/addonOptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List add-ons supported for a Kubernetes version
      effect: read
      questions:
      - Which cluster add-ons are available for a given Kubernetes version on OKE?
      - Can I see every version of an add-on, not just the latest, before installing it?
      instructions:
      - text: Show the add-ons supported on Kubernetes {kubernetesVersion}.
        slots:
          kubernetesVersion: query.kubernetesVersion
      - text: List all available versions of the {addonName} add-on for Kubernetes {kubernetesVersion}.
        slots:
          addonName: query.addonName
          kubernetesVersion: query.kubernetesVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusterOptions/{clusterOptionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the options available for creating clusters
      effect: read
      questions:
      - What Kubernetes versions and settings can I choose when creating a new cluster?
      - Can I see every patch version available for new clusters, not just the minor releases?
      instructions:
      - text: Fetch cluster options {clusterOptionId} so I can pick a Kubernetes version for a new cluster.
        slots:
          clusterOptionId: path.clusterOptionId
      - text: Show cluster options {clusterOptionId} for compartment {compartmentId} including all patch versions.
        slots:
          clusterOptionId: path.clusterOptionId
          compartmentId: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Kubernetes clusters in a compartment
      effect: read
      questions:
      - What Kubernetes clusters are running in my compartment?
      - Can I filter my cluster list to only the ones that are active or failed?
      instructions:
      - text: List all Kubernetes clusters in compartment {compartmentId}.
        slots:
          compartmentId: query.compartmentId
      - text: Find clusters named {name} in compartment {compartmentId}.
        slots:
          name: query.name
          compartmentId: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Kubernetes cluster
      effect: write
      questions:
      - How do I spin up a new managed Kubernetes cluster in Oracle Cloud?
      - Which VCN and Kubernetes version do I need to pick when creating a cluster?
      instructions:
      - text: Create a Kubernetes cluster called {name} on version {kubernetesVersion} in VCN {vcnId} under compartment {compartmentId}.
        slots:
          name: requestBody.name
          kubernetesVersion: requestBody.kubernetesVersion
          vcnId: requestBody.vcnId
          compartmentId: requestBody.compartmentId
      - text: Stand up a new OKE cluster named {name} encrypted with KMS key {kmsKeyId}, running Kubernetes {kubernetesVersion} in VCN {vcnId}, compartment {compartmentId}.
        slots:
          name: requestBody.name
          kmsKeyId: requestBody.kmsKeyId
          kubernetesVersion: requestBody.kubernetesVersion
          vcnId: requestBody.vcnId
          compartmentId: requestBody.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Kubernetes cluster
      effect: read
      questions:
      - What version and state is my Kubernetes cluster in right now?
      - Can I get the OIDC discovery config file along with a cluster's details?
      instructions:
      - text: Show me the details of cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Get cluster {clusterId} including its OIDC configuration file.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Kubernetes cluster's settings
      effect: write
      questions:
      - How do I upgrade the Kubernetes version of an existing cluster?
      - Can I rename a cluster or change its image policy after it is created?
      instructions:
      - text: Upgrade cluster {clusterId} to Kubernetes {kubernetesVersion}.
        slots:
          clusterId: path.clusterId
          kubernetesVersion: requestBody.kubernetesVersion
      - text: Rename cluster {clusterId} to {name}.
        slots:
          clusterId: path.clusterId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Kubernetes cluster
      effect: destructive
      questions:
      - How do I tear down a Kubernetes cluster I no longer need?
      - What happens when I delete an OKE cluster I'm done with?
      instructions:
      - text: Delete Kubernetes cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Tear down the cluster {clusterId} permanently.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/completeCredentialRotation'].post
  update:
    x-apievangelist-phrasing:
      intent: Finish a cluster credential rotation
      effect: destructive
      questions:
      - How do I retire the old credentials after rotating my cluster's certificates?
      - Once new cluster credentials are in place, can I cut off the old ones right away?
      instructions:
      - text: Complete the credential rotation on cluster {clusterId} and retire the old credentials.
        slots:
          clusterId: path.clusterId
      - text: Finish rotating credentials for cluster {clusterId} now.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/extendEndpointDecommissionRollbackDeadline'].post
  update:
    x-apievangelist-phrasing:
      intent: Extend the rollback window for endpoint decommission
      effect: write
      questions:
      - Can I get more time to roll back the public API endpoint decommission on my cluster?
      - Is there a way to push out the deadline for undoing a legacy endpoint decommission?
      instructions:
      - text: Extend the endpoint decommission rollback deadline on cluster {clusterId} by {rollbackDeadlineDelay}.
        slots:
          clusterId: path.clusterId
          rollbackDeadlineDelay: requestBody.rollbackDeadlineDelay
      - text: Give me {rollbackDeadlineDelay} more to roll back the public endpoint decommission for cluster {clusterId}.
        slots:
          rollbackDeadlineDelay: requestBody.rollbackDeadlineDelay
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/migrateToNativeVcn'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a cluster to native VCN networking
      effect: write
      questions:
      - How do I move an older cluster onto native VCN-integrated networking?
      - Can I delay decommissioning the old endpoint when migrating a cluster to native VCN?
      instructions:
      - text: Start migrating cluster {clusterId} to native VCN with endpoint config {endpointConfig}.
        slots:
          clusterId: path.clusterId
          endpointConfig: requestBody.endpointConfig
      - text: Migrate cluster {clusterId} to native VCN using {endpointConfig} and keep the old endpoint for {decommissionDelayDuration}.
        slots:
          clusterId: path.clusterId
          endpointConfig: requestBody.endpointConfig
          decommissionDelayDuration: requestBody.decommissionDelayDuration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/rollbackPublicApiEndpointDecommission'].post
  update:
    x-apievangelist-phrasing:
      intent: Bring back a decommissioned public API endpoint
      effect: write
      questions:
      - Can I undo the public API endpoint decommission and get the legacy Kubernetes endpoint back?
      - What restores the old public endpoint on a cluster after I decommissioned it?
      instructions:
      - text: Roll back the public API endpoint decommission on cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Restore the legacy Kubernetes endpoint for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/startCredentialRotation'].post
  update:
    x-apievangelist-phrasing:
      intent: Start rotating a cluster's credentials
      effect: write
      questions:
      - How do I rotate the certificates and credentials on my Kubernetes cluster?
      - Will old cluster credentials keep working while a rotation is in progress?
      instructions:
      - text: Start a credential rotation on cluster {clusterId} that auto-completes after {autoCompletionDelayDuration}.
        slots:
          clusterId: path.clusterId
          autoCompletionDelayDuration: requestBody.autoCompletionDelayDuration
      - text: Begin rotating credentials for cluster {clusterId} with an auto-completion delay of {autoCompletionDelayDuration}.
        slots:
          clusterId: path.clusterId
          autoCompletionDelayDuration: requestBody.autoCompletionDelayDuration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/startPublicApiEndpointDecommission'].post
  update:
    x-apievangelist-phrasing:
      intent: Decommission a cluster's legacy public API endpoint
      effect: destructive
      questions:
      - How do I turn off the legacy public Kubernetes API endpoint on my cluster?
      - What happens to the old public endpoint once I start decommissioning it?
      instructions:
      - text: Start decommissioning the public API endpoint on cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Shut off the legacy Kubernetes endpoint for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/actions/updateEndpointConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a cluster's API endpoint network settings
      effect: write
      questions:
      - Can I give my cluster's Kubernetes API endpoint a public IP after creation?
      - Which network security groups protect my cluster endpoint, and can I change them?
      instructions:
      - text: Enable a public IP on the API endpoint of cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Set the endpoint network security groups for cluster {clusterId} to {nsgIds}.
        slots:
          clusterId: path.clusterId
          nsgIds: requestBody.nsgIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: List add-ons installed on a cluster
      effect: read
      questions:
      - What add-ons are currently installed on my cluster?
      - Which add-ons has my provisioned cluster got enabled right now?
      instructions:
      - text: List the add-ons installed on cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Show every add-on enabled on cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/addons'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an add-on on a cluster
      effect: write
      questions:
      - How do I install an add-on on my Kubernetes cluster?
      - Can I pin a specific add-on version and override an existing installation?
      instructions:
      - text: Install the {addonName} add-on on cluster {clusterId}.
        slots:
          addonName: requestBody.addonName
          clusterId: path.clusterId
      - text: Install version {version} of add-on {addonName} on cluster {clusterId}, overriding any existing one.
        slots:
          version: requestBody.version
          addonName: requestBody.addonName
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/addons/{addonName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of an add-on on a cluster
      effect: read
      questions:
      - What version and configuration is a specific add-on running on my cluster?
      - Is a particular add-on on my cluster healthy and active?
      instructions:
      - text: Show the {addonName} add-on details for cluster {clusterId}.
        slots:
          addonName: path.addonName
          clusterId: path.clusterId
      - text: Check the status of add-on {addonName} on cluster {clusterId}.
        slots:
          addonName: path.addonName
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/addons/{addonName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an installed add-on's version or configuration
      effect: write
      questions:
      - How do I upgrade an add-on already installed on my cluster?
      - Can I change the configuration of an installed cluster add-on?
      instructions:
      - text: Upgrade the {addonName} add-on on cluster {clusterId} to version {version}.
        slots:
          addonName: path.addonName
          clusterId: path.clusterId
          version: requestBody.version
      - text: Apply configurations {configurations} to installed add-on {addonName} on cluster {clusterId}.
        slots:
          configurations: requestBody.configurations
          addonName: path.addonName
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/addons/{addonName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable an add-on on a cluster
      effect: destructive
      questions:
      - How do I disable an add-on on my cluster?
      - When disabling an add-on, can I also remove the resources it already deployed?
      instructions:
      - text: 'Disable add-on {addonName} on cluster {clusterId} and remove existing add-on resources: {isRemoveExistingAddOn}.'
        slots:
          addonName: path.addonName
          clusterId: path.clusterId
          isRemoveExistingAddOn: query.isRemoveExistingAddOn
      - text: Turn off the {addonName} add-on for cluster {clusterId}, setting remove-existing to {isRemoveExistingAddOn}.
        slots:
          addonName: path.addonName
          clusterId: path.clusterId
          isRemoveExistingAddOn: query.isRemoveExistingAddOn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/credentialRotationStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a cluster's credential rotation status
      effect: read
      questions:
      - Is the credential rotation on my cluster still in progress or finished?
      - When will my cluster's credential rotation auto-complete?
      instructions:
      - text: Check the credential rotation status of cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Tell me how far along the credential rotation is for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/kubeconfig/content'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a kubeconfig file for a cluster
      effect: write
      questions:
      - How do I get a kubeconfig so kubectl can talk to my cluster?
      - Can I generate a kubeconfig for the private endpoint and set how long its token lasts?
      instructions:
      - text: Generate a kubeconfig for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Create a kubeconfig for cluster {clusterId} targeting the {endpoint} endpoint with expiration {expiration}.
        slots:
          clusterId: path.clusterId
          endpoint: requestBody.endpoint
          expiration: requestBody.expiration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/migrateToNativeVcnStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a cluster's native VCN migration status
      effect: read
      questions:
      - How far along is my cluster's migration to native VCN?
      - Has the native VCN migration for my cluster finished yet?
      instructions:
      - text: Show the native VCN migration status for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Check whether cluster {clusterId} has finished migrating to native VCN.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/nodes/{nodeId}/actions/reboot'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot a node in a cluster
      effect: write
      questions:
      - How do I reboot a single worker node in my Kubernetes cluster?
      - Can I control pod eviction settings when rebooting a cluster node?
      instructions:
      - text: Reboot node {nodeId} in cluster {clusterId}.
        slots:
          nodeId: path.nodeId
          clusterId: path.clusterId
      - text: Restart worker node {nodeId} of cluster {clusterId} using eviction settings {nodeEvictionSettings}.
        slots:
          nodeId: path.nodeId
          clusterId: path.clusterId
          nodeEvictionSettings: requestBody.nodeEvictionSettings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/nodes/{nodeId}/actions/replaceBootVolume'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace the boot volume of a cluster node
      effect: write
      questions:
      - Can I replace the boot volume on a worker node without deleting the node?
      - What cycles a cluster node onto a fresh boot volume?
      instructions:
      - text: Replace the boot volume of node {nodeId} in cluster {clusterId}.
        slots:
          nodeId: path.nodeId
          clusterId: path.clusterId
      - text: Cycle node {nodeId} in cluster {clusterId} onto a new boot volume with eviction settings {nodeEvictionSettings}.
        slots:
          nodeId: path.nodeId
          clusterId: path.clusterId
          nodeEvictionSettings: requestBody.nodeEvictionSettings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/publicApiEndpointDecommissionStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a cluster's endpoint decommission status
      effect: read
      questions:
      - Where is my cluster in decommissioning its legacy public API endpoint?
      - Until when can I still roll back my cluster's public endpoint decommission?
      instructions:
      - text: Get the public API endpoint decommission status of cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Check if the legacy endpoint on cluster {clusterId} has been decommissioned yet.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/workloadMappings'].get
  update:
    x-apievangelist-phrasing:
      intent: List workload mappings for a cluster
      effect: read
      questions:
      - Which Kubernetes namespaces on my cluster are mapped to other compartments?
      - What workload mappings exist on my provisioned cluster?
      instructions:
      - text: List the workload mappings on cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      - text: Show all namespace-to-compartment mappings for cluster {clusterId}.
        slots:
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/workloadMappings'].post
  update:
    x-apievangelist-phrasing:
      intent: Map a cluster namespace to a compartment
      effect: write
      questions:
      - How do I map a Kubernetes namespace to a different compartment for its workloads?
      - Can workloads in one namespace be billed or governed under another compartment?
      instructions:
      - text: Map namespace {namespace} on cluster {clusterId} to compartment {mappedCompartmentId}.
        slots:
          namespace: requestBody.namespace
          clusterId: path.clusterId
          mappedCompartmentId: requestBody.mappedCompartmentId
      - text: Create a workload mapping for cluster {clusterId} sending namespace {namespace} workloads to compartment {mappedCompartmentId}.
        slots:
          clusterId: path.clusterId
          namespace: requestBody.namespace
          mappedCompartmentId: requestBody.mappedCompartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/workloadMappings/{workloadMappingId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster workload mapping
      effect: read
      questions:
      - Which compartment does a particular workload mapping on my cluster point to?
      - Can I look up one workload mapping's namespace and target compartment?
      instructions:
      - text: Show workload mapping {workloadMappingId} on cluster {clusterId}.
        slots:
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
      - text: Get the details of workload mapping {workloadMappingId} for cluster {clusterId}.
        slots:
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/workloadMappings/{workloadMappingId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a workload mapping's target compartment
      effect: write
      questions:
      - Can I point an existing workload mapping at a different compartment?
      - How do I retag an existing namespace workload mapping?
      instructions:
      - text: Repoint workload mapping {workloadMappingId} on cluster {clusterId} to compartment {mappedCompartmentId}.
        slots:
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
          mappedCompartmentId: requestBody.mappedCompartmentId
      - text: Set freeform tags {freeformTags} on workload mapping {workloadMappingId} of cluster {clusterId}.
        slots:
          freeformTags: requestBody.freeformTags
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/clusters/{clusterId}/workloadMappings/{workloadMappingId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cluster workload mapping
      effect: destructive
      questions:
      - How do I remove a namespace-to-compartment mapping from my cluster?
      - Can I delete a workload mapping I no longer need?
      instructions:
      - text: Delete workload mapping {workloadMappingId} from cluster {clusterId}.
        slots:
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
      - text: Remove the namespace mapping {workloadMappingId} on cluster {clusterId}.
        slots:
          workloadMappingId: path.workloadMappingId
          clusterId: path.clusterId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePoolOptions/{nodePoolOptionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get options available for node pools
      effect: read
      questions:
      - Which node images, shapes and Kubernetes versions can I use for a node pool?
      - Can I filter node pool options by OS type, CPU architecture or Kubernetes version?
      instructions:
      - text: Show node pool options {nodePoolOptionId}.
        slots:
          nodePoolOptionId: path.nodePoolOptionId
      - text: Get node pool options {nodePoolOptionId} for {nodePoolOsArch} nodes on Kubernetes {nodePoolK8sVersion}.
        slots:
          nodePoolOptionId: path.nodePoolOptionId
          nodePoolOsArch: query.nodePoolOsArch
          nodePoolK8sVersion: query.nodePoolK8sVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools'].get
  update:
    x-apievangelist-phrasing:
      intent: List node pools in a compartment
      effect: read
      questions:
      - What node pools do I have across my compartment?
      - Can I list only the node pools that belong to one cluster?
      instructions:
      - text: List node pools in compartment {compartmentId}.
        slots:
          compartmentId: query.compartmentId
      - text: Show node pools for cluster {clusterId} in compartment {compartmentId}.
        slots:
          clusterId: query.clusterId
          compartmentId: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a node pool for a cluster
      effect: write
      questions:
      - How do I add worker nodes to my Kubernetes cluster?
      - Which node shape and subnets do I specify when creating a node pool?
      instructions:
      - text: Create a node pool named {name} with shape {nodeShape} on cluster {clusterId} in compartment {compartmentId}.
        slots:
          name: requestBody.name
          nodeShape: requestBody.nodeShape
          clusterId: requestBody.clusterId
          compartmentId: requestBody.compartmentId
      - text: Add node pool {name} to cluster {clusterId} in compartment {compartmentId} using {nodeShape} nodes and SSH key {sshPublicKey}.
        slots:
          name: requestBody.name
          clusterId: requestBody.clusterId
          compartmentId: requestBody.compartmentId
          nodeShape: requestBody.nodeShape
          sshPublicKey: requestBody.sshPublicKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools/{nodePoolId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a node pool
      effect: read
      questions:
      - What shape, size and Kubernetes version is my node pool running?
      - Which nodes are in a specific node pool right now?
      instructions:
      - text: Show details of node pool {nodePoolId}.
        slots:
          nodePoolId: path.nodePoolId
      - text: Get the nodes and configuration of node pool {nodePoolId}.
        slots:
          nodePoolId: path.nodePoolId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools/{nodePoolId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a node pool's configuration
      effect: write
      questions:
      - How do I upgrade the Kubernetes version of my worker node pool?
      - Can I change a node pool's shape or node labels after it is created?
      instructions:
      - text: Upgrade node pool {nodePoolId} to Kubernetes {kubernetesVersion}.
        slots:
          nodePoolId: path.nodePoolId
          kubernetesVersion: requestBody.kubernetesVersion
      - text: Change node pool {nodePoolId} to use shape {nodeShape}.
        slots:
          nodePoolId: path.nodePoolId
          nodeShape: requestBody.nodeShape
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools/{nodePoolId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a node pool
      effect: destructive
      questions:
      - How do I remove an entire node pool from my cluster?
      - Can I force-delete a node pool if pods don't evict within the grace period?
      instructions:
      - text: Delete node pool {nodePoolId}.
        slots:
          nodePoolId: path.nodePoolId
      - text: Delete node pool {nodePoolId} with an eviction grace period of {overrideEvictionGraceDuration}.
        slots:
          nodePoolId: path.nodePoolId
          overrideEvictionGraceDuration: query.overrideEvictionGraceDuration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/nodePools/{nodePoolId}/node/{nodeId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single node from a node pool
      effect: destructive
      questions:
      - Can I remove one specific worker node from a node pool?
      - When deleting a node, can I shrink the pool size so it isn't replaced?
      instructions:
      - text: Delete node {nodeId} from node pool {nodePoolId}.
        slots:
          nodeId: path.nodeId
          nodePoolId: path.nodePoolId
      - text: Remove node {nodeId} from pool {nodePoolId} and decrease the pool size.
        slots:
          nodeId: path.nodeId
          nodePoolId: path.nodePoolId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/podShapes'].get
  update:
    x-apievangelist-phrasing:
      intent: List pod shapes available for virtual nodes
      effect: read
      questions:
      - Which pod shapes can I use for virtual nodes in my compartment?
      - Are specific pod shapes available in a given availability domain?
      instructions:
      - text: List the pod shapes in compartment {compartmentId}.
        slots:
          compartmentId: query.compartmentId
      - text: Show pod shapes in compartment {compartmentId} for availability domain {availabilityDomain}.
        slots:
          compartmentId: query.compartmentId
          availabilityDomain: query.availabilityDomain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/virtualNodePools'].get
  update:
    x-apievangelist-phrasing:
      intent: List virtual node pools in a compartment
      effect: read
      questions:
      - What virtual node pools exist in my compartment?
      - Can I see just the virtual node pools attached to one cluster?
      instructions:
      - text: List virtual node pools in compartment {compartmentId}.
        slots:
          compartmentId: query.compartmentId
      - text: Show the virtual node pools of cluster {clusterId} in compartment {compartmentId}.
        slots:
          clusterId: query.clusterId
          compartmentId: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/virtualNodePools'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a virtual node pool
      effect: write
      questions:
      - How do I add serverless virtual nodes to my cluster?
      - What placement and pod configuration does a new virtual node pool require?
      instructions:
      - text: Create a virtual node pool {displayName} with {size} nodes on cluster {clusterId} in compartment {compartmentId}.
        slots:
          displayName: requestBody.displayName
          size: requestBody.size
          clusterId: requestBody.clusterId
          compartmentId: requestBody.compartmentId
      - text: Add virtual node pool {displayName} to cluster {clusterId} using pod configuration {podConfiguration} and placement {placementConfigurations}.
        slots:
          displayName: requestBody.displayName
          clusterId: requestBody.clusterId
          podConfiguration: requestBody.podConfiguration
          placementConfigurations: requestBody.placementConfigurations
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-cloud/refs/heads/main/overlays/oracle-cloud-containerengine-api-phrasing-overlay.yaml