# 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 Private Graph Endpoints API
  version: 1.0.0
extends: openapi/amazon-neptune-private-graph-endpoints-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['/privategraphendpoints/{graphIdentifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoints for a graph
      effect: read
      questions:
      - Which VPC private endpoints exist for my analytics graph?
      - Can I page through a graph's private endpoints?
      instructions:
      - text: List the private endpoints for graph {graph}.
        slots:
          graph: path.graphIdentifier
      - text: Show private endpoints on graph {graph}, {max} per page.
        slots:
          graph: path.graphIdentifier
          max: query.maxResults
      method: generated
      generated: '2026-10-01'
- target: $.paths['/privategraphendpoints/{graphIdentifier}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a private VPC endpoint for a graph
      effect: write
      questions:
      - How do I reach a Neptune Analytics graph without going over the public internet?
      - Can I choose the subnets and security groups for a graph's private endpoint?
      instructions:
      - text: Create a private endpoint for graph {graph} in VPC {vpc}.
        slots:
          graph: path.graphIdentifier
          vpc: requestBody.vpcId
      - text: Add a private endpoint to graph {graph} in subnets {subnets}.
        slots:
          graph: path.graphIdentifier
          subnets: requestBody.subnetIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/privategraphendpoints/{graphIdentifier}/{vpcId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a graph's private endpoint in a VPC
      effect: read
      questions:
      - What are the details of the private endpoint my graph has in a given VPC?
      - Is the private endpoint for my graph in a specific VPC available yet?
      instructions:
      - text: Show the private endpoint for graph {graph} in VPC {vpc}.
        slots:
          graph: path.graphIdentifier
          vpc: path.vpcId
      - text: Check the status of graph {graph}'s endpoint in {vpc}.
        slots:
          graph: path.graphIdentifier
          vpc: path.vpcId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/privategraphendpoints/{graphIdentifier}/{vpcId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a graph's private endpoint
      effect: destructive
      questions:
      - Can I remove a graph's private endpoint from one of my VPCs?
      - What do I need to delete a private graph endpoint?
      instructions:
      - text: Delete the private endpoint for graph {graph} in VPC {vpc}.
        slots:
          graph: path.graphIdentifier
          vpc: path.vpcId
      - text: Remove graph {graph}'s endpoint from {vpc}.
        slots:
          graph: path.graphIdentifier
          vpc: path.vpcId
      method: generated
      generated: '2026-10-01'