# 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 Neptune Analytics Graph Snapshots API
  version: 1.0.0
extends: openapi/amazon-neptune-graph-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: 5
- target: $.paths['/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List Neptune Analytics graph snapshots
      effect: read
      questions:
      - What Neptune Analytics graph snapshots exist in my account?
      - Can I list only the snapshots taken of one specific graph?
      instructions:
      - text: List my Neptune Analytics graph snapshots.
      - text: List the snapshots taken of graph {graph}.
        slots:
          graph: query.graphIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/snapshots'].post
  update:
    x-apievangelist-phrasing:
      intent: Snapshot a Neptune Analytics graph
      effect: write
      questions:
      - How do I back up a Neptune Analytics graph?
      - Can I tag a graph snapshot when I take it?
      instructions:
      - text: Take a snapshot of graph {graph} named {name}.
        slots:
          graph: requestBody.graphIdentifier
          name: requestBody.snapshotName
      - text: Back up analytics graph {graph} as snapshot {name}.
        slots:
          graph: requestBody.graphIdentifier
          name: requestBody.snapshotName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/snapshots/{snapshotIdentifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a graph snapshot
      effect: read
      questions:
      - What is the status of a particular graph snapshot?
      - Which graph was a given snapshot taken from?
      instructions:
      - text: Show details of graph snapshot {snapshot}.
        slots:
          snapshot: path.snapshotIdentifier
      - text: Check whether graph snapshot {snapshot} is available.
        slots:
          snapshot: path.snapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/snapshots/{snapshotIdentifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a graph snapshot
      effect: destructive
      questions:
      - Can I remove an old Neptune Analytics snapshot I no longer need?
      - Is deleting a graph snapshot permanent?
      instructions:
      - text: Delete graph snapshot {snapshot}.
        slots:
          snapshot: path.snapshotIdentifier
      - text: Remove the analytics snapshot {snapshot}.
        slots:
          snapshot: path.snapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/snapshots/{snapshotIdentifier}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a new graph from a snapshot
      effect: write
      questions:
      - How do I bring back a Neptune Analytics graph from one of its snapshots?
      - Can I give the restored graph a different memory size or replica count?
      instructions:
      - text: Restore snapshot {snapshot} into a new graph named {graph_name}.
        slots:
          snapshot: path.snapshotIdentifier
          graph_name: requestBody.graphName
      - text: Restore {snapshot} as graph {graph_name} with {memory} provisioned memory.
        slots:
          snapshot: path.snapshotIdentifier
          graph_name: requestBody.graphName
          memory: requestBody.provisionedMemory
      method: generated
      generated: '2026-10-01'