# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon S3 Control Multi-Region Access Points API
  version: 1.0.0
extends: openapi/amazon-s3-multi-region-access-points-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: 3
- target: $.paths['/v20180820/async-requests/mrap/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Multi-Region Access Point
      effect: write
      questions:
      - How do I put one global endpoint in front of buckets in several regions?
      - Is creating a Multi-Region Access Point asynchronous?
      instructions:
      - text: Create a Multi-Region Access Point with details {details} and client token {token}.
        slots:
          details: requestBody.Details
          token: requestBody.ClientToken
      - text: Set up a global endpoint across my regional buckets in account {account}.
        slots:
          account: header.x-amz-account-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v20180820/mrap/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List Multi-Region Access Points
      effect: read
      questions:
      - Which Multi-Region Access Points does my account have?
      - Can I page through Multi-Region Access Points a few at a time?
      instructions:
      - text: List Multi-Region Access Points in account {account}.
        slots:
          account: header.x-amz-account-id
      - text: List my Multi-Region Access Points, {max} per page.
        slots:
          max: query.maxResults
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v20180820/mrap/instances/{mrap_name+}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Multi-Region Access Point
      effect: read
      questions:
      - Which buckets sit behind a particular Multi-Region Access Point?
      - What's the configuration of my global access point?
      instructions:
      - text: Show Multi-Region Access Point {name}.
        slots:
          name: path.mrap_name+
      - text: Get configuration for Multi-Region Access Point {name} in account {account}.
        slots:
          name: path.mrap_name+
          account: header.x-amz-account-id
      method: generated
      generated: '2026-10-01'