Oracle Cloud Infrastructure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Core Services Compute API

131 actions 131 updates phrasing extends openapi/oracle-cloud-compute-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Oracle Cloud Infrastructure's API. It is a proposal applied on top of the contract, not a document Oracle Cloud Infrastructure publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 131 · first 16 shown; the file carries all of them

$.info
$.paths['/appCatalogListings'].get
$.paths['/appCatalogListings/{listingId}'].get
$.paths['/appCatalogListings/{listingId}/resourceVersions'].get
$.paths['/appCatalogListings/{listingId}/resourceVersions/{resourceVersion}'].get
$.paths['/appCatalogListings/{listingId}/resourceVersions/{resourceVersion}/agreements'].get
$.paths['/appCatalogSubscriptions'].get
$.paths['/appCatalogSubscriptions'].post
$.paths['/appCatalogSubscriptions'].delete
$.paths['/bootVolumeAttachments/'].get
$.paths['/bootVolumeAttachments/'].post
$.paths['/bootVolumeAttachments/{bootVolumeAttachmentId}'].get
$.paths['/bootVolumeAttachments/{bootVolumeAttachmentId}'].delete
$.paths['/computeCapacityReports'].post
$.paths['/computeCapacityReservationInstanceShapes'].get
$.paths['/computeCapacityReservations'].get

OpenAPI Overlay

Raw ↑
# 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'


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