# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Neptune Management DB Instances API
  version: 1.0.0
extends: openapi/amazon-neptune-db-instances-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/?Action=CreateDBInstance'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a DB instance to a Neptune cluster
      effect: write
      questions:
      - How do I add a new instance or read replica to my Neptune cluster?
      - Can I pick the availability zone and instance class for a new Neptune instance?
      - What does the promotion tier control on a new instance?
      instructions:
      - text: Create instance {instance} of class {class} in cluster {cluster} with engine {engine}.
        slots:
          instance: requestBody.DBInstanceIdentifier
          class: requestBody.DBInstanceClass
          cluster: requestBody.DBClusterIdentifier
          engine: requestBody.Engine
      - text: Add a {class} instance named {instance} to cluster {cluster} in zone {zone}, engine {engine}.
        slots:
          instance: requestBody.DBInstanceIdentifier
          class: requestBody.DBInstanceClass
          cluster: requestBody.DBClusterIdentifier
          zone: requestBody.AvailabilityZone
          engine: requestBody.Engine
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DeleteDBInstance'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Neptune DB instance
      effect: destructive
      questions:
      - Will deleting a Neptune instance also remove its automated backups?
      - Can I remove a single instance from my cluster without deleting the cluster?
      instructions:
      - text: Delete Neptune instance {instance}.
        slots:
          instance: query.DBInstanceIdentifier
      - text: Remove DB instance {instance} and skip the final snapshot.
        slots:
          instance: query.DBInstanceIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DescribeDBInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe Neptune DB instances
      effect: read
      questions:
      - Which Neptune DB instances are provisioned in my account?
      - Can I look up the class and status of one specific instance?
      instructions:
      - text: Describe all my Neptune DB instances.
      - text: Show details for Neptune instance {instance}.
        slots:
          instance: query.DBInstanceIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=ModifyDBInstance'].post
  update:
    x-apievangelist-phrasing:
      intent: Change settings on a Neptune DB instance
      effect: write
      questions:
      - How do I resize a Neptune instance to a bigger instance class?
      - Can I change an instance's maintenance window or turn off auto minor upgrades?
      instructions:
      - text: Change instance {instance} to class {class}.
        slots:
          instance: requestBody.DBInstanceIdentifier
          class: requestBody.DBInstanceClass
      - text: Rename DB instance {instance} to {new_name} and apply it immediately.
        slots:
          instance: requestBody.DBInstanceIdentifier
          new_name: requestBody.NewDBInstanceIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=RebootDBInstance'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot a Neptune DB instance
      effect: write
      questions:
      - Can I restart a Neptune instance, and will there be downtime?
      - Is it possible to force a failover while rebooting an instance?
      instructions:
      - text: Reboot Neptune instance {instance}.
        slots:
          instance: query.DBInstanceIdentifier
      - text: Reboot instance {instance} with a forced failover.
        slots:
          instance: query.DBInstanceIdentifier
      method: generated
      generated: '2026-10-01'