# 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 API
  version: 1.0.0
extends: openapi/microsoft-azure-share-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}/shares/{shareName}/listSynchronizationDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: List dataset-level details of a share sync
      effect: read
      questions:
      - Which datasets were copied in a particular share synchronization run?
      - Can I drill into one synchronization to see per-dataset status?
      instructions:
      - text: List dataset details for synchronization {synchronizationId} of share {shareName} in account {accountName}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareName: path.shareName
          accountName: path.accountName
      - text: Show per-dataset results of sync {synchronizationId} on share {shareName} in {resourceGroupName}.
        slots:
          synchronizationId: requestBody.synchronizationId
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, show dataset-level sync details for share {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizations'].post
  update:
    x-apievangelist-phrasing:
      intent: List synchronization runs of a share
      effect: read
      questions:
      - What synchronization runs have happened for my data share?
      - Can I filter or sort a share's synchronization history?
      instructions:
      - text: List synchronizations of share {shareName} in account {accountName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
      - text: Show sync history for share {shareName} in {resourceGroupName} filtered by {filter}.
        slots:
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
          filter: query.$filter
      - text: In subscription {subscriptionId}, list every sync run of share {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/reinstate'].post
  update:
    x-apievangelist-phrasing:
      intent: Reinstate a revoked share subscription
      effect: write
      questions:
      - How do I restore a consumer's access after I revoked their share subscription?
      - Can a revoked provider share subscription be reinstated?
      instructions:
      - text: Reinstate share subscription {providerShareSubscriptionId} on share {shareName} in account {accountName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          accountName: path.accountName
      - text: Restore access for subscription {providerShareSubscriptionId} to share {shareName} in {resourceGroupName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, reinstate {providerShareSubscriptionId} on {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
          providerShareSubscriptionId: path.providerShareSubscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a consumer's share subscription
      effect: destructive
      questions:
      - How do I cut off a consumer's access to data I shared?
      - Can I revoke one share subscription without deleting the whole share?
      instructions:
      - text: Revoke share subscription {providerShareSubscriptionId} on share {shareName} in account {accountName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          accountName: path.accountName
      - text: Cut off subscription {providerShareSubscriptionId} from share {shareName} in {resourceGroupName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, revoke {providerShareSubscriptionId} on {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
          providerShareSubscriptionId: path.providerShareSubscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one consumer subscription to a share
      effect: read
      questions:
      - Who is behind a specific subscription to my data share and what is its status?
      - Can I look up one provider share subscription by its ID?
      instructions:
      - text: Get share subscription {providerShareSubscriptionId} on share {shareName} in account {accountName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          accountName: path.accountName
      - text: Show details of subscription {providerShareSubscriptionId} to {shareName} in {resourceGroupName}.
        slots:
          providerShareSubscriptionId: path.providerShareSubscriptionId
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, fetch consumer subscription {providerShareSubscriptionId} to {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
          providerShareSubscriptionId: path.providerShareSubscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List consumer subscriptions to a share
      effect: read
      questions:
      - Which consumers have subscribed to my data share?
      - How do I page through all subscriptions on a provider share?
      instructions:
      - text: List subscriptions to share {shareName} in account {accountName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
      - text: Show everyone subscribed to {shareName} in {resourceGroupName}.
        slots:
          shareName: path.shareName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, list consumer subscriptions to {shareName} in {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data share
      effect: read
      questions:
      - What are the properties of one data share in my account?
      - Can I look up a data share by name?
      instructions:
      - text: Get share {shareName} in data share account {accountName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
      - text: Show share {shareName} from account {accountName} in {resourceGroupName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, read share {shareName} of account {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a data share in an account
      effect: write
      questions:
      - How do I create a new share to send data to other organizations?
      - Can I set properties like description or terms when creating a data share?
      instructions:
      - text: Create share {shareName} in data share account {accountName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
      - text: Create share {shareName} in {accountName} under {resourceGroupName} with properties {properties}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      - text: In subscription {subscriptionId}, create a new share {shareName} in account {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data share
      effect: destructive
      questions:
      - How do I remove a data share I no longer offer?
      - What happens to a share when I delete it from my account?
      instructions:
      - text: Delete share {shareName} from data share account {accountName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
      - text: Remove share {shareName} in {accountName} under {resourceGroupName}.
        slots:
          shareName: path.shareName
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
      - text: In subscription {subscriptionId}, delete share {shareName} of account {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          shareName: path.shareName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares'].get
  update:
    x-apievangelist-phrasing:
      intent: List data shares in an account
      effect: read
      questions:
      - Which shares exist in my data share account?
      - Can I filter and sort the shares listed for an account?
      instructions:
      - text: List all shares in data share account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show shares in {accountName} under {resourceGroupName} ordered by {orderby}.
        slots:
          accountName: path.accountName
          resourceGroupName: path.resourceGroupName
          orderby: query.$orderby
      - text: In subscription {subscriptionId}, list the shares of account {accountName}.
        slots:
          subscriptionId: path.subscriptionId
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'