# 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 Clusters API
  version: 1.0.0
extends: openapi/amazon-neptune-db-clusters-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: 9
- target: $.paths['/'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe Neptune DB clusters
      effect: read
      questions:
      - What Neptune DB clusters do I have provisioned?
      - Can I get the full configuration of one specific Neptune cluster?
      - How many clusters come back at once when I describe them, and can I page through more?
      instructions:
      - text: Describe all my Neptune DB clusters.
      - text: Show the details of Neptune cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: List my Neptune clusters {max} at a time.
        slots:
          max: query.MaxRecords
      method: generated
      generated: '2026-10-01'
- target: $.paths['/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Neptune DB cluster
      effect: write
      questions:
      - How do I provision a new Amazon Neptune database cluster?
      - Can I turn on storage encryption and deletion protection when creating a cluster?
      - Which engine version and port can I choose for a new Neptune cluster?
      instructions:
      - text: Create a Neptune DB cluster named {cluster} using engine {engine}.
        slots:
          cluster: requestBody.DBClusterIdentifier
          engine: requestBody.Engine
      - text: Create Neptune cluster {cluster} on engine version {version} with encrypted storage.
        slots:
          cluster: requestBody.DBClusterIdentifier
          version: requestBody.EngineVersion
      - text: Provision cluster {cluster} with engine {engine} in subnet group {subnets}.
        slots:
          cluster: requestBody.DBClusterIdentifier
          engine: requestBody.Engine
          subnets: requestBody.DBSubnetGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DeleteDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a Neptune DB cluster
      effect: destructive
      questions:
      - What happens to my automated backups when I delete a Neptune cluster?
      - Can I take a final snapshot before a Neptune cluster is deleted?
      instructions:
      - text: Delete Neptune cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: Delete cluster {cluster} but save a final snapshot named {snapshot} first.
        slots:
          cluster: query.DBClusterIdentifier
          snapshot: query.FinalDBSnapshotIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=ModifyDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Change settings on a Neptune DB cluster
      effect: write
      questions:
      - Can I rename an existing Neptune cluster or change its backup retention?
      - Is it possible to apply cluster configuration changes immediately instead of in the maintenance window?
      - How can I upgrade the engine version of a cluster I already run?
      instructions:
      - text: Change the backup retention on cluster {cluster} to {days} days.
        slots:
          cluster: requestBody.DBClusterIdentifier
          days: requestBody.BackupRetentionPeriod
      - text: Rename Neptune cluster {cluster} to {new_name}.
        slots:
          cluster: requestBody.DBClusterIdentifier
          new_name: requestBody.NewDBClusterIdentifier
      - text: Upgrade existing cluster {cluster} to engine version {version} right away.
        slots:
          cluster: requestBody.DBClusterIdentifier
          version: requestBody.EngineVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=StartDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a stopped Neptune cluster
      effect: write
      questions:
      - How do I bring a stopped Neptune cluster back online?
      - Does starting a stopped cluster restore it to the state it was in?
      instructions:
      - text: Start the stopped Neptune cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: Power cluster {cluster} back up.
        slots:
          cluster: query.DBClusterIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=StopDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a running Neptune cluster
      effect: write
      questions:
      - Can I pause a Neptune cluster so I only pay for storage?
      - How long does a stopped Neptune cluster stay stopped before restarting on its own?
      instructions:
      - text: Stop the running Neptune cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: Pause cluster {cluster} to save on compute costs.
        slots:
          cluster: query.DBClusterIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=FailoverDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Force a failover on a Neptune cluster
      effect: write
      questions:
      - Can I promote a read replica to primary in my Neptune cluster?
      - Is there a way to choose which replica becomes the new primary during failover?
      instructions:
      - text: Force a failover on cluster {cluster}.
        slots:
          cluster: query.DBClusterIdentifier
      - text: Fail over cluster {cluster} and promote instance {target} to primary.
        slots:
          cluster: query.DBClusterIdentifier
          target: query.TargetDBInstanceIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=AddRoleToDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Associate an IAM role with a cluster
      effect: write
      questions:
      - How do I let my Neptune cluster access S3 or other AWS services on my behalf?
      - Can I attach an IAM role to an existing Neptune cluster?
      instructions:
      - text: Associate IAM role {role} with Neptune cluster {cluster}.
        slots:
          role: query.RoleArn
          cluster: query.DBClusterIdentifier
      - text: Give cluster {cluster} the permissions of role {role}.
        slots:
          role: query.RoleArn
          cluster: query.DBClusterIdentifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=RemoveRoleFromDBCluster'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove an IAM role from a cluster
      effect: destructive
      questions:
      - Can I detach an IAM role that my Neptune cluster no longer needs?
      - What do I call to revoke a cluster's associated IAM role?
      instructions:
      - text: Remove IAM role {role} from Neptune cluster {cluster}.
        slots:
          role: query.RoleArn
          cluster: query.DBClusterIdentifier
      - text: Disassociate role {role} from cluster {cluster}.
        slots:
          role: query.RoleArn
          cluster: query.DBClusterIdentifier
      method: generated
      generated: '2026-10-01'