# 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 Snapshots API
  version: 1.0.0
extends: openapi/amazon-neptune-snapshots-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: 4
- target: $.paths['/?Action=CreateDBClusterSnapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Snapshot a Neptune DB cluster
      effect: write
      questions:
      - How do I take a manual backup of my Neptune cluster?
      - Can I name a cluster snapshot so I can restore to it later?
      instructions:
      - text: Snapshot cluster {cluster} as {snapshot}.
        slots:
          cluster: query.DBClusterIdentifier
          snapshot: query.DBClusterSnapshotIdentifier
      - text: Create manual snapshot {snapshot} of Neptune cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
          snapshot: query.DBClusterSnapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DescribeDBClusterSnapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List Neptune DB cluster snapshots
      effect: read
      questions:
      - Which snapshots exist for my Neptune clusters?
      - Can I list only the snapshots taken of one cluster?
      instructions:
      - text: List my Neptune cluster snapshots.
      - text: Show snapshots of cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: Describe cluster snapshot {snapshot}.
        slots:
          snapshot: query.DBClusterSnapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DeleteDBClusterSnapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Neptune cluster snapshot
      effect: destructive
      questions:
      - Can I delete an old manual cluster snapshot?
      - What happens if I delete a snapshot that is still being copied?
      instructions:
      - text: Delete cluster snapshot {snapshot}.
        slots:
          snapshot: query.DBClusterSnapshotIdentifier
      - text: Remove the Neptune snapshot {snapshot}.
        slots:
          snapshot: query.DBClusterSnapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=RestoreDBClusterFromSnapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a cluster from a snapshot
      effect: write
      questions:
      - How do I restore a Neptune cluster from a snapshot?
      - Can I enable IAM database auth on a cluster restored from a snapshot?
      instructions:
      - text: Restore snapshot {snapshot} into new cluster {cluster} with engine {engine}.
        slots:
          snapshot: requestBody.SnapshotIdentifier
          cluster: requestBody.DBClusterIdentifier
          engine: requestBody.Engine
      - text: Recreate cluster {cluster} from {snapshot} on engine {engine} in subnet group {subnets}.
        slots:
          snapshot: requestBody.SnapshotIdentifier
          cluster: requestBody.DBClusterIdentifier
          engine: requestBody.Engine
          subnets: requestBody.DBSubnetGroupName
      method: generated
      generated: '2026-10-01'