# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon API Gateway REST API Keys VPC Links API
  version: 1.0.0
extends: openapi/aws-api-gateway-vpclinks-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['/vpclinks'].get
  update:
    x-apievangelist-phrasing:
      intent: List VPC links
      effect: read
      questions:
      - What VPC links connect my APIs to private resources?
      - How do I list all VPC links in my account?
      instructions:
      - text: List all my VPC links.
      - text: Show up to {limit} VPC links.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/vpclinks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a VPC link
      effect: write
      questions:
      - How do I connect API Gateway to a private load balancer in my VPC?
      - What target ARNs does a new VPC link need?
      instructions:
      - text: Create a VPC link named {name} to target {targetArns}.
        slots:
          name: requestBody.name
          targetArns: requestBody.targetArns
      - text: Set up VPC link {name} for load balancer {targetArns} described as {description}.
        slots:
          name: requestBody.name
          targetArns: requestBody.targetArns
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/vpclinks/{vpclink_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one VPC link
      effect: read
      questions:
      - How do I check the status of a specific VPC link?
      - Which load balancer does one of my VPC links point to?
      instructions:
      - text: Show VPC link {vpclink_id}.
        slots:
          vpclink_id: path.vpclink_id
      - text: Check the status and targets of VPC link {vpclink_id}.
        slots:
          vpclink_id: path.vpclink_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/vpclinks/{vpclink_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VPC link
      effect: destructive
      questions:
      - How do I remove a VPC link I no longer need?
      - Can I delete a VPC link for private integrations?
      instructions:
      - text: Delete VPC link {vpclink_id}.
        slots:
          vpclink_id: path.vpclink_id
      - text: Tear down the private VPC link {vpclink_id}.
        slots:
          vpclink_id: path.vpclink_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/vpclinks/{vpclink_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a VPC link
      effect: write
      questions:
      - Can I rename an existing VPC link?
      - How do I change the description of a VPC link already in place?
      instructions:
      - text: Update VPC link {vpclink_id} with patch operations {patchOperations}.
        slots:
          vpclink_id: path.vpclink_id
          patchOperations: requestBody.patchOperations
      - text: Rename existing VPC link {vpclink_id}.
        slots:
          vpclink_id: path.vpclink_id
      method: generated
      generated: '2026-10-01'