API Evangelist conversational phrasing for Microsoft Azure Service Fabric Client Image Store API

# 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 Service Fabric Client Image Store API
  version: 1.0.0
extends: openapi/microsoft-azure-imagestore-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: 13
- target: $.paths['/ImageStore/{contentPath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get image store content at a path
      effect: read
      questions:
      - What files and folders are stored at a given path in the Service Fabric image store?
      - Can I inspect the image store contents under an application package folder?
      instructions:
      - text: Show the image store content at {contentPath}.
        slots:
          contentPath: path.contentPath
      - text: List what is stored under image store path {contentPath}.
        slots:
          contentPath: path.contentPath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/{contentPath}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a small file to the image store
      effect: write
      questions:
      - How do I upload a small file to the image store in one request?
      - Can I push a file to the image store without chunking it?
      instructions:
      - text: Upload the file to image store path {contentPath} in one piece.
        slots:
          contentPath: path.contentPath
      - text: Put this small file at {contentPath} in the image store.
        slots:
          contentPath: path.contentPath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/{contentPath}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete content from the image store
      effect: destructive
      questions:
      - Can I delete an application package from the image store after it's provisioned?
      - How do I remove files under an image store path?
      instructions:
      - text: Delete the image store content at {contentPath}.
        slots:
          contentPath: path.contentPath
      - text: Remove the uploaded package at {contentPath} from the image store.
        slots:
          contentPath: path.contentPath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore'].get
  update:
    x-apievangelist-phrasing:
      intent: List content at the image store root
      effect: read
      questions:
      - What is at the top level of my image store?
      - How do I browse the root folder of the image store?
      instructions:
      - text: List the content at the root of the image store.
      - text: Show the root of the image store with a {timeout}-second timeout.
        slots:
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/Copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy content within the image store
      effect: write
      questions:
      - Can I copy files from one image store path to another without re-uploading?
      - How do I duplicate an application package inside the image store?
      instructions:
      - text: Copy image store content as described in {ImageStoreCopyDescription}.
        slots:
          ImageStoreCopyDescription: body.ImageStoreCopyDescription
      - text: Copy between image store paths using {ImageStoreCopyDescription}.
        slots:
          ImageStoreCopyDescription: body.ImageStoreCopyDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/DeleteUploadSession'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an image store upload session
      effect: destructive
      questions:
      - How do I abort a chunked upload and discard the chunks already sent?
      - Can I expire an image store upload session early?
      instructions:
      - text: Cancel upload session {session-id} and discard its chunks.
        slots:
          session-id: query.session-id
      - text: Abort image store upload session {session-id}.
        slots:
          session-id: query.session-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/CommitUploadSession'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit a chunked image store upload
      effect: write
      questions:
      - What do I do after all file chunks are uploaded to finish the upload?
      - How long does an uncommitted image store upload session stay around?
      instructions:
      - text: Commit upload session {session-id} to finish the upload.
        slots:
          session-id: query.session-id
      - text: Finalize the chunked upload for session {session-id}.
        slots:
          session-id: query.session-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/GetUploadSession'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an image store upload session by ID
      effect: read
      questions:
      - How can I check the progress of an upload session when I have its ID?
      - Which chunks have been received so far for my session ID?
      instructions:
      - text: Show image store upload session {session-id}.
        slots:
          session-id: query.session-id
      - text: Check which chunks session {session-id} has received.
        slots:
          session-id: query.session-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/{contentPath}/$/GetUploadSession'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the upload session for an image store path
      effect: read
      questions:
      - Is there an upload session in progress for a given image store path?
      - Can I look up an upload session by its relative path instead of its ID?
      instructions:
      - text: Get the upload session for image store path {contentPath}.
        slots:
          contentPath: path.contentPath
      - text: Check upload progress at {contentPath} by path.
        slots:
          contentPath: path.contentPath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/{contentPath}/$/UploadChunk'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload one chunk of a large file
      effect: write
      questions:
      - How do I upload a large file to the image store in resumable chunks?
      - Can I resume an upload after a network interruption without starting over?
      instructions:
      - text: Upload byte range {Content-Range} to {contentPath} in session {session-id}.
        slots:
          Content-Range: header.Content-Range
          contentPath: path.contentPath
          session-id: query.session-id
      - text: Send the next chunk of {contentPath} for upload session {session-id} covering {Content-Range}.
        slots:
          contentPath: path.contentPath
          session-id: query.session-id
          Content-Range: header.Content-Range
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/FolderSize'].get
  update:
    x-apievangelist-phrasing:
      intent: Get total size of the image store
      effect: read
      questions:
      - How much space do all files in the image store take up?
      - Can I get the size of the root and every child folder of the image store?
      instructions:
      - text: Get the total folder size at the image store root.
      - text: Report how big the whole image store is.
      - text: Get the image store root folder size using API version {api-version}.
        slots:
          api-version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/{contentPath}/$/FolderSize'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the size of an image store folder
      effect: read
      questions:
      - How large is one specific folder in the image store?
      - Can I check the size of an application package folder before copying it?
      instructions:
      - text: Get the size of image store folder {contentPath}.
        slots:
          contentPath: path.contentPath
      - text: How much space does {contentPath} use in the image store.
        slots:
          contentPath: path.contentPath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ImageStore/$/Info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get image store disk capacity and usage
      effect: read
      questions:
      - How much free disk space is left on the node hosting the image store replica?
      - What categories of file system usage does the image store report?
      instructions:
      - text: Show the image store's disk capacity and usage.
      - text: Get overall image store information for the primary replica.
      - text: Report image store replica disk space using API version {api-version}.
        slots:
          api-version: query.api-version
      method: generated
      generated: '2026-09-26'