# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Data Lake Storage REST File and…
  version: 1.0.0
extends: openapi/microsoft-azure-file-and-directory-operations-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: 6
- target: $.paths['/{filesystem}/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a Data Lake file's contents
      effect: read
      questions:
      - How do I download a file from a Data Lake Storage Gen2 filesystem?
      - Can I read only part of a file using a byte range?
      instructions:
      - text: Read file {path} in filesystem {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
      - text: Download bytes {Range} of {path} in {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
          Range: header.Range
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{filesystem}/{path}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or rename a file or directory
      effect: write
      questions:
      - How do I create a new directory in a Data Lake filesystem?
      - Can I rename or move a file to a new path?
      instructions:
      - text: Create a {resource} at {path} in filesystem {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
          resource: query.resource
      - text: Rename {source} to {path} in filesystem {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
          source: header.x-ms-rename-source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{filesystem}/{path}'].post
  update:
    x-apievangelist-phrasing:
      intent: Acquire or manage a lease on a path
      effect: write
      questions:
      - How do I lock a Data Lake file so others cannot write or delete it?
      - Can I renew, break or release a lease on a path?
      instructions:
      - text: '{action} a lease on {path} in filesystem {filesystem}.'
        slots:
          filesystem: path.filesystem
          path: path.path
          action: header.x-ms-lease-action
      - text: Acquire a {duration}-second lease on {path} in {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
          duration: header.x-ms-lease-duration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{filesystem}/{path}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file or directory
      effect: destructive
      questions:
      - How do I delete a file or folder from a Data Lake filesystem?
      - Can I delete a directory and everything under it recursively?
      instructions:
      - text: Delete {path} from filesystem {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
      - text: Recursively delete directory {path} in {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{filesystem}/{path}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Append, flush or set ACLs on a path
      effect: write
      questions:
      - How do I append data to a Data Lake file and then flush it?
      - Can I set the owner, permissions or ACL on a file or directory?
      instructions:
      - text: Run {action} on {path} in filesystem {filesystem} at position {position}.
        slots:
          filesystem: path.filesystem
          path: path.path
          action: query.action
          position: query.position
      - text: Set the access control list on {path} in {filesystem} to {acl}.
        slots:
          filesystem: path.filesystem
          path: path.path
          acl: header.x-ms-acl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{filesystem}/{path}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get properties, status or ACL of a path
      effect: read
      questions:
      - What system and user properties does a Data Lake file have?
      - How do I read the access control list on a directory?
      instructions:
      - text: Get the properties of {path} in filesystem {filesystem}.
        slots:
          filesystem: path.filesystem
          path: path.path
      - text: Show the ACL of {path} in {filesystem} with action {action}.
        slots:
          filesystem: path.filesystem
          path: path.path
          action: query.action
      method: generated
      generated: '2026-09-26'