API Evangelist conversational phrasing for Aws Lambda Functions API

# 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 Functions API
  version: 1.0.0
extends: openapi/aws-lambda-functions-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: 15
- target: $.paths['/2015-03-31/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Lambda functions with their configuration
      effect: read
      questions:
      - What Lambda functions do I have in this AWS Region?
      - Can I include every published version of each function when listing them, not just $LATEST?
      - Is there a way to list Lambda@Edge functions replicated from a master Region?
      instructions:
      - text: List my Lambda functions, {max} per page, on the 2015-03-31 API.
        slots:
          max: query.MaxItems
      - text: List all functions including every published version by setting FunctionVersion to {function_version}.
        slots:
          function_version: query.FunctionVersion
      - text: List the Lambda@Edge functions whose master function lives in {master_region}.
        slots:
          master_region: query.MasterRegion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Lambda function from a deployment package
      effect: write
      questions:
      - 'What do I need to create a new Lambda function: code, execution role, runtime?'
      - Can I set memory, timeout, VPC and environment variables when I first create a function?
      - Is it possible to publish version 1 at the moment the function is created?
      instructions:
      - text: Create a Lambda function named {name} with runtime {runtime}, handler {handler} and execution role {role} from code {code}.
        slots:
          name: requestBody.FunctionName
          runtime: requestBody.Runtime
          handler: requestBody.Handler
          role: requestBody.Role
          code: requestBody.Code
      - text: Create function {name} from container image code {code} with role {role}, packaged as {package_type}.
        slots:
          name: requestBody.FunctionName
          code: requestBody.Code
          role: requestBody.Role
          package_type: requestBody.PackageType
      - text: Create new function {name} using role {role} and code {code}, with {memory} MB of memory, a {timeout}-second timeout, and publish the first version.
        slots:
          name: requestBody.FunctionName
          role: requestBody.Role
          code: requestBody.Code
          memory: requestBody.MemorySize
          timeout: requestBody.Timeout
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a function's details and code download link
      effect: read
      questions:
      - How can I download the deployment package of an existing Lambda function?
      - Can I get details for one specific version or alias of a function rather than $LATEST?
      - How long is the code download link for a Lambda function valid?
      instructions:
      - text: Get the details and a code download link for function {function} via the 2015-03-31 API.
        slots:
          function: path.FunctionName
      - text: Show me function {function} at version or alias {qualifier}, including its tags and code location.
        slots:
          function: path.FunctionName
          qualifier: query.Qualifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Lambda function or one of its versions
      effect: destructive
      questions:
      - Does deleting a Lambda function also remove all its versions and aliases?
      - Can I delete just one published version of a function and keep the rest?
      - Are event source mappings removed when I delete the function they invoke?
      instructions:
      - text: Delete Lambda function {function} with all of its versions and aliases using the 2015-03-31 endpoint.
        slots:
          function: path.FunctionName
      - text: Delete only version {qualifier} of function {function}.
        slots:
          function: path.FunctionName
          qualifier: query.Qualifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a function's runtime and resource settings
      effect: read
      questions:
      - What runtime, memory size and timeout is my function configured with?
      - Where can I check a function's handler, role, VPC settings and code SHA-256 without downloading the code?
      - Can I read the settings of a particular published version of a function?
      instructions:
      - text: Show the configuration settings (runtime, memory, timeout, role) of function {function}.
        slots:
          function: path.FunctionName
      - text: Get the version-specific configuration of function {function} for {qualifier}.
        slots:
          function: path.FunctionName
          qualifier: query.Qualifier
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/configuration'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a function's memory, timeout or environment
      effect: write
      questions:
      - How do I raise the memory or timeout on an existing Lambda function?
      - Can I change environment variables or attach layers to a function without redeploying its code?
      - Is there a way to avoid overwriting someone else's concurrent change to a function's settings?
      instructions:
      - text: Set function {function} to {memory} MB of memory and a {timeout}-second timeout on the 2015-03-31 configuration endpoint.
        slots:
          function: path.FunctionName
          memory: requestBody.MemorySize
          timeout: requestBody.Timeout
      - text: Replace the environment variables of function {function} with {environment}.
        slots:
          function: path.FunctionName
          environment: requestBody.Environment
      - text: Switch function {function} to runtime {runtime} only if its revision is still {revision}.
        slots:
          function: path.FunctionName
          runtime: requestBody.Runtime
          revision: requestBody.RevisionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/code'].put
  update:
    x-apievangelist-phrasing:
      intent: Deploy new code to a Lambda function
      effect: write
      questions:
      - How do I deploy a new zip from S3 to my existing Lambda function?
      - Can I point a container-image function at a new image in Amazon ECR?
      - Is there a dry run option to validate a code update before applying it?
      instructions:
      - text: Deploy the package at s3://{bucket}/{key} to function {function} using the 2015-03-31 code endpoint.
        slots:
          function: path.FunctionName
          bucket: requestBody.S3Bucket
          key: requestBody.S3Key
      - text: Update function {function} to container image {image_uri} and publish a new version.
        slots:
          function: path.FunctionName
          image_uri: requestBody.ImageUri
      - text: Do a dry run of uploading zip {zip} to function {function} without changing its code.
        slots:
          function: path.FunctionName
          zip: requestBody.ZipFile
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/functions/{FunctionName}/invocations'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a Lambda function synchronously or async
      effect: write
      questions:
      - How do I call a Lambda function and wait for its response?
      - Can I trigger a function asynchronously so the call returns right away?
      - Is it possible to get the tail of the execution log back with the invocation result?
      instructions:
      - text: Invoke function {function} synchronously through the 2015-03-31 invocations endpoint and return its response.
        slots:
          function: path.FunctionName
      - text: Invoke function {function} with invocation type {invocation_type} so it runs in the background.
        slots:
          function: path.FunctionName
          invocation_type: header.X-Amz-Invocation-Type
      - text: Run alias {qualifier} of function {function} with log type {log_type} so I see the last lines of its log.
        slots:
          function: path.FunctionName
          qualifier: query.Qualifier
          log_type: header.X-Amz-Log-Type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List functions via the unversioned /functions path
      effect: read
      questions:
      - Is there a short /functions path without the date prefix for listing Lambda functions?
      - Which functions come back from the unversioned list endpoint?
      instructions:
      - text: List my functions using the unversioned /functions endpoint.
      - text: Fetch the function list from the short-path Lambda endpoint without a date prefix.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a function via the unversioned /functions path
      effect: write
      questions:
      - Can I create a Lambda function by posting to the short /functions path?
      - What does the unversioned create-function endpoint accept?
      instructions:
      - text: Create a function through the unversioned /functions endpoint.
      - text: Post a new function definition to the short-path create endpoint without a date prefix.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions/{FunctionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a function via the unversioned /functions path
      effect: read
      questions:
      - Can I look up a single function through the short undated /functions path?
      - What does the unversioned get-function endpoint return for a function name?
      instructions:
      - text: Get function {function} from the unversioned /functions path.
        slots:
          function: path.FunctionName
      - text: Look up {function} on the short-path endpoint without the 2015-03-31 prefix.
        slots:
          function: path.FunctionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions/{FunctionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a function via the unversioned /functions path
      effect: destructive
      questions:
      - Can I delete a function through the short undated /functions path instead of the dated one?
      - Does the unversioned delete endpoint take only a function name?
      instructions:
      - text: Delete function {function} using the unversioned /functions endpoint.
        slots:
          function: path.FunctionName
      - text: Remove {function} through the short-path delete call without a date prefix.
        slots:
          function: path.FunctionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions/{FunctionName}/code'].put
  update:
    x-apievangelist-phrasing:
      intent: Update code via the unversioned /functions path
      effect: write
      questions:
      - Is there a short /functions code path for pushing new function code?
      - What can I send to the unversioned update-code endpoint?
      instructions:
      - text: Update the code of function {function} through the unversioned /functions code path.
        slots:
          function: path.FunctionName
      - text: Push new code to {function} using the short-path code endpoint without a date prefix.
        slots:
          function: path.FunctionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions/{FunctionName}/configuration'].put
  update:
    x-apievangelist-phrasing:
      intent: Update settings via the unversioned /functions path
      effect: write
      questions:
      - Can I modify a function's settings through the short /functions configuration path?
      - What does the unversioned update-configuration endpoint change?
      instructions:
      - text: Update the settings of function {function} through the unversioned configuration path.
        slots:
          function: path.FunctionName
      - text: Modify {function}'s configuration using the short-path endpoint without the 2015-03-31 prefix.
        slots:
          function: path.FunctionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/functions/{FunctionName}/invocations'].post
  update:
    x-apievangelist-phrasing:
      intent: Invoke a function via the unversioned /functions path
      effect: write
      questions:
      - Can I invoke a function by posting to the short /functions invocations path?
      - What does the unversioned invocations endpoint need besides the function name?
      instructions:
      - text: Invoke function {function} through the unversioned /functions invocations path.
        slots:
          function: path.FunctionName
      - text: Call {function} using the short-path invoke endpoint without a date prefix.
        slots:
          function: path.FunctionName
      method: generated
      generated: '2026-10-01'