# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Core Services Compute API version: 1.0.0 extends: openapi/oracle-cloud-compute-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-02' generator: build-phrasing.py label: Generated by API Evangelist operations: 130 - target: $.paths['/appCatalogListings'].get update: x-apievangelist-phrasing: intent: Browse published App Catalog listings effect: read questions: - What images and apps are published in the Oracle Cloud App Catalog? - Can I filter App Catalog listings by publisher name or type? instructions: - text: List App Catalog listings published by {publisher}. slots: publisher: query.publisherName - text: Find App Catalog listings whose display name is {name}. slots: name: query.displayName method: generated generated: '2026-09-26' - target: $.paths['/appCatalogListings/{listingId}'].get update: x-apievangelist-phrasing: intent: Get one App Catalog listing effect: read questions: - Where can I see the details of a single App Catalog listing? - What does an App Catalog listing record contain for one specific app? instructions: - text: Show me App Catalog listing {listing}. slots: listing: path.listingId - text: Fetch the details of catalog listing {listing}. slots: listing: path.listingId method: generated generated: '2026-09-26' - target: $.paths['/appCatalogListings/{listingId}/resourceVersions'].get update: x-apievangelist-phrasing: intent: List versions of an App Catalog listing effect: read questions: - Which resource versions are available for an App Catalog listing? - Can I see every published version of a catalog app? instructions: - text: List all resource versions of catalog listing {listing}. slots: listing: path.listingId - text: Show the available versions for App Catalog listing {listing}. slots: listing: path.listingId method: generated generated: '2026-09-26' - target: $.paths['/appCatalogListings/{listingId}/resourceVersions/{resourceVersion}'].get update: x-apievangelist-phrasing: intent: Get one version of an App Catalog listing effect: read questions: - What details are recorded for a specific version of a catalog listing? - Is a particular resource version of an App Catalog app still available? instructions: - text: Get version {version} of catalog listing {listing}. slots: version: path.resourceVersion listing: path.listingId - text: Show resource version {version} details for App Catalog listing {listing}. slots: version: path.resourceVersion listing: path.listingId method: generated generated: '2026-09-26' - target: $.paths['/appCatalogListings/{listingId}/resourceVersions/{resourceVersion}/agreements'].get update: x-apievangelist-phrasing: intent: Retrieve the agreements for a listing version effect: read questions: - What terms do I have to accept before subscribing to an App Catalog listing version? - Where do I get the EULA link and signature needed to subscribe to a catalog image? instructions: - text: Retrieve the agreements for version {version} of listing {listing}. slots: version: path.resourceVersion listing: path.listingId - text: Get the EULA and terms of use for catalog listing {listing} at version {version}. slots: listing: path.listingId version: path.resourceVersion method: generated generated: '2026-09-26' - target: $.paths['/appCatalogSubscriptions'].get update: x-apievangelist-phrasing: intent: List App Catalog subscriptions in a compartment effect: read questions: - Which App Catalog listings is my compartment subscribed to? - Can I check whether a compartment already has a subscription for a given listing? instructions: - text: List the App Catalog subscriptions in compartment {compartment}. slots: compartment: query.compartmentId - text: Show subscriptions to listing {listing} in compartment {compartment}. slots: listing: query.listingId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/appCatalogSubscriptions'].post update: x-apievangelist-phrasing: intent: Subscribe a compartment to a catalog listing version effect: write questions: - How do I subscribe my compartment to an App Catalog image so I can launch it? - Why does a new App Catalog subscription take a while before I can use it? instructions: - text: Subscribe compartment {compartment} to version {version} of catalog listing {listing}. slots: compartment: requestBody.compartmentId version: requestBody.listingResourceVersion listing: requestBody.listingId - text: Create an App Catalog subscription for listing {listing} version {version} in {compartment} using signature {signature}. slots: listing: requestBody.listingId version: requestBody.listingResourceVersion compartment: requestBody.compartmentId signature: requestBody.signature method: generated generated: '2026-09-26' - target: $.paths['/appCatalogSubscriptions'].delete update: x-apievangelist-phrasing: intent: Remove an App Catalog subscription effect: destructive questions: - How do I unsubscribe a compartment from an App Catalog listing version? - Can I remove a catalog subscription I no longer need? instructions: - text: Delete the subscription to listing {listing} version {version} in compartment {compartment}. slots: listing: query.listingId version: query.resourceVersion compartment: query.compartmentId - text: Unsubscribe compartment {compartment} from App Catalog listing {listing} at version {version}. slots: compartment: query.compartmentId listing: query.listingId version: query.resourceVersion method: generated generated: '2026-09-26' - target: $.paths['/bootVolumeAttachments/'].get update: x-apievangelist-phrasing: intent: List boot volume attachments effect: read questions: - Which boot volumes are attached to instances in my compartment? - Can I find which instance a particular boot volume is attached to? instructions: - text: List boot volume attachments in compartment {compartment} in availability domain {ad}. slots: compartment: query.compartmentId ad: query.availabilityDomain - text: Show the boot volume attachment for instance {instance} in {ad}, compartment {compartment}. slots: instance: query.instanceId ad: query.availabilityDomain compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/bootVolumeAttachments/'].post update: x-apievangelist-phrasing: intent: Attach a boot volume to an instance effect: write questions: - How do I attach an existing boot volume to a compute instance? - Can I turn on in-transit encryption when attaching a boot volume? instructions: - text: Attach boot volume {bootVolume} to instance {instance}. slots: bootVolume: requestBody.bootVolumeId instance: requestBody.instanceId - text: Attach boot volume {bootVolume} to {instance} with encryption-in-transit type {encryption}. slots: bootVolume: requestBody.bootVolumeId instance: requestBody.instanceId encryption: requestBody.encryptionInTransitType method: generated generated: '2026-09-26' - target: $.paths['/bootVolumeAttachments/{bootVolumeAttachmentId}'].get update: x-apievangelist-phrasing: intent: Get a boot volume attachment effect: read questions: - What state is a specific boot volume attachment in? - Where can I see the details of one boot volume attachment? instructions: - text: Get boot volume attachment {attachment}. slots: attachment: path.bootVolumeAttachmentId - text: Check whether boot volume attachment {attachment} has finished attaching. slots: attachment: path.bootVolumeAttachmentId method: generated generated: '2026-09-26' - target: $.paths['/bootVolumeAttachments/{bootVolumeAttachmentId}'].delete update: x-apievangelist-phrasing: intent: Detach a boot volume from an instance effect: destructive questions: - How do I detach a boot volume from a stopped instance? - Is detaching a boot volume asynchronous, and how do I know it finished? instructions: - text: Detach the boot volume in attachment {attachment}. slots: attachment: path.bootVolumeAttachmentId - text: Remove boot volume attachment {attachment} from its instance. slots: attachment: path.bootVolumeAttachmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReports'].post update: x-apievangelist-phrasing: intent: Report available host capacity for shapes effect: read questions: - Is there enough host capacity in an availability domain to launch the shapes I need? - Can I check capacity for several shapes at once before launching instances? instructions: - text: Generate a capacity report for shapes {shapes} in {ad}, compartment {compartment}. slots: shapes: requestBody.shapeAvailabilities ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Check how much host capacity is available for {shapes} in availability domain {ad} for compartment {compartment}. slots: shapes: requestBody.shapeAvailabilities ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservationInstanceShapes'].get update: x-apievangelist-phrasing: intent: List shapes that can be reserved effect: read questions: - Which instance shapes can I reserve capacity for? - What shapes are eligible for a capacity reservation in a given availability domain? instructions: - text: List reservable instance shapes in compartment {compartment}. slots: compartment: query.compartmentId - text: Show the shapes I can reserve in availability domain {ad} for compartment {compartment}. slots: ad: query.availabilityDomain compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations'].get update: x-apievangelist-phrasing: intent: List compute capacity reservations effect: read questions: - What capacity reservations do I have in my compartment? - Can I filter capacity reservations by lifecycle state? instructions: - text: List capacity reservations in compartment {compartment}. slots: compartment: query.compartmentId - text: Show capacity reservations in {compartment} that are {state}. slots: compartment: query.compartmentId state: query.lifecycleState method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations'].post update: x-apievangelist-phrasing: intent: Reserve compute capacity effect: write questions: - How do I reserve compute capacity so instance launches don't fail for lack of hosts? - Can I make a new capacity reservation the default for my compartment? instructions: - text: Create a capacity reservation in {ad} for compartment {compartment}. slots: ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Reserve capacity named {name} in {ad}, compartment {compartment}, with configs {configs}. slots: name: requestBody.displayName ad: requestBody.availabilityDomain compartment: requestBody.compartmentId configs: requestBody.instanceReservationConfigs method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations/{capacityReservationId}'].get update: x-apievangelist-phrasing: intent: Get a compute capacity reservation effect: read questions: - How much of a capacity reservation is already used? - Where do I see the configuration of one capacity reservation? instructions: - text: Get capacity reservation {reservation}. slots: reservation: path.capacityReservationId - text: Show the used and reserved counts for capacity reservation {reservation}. slots: reservation: path.capacityReservationId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations/{capacityReservationId}'].put update: x-apievangelist-phrasing: intent: Update a compute capacity reservation effect: write questions: - Can I change the reserved instance configurations on an existing capacity reservation? - How do I rename a capacity reservation I already created? instructions: - text: Update the instance reservation configs on reservation {reservation} to {configs}. slots: reservation: path.capacityReservationId configs: requestBody.instanceReservationConfigs - text: Rename capacity reservation {reservation} to {name}. slots: reservation: path.capacityReservationId name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations/{capacityReservationId}'].delete update: x-apievangelist-phrasing: intent: Delete a compute capacity reservation effect: destructive questions: - How do I release a capacity reservation I no longer need? - What happens to reserved capacity when I delete the reservation? instructions: - text: Delete capacity reservation {reservation}. slots: reservation: path.capacityReservationId - text: Release the reserved capacity in reservation {reservation}. slots: reservation: path.capacityReservationId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations/{capacityReservationId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a capacity reservation to another compartment effect: write questions: - Can I move a capacity reservation into a different compartment? - How do I reorganize capacity reservations across compartments? instructions: - text: Move capacity reservation {reservation} to compartment {compartment}. slots: reservation: path.capacityReservationId compartment: requestBody.compartmentId - text: Change the compartment of reservation {reservation} to {compartment}. slots: reservation: path.capacityReservationId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityReservations/{capacityReservationId}/instances'].get update: x-apievangelist-phrasing: intent: List instances launched under a reservation effect: read questions: - Which instances are consuming a given capacity reservation? - Can I see what is running inside my reserved capacity? instructions: - text: List the instances launched under capacity reservation {reservation}. slots: reservation: path.capacityReservationId - text: Show instances using reservation {reservation} in availability domain {ad}. slots: reservation: path.capacityReservationId ad: query.availabilityDomain method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies'].get update: x-apievangelist-phrasing: intent: List compute capacity topologies effect: read questions: - What compute capacity topologies exist in my compartment? - Can I look up a capacity topology by its display name? instructions: - text: List compute capacity topologies in compartment {compartment}. slots: compartment: query.compartmentId - text: Find the capacity topology named {name} in {compartment}. slots: name: query.displayName compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies'].post update: x-apievangelist-phrasing: intent: Create a compute capacity topology effect: write questions: - How do I create a capacity topology to see the layout of my dedicated bare metal capacity? - What capacity source do I need to create a compute capacity topology? instructions: - text: Create a capacity topology in {ad} for compartment {compartment} from capacity source {source}. slots: ad: requestBody.availabilityDomain compartment: requestBody.compartmentId source: requestBody.capacitySource - text: Set up a compute capacity topology called {name} using source {source} in {ad}, compartment {compartment}. slots: name: requestBody.displayName source: requestBody.capacitySource ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}'].get update: x-apievangelist-phrasing: intent: Get a compute capacity topology effect: read questions: - Where can I see the details of one capacity topology? - What capacity source is a given topology built from? instructions: - text: Get compute capacity topology {topology}. slots: topology: path.computeCapacityTopologyId - text: Show the capacity source and state of topology {topology}. slots: topology: path.computeCapacityTopologyId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}'].put update: x-apievangelist-phrasing: intent: Update a compute capacity topology effect: write questions: - Can I change the capacity source of an existing topology? - How do I rename a capacity topology? instructions: - text: Change the capacity source of topology {topology} to {source}. slots: topology: path.computeCapacityTopologyId source: requestBody.capacitySource - text: Rename capacity topology {topology} to {name}. slots: topology: path.computeCapacityTopologyId name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}'].delete update: x-apievangelist-phrasing: intent: Delete a compute capacity topology effect: destructive questions: - How do I delete a capacity topology I no longer use? - Can I remove an old compute capacity topology? instructions: - text: Delete compute capacity topology {topology}. slots: topology: path.computeCapacityTopologyId - text: Remove capacity topology {topology}. slots: topology: path.computeCapacityTopologyId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a capacity topology to another compartment effect: write questions: - Can a capacity topology be moved into another compartment? - How do I relocate a compute capacity topology between compartments? instructions: - text: Move capacity topology {topology} to compartment {compartment}. slots: topology: path.computeCapacityTopologyId compartment: requestBody.compartmentId - text: Change the compartment of topology {topology} to {compartment}. slots: topology: path.computeCapacityTopologyId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}/computeBareMetalHosts'].get update: x-apievangelist-phrasing: intent: List bare metal hosts in a capacity topology effect: read questions: - Which bare metal hosts belong to my capacity topology? - Can I narrow the bare metal hosts in a topology to one HPC island or network block? instructions: - text: List bare metal hosts in capacity topology {topology}. slots: topology: path.computeCapacityTopologyId - text: Show the bare metal hosts in topology {topology} that sit in HPC island {island}. slots: topology: path.computeCapacityTopologyId island: query.computeHpcIslandId method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}/computeHpcIslands'].get update: x-apievangelist-phrasing: intent: List HPC islands in a capacity topology effect: read questions: - What HPC islands make up my compute capacity topology? - How is my dedicated capacity grouped into HPC islands? instructions: - text: List the HPC islands in capacity topology {topology}. slots: topology: path.computeCapacityTopologyId - text: Show HPC islands for topology {topology} in availability domain {ad}. slots: topology: path.computeCapacityTopologyId ad: query.availabilityDomain method: generated generated: '2026-09-26' - target: $.paths['/computeCapacityTopologies/{computeCapacityTopologyId}/computeNetworkBlocks'].get update: x-apievangelist-phrasing: intent: List network blocks in a capacity topology effect: read questions: - Which network blocks are in my capacity topology? - Can I list the network blocks inside a single HPC island? instructions: - text: List network blocks in capacity topology {topology}. slots: topology: path.computeCapacityTopologyId - text: Show the network blocks of topology {topology} within HPC island {island}. slots: topology: path.computeCapacityTopologyId island: query.computeHpcIslandId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters'].get update: x-apievangelist-phrasing: intent: List compute clusters effect: read questions: - What compute clusters do I have for RDMA-connected bare metal workloads? - Can I find a compute cluster by display name? instructions: - text: List compute clusters in compartment {compartment}. slots: compartment: query.compartmentId - text: Find the compute cluster named {name} in {compartment}. slots: name: query.displayName compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters'].post update: x-apievangelist-phrasing: intent: Create an empty compute cluster effect: write questions: - How do I create a compute cluster for high-bandwidth, low-latency bare metal instances? - Does a new compute cluster start with any instances in it? instructions: - text: Create an empty compute cluster in {ad} for compartment {compartment}. slots: ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Create a compute cluster called {name} in availability domain {ad}, compartment {compartment}. slots: name: requestBody.displayName ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters/{computeClusterId}'].get update: x-apievangelist-phrasing: intent: Get a compute cluster effect: read questions: - Where do I see the details of a single compute cluster? - What lifecycle state is my compute cluster in? instructions: - text: Get compute cluster {cluster}. slots: cluster: path.computeClusterId - text: Show the state and placement of compute cluster {cluster}. slots: cluster: path.computeClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters/{computeClusterId}'].put update: x-apievangelist-phrasing: intent: Update a compute cluster effect: write questions: - Can I rename a compute cluster or change its tags? - How do I change the placement constraints on an existing compute cluster? instructions: - text: Rename compute cluster {cluster} to {name}. slots: cluster: path.computeClusterId name: requestBody.displayName - text: Set placement constraints {constraints} on compute cluster {cluster}. slots: constraints: requestBody.placementConstraintDetails cluster: path.computeClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters/{computeClusterId}'].delete update: x-apievangelist-phrasing: intent: Delete a compute cluster effect: destructive questions: - How do I delete a compute cluster I'm done with? - Can I remove a compute cluster from my tenancy? instructions: - text: Delete compute cluster {cluster}. slots: cluster: path.computeClusterId - text: Tear down compute cluster {cluster}. slots: cluster: path.computeClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeClusters/{computeClusterId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a compute cluster to another compartment effect: write questions: - Can I move a compute cluster to another compartment in the same tenancy? - How do I reassign a compute cluster to a different compartment? instructions: - text: Move compute cluster {cluster} to compartment {compartment}. slots: cluster: path.computeClusterId compartment: requestBody.compartmentId - text: Change the compartment of compute cluster {cluster} to {compartment}. slots: cluster: path.computeClusterId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeGlobalImageCapabilitySchemas'].get update: x-apievangelist-phrasing: intent: List global image capability schemas effect: read questions: - Which global image capability schemas does Oracle Cloud publish? - Can I look up a global image capability schema by name? instructions: - text: List the global image capability schemas. - text: Find the global image capability schema named {name}. slots: name: query.displayName method: generated generated: '2026-09-26' - target: $.paths['/computeGlobalImageCapabilitySchemas/{computeGlobalImageCapabilitySchemaId}'].get update: x-apievangelist-phrasing: intent: Get a global image capability schema effect: read questions: - What does a specific global image capability schema define? - Which is the current version of a global image capability schema? instructions: - text: Get global image capability schema {schema}. slots: schema: path.computeGlobalImageCapabilitySchemaId - text: Show the current version of global capability schema {schema}. slots: schema: path.computeGlobalImageCapabilitySchemaId method: generated generated: '2026-09-26' - target: $.paths['/computeGlobalImageCapabilitySchemas/{computeGlobalImageCapabilitySchemaId}/versions'].get update: x-apievangelist-phrasing: intent: List versions of a global capability schema effect: read questions: - What versions exist for a global image capability schema? - Can I list every version of the global capability schema? instructions: - text: List versions of global image capability schema {schema}. slots: schema: path.computeGlobalImageCapabilitySchemaId - text: Show the version history for global capability schema {schema}. slots: schema: path.computeGlobalImageCapabilitySchemaId method: generated generated: '2026-09-26' - target: $.paths['/computeGlobalImageCapabilitySchemas/{computeGlobalImageCapabilitySchemaId}/versions/{computeGlobalImageCapabilitySchemaVersionName}'].get update: x-apievangelist-phrasing: intent: Get one global capability schema version effect: read questions: - What capabilities are defined in a specific global schema version? - Where do I read the schema data for one global capability schema version? instructions: - text: Get version {version} of global image capability schema {schema}. slots: version: path.computeGlobalImageCapabilitySchemaVersionName schema: path.computeGlobalImageCapabilitySchemaId - text: Show the schema data in global capability schema {schema} version {version}. slots: schema: path.computeGlobalImageCapabilitySchemaId version: path.computeGlobalImageCapabilitySchemaVersionName method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters'].get update: x-apievangelist-phrasing: intent: List GPU memory clusters effect: read questions: - What GPU memory clusters are running in my compartment? - Can I list the GPU memory clusters on one GPU memory fabric? instructions: - text: List GPU memory clusters in compartment {compartment}. slots: compartment: query.compartmentId - text: Show GPU memory clusters on fabric {fabric} in {compartment}. slots: fabric: query.computeGpuMemoryFabricId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters'].post update: x-apievangelist-phrasing: intent: Create a GPU memory cluster on a fabric effect: write questions: - How do I create a GPU memory cluster on a specific GPU memory fabric? - What do I need, like an instance configuration and compute cluster, to create a GPU memory cluster? instructions: - text: Create a GPU memory cluster in compute cluster {cluster} from instance configuration {config} in {ad}, compartment {compartment}. slots: cluster: requestBody.computeClusterId config: requestBody.instanceConfigurationId ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Create a GPU memory cluster of size {size} on fabric {fabric} using configuration {config}, cluster {cluster}, {ad}, compartment {compartment}. slots: size: requestBody.size fabric: requestBody.gpuMemoryFabricId config: requestBody.instanceConfigurationId cluster: requestBody.computeClusterId ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters/{computeGpuMemoryClusterId}'].get update: x-apievangelist-phrasing: intent: Get a GPU memory cluster effect: read questions: - What is the size and state of one GPU memory cluster? - Which fabric is a given GPU memory cluster running on? instructions: - text: Get GPU memory cluster {gpuCluster}. slots: gpuCluster: path.computeGpuMemoryClusterId - text: Show the fabric and size of GPU memory cluster {gpuCluster}. slots: gpuCluster: path.computeGpuMemoryClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters/{computeGpuMemoryClusterId}'].put update: x-apievangelist-phrasing: intent: Resize or update a GPU memory cluster effect: write questions: - Can I scale an existing GPU memory cluster to more instances? - How do I switch the instance configuration used by a GPU memory cluster? instructions: - text: Resize GPU memory cluster {gpuCluster} to {size} instances. slots: gpuCluster: path.computeGpuMemoryClusterId size: requestBody.size - text: Switch GPU memory cluster {gpuCluster} to instance configuration {config}. slots: gpuCluster: path.computeGpuMemoryClusterId config: requestBody.instanceConfigurationId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters/{computeGpuMemoryClusterId}'].delete update: x-apievangelist-phrasing: intent: Terminate a GPU memory cluster effect: destructive questions: - Does deleting a GPU memory cluster also terminate its instances? - How do I tear down a GPU memory cluster I'm done with? instructions: - text: Terminate GPU memory cluster {gpuCluster} and its instances. slots: gpuCluster: path.computeGpuMemoryClusterId - text: Delete GPU memory cluster {gpuCluster}. slots: gpuCluster: path.computeGpuMemoryClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters/{computeGpuMemoryClusterId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a GPU memory cluster to another compartment effect: write questions: - Can a GPU memory cluster be moved to a different compartment? - How do I reassign a GPU memory cluster to another team's compartment? instructions: - text: Move GPU memory cluster {gpuCluster} to compartment {compartment}. slots: gpuCluster: path.computeGpuMemoryClusterId compartment: requestBody.compartmentId - text: Change the compartment of GPU memory cluster {gpuCluster} to {compartment}. slots: gpuCluster: path.computeGpuMemoryClusterId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryClusters/{computeGpuMemoryClusterId}/instances'].get update: x-apievangelist-phrasing: intent: List instances in a GPU memory cluster effect: read questions: - Which instances belong to a GPU memory cluster? - Can I see the members of my GPU memory cluster? instructions: - text: List the instances in GPU memory cluster {gpuCluster}. slots: gpuCluster: path.computeGpuMemoryClusterId - text: Show every member instance of GPU memory cluster {gpuCluster}. slots: gpuCluster: path.computeGpuMemoryClusterId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryFabrics'].get update: x-apievangelist-phrasing: intent: List GPU memory fabrics effect: read questions: - What GPU memory fabrics are available in my compartment? - Can I filter GPU memory fabrics by health or lifecycle state? instructions: - text: List GPU memory fabrics in compartment {compartment}. slots: compartment: query.compartmentId - text: Show GPU memory fabrics in {compartment} whose health is {health}. slots: compartment: query.compartmentId health: query.computeGpuMemoryFabricHealth method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryFabrics/{computeGpuMemoryFabricId}'].get update: x-apievangelist-phrasing: intent: Get a GPU memory fabric effect: read questions: - What is the health and firmware of one GPU memory fabric? - Where do I see the details of a single GPU memory fabric? instructions: - text: Get GPU memory fabric {fabric}. slots: fabric: path.computeGpuMemoryFabricId - text: Show the health and state of GPU memory fabric {fabric}. slots: fabric: path.computeGpuMemoryFabricId method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryFabrics/{computeGpuMemoryFabricId}'].put update: x-apievangelist-phrasing: intent: Update a GPU memory fabric's name or firmware effect: write questions: - Can I set the desired firmware bundle or recycle level for a GPU memory fabric? - How do I rename a GPU memory fabric? instructions: - text: Set memory fabric preferences {preferences} on GPU memory fabric {fabric}. slots: preferences: requestBody.memoryFabricPreferences fabric: path.computeGpuMemoryFabricId - text: Rename GPU memory fabric {fabric} to {name}. slots: fabric: path.computeGpuMemoryFabricId name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/computeGpuMemoryFabrics/{computeGpuMemoryFabricId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a GPU memory fabric to another compartment effect: write questions: - Can a GPU memory fabric be moved between compartments? - How do I relocate a GPU memory fabric to another compartment? instructions: - text: Move GPU memory fabric {fabric} to compartment {compartment}. slots: fabric: path.computeGpuMemoryFabricId compartment: requestBody.compartmentId - text: Change the compartment of GPU memory fabric {fabric} to {compartment}. slots: fabric: path.computeGpuMemoryFabricId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups'].get update: x-apievangelist-phrasing: intent: List compute host groups effect: read questions: - What compute host groups exist in my compartment? - Which host groups have I set up for my bare metal hosts? instructions: - text: List compute host groups in compartment {compartment}. slots: compartment: query.compartmentId - text: Show all host groups for compartment {compartment}. slots: compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups'].post update: x-apievangelist-phrasing: intent: Create a compute host group effect: write questions: - How do I create a host group to organize bare metal hosts? - Can a host group require targeted placement for instance launches? instructions: - text: Create a host group named {name} in {ad}, compartment {compartment}, with targeted placement {targeted}. slots: name: requestBody.displayName ad: requestBody.availabilityDomain compartment: requestBody.compartmentId targeted: requestBody.isTargetedPlacementRequired - text: Create compute host group {name} in {compartment} and {ad} with configurations {configs}, targeted placement {targeted}. slots: name: requestBody.displayName compartment: requestBody.compartmentId ad: requestBody.availabilityDomain configs: requestBody.configurations targeted: requestBody.isTargetedPlacementRequired method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups/{computeHostGroupId}'].get update: x-apievangelist-phrasing: intent: Get a compute host group effect: read questions: - What configurations are set on a compute host group? - Where can I see one host group's details? instructions: - text: Get compute host group {hostGroup}. slots: hostGroup: path.computeHostGroupId - text: Show the configuration of host group {hostGroup}. slots: hostGroup: path.computeHostGroupId method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups/{computeHostGroupId}'].put update: x-apievangelist-phrasing: intent: Update a compute host group effect: write questions: - Can I change the target configurations of an existing host group? - How do I turn targeted placement on or off for a host group? instructions: - text: Update host group {hostGroup} configurations to {configs}. slots: hostGroup: path.computeHostGroupId configs: requestBody.configurations - text: Set targeted placement to {targeted} on host group {hostGroup}. slots: targeted: requestBody.isTargetedPlacementRequired hostGroup: path.computeHostGroupId method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups/{computeHostGroupId}'].delete update: x-apievangelist-phrasing: intent: Delete a compute host group effect: destructive questions: - How do I delete a compute host group? - Can I remove a host group I no longer use? instructions: - text: Delete compute host group {hostGroup}. slots: hostGroup: path.computeHostGroupId - text: Remove host group {hostGroup}. slots: hostGroup: path.computeHostGroupId method: generated generated: '2026-09-26' - target: $.paths['/computeHostGroups/{computeHostGroupId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a host group to another compartment effect: write questions: - Can I move a compute host group into a different compartment? - How do I reassign a host group between compartments? instructions: - text: Move host group {hostGroup} to compartment {compartment}. slots: hostGroup: path.computeHostGroupId compartment: requestBody.compartmentId - text: Change the compartment of compute host group {hostGroup} to {compartment}. slots: hostGroup: path.computeHostGroupId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts'].get update: x-apievangelist-phrasing: intent: List compute hosts effect: read questions: - Which bare metal compute hosts do I have and are any unhealthy? - Can I list only the hosts in a particular host group? instructions: - text: List compute hosts in compartment {compartment}. slots: compartment: query.compartmentId - text: Show compute hosts in {compartment} with health {health}. slots: compartment: query.compartmentId health: query.computeHostHealth - text: List the hosts in host group {hostGroup} for compartment {compartment}. slots: hostGroup: query.computeHostGroupId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}'].get update: x-apievangelist-phrasing: intent: Get a compute host effect: read questions: - What is the health and configuration state of one compute host? - Where do I see details for a single bare metal host? instructions: - text: Get compute host {host}. slots: host: path.computeHostId - text: Show the health of compute host {host}. slots: host: path.computeHostId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}'].put update: x-apievangelist-phrasing: intent: Rename or retag a compute host effect: write questions: - Can I rename a compute host? - How do I add free-form tags to a bare metal host record? instructions: - text: Rename compute host {host} to {name}. slots: host: path.computeHostId name: requestBody.displayName - text: Set free-form tags {tags} on compute host {host}. slots: tags: requestBody.freeformTags host: path.computeHostId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}/actions/applyConfiguration'].post update: x-apievangelist-phrasing: intent: Apply a host's target configuration effect: write questions: - How do I push a host's target configuration onto the host? - Is applying a host configuration asynchronous? instructions: - text: Apply the target configuration to compute host {host}. slots: host: path.computeHostId - text: Start applying host {host}'s target configuration now. slots: host: path.computeHostId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}/actions/attachToHostGroup'].post update: x-apievangelist-phrasing: intent: Add a bare metal host to a host group effect: write questions: - How do I put a bare metal host into a host group? - Can I assign a compute host to an existing host group? instructions: - text: Attach compute host {host} to host group {hostGroup}. slots: host: path.computeHostId hostGroup: requestBody.computeHostGroupId - text: Add host {host} to compute host group {hostGroup}. slots: host: path.computeHostId hostGroup: requestBody.computeHostGroupId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a compute host to another compartment effect: write questions: - Can I move a single compute host into another compartment? - How do I reassign a bare metal host to a different compartment? instructions: - text: Move compute host {host} to compartment {compartment}. slots: host: path.computeHostId compartment: requestBody.compartmentId - text: Change the compartment of bare metal host {host} to {compartment}. slots: host: path.computeHostId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}/actions/checkConfiguration'].post update: x-apievangelist-phrasing: intent: Check a host against its target configuration effect: write questions: - How do I check whether a host conforms to its target configuration? - Can I flag a bare metal host for a configuration conformance check? instructions: - text: Mark compute host {host} for a configuration conformance check. slots: host: path.computeHostId - text: Check whether host {host} matches its target configuration. slots: host: path.computeHostId method: generated generated: '2026-09-26' - target: $.paths['/computeHosts/{computeHostId}/actions/detachFromHostGroup'].post update: x-apievangelist-phrasing: intent: Remove a bare metal host from a host group effect: write questions: - How do I take a bare metal host out of its host group? - Can I detach a compute host from a host group without deleting the group? instructions: - text: Detach compute host {host} from host group {hostGroup}. slots: host: path.computeHostId hostGroup: requestBody.computeHostGroupId - text: Remove host {host} from compute host group {hostGroup}. slots: host: path.computeHostId hostGroup: requestBody.computeHostGroupId method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas'].get update: x-apievangelist-phrasing: intent: List image capability schemas effect: read questions: - Which image capability schemas are defined in my compartment? - Can I find the capability schema attached to a particular image? instructions: - text: List image capability schemas in compartment {compartment}. slots: compartment: query.compartmentId - text: Find the image capability schema for image {image}. slots: image: query.imageId method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas'].post update: x-apievangelist-phrasing: intent: Create an image capability schema effect: write questions: - How do I define which capabilities a custom image supports? - What global schema version do I base an image capability schema on? instructions: - text: Create a capability schema for image {image} in {compartment} from global version {version} with data {data}. slots: image: requestBody.imageId compartment: requestBody.compartmentId version: requestBody.computeGlobalImageCapabilitySchemaVersionName data: requestBody.schemaData - text: Define image capabilities {data} for image {image} using global schema version {version} in compartment {compartment}. slots: data: requestBody.schemaData image: requestBody.imageId version: requestBody.computeGlobalImageCapabilitySchemaVersionName compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas/{computeImageCapabilitySchemaId}'].get update: x-apievangelist-phrasing: intent: Get an image capability schema effect: read questions: - What capabilities does a specific image capability schema declare? - Can I see an image capability schema merged with its global schema? instructions: - text: Get image capability schema {schema}. slots: schema: path.computeImageCapabilitySchemaId - text: Show image capability schema {schema} merged with the global schema. slots: schema: path.computeImageCapabilitySchemaId method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas/{computeImageCapabilitySchemaId}'].put update: x-apievangelist-phrasing: intent: Update an image capability schema effect: write questions: - Can I change the schema data on an existing image capability schema? - How do I rename an image capability schema? instructions: - text: Update the schema data of image capability schema {schema} to {data}. slots: schema: path.computeImageCapabilitySchemaId data: requestBody.schemaData - text: Rename image capability schema {schema} to {name}. slots: schema: path.computeImageCapabilitySchemaId name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas/{computeImageCapabilitySchemaId}'].delete update: x-apievangelist-phrasing: intent: Delete an image capability schema effect: destructive questions: - How do I delete an image capability schema? - Can I remove a capability schema from a custom image? instructions: - text: Delete image capability schema {schema}. slots: schema: path.computeImageCapabilitySchemaId - text: Remove the capability schema {schema}. slots: schema: path.computeImageCapabilitySchemaId method: generated generated: '2026-09-26' - target: $.paths['/computeImageCapabilitySchemas/{computeImageCapabilitySchemaId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move an image capability schema's compartment effect: write questions: - Can an image capability schema be moved to another compartment? - How do I relocate a capability schema along with its image? instructions: - text: Move image capability schema {schema} to compartment {compartment}. slots: schema: path.computeImageCapabilitySchemaId compartment: requestBody.compartmentId - text: Change the compartment of capability schema {schema} to {compartment}. slots: schema: path.computeImageCapabilitySchemaId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHostInstanceShapes'].get update: x-apievangelist-phrasing: intent: List VM shapes for dedicated VM hosts effect: read questions: - Which VM shapes can I launch on a dedicated virtual machine host? - What instance shapes fit on a given dedicated VM host shape? instructions: - text: List instance shapes I can place on dedicated VM hosts in compartment {compartment}. slots: compartment: query.compartmentId - text: Show VM shapes that run on dedicated host shape {hostShape} in {compartment}. slots: hostShape: query.dedicatedVmHostShape compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHostShapes'].get update: x-apievangelist-phrasing: intent: List dedicated VM host shapes effect: read questions: - What shapes are available for creating a dedicated VM host? - Which dedicated host shapes support a particular instance shape? instructions: - text: List dedicated VM host shapes in compartment {compartment}. slots: compartment: query.compartmentId - text: Show dedicated host shapes that can hold instance shape {shape} in {compartment}. slots: shape: query.instanceShapeName compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts'].get update: x-apievangelist-phrasing: intent: List dedicated VM hosts effect: read questions: - What dedicated virtual machine hosts do I have? - Can I find dedicated hosts with at least a certain amount of free memory or OCPUs? instructions: - text: List dedicated VM hosts in compartment {compartment}. slots: compartment: query.compartmentId - text: Find dedicated hosts in {compartment} with at least {ocpus} OCPUs remaining. slots: compartment: query.compartmentId ocpus: query.remainingOcpusGreaterThanOrEqualTo method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts'].post update: x-apievangelist-phrasing: intent: Create a dedicated VM host effect: write questions: - How do I provision a dedicated virtual machine host for my own VMs? - Can I enable memory encryption on a new dedicated VM host? instructions: - text: Create a dedicated VM host of shape {hostShape} in {ad}, compartment {compartment}. slots: hostShape: requestBody.dedicatedVmHostShape ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Provision dedicated host {name} with shape {hostShape} in fault domain {fd}, {ad}, compartment {compartment}. slots: name: requestBody.displayName hostShape: requestBody.dedicatedVmHostShape fd: requestBody.faultDomain ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts/{dedicatedVmHostId}'].get update: x-apievangelist-phrasing: intent: Get a dedicated VM host effect: read questions: - How much capacity is left on one dedicated VM host? - Where do I see the details of a single dedicated host? instructions: - text: Get dedicated VM host {host}. slots: host: path.dedicatedVmHostId - text: Show remaining OCPUs and memory on dedicated host {host}. slots: host: path.dedicatedVmHostId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts/{dedicatedVmHostId}'].put update: x-apievangelist-phrasing: intent: Rename or retag a dedicated VM host effect: write questions: - Can I rename a dedicated VM host? - What fields on a dedicated host can be updated after creation? instructions: - text: Rename dedicated VM host {host} to {name}. slots: host: path.dedicatedVmHostId name: requestBody.displayName - text: Set free-form tags {tags} on dedicated host {host}. slots: tags: requestBody.freeformTags host: path.dedicatedVmHostId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts/{dedicatedVmHostId}'].delete update: x-apievangelist-phrasing: intent: Delete a dedicated VM host effect: destructive questions: - Why does deleting my dedicated VM host fail with a 409? - How do I delete a dedicated host once its VMs are gone? instructions: - text: Delete dedicated VM host {host}. slots: host: path.dedicatedVmHostId - text: Remove dedicated host {host} now that it has no instances. slots: host: path.dedicatedVmHostId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts/{dedicatedVmHostId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move a dedicated VM host to another compartment effect: write questions: - Can a dedicated VM host be moved between compartments? - How do I reassign a dedicated host to a different compartment? instructions: - text: Move dedicated VM host {host} to compartment {compartment}. slots: host: path.dedicatedVmHostId compartment: requestBody.compartmentId - text: Change the compartment of dedicated host {host} to {compartment}. slots: host: path.dedicatedVmHostId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/dedicatedVmHosts/{dedicatedVmHostId}/instances'].get update: x-apievangelist-phrasing: intent: List instances on a dedicated VM host effect: read questions: - Which VMs are running on a particular dedicated host? - Can I list only memory-encrypted instances on a dedicated host? instructions: - text: List instances on dedicated VM host {host} in compartment {compartment}. slots: host: path.dedicatedVmHostId compartment: query.compartmentId - text: Show VMs placed on dedicated host {host} for {compartment}. slots: host: path.dedicatedVmHostId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/firmwareBundles'].get update: x-apievangelist-phrasing: intent: List firmware bundles for a platform effect: read questions: - Which firmware bundles are available for my bare metal platform? - Can I find the default firmware bundle for a platform? instructions: - text: List firmware bundles for platform {platform}. slots: platform: query.platform - text: Show the default firmware bundle for platform {platform}. slots: platform: query.platform method: generated generated: '2026-09-26' - target: $.paths['/firmwareBundles/{firmwareBundleId}'].get update: x-apievangelist-phrasing: intent: Get a firmware bundle effect: read questions: - What firmware versions are in a specific firmware bundle? - Where can I see the details of one firmware bundle? instructions: - text: Get firmware bundle {bundle}. slots: bundle: path.firmwareBundleId - text: Show what's included in firmware bundle {bundle}. slots: bundle: path.firmwareBundleId method: generated generated: '2026-09-26' - target: $.paths['/images'].get update: x-apievangelist-phrasing: intent: List images available for instances effect: read questions: - Which platform and custom images can I launch instances from? - Can I filter images by operating system and version? instructions: - text: List images in compartment {compartment}. slots: compartment: query.compartmentId - text: Find {os} {osVersion} images in compartment {compartment}. slots: os: query.operatingSystem osVersion: query.operatingSystemVersion compartment: query.compartmentId - text: Show images compatible with shape {shape} in {compartment}. slots: shape: query.shape compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/images'].post update: x-apievangelist-phrasing: intent: Create a custom image from an instance effect: write questions: - How do I make a custom boot disk image from one of my instances? - Can I import an exported image from Object Storage as a new image? instructions: - text: Create a custom image from instance {instance} in compartment {compartment}. slots: instance: requestBody.instanceId compartment: requestBody.compartmentId - text: Import an image into {compartment} from Object Storage source {source}. slots: compartment: requestBody.compartmentId source: requestBody.imageSourceDetails method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}'].get update: x-apievangelist-phrasing: intent: Get an image effect: read questions: - What operating system and state does a specific image have? - Where do I see the details of one custom image? instructions: - text: Get image {image}. slots: image: path.imageId - text: Show the operating system and lifecycle state of image {image}. slots: image: path.imageId method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}'].put update: x-apievangelist-phrasing: intent: Rename or retag an image effect: write questions: - Can I rename a custom image? - How do I correct the operating system version recorded on an image? instructions: - text: Rename image {image} to {name}. slots: image: path.imageId name: requestBody.displayName - text: Set the operating system version on image {image} to {osVersion}. slots: image: path.imageId osVersion: requestBody.operatingSystemVersion method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}'].delete update: x-apievangelist-phrasing: intent: Delete an image effect: destructive questions: - How do I delete a custom image I no longer need? - Can I remove an old image from my compartment? instructions: - text: Delete image {image}. slots: image: path.imageId - text: Remove custom image {image}. slots: image: path.imageId method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move an image to another compartment effect: write questions: - Can I move a custom image to another compartment in the same tenancy? - How do I reorganize images across compartments? instructions: - text: Move image {image} to compartment {compartment}. slots: image: path.imageId compartment: requestBody.compartmentId - text: Change the compartment of image {image} to {compartment}. slots: image: path.imageId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/actions/export'].post update: x-apievangelist-phrasing: intent: Export an image to Object Storage effect: write questions: - How do I export a custom image to an Object Storage bucket? - Which formats can I export an image in, such as QCOW2 or VMDK? instructions: - text: Export image {image} to Object Storage using destination type {destination}. slots: image: path.imageId destination: requestBody.destinationType - text: Export image {image} in {format} format to destination type {destination}. slots: image: path.imageId format: requestBody.exportFormat destination: requestBody.destinationType method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/shapes'].get update: x-apievangelist-phrasing: intent: List shapes compatible with an image effect: read questions: - Which shapes can I launch a given image on? - What is the compatible shapes list for my custom image? instructions: - text: List the compatible shapes for image {image}. slots: image: path.imageId - text: Show every shape image {image} is allowed to run on. slots: image: path.imageId method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/shapes/{shapeName}'].get update: x-apievangelist-phrasing: intent: Check one shape's compatibility with an image effect: read questions: - Is a specific shape compatible with my image, and with what OCPU or memory limits? - What constraints apply when running an image on one particular shape? instructions: - text: Get the compatibility entry for shape {shape} on image {image}. slots: shape: path.shapeName image: path.imageId - text: Check whether image {image} supports shape {shape}. slots: image: path.imageId shape: path.shapeName method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/shapes/{shapeName}'].put update: x-apievangelist-phrasing: intent: Add a shape to an image's compatible list effect: write questions: - How do I allow my custom image to run on an additional shape? - Can I set OCPU or memory constraints when adding a compatible shape to an image? instructions: - text: Add shape {shape} to the compatible shapes of image {image}. slots: shape: path.shapeName image: path.imageId - text: Make image {image} compatible with shape {shape} with OCPU constraints {ocpu}. slots: image: path.imageId shape: path.shapeName ocpu: requestBody.ocpuConstraints method: generated generated: '2026-09-26' - target: $.paths['/images/{imageId}/shapes/{shapeName}'].delete update: x-apievangelist-phrasing: intent: Remove a shape from an image's compatible list effect: destructive questions: - How do I stop an image from being launched on a certain shape? - Can I take a shape off my image's compatibility list? instructions: - text: Remove shape {shape} from image {image}'s compatible shapes. slots: shape: path.shapeName image: path.imageId - text: Drop compatibility between image {image} and shape {shape}. slots: image: path.imageId shape: path.shapeName method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleConnections'].get update: x-apievangelist-phrasing: intent: List instance console connections effect: read questions: - Which console connections are open for my instances? - Can I see the console connections for a single instance? instructions: - text: List console connections in compartment {compartment}. slots: compartment: query.compartmentId - text: Show console connections for instance {instance} in {compartment}. slots: instance: query.instanceId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleConnections'].post update: x-apievangelist-phrasing: intent: Open a console connection to an instance effect: write questions: - How do I connect to an instance's serial console when SSH isn't working? - What public key do I need to create an instance console connection? instructions: - text: Create a console connection to instance {instance} with public key {key}. slots: instance: requestBody.instanceId key: requestBody.publicKey - text: Open a serial console connection on {instance} using SSH key {key}. slots: instance: requestBody.instanceId key: requestBody.publicKey method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleConnections/{instanceConsoleConnectionId}'].get update: x-apievangelist-phrasing: intent: Get an instance console connection effect: read questions: - What connection string do I use for an existing console connection? - Is my instance console connection active yet? instructions: - text: Get console connection {connection}. slots: connection: path.instanceConsoleConnectionId - text: Show the connection string for console connection {connection}. slots: connection: path.instanceConsoleConnectionId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleConnections/{instanceConsoleConnectionId}'].put update: x-apievangelist-phrasing: intent: Retag an instance console connection effect: write questions: - Can I change the tags on a console connection? - What can be updated on an existing instance console connection? instructions: - text: Set free-form tags {tags} on console connection {connection}. slots: tags: requestBody.freeformTags connection: path.instanceConsoleConnectionId - text: Update the defined tags of console connection {connection} to {tags}. slots: connection: path.instanceConsoleConnectionId tags: requestBody.definedTags method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleConnections/{instanceConsoleConnectionId}'].delete update: x-apievangelist-phrasing: intent: Delete an instance console connection effect: destructive questions: - How do I close a console connection when I'm done troubleshooting? - Can I remove an instance console connection? instructions: - text: Delete console connection {connection}. slots: connection: path.instanceConsoleConnectionId - text: Close instance console connection {connection}. slots: connection: path.instanceConsoleConnectionId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/'].get update: x-apievangelist-phrasing: intent: List captured console histories effect: read questions: - Which serial console history captures do I have? - Can I list console histories for just one instance? instructions: - text: List console histories in compartment {compartment}. slots: compartment: query.compartmentId - text: Show console history captures for instance {instance} in {compartment}. slots: instance: query.instanceId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/'].post update: x-apievangelist-phrasing: intent: Capture an instance's serial console output effect: write questions: - How do I capture recent serial console output to debug a boot problem? - How much console data does a console history capture include? instructions: - text: Capture the console history of instance {instance}. slots: instance: requestBody.instanceId - text: Take a serial console capture of {instance} named {name}. slots: instance: requestBody.instanceId name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/{instanceConsoleHistoryId}'].get update: x-apievangelist-phrasing: intent: Get console history metadata effect: read questions: - Has my console history capture finished yet? - Where do I see the metadata for one console history capture? instructions: - text: Get console history {history}. slots: history: path.instanceConsoleHistoryId - text: Check the capture state of console history {history}. slots: history: path.instanceConsoleHistoryId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/{instanceConsoleHistoryId}'].put update: x-apievangelist-phrasing: intent: Rename or retag a console history effect: write questions: - Can I rename a console history capture? - How do I tag a console history for later reference? instructions: - text: Rename console history {history} to {name}. slots: history: path.instanceConsoleHistoryId name: requestBody.displayName - text: Set free-form tags {tags} on console history {history}. slots: tags: requestBody.freeformTags history: path.instanceConsoleHistoryId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/{instanceConsoleHistoryId}'].delete update: x-apievangelist-phrasing: intent: Delete a console history capture effect: destructive questions: - How do I delete a console history and its captured data? - Can I clean up old serial console captures? instructions: - text: Delete console history {history}. slots: history: path.instanceConsoleHistoryId - text: Remove console capture {history} and its data. slots: history: path.instanceConsoleHistoryId method: generated generated: '2026-09-26' - target: $.paths['/instanceConsoleHistories/{instanceConsoleHistoryId}/data'].get update: x-apievangelist-phrasing: intent: Download captured serial console output effect: read questions: - How do I read the actual serial console output I captured? - Can I fetch only part of a console history using an offset and length? instructions: - text: Show the console output text in capture {history}. slots: history: path.instanceConsoleHistoryId - text: Read {length} bytes of console history {history} starting at offset {offset}. slots: length: query.length history: path.instanceConsoleHistoryId offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/instanceMaintenanceEvents'].get update: x-apievangelist-phrasing: intent: List instance maintenance events effect: read questions: - Which of my instances have upcoming infrastructure maintenance? - Can I filter maintenance events to a time window or a single instance? instructions: - text: List maintenance events in compartment {compartment}. slots: compartment: query.compartmentId - text: Show maintenance events for instance {instance} in {compartment}. slots: instance: query.instanceId compartment: query.compartmentId - text: List maintenance scheduled to start after {start} in compartment {compartment}. slots: start: query.timeWindowStartGreaterThanOrEqualTo compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instanceMaintenanceEvents/{instanceMaintenanceEventId}'].get update: x-apievangelist-phrasing: intent: Get an instance maintenance event effect: read questions: - When exactly is a specific maintenance event scheduled to start? - What alternative resolution actions does a maintenance event offer? instructions: - text: Get maintenance event {event}. slots: event: path.instanceMaintenanceEventId - text: Show the time window and actions for maintenance event {event}. slots: event: path.instanceMaintenanceEventId method: generated generated: '2026-09-26' - target: $.paths['/instanceMaintenanceEvents/{instanceMaintenanceEventId}'].put update: x-apievangelist-phrasing: intent: Reschedule or resolve a maintenance event effect: write questions: - Can I reschedule when maintenance starts on my instance? - How do I pick an alternative resolution action for a maintenance event? instructions: - text: Reschedule maintenance event {event} to start at {start}. slots: event: path.instanceMaintenanceEventId start: requestBody.timeWindowStart - text: Resolve maintenance event {event} with action {action}. slots: event: path.instanceMaintenanceEventId action: requestBody.alternativeResolutionAction method: generated generated: '2026-09-26' - target: $.paths['/instances/'].get update: x-apievangelist-phrasing: intent: List compute instances effect: read questions: - What compute instances are running in my compartment? - Can I list only the instances that are stopped? - Which instances were launched into a particular compute cluster? instructions: - text: List instances in compartment {compartment}. slots: compartment: query.compartmentId - text: Show instances in {compartment} that are {state}. slots: compartment: query.compartmentId state: query.lifecycleState - text: Find the instance named {name} in compartment {compartment}. slots: name: query.displayName compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instances/'].post update: x-apievangelist-phrasing: intent: Launch a new compute instance effect: write questions: - How do I launch a new VM or bare metal instance on Oracle Cloud? - Can I launch an instance as preemptible capacity or onto a dedicated VM host? instructions: - text: Launch an instance of shape {shape} in {ad}, compartment {compartment}, on subnet {subnet}. slots: shape: requestBody.shape ad: requestBody.availabilityDomain compartment: requestBody.compartmentId subnet: requestBody.subnetId - text: Launch instance {name} from image {image} in {ad}, compartment {compartment}. slots: name: requestBody.displayName image: requestBody.imageId ad: requestBody.availabilityDomain compartment: requestBody.compartmentId - text: Launch an instance from instance configuration {config} in {ad}, compartment {compartment}. slots: config: requestBody.instanceConfigurationId ad: requestBody.availabilityDomain compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}'].get update: x-apievangelist-phrasing: intent: Get a compute instance effect: read questions: - What shape, image and state is my instance in? - Where do I see the full details of one compute instance? instructions: - text: Get instance {instance}. slots: instance: path.instanceId - text: Show the shape and lifecycle state of instance {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}'].put update: x-apievangelist-phrasing: intent: Update an instance's settings or shape effect: write questions: - Can I change the shape of a running instance to resize it? - How do I rename an instance or move it to another fault domain? instructions: - text: Change instance {instance} to shape {shape}. slots: instance: path.instanceId shape: requestBody.shape - text: Rename instance {instance} to {name}. slots: instance: path.instanceId name: requestBody.displayName - text: Move instance {instance} to fault domain {fd}. slots: instance: path.instanceId fd: requestBody.faultDomain method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}'].post update: x-apievangelist-phrasing: intent: Start, stop or reboot an instance effect: write questions: - How do I start, stop or reboot a compute instance? - What's the difference between a soft stop and a hard stop on an instance? instructions: - text: Run power action {action} on instance {instance}. slots: action: query.action instance: path.instanceId - text: Perform {action} on instance {instance} with action type {actionType}. slots: action: query.action instance: path.instanceId actionType: requestBody.actionType method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}'].delete update: x-apievangelist-phrasing: intent: Terminate an instance permanently effect: destructive questions: - How do I permanently terminate an instance? - Can I keep the boot volume when I terminate an instance? instructions: - text: Terminate instance {instance}. slots: instance: path.instanceId - text: Terminate instance {instance} and set preserve boot volume to {preserve}. slots: instance: path.instanceId preserve: query.preserveBootVolume method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/actions/acceptShieldedIntegrityPolicy'].post update: x-apievangelist-phrasing: intent: Accept new measured boot PCR values effect: write questions: - How do I accept changed PCR values in a shielded instance's measured boot report? - Can I reset a shielded instance's integrity baseline after a legitimate change? instructions: - text: Accept the shielded integrity policy changes on instance {instance}. slots: instance: path.instanceId - text: Accept the new measured boot PCR values for {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/actions/changeCompartment'].post update: x-apievangelist-phrasing: intent: Move an instance to another compartment effect: write questions: - Can I move a running instance to another compartment? - How do I reassign an instance to a different compartment in my tenancy? instructions: - text: Move instance {instance} to compartment {compartment}. slots: instance: path.instanceId compartment: requestBody.compartmentId - text: Change the compartment of instance {instance} to {compartment}. slots: instance: path.instanceId compartment: requestBody.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/defaultCredentials'].get update: x-apievangelist-phrasing: intent: Get an instance's generated login credentials effect: read questions: - How do I get the initial password for a Windows instance? - Where can I retrieve the generated credentials for an instance that needs a password? instructions: - text: Get the default login credentials for instance {instance}. slots: instance: path.instanceId - text: Retrieve the generated username and password for {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/devices'].get update: x-apievangelist-phrasing: intent: List devices on an instance effect: read questions: - Which device paths are free on my instance for attaching a volume? - Can I list only the available devices on an instance? instructions: - text: List devices on instance {instance}. slots: instance: path.instanceId - text: Show only the available devices on instance {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/initialCredentials'].get update: x-apievangelist-phrasing: intent: Get Windows initial credentials (deprecated) effect: read questions: - Is there an older deprecated endpoint for Windows instance initial credentials? - What does the legacy Windows initial credentials call return? instructions: - text: Use the deprecated Windows initial credentials endpoint for instance {instance}. slots: instance: path.instanceId - text: Get the legacy Windows initial credentials of {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/maintenanceReboot'].get update: x-apievangelist-phrasing: intent: Get the latest date a maintenance reboot can move to effect: read questions: - How far can I push out a maintenance reboot for my instance? - What's the deadline for extending an instance's maintenance reboot? instructions: - text: Get the maximum maintenance reboot extension date for instance {instance}. slots: instance: path.instanceId - text: Show how late the maintenance reboot of {instance} can be delayed. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/instances/{instanceId}/measuredBootReport'].get update: x-apievangelist-phrasing: intent: Get a shielded instance's measured boot report effect: read questions: - How do I check the measured boot report on a shielded instance? - Did my shielded instance's boot measurements change from the policy? instructions: - text: Get the measured boot report for instance {instance}. slots: instance: path.instanceId - text: Show measured boot PCR values for shielded instance {instance}. slots: instance: path.instanceId method: generated generated: '2026-09-26' - target: $.paths['/shapes'].get update: x-apievangelist-phrasing: intent: List shapes for launching instances effect: read questions: - What instance shapes can I launch in my compartment? - Which shapes are compatible with a given image? instructions: - text: List launchable instance shapes in compartment {compartment}. slots: compartment: query.compartmentId - text: List launchable shapes in compartment {compartment}, filtered to those compatible with image {image}. slots: image: query.imageId compartment: query.compartmentId method: generated generated: '2026-10-02' - target: $.paths['/vnicAttachments/'].get update: x-apievangelist-phrasing: intent: List VNIC attachments effect: read questions: - Which VNICs are attached to my instances? - Can I find the VNIC attachments for a single instance? instructions: - text: List VNIC attachments in compartment {compartment}. slots: compartment: query.compartmentId - text: Show VNIC attachments for instance {instance} in {compartment}. slots: instance: query.instanceId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/vnicAttachments/'].post update: x-apievangelist-phrasing: intent: Attach a secondary VNIC to an instance effect: write questions: - How do I add a secondary network interface to an instance? - Can I choose which physical NIC a secondary VNIC uses on bare metal? instructions: - text: Attach a secondary VNIC to instance {instance} with details {vnic}. slots: instance: requestBody.instanceId vnic: requestBody.createVnicDetails - text: Add a VNIC to {instance} on NIC index {nic} using {vnic}. slots: instance: requestBody.instanceId nic: requestBody.nicIndex vnic: requestBody.createVnicDetails method: generated generated: '2026-09-26' - target: $.paths['/vnicAttachments/{vnicAttachmentId}'].get update: x-apievangelist-phrasing: intent: Get a VNIC attachment effect: read questions: - Which VNIC and instance does a specific VNIC attachment link? - Is my secondary VNIC attachment finished attaching? instructions: - text: Get VNIC attachment {attachment}. slots: attachment: path.vnicAttachmentId - text: Show the state of VNIC attachment {attachment}. slots: attachment: path.vnicAttachmentId method: generated generated: '2026-09-26' - target: $.paths['/vnicAttachments/{vnicAttachmentId}'].delete update: x-apievangelist-phrasing: intent: Detach and delete a secondary VNIC effect: destructive questions: - How do I remove a secondary VNIC from an instance? - Can I detach an instance's primary VNIC? instructions: - text: Detach and delete the secondary VNIC in attachment {attachment}. slots: attachment: path.vnicAttachmentId - text: Remove VNIC attachment {attachment}. slots: attachment: path.vnicAttachmentId method: generated generated: '2026-09-26' - target: $.paths['/volumeAttachments/'].get update: x-apievangelist-phrasing: intent: List block volume attachments effect: read questions: - Which block volumes are attached to my instances? - Can I see which instance a specific block volume is attached to? instructions: - text: List volume attachments in compartment {compartment}. slots: compartment: query.compartmentId - text: Show block volume attachments for instance {instance} in {compartment}. slots: instance: query.instanceId compartment: query.compartmentId - text: Find where volume {volume} is attached in compartment {compartment}. slots: volume: query.volumeId compartment: query.compartmentId method: generated generated: '2026-09-26' - target: $.paths['/volumeAttachments/'].post update: x-apievangelist-phrasing: intent: Attach a block volume to an instance effect: write questions: - How do I attach a block storage volume to an instance? - Can I attach a volume as read-only or shareable across instances? instructions: - text: Attach volume {volume} to instance {instance} as a {type} attachment. slots: volume: requestBody.volumeId instance: requestBody.instanceId type: requestBody.type - text: Attach volume {volume} to {instance} at device {device} using attachment type {type}. slots: volume: requestBody.volumeId instance: requestBody.instanceId device: requestBody.device type: requestBody.type method: generated generated: '2026-09-26' - target: $.paths['/volumeAttachments/{volumeAttachmentId}'].get update: x-apievangelist-phrasing: intent: Get a block volume attachment effect: read questions: - What are the iSCSI details of one volume attachment? - Has a block volume attachment finished attaching? instructions: - text: Get volume attachment {attachment}. slots: attachment: path.volumeAttachmentId - text: Show the iSCSI connection details for volume attachment {attachment}. slots: attachment: path.volumeAttachmentId method: generated generated: '2026-09-26' - target: $.paths['/volumeAttachments/{volumeAttachmentId}'].put update: x-apievangelist-phrasing: intent: Update a volume attachment's iSCSI login state effect: write questions: - How do I change the iSCSI login state of a volume attachment? - Can I update an existing block volume attachment? instructions: - text: Set the iSCSI login state of volume attachment {attachment} to {state}. slots: attachment: path.volumeAttachmentId state: requestBody.iscsiLoginState - text: Update volume attachment {attachment} with iSCSI login state {state}. slots: attachment: path.volumeAttachmentId state: requestBody.iscsiLoginState method: generated generated: '2026-09-26' - target: $.paths['/volumeAttachments/{volumeAttachmentId}'].delete update: x-apievangelist-phrasing: intent: Detach a block volume from an instance effect: destructive questions: - How do I detach a block volume from an instance? - Is detaching a block volume asynchronous? instructions: - text: Detach the volume in attachment {attachment}. slots: attachment: path.volumeAttachmentId - text: Remove block volume attachment {attachment} from its instance. slots: attachment: path.volumeAttachmentId method: generated generated: '2026-09-26'