# 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 Microsoft Storage Sync ServerEndpoint…
  version: 1.0.0
extends: openapi/microsoft-azure-serverendpoint-resource-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints/{serverEndpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure File Sync server endpoint
      effect: read
      questions:
      - How do I look up one server endpoint in an Azure File Sync group?
      - What cloud tiering settings does my server endpoint have?
      instructions:
      - text: Get server endpoint {serverEndpointName} in sync group {syncGroupName} of storage sync service {storageSyncServiceName}.
        slots:
          serverEndpointName: path.serverEndpointName
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
      - text: Show the details of server endpoint {serverEndpointName}.
        slots:
          serverEndpointName: path.serverEndpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints/{serverEndpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a server endpoint in a sync group
      effect: write
      questions:
      - How do I add a server folder to an Azure File Sync group?
      - Can I turn on cloud tiering when I create a server endpoint?
      instructions:
      - text: Create server endpoint {serverEndpointName} in sync group {syncGroupName} of storage sync service {storageSyncServiceName}.
        slots:
          serverEndpointName: path.serverEndpointName
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
      - text: Add a new server endpoint {serverEndpointName} with properties {properties}.
        slots:
          serverEndpointName: path.serverEndpointName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints/{serverEndpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a server endpoint
      effect: destructive
      questions:
      - Can I stop syncing a server folder by removing its server endpoint?
      - What happens to tiered files when I delete a server endpoint?
      instructions:
      - text: Delete server endpoint {serverEndpointName} from sync group {syncGroupName} in storage sync service {storageSyncServiceName}.
        slots:
          serverEndpointName: path.serverEndpointName
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
      - text: Remove server endpoint {serverEndpointName}.
        slots:
          serverEndpointName: path.serverEndpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints/{serverEndpointName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a server endpoint's settings
      effect: write
      questions:
      - Can I change cloud tiering or volume free space on an existing server endpoint?
      - Which server endpoint properties can I patch after creation?
      instructions:
      - text: Patch server endpoint {serverEndpointName} in sync group {syncGroupName} of {storageSyncServiceName} with {properties}.
        slots:
          serverEndpointName: path.serverEndpointName
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
          properties: requestBody.properties
      - text: Update the settings on existing server endpoint {serverEndpointName}.
        slots:
          serverEndpointName: path.serverEndpointName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List server endpoints in a sync group
      effect: read
      questions:
      - Which servers are syncing in a particular Azure File Sync group?
      - Can I list all server endpoints registered to one sync group?
      instructions:
      - text: List the server endpoints in sync group {syncGroupName} of storage sync service {storageSyncServiceName}.
        slots:
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
      - text: Show every server endpoint under sync group {syncGroupName}.
        slots:
          syncGroupName: path.syncGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageSync/storageSyncServices/{storageSyncServiceName}/syncGroups/{syncGroupName}/serverEndpoints/{serverEndpointName}/recallAction'].post
  update:
    x-apievangelist-phrasing:
      intent: Recall tiered files to a server endpoint
      effect: write
      questions:
      - How do I bring tiered files back down to the local server?
      - Can I recall only a specific path or file pattern on a server endpoint?
      instructions:
      - text: Recall files to server endpoint {serverEndpointName} in sync group {syncGroupName} of {storageSyncServiceName}.
        slots:
          serverEndpointName: path.serverEndpointName
          syncGroupName: path.syncGroupName
          storageSyncServiceName: path.storageSyncServiceName
      - text: Recall files under {recallPath} matching {pattern} on server endpoint {serverEndpointName}.
        slots:
          recallPath: requestBody.recallPath
          pattern: requestBody.pattern
          serverEndpointName: path.serverEndpointName
      method: generated
      generated: '2026-09-26'