# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AWS Lambda Aliases API
  version: 1.0.0
extends: openapi/aws-lambda-aliases-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['/2015-03-31/functions/{FunctionName}/aliases'].get
  update:
    x-apievangelist-phrasing:
      intent: List a function's aliases
      effect: read
      questions:
      - Which aliases exist for my Lambda function and which versions do they point to?
      - Can I see only the aliases that point at a particular version?
      instructions:
      - text: List all aliases of function {function}.
        slots:
          function: path.FunctionName
      - text: List the aliases of {function} that point at version {version}.
        slots:
          function: path.FunctionName
          version: query.FunctionVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/aliases'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an alias pointing at a function version
      effect: write
      questions:
      - How do I give clients a stable name like prod that points at a function version?
      - Can a new alias split traffic between two versions for a canary release?
      instructions:
      - text: Create alias {alias} on function {function} pointing at version {version}.
        slots:
          function: path.FunctionName
          alias: requestBody.Name
          version: requestBody.FunctionVersion
      - text: Create new alias {alias} for {function} on version {version} with weighted routing {routing}.
        slots:
          function: path.FunctionName
          alias: requestBody.Name
          version: requestBody.FunctionVersion
          routing: requestBody.RoutingConfig
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/aliases/{AliasName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of one function alias
      effect: read
      questions:
      - Which version does my prod alias currently invoke?
      - What traffic weights are set on an existing alias?
      instructions:
      - text: Show alias {alias} of function {function}.
        slots:
          function: path.FunctionName
          alias: path.AliasName
      - text: Tell me which version {function}:{alias} routes to.
        slots:
          function: path.FunctionName
          alias: path.AliasName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/aliases/{AliasName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Repoint or reweight an existing alias
      effect: write
      questions:
      - How do I move an existing alias to a newer function version?
      - Can I shift a percentage of an alias's traffic to a second version gradually?
      instructions:
      - text: Point existing alias {alias} of function {function} at version {version}.
        slots:
          function: path.FunctionName
          alias: path.AliasName
          version: requestBody.FunctionVersion
      - text: Change the traffic split on {function} alias {alias} to {routing}.
        slots:
          function: path.FunctionName
          alias: path.AliasName
          routing: requestBody.RoutingConfig
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/aliases/{AliasName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a function alias
      effect: destructive
      questions:
      - How do I remove an alias I no longer use from a function?
      - Does deleting an alias delete the function version it points to?
      instructions:
      - text: Delete alias {alias} from function {function}.
        slots:
          function: path.FunctionName
          alias: path.AliasName
      - text: Remove the {alias} alias on {function}.
        slots:
          function: path.FunctionName
          alias: path.AliasName
      method: generated
      generated: '2026-10-01'