API Evangelist conversational phrasing for Service Database API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Service Database API
  version: 1.0.0
extends: openapi/oracle-cloud-database-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: 444
- target: $.paths['/applicationVip'].get
  update:
    x-apievangelist-phrasing:
      intent: List application VIPs on a cloud VM cluster
      effect: read
      questions:
      - Which application virtual IP addresses are assigned to my cloud VM cluster?
      - Can I filter a cloud VM cluster's application VIPs by lifecycle state?
      instructions:
      - text: List the application VIPs on cloud VM cluster {cluster} in compartment {compartment}.
        slots:
          cluster: query.cloudVmClusterId
          compartment: query.compartmentId
      - text: Show only {state} application VIPs for cluster {cluster} in compartment {compartment}.
        slots:
          state: query.lifecycleState
          cluster: query.cloudVmClusterId
          compartment: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applicationVip'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application VIP on a cloud VM cluster
      effect: write
      questions:
      - How do I add a new application virtual IP address to an Oracle cloud VM cluster?
      - Can I pick the exact IP address and subnet for a new application VIP?
      instructions:
      - text: Create an application VIP with hostname label {hostname} on cloud VM cluster {cluster}.
        slots:
          hostname: requestBody.hostnameLabel
          cluster: requestBody.cloudVmClusterId
      - text: Add application VIP {ip} named {hostname} to cluster {cluster} in subnet {subnet}.
        slots:
          ip: requestBody.ipAddress
          hostname: requestBody.hostnameLabel
          cluster: requestBody.cloudVmClusterId
          subnet: requestBody.subnetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applicationVip/{applicationVipId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of an application VIP
      effect: read
      questions:
      - What IP address and hostname does a specific application VIP have?
      - Is my application virtual IP address active or still provisioning?
      instructions:
      - text: Show the details of application VIP {vip}.
        slots:
          vip: path.applicationVipId
      - text: Look up the state of application virtual IP {vip}.
        slots:
          vip: path.applicationVipId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applicationVip/{applicationVipId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application VIP
      effect: destructive
      questions:
      - How can I remove and deregister an application VIP I no longer need?
      - Does deleting an application virtual IP also deregister it from the cluster?
      instructions:
      - text: Delete application VIP {vip}.
        slots:
          vip: path.applicationVipId
      - text: Deregister and remove application virtual IP {vip} from its VM cluster.
        slots:
          vip: path.applicationVipId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabaseBackups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Autonomous Container Database backups
      effect: read
      questions:
      - Where can I see the backups taken of an Autonomous Container Database?
      - Can I list only remote backups of my container databases?
      instructions:
      - text: List backups of Autonomous Container Database {acd}.
        slots:
          acd: query.autonomousContainerDatabaseId
      - text: Show all Autonomous Container Database backups in compartment {compartment}.
        slots:
          compartment: query.compartmentId
      - text: List container database backups in compartment {compartment} where remote is {remote}.
        slots:
          compartment: query.compartmentId
          remote: query.isRemote
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabaseVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported Autonomous Container Database versions
      effect: read
      questions:
      - Which database versions can I choose when creating an Autonomous Container Database?
      - What container database versions are supported for a given service component?
      instructions:
      - text: List supported Autonomous Container Database versions in compartment {compartment} for service component {component}.
        slots:
          compartment: query.compartmentId
          component: query.serviceComponent
      - text: Show the available ACD versions for {component} in compartment {compartment}, newest first.
        slots:
          component: query.serviceComponent
          compartment: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases'].get
  update:
    x-apievangelist-phrasing:
      intent: List Autonomous Container Databases in a compartment
      effect: read
      questions:
      - What Autonomous Container Databases exist in my compartment?
      - Can I list the container databases running on one Autonomous VM cluster?
      - Which of my Autonomous Container Databases are in a particular availability domain?
      instructions:
      - text: List the Autonomous Container Databases in compartment {compartment}.
        slots:
          compartment: query.compartmentId
      - text: Show Autonomous Container Databases on cloud Autonomous VM cluster {cluster} in compartment {compartment}.
        slots:
          cluster: query.cloudAutonomousVmClusterId
          compartment: query.compartmentId
      - text: Find the Autonomous Container Database named {name} in compartment {compartment}.
        slots:
          name: query.displayName
          compartment: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Autonomous Container Database
      effect: write
      questions:
      - How do I create a new Autonomous Container Database on dedicated Exadata infrastructure?
      - Can I set the patch model and backup config when creating a container database?
      instructions:
      - text: Create an Autonomous Container Database called {name} with patch model {patchModel}.
        slots:
          name: requestBody.displayName
          patchModel: requestBody.patchModel
      - text: Create container database {name} on cloud Autonomous VM cluster {cluster} using patch model {patchModel}.
        slots:
          name: requestBody.displayName
          cluster: requestBody.cloudAutonomousVmClusterId
          patchModel: requestBody.patchModel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Autonomous Container Database
      effect: read
      questions:
      - What are the settings and state of a specific Autonomous Container Database?
      - Can I check which version and patch model one container database is on?
      instructions:
      - text: Get the details of Autonomous Container Database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Show the lifecycle state of container database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Autonomous Container Database
      effect: write
      questions:
      - How do I rename an Autonomous Container Database or change its maintenance preference?
      - Can I change backup retention on an existing container database?
      instructions:
      - text: Rename Autonomous Container Database {acd} to {name}.
        slots:
          acd: path.autonomousContainerDatabaseId
          name: requestBody.displayName
      - text: Change the patch model of container database {acd} to {patchModel}.
        slots:
          acd: path.autonomousContainerDatabaseId
          patchModel: requestBody.patchModel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Terminate an Autonomous Container Database
      effect: destructive
      questions:
      - What happens to the databases inside a container database when I terminate it?
      - Is terminating an Autonomous Container Database permanent?
      instructions:
      - text: Terminate Autonomous Container Database {acd} and everything in it.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Permanently delete container database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/addStandby'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a standby to an Autonomous Container Database
      effect: write
      questions:
      - How do I add an Autonomous Data Guard standby to my container database?
      - Can I choose the protection mode and automatic failover when adding a standby ACD?
      instructions:
      - text: Add a standby for Autonomous Container Database {acd} named {name}.
        slots:
          acd: path.autonomousContainerDatabaseId
          name: requestBody.peerAutonomousContainerDatabaseDisplayName
      - text: Add a standby ACD for {acd} on peer cloud Autonomous VM cluster {peerCluster} with protection mode {mode}.
        slots:
          acd: path.autonomousContainerDatabaseId
          peerCluster: requestBody.peerCloudAutonomousVmClusterId
          mode: requestBody.protectionMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeCompartment'].post
  update:
    x-apievangelist-phrasing:
      intent: Move an Autonomous Container Database to a compartment
      effect: write
      questions:
      - Can I move an Autonomous Container Database into a different compartment?
      - Do dependent resources move along with a container database when I change its compartment?
      instructions:
      - text: Move Autonomous Container Database {acd} to compartment {compartment}.
        slots:
          acd: path.autonomousContainerDatabaseId
          compartment: requestBody.compartmentId
      - text: Relocate container database {acd} and its dependents into compartment {compartment}.
        slots:
          acd: path.autonomousContainerDatabaseId
          compartment: requestBody.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeDataguardRole'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a container database's Data Guard role (deprecated)
      effect: write
      questions:
      - Is there an older endpoint to switch a container database's Data Guard role by association?
      - Can I still change an ACD's Data Guard role with the deprecated changeDataguardRole action?
      instructions:
      - text: Using the deprecated role-change action, set container database {acd} to role {role} in Data Guard association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          role: requestBody.role
          association: requestBody.autonomousContainerDatabaseDataguardAssociationId
      - text: Call the legacy changeDataguardRole on {acd} to make it {role} for association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          role: requestBody.role
          association: requestBody.autonomousContainerDatabaseDataguardAssociationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/editDataguard'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit Data Guard settings of a container database
      effect: write
      questions:
      - How do I change the Data Guard protection mode on an Autonomous Container Database?
      - Can I turn on automatic failover for my container database's Data Guard?
      - What fast-start failover lag limit can I set on a container database?
      instructions:
      - text: Set the Data Guard protection mode of container database {acd} to {mode}.
        slots:
          acd: path.autonomousContainerDatabaseId
          mode: requestBody.protectionMode
      - text: Enable automatic failover on container database {acd} with a fast-start failover lag limit of {lag} seconds.
        slots:
          acd: path.autonomousContainerDatabaseId
          lag: requestBody.fastStartFailOverLagLimitInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/failover'].post
  update:
    x-apievangelist-phrasing:
      intent: Fail over to a standby container database
      effect: destructive
      questions:
      - How can I fail over to my standby Autonomous Container Database when the primary is down?
      - Does the standby ACD become the new primary after a failover?
      instructions:
      - text: Fail over to standby container database {acd} so it becomes primary.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Promote standby ACD {acd} to primary via failover.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/reinstate'].post
  update:
    x-apievangelist-phrasing:
      intent: Reinstate a disabled standby container database
      effect: write
      questions:
      - How do I bring a disabled standby Autonomous Container Database back to an active standby after a failover?
      - Can a disabled standby ACD be reinstated rather than rebuilt?
      instructions:
      - text: Reinstate disabled standby container database {acd} as an active standby.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Bring standby ACD {acd} back into service after failover.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Rolling restart an Autonomous Container Database
      effect: write
      questions:
      - Can I do a rolling restart of an Autonomous Container Database?
      - Is there a way to force a container database restart?
      instructions:
      - text: Do a rolling restart of Autonomous Container Database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Restart container database {acd} with force restart set to {force}.
        slots:
          acd: path.autonomousContainerDatabaseId
          force: requestBody.isForceRestart
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/rotateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate a container database's encryption key
      effect: write
      questions:
      - How do I rotate the Vault encryption key of an Autonomous Container Database?
      - Can I bring my own key version when rotating a container database key?
      instructions:
      - text: Rotate the encryption key for Autonomous Container Database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Rotate container database {acd} to Vault key version {keyVersion}.
        slots:
          acd: path.autonomousContainerDatabaseId
          keyVersion: requestBody.keyVersionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/snapshotStandby'].post
  update:
    x-apievangelist-phrasing:
      intent: Convert a standby ACD to or from snapshot standby
      effect: write
      questions:
      - How do I turn a physical standby container database into a snapshot standby I can write to?
      - Can I convert a snapshot standby ACD back to a physical standby?
      instructions:
      - text: Convert standby container database {acd} to role {role}.
        slots:
          acd: path.autonomousContainerDatabaseId
          role: requestBody.role
      - text: Switch standby ACD {acd} to {role} using {connType} connection strings.
        slots:
          acd: path.autonomousContainerDatabaseId
          role: requestBody.role
          connType: requestBody.connectionStringsType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/switchover'].post
  update:
    x-apievangelist-phrasing:
      intent: Switch over a container database to its standby
      effect: write
      questions:
      - How can I do a planned switchover of my Autonomous Container Database to its standby?
      - What is the difference in outcome of a switchover for the standby container database?
      instructions:
      - text: Switch over Autonomous Container Database {acd} to its active standby.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Perform a planned role swap for container database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a container database's Data Guard associations
      effect: read
      questions:
      - Where can I find the older Data Guard association records for a container database?
      - Can I page through the Data Guard associations of an ACD with the legacy endpoint?
      instructions:
      - text: List the Data Guard associations for container database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Show up to {limit} Autonomous Data Guard associations of ACD {acd} from the deprecated list.
        slots:
          limit: query.limit
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a container database Data Guard association (legacy)
      effect: write
      questions:
      - Is there a legacy way to create an Autonomous Data Guard association for a container database?
      - What does the deprecated Data Guard association create call require?
      instructions:
      - text: Create a Data Guard association for {acd} with peer {peerName} in protection mode {mode} using the legacy endpoint.
        slots:
          acd: path.autonomousContainerDatabaseId
          peerName: requestBody.peerAutonomousContainerDatabaseDisplayName
          mode: requestBody.protectionMode
      - text: Using the deprecated association call, pair ACD {acd} with standby {peerName} as {mode}.
        slots:
          acd: path.autonomousContainerDatabaseId
          peerName: requestBody.peerAutonomousContainerDatabaseDisplayName
          mode: requestBody.protectionMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a container database Data Guard association
      effect: read
      questions:
      - What is the status of one specific Data Guard association on my container database?
      - Can I see the peer and role in a single ACD Data Guard association record?
      instructions:
      - text: Get Data Guard association {association} of container database {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      - text: Show the peer role in association {association} for ACD {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a container Data Guard association (legacy)
      effect: write
      questions:
      - Can I update protection mode through a specific Data Guard association record on an ACD?
      - Which settings does the deprecated Autonomous Container Database association update accept?
      instructions:
      - text: Set protection mode {mode} on Data Guard association {association} of container database {acd}.
        slots:
          mode: requestBody.protectionMode
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      - text: Turn on automatic failover for association {association} of ACD {acd} via the legacy update.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-10-02'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/failover'].post
  update:
    x-apievangelist-phrasing:
      intent: Fail over via a container Data Guard association
      effect: destructive
      questions:
      - Is there a deprecated failover call that works on a Data Guard association ID?
      - Can I fail over a container database by naming its association instead of just the ACD?
      instructions:
      - text: Fail over container database {acd} through Data Guard association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          association: path.autonomousContainerDatabaseDataguardAssociationId
      - text: Use the legacy association failover to promote the standby in {association} for ACD {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a container Data Guard association
      effect: write
      questions:
      - How do I migrate the primary container database of a Data Guard association into a standby role?
      - What does migrating an Autonomous Data Guard association do?
      instructions:
      - text: Migrate container database {acd} in Data Guard association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          association: path.autonomousContainerDatabaseDataguardAssociationId
      - text: Run the migrate action on association {association} of ACD {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/reinstate'].post
  update:
    x-apievangelist-phrasing:
      intent: Reinstate via a container Data Guard association
      effect: write
      questions:
      - Is there an older association-based call to reinstate a container database into standby?
      - Can I reinstate a standby ACD by giving its Data Guard association ID?
      instructions:
      - text: Reinstate container database {acd} as standby through association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          association: path.autonomousContainerDatabaseDataguardAssociationId
      - text: Use the deprecated association reinstate on {association} for ACD {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/switchover'].post
  update:
    x-apievangelist-phrasing:
      intent: Switch over via a container Data Guard association
      effect: write
      questions:
      - Is there a deprecated way to switch over a container database using its association ID?
      - Can I swap primary and standby roles through a specific ACD Data Guard association?
      instructions:
      - text: Switch over container database {acd} through Data Guard association {association}.
        slots:
          acd: path.autonomousContainerDatabaseId
          association: path.autonomousContainerDatabaseDataguardAssociationId
      - text: Use the legacy association switchover on {association} for ACD {acd}.
        slots:
          association: path.autonomousContainerDatabaseDataguardAssociationId
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/patches'].get
  update:
    x-apievangelist-phrasing:
      intent: List patches applicable to a container database
      effect: read
      questions:
      - Which patches can be applied to my Autonomous Container Database?
      - Can I filter a container database's available patches by patch type?
      instructions:
      - text: List patches applicable to container database {acd} in compartment {compartment}.
        slots:
          acd: path.autonomousContainerDatabaseId
          compartment: query.compartmentId
      - text: Show {patchType} patches available for ACD {acd} in compartment {compartment}.
        slots:
          patchType: query.autonomousPatchType
          acd: path.autonomousContainerDatabaseId
          compartment: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousContainerDatabases/{autonomousContainerDatabaseId}/resourceUsage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get resource usage of a container database
      effect: read
      questions:
      - How much CPU and storage is my Autonomous Container Database using?
      - Can I see the resource usage breakdown for one container database?
      instructions:
      - text: Show resource usage for Autonomous Container Database {acd}.
        slots:
          acd: path.autonomousContainerDatabaseId
      - text: Report how much capacity container database {acd} is consuming.
        slots:
          acd: path.autonomousContainerDatabaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousDatabaseBackups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Autonomous AI Database backups
      effect: read
      questions:
      - Where can I see all the backups of my Autonomous AI Database?
      - Can I list only long-term backups of an autonomous database?
      instructions:
      - text: List backups of Autonomous AI Database {adb}.
        slots:
          adb: query.autonomousDatabaseId
      - text: Show Autonomous AI Database backups of type {type} in compartment {compartment}.
        slots:
          type: query.type
          compartment: query.compartmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousDatabaseBackups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Autonomous AI Database backup
      effect: write
      questions:
      - How do I take a manual backup of an Autonomous AI Database right now?
      - Can I create a long-term backup with a custom retention period?
      instructions:
      - text: Back up Autonomous AI Database {adb} now.
        slots:
          adb: requestBody.autonomousDatabaseId
      - text: Create a long-term backup named {name} of autonomous database {adb} kept for {days} days.
        slots:
          name: requestBody.displayName
          adb: requestBody.autonomousDatabaseId
          days: requestBody.retentionPeriodInDays
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousDatabaseBackups/{autonomousDatabaseBackupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Autonomous AI Database backup
      effect: read
      questions:
      - What are the details of a particular Autonomous AI Database backup?
      - Has my autonomous database backup finished and how long is it retained?
      instructions:
      - text: Get Autonomous AI Database backup {backup}.
        slots:
          backup: path.autonomousDatabaseBackupId
      - text: Check the status of autonomous database backup {backup}.
        slots:
          backup: path.autonomousDatabaseBackupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousDatabaseBackups/{autonomousDatabaseBackupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change retention of an Autonomous AI Database backup
      effect: write
      questions:
      - Can I extend how long an existing Autonomous AI Database backup is kept?
      - How do I shorten the retention period on an autonomous database backup?
      instructions:
      - text: Set retention of autonomous database backup {backup} to {days} days.
        slots:
          backup: path.autonomousDatabaseBackupId
          days: requestBody.retentionPeriodInDays
      - text: Keep Autonomous AI Database backup {backup} for {days} days instead.
        slots:
          backup: path.autonomousDatabaseBackupId
          days: requestBody.retentionPeriodInDays
      method: generated
      generated: '2026-09-26'
- target: $.paths['/autonomousDatabaseBackups/{autonomousDatabaseBackupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a long-term Autonomous AI Database backup
      effect: destructive
      questions:
      - Can I delete a long-term backup of my Autonomous AI Database?
      - Which autonomous database backups am I allowed to delete through the API?
      instructions:
      - text: Delete long-term autonomous database backup {backup}.
        slots:
          backup: path.autonomousDatabaseBackupId
      - text: Remove Autonomous AI Database long-term backup {backup}.
        slots:
          backup: path.autonomousDatabaseBackupId
      method: generated
      generated: '2026-09-26'


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