# 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 DataShareManagementClient Share…
  version: 1.0.0
extends: openapi/microsoft-azure-sharesubscription-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/cancelSynchronization'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a share subscription synchronization
      effect: destructive
      questions:
      - How do I cancel a Data Share snapshot sync that's in progress?
      - Can I stop one specific synchronization by its ID?
      instructions:
      - text: Cancel synchronization {synchronizationId} on share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Stop sync {synchronizationId} for share subscription {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/consumerSourceDataSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List source datasets of a share subscription
      effect: read
      questions:
      - Which source datasets does a received share contain?
      - Can I see the provider's datasets behind my share subscription?
      instructions:
      - text: List source datasets of share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Show consumer source datasets for {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSourceShareSynchronizationSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the source share's synchronization settings
      effect: read
      questions:
      - What synchronization schedule did the data provider set on the share I subscribed to?
      - Can I read the source share's sync settings from my share subscription?
      instructions:
      - text: Get source share sync settings for share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Show provider sync schedule for {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSynchronizationDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: List dataset-level details of a synchronization
      effect: read
      questions:
      - Which datasets succeeded or failed in one share subscription synchronization?
      - Can I get per-dataset details for a specific sync run?
      instructions:
      - text: List dataset details for synchronization {synchronizationId} of share subscription {shareSubscriptionName}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareSubscriptionName: path.shareSubscriptionName
      - text: Per-dataset results of sync {synchronizationId} in {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSynchronizations'].post
  update:
    x-apievangelist-phrasing:
      intent: List synchronizations of a share subscription
      effect: read
      questions:
      - What sync runs have happened on my share subscription?
      - Can I sort or filter a share subscription's synchronization history?
      instructions:
      - text: List synchronizations for share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Show sync history of {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/synchronize'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a share subscription synchronization
      effect: write
      questions:
      - How do I trigger a copy of the shared data into my account now?
      - Can I choose a full or incremental sync when synchronizing a share subscription?
      instructions:
      - text: Synchronize share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Run a {synchronizationMode} sync of {shareSubscriptionName}, account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          synchronizationMode: requestBody.synchronizationMode
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a share subscription
      effect: read
      questions:
      - What's the state of one share subscription in my Data Share account?
      - Can I look up a received share subscription by name?
      instructions:
      - text: Get share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Show {shareSubscriptionName} from Data Share account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Accept an invitation as a share subscription
      effect: write
      questions:
      - How do I accept a data share and create a share subscription in my account?
      - Can I subscribe to a shared dataset from another Azure account?
      instructions:
      - text: Create share subscription {shareSubscriptionName} in account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Set up {shareSubscriptionName} in Data Share account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a share subscription
      effect: destructive
      questions:
      - Can I unsubscribe from a data share by deleting the share subscription?
      - Is it possible to remove a share subscription from my account?
      instructions:
      - text: Delete share subscription {shareSubscriptionName} from account {accountName}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
      - text: Remove {shareSubscriptionName} from Data Share account {accountName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          shareSubscriptionName: path.shareSubscriptionName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List share subscriptions in a Data Share account
      effect: read
      questions:
      - Which share subscriptions do I have in a Data Share account?
      - Can I filter or order the share subscriptions under one account?
      instructions:
      - text: List share subscriptions in Data Share account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show all share subscriptions for account {accountName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'