API Evangelist conversational phrasing for Amazon Lightsail Distributions API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Lightsail Distributions API
  version: 1.0.0
extends: openapi/amazon-lightsail-distributions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/ls/api/2016-11-28/AttachCertificateToDistribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a certificate to a CDN distribution
      effect: write
      questions:
      - How do I use my custom domain with HTTPS on a Lightsail CDN distribution?
      - Can I attach a validated certificate to an existing distribution?
      instructions:
      - text: Attach certificate {certificateName} to distribution {distributionName}.
        slots:
          certificateName: requestBody.certificateName
          distributionName: requestBody.distributionName
      - text: Enable custom-domain HTTPS on {distributionName} with {certificateName}.
        slots:
          distributionName: requestBody.distributionName
          certificateName: requestBody.certificateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/CreateDistribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a CDN distribution
      effect: write
      questions:
      - How do I put a CDN in front of my Lightsail instance or bucket?
      - Can I set caching rules per path when creating a distribution?
      - What's the minimum TLS version I can require from viewers?
      instructions:
      - text: Create distribution {distributionName} for origin {origin} with cache behavior {defaultCacheBehavior} on plan {bundleId}.
        slots:
          distributionName: requestBody.distributionName
          origin: requestBody.origin
          defaultCacheBehavior: requestBody.defaultCacheBehavior
          bundleId: requestBody.bundleId
      - text: Set up a CDN {distributionName} for {origin}, caching {defaultCacheBehavior}, plan {bundleId}, cert {certificateName}.
        slots:
          distributionName: requestBody.distributionName
          origin: requestBody.origin
          defaultCacheBehavior: requestBody.defaultCacheBehavior
          bundleId: requestBody.bundleId
          certificateName: requestBody.certificateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/DeleteDistribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a CDN distribution
      effect: destructive
      questions:
      - How do I delete a CDN distribution I no longer need?
      - Will deleting the distribution affect my origin instance?
      instructions:
      - text: Delete distribution {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      - text: Tear down the CDN named {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/DetachCertificateFromDistribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove the certificate from a distribution
      effect: write
      questions:
      - How do I stop using my custom-domain certificate on a distribution?
      - Does detaching a certificate revert the distribution to its default domain?
      instructions:
      - text: Detach the certificate from distribution {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      - text: Remove custom-domain TLS from {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/GetDistributionBundles'].post
  update:
    x-apievangelist-phrasing:
      intent: List CDN distribution plans
      effect: read
      questions:
      - What CDN plans are available and how much transfer do they include?
      - Which distribution bundle should cover 500 GB a month?
      instructions:
      - text: List the distribution bundles.
      - text: Show CDN plan prices and data transfer quotas.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/GetDistributionLatestCacheReset'].post
  update:
    x-apievangelist-phrasing:
      intent: Check the last CDN cache reset
      effect: read
      questions:
      - When was my distribution's cache last cleared?
      - Has my most recent cache reset finished?
      instructions:
      - text: Get the latest cache reset for {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      - text: Check the status of the last cache purge on {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/GetDistributionMetricData'].post
  update:
    x-apievangelist-phrasing:
      intent: Get traffic metrics for a distribution
      effect: read
      questions:
      - How many requests is my CDN distribution serving?
      - Can I see bytes downloaded or error rates for a distribution?
      instructions:
      - text: Get {metricName} for distribution {distributionName} from {startTime} to {endTime} every {period} seconds as {statistics} in {unit}.
        slots:
          metricName: requestBody.metricName
          distributionName: requestBody.distributionName
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          period: requestBody.period
          statistics: requestBody.statistics
          unit: requestBody.unit
      - text: Chart CDN {distributionName} {metricName} since {startTime}.
        slots:
          distributionName: requestBody.distributionName
          metricName: requestBody.metricName
          startTime: requestBody.startTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/GetDistributions'].post
  update:
    x-apievangelist-phrasing:
      intent: List CDN distributions
      effect: read
      questions:
      - What CDN distributions do I have and what domains do they serve?
      - Can I look up just one distribution's configuration?
      instructions:
      - text: List my CDN distributions.
      - text: Get the configuration of distribution {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/ResetDistributionCache'].post
  update:
    x-apievangelist-phrasing:
      intent: Purge a distribution's cached content
      effect: write
      questions:
      - How do I clear the CDN cache after deploying new files?
      - Can I force the distribution to fetch fresh content from the origin?
      instructions:
      - text: Reset the cache of distribution {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      - text: Purge everything cached on {distributionName}.
        slots:
          distributionName: requestBody.distributionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/UpdateDistribution'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a CDN distribution's settings
      effect: write
      questions:
      - How do I change the origin or caching behavior of an existing distribution?
      - Can I temporarily disable a distribution?
      - Can I switch a distribution back to its default certificate?
      instructions:
      - text: Point distribution {distributionName} at origin {origin}.
        slots:
          distributionName: requestBody.distributionName
          origin: requestBody.origin
      - text: Set {distributionName} enabled to {isEnabled}.
        slots:
          distributionName: requestBody.distributionName
          isEnabled: requestBody.isEnabled
      - text: Change the cache behaviors of {distributionName} to {cacheBehaviors}.
        slots:
          distributionName: requestBody.distributionName
          cacheBehaviors: requestBody.cacheBehaviors
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ls/api/2016-11-28/UpdateDistributionBundle'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a distribution's CDN plan
      effect: write
      questions:
      - How do I upgrade my CDN distribution to a larger transfer plan?
      - Can I downgrade a distribution's bundle?
      instructions:
      - text: Move distribution {distributionName} to bundle {bundleId}.
        slots:
          distributionName: requestBody.distributionName
          bundleId: requestBody.bundleId
      - text: Change the CDN plan of {distributionName} to {bundleId}.
        slots:
          distributionName: requestBody.distributionName
          bundleId: requestBody.bundleId
      method: generated
      generated: '2026-09-26'