# 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 Trigger API
  version: 1.0.0
extends: openapi/microsoft-azure-trigger-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Data Share snapshot trigger
      effect: read
      questions:
      - How do I look up one trigger on a Data Share share subscription?
      - What schedule does a specific share subscription trigger use?
      instructions:
      - text: Get trigger {trigger} on share subscription {share_subscription} in account {account}, {resource_group}, subscription {subscription}.
        slots:
          trigger: path.triggerName
          share_subscription: path.shareSubscriptionName
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the details of trigger {trigger}.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a trigger for a Data Share subscription
      effect: write
      questions:
      - How do I schedule automatic snapshots for a received data share?
      - Can I create a trigger of a given kind on a share subscription?
      instructions:
      - text: Create trigger {trigger} on share subscription {share_subscription} in account {account}, {resource_group}, subscription {subscription}.
        slots:
          trigger: path.triggerName
          share_subscription: path.shareSubscriptionName
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Add a {kind} trigger named {trigger} to {share_subscription}.
        slots:
          kind: requestBody.kind
          trigger: path.triggerName
          share_subscription: path.shareSubscriptionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Data Share subscription trigger
      effect: destructive
      questions:
      - How do I stop scheduled snapshots by removing a share subscription trigger?
      - Can I delete one trigger from a Data Share subscription?
      instructions:
      - text: Delete trigger {trigger} from share subscription {share_subscription} in account {account}, {resource_group}, subscription {subscription}.
        slots:
          trigger: path.triggerName
          share_subscription: path.shareSubscriptionName
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove trigger {trigger}.
        slots:
          trigger: path.triggerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers'].get
  update:
    x-apievangelist-phrasing:
      intent: List triggers on a Data Share subscription
      effect: read
      questions:
      - Which triggers are set up on my Data Share share subscription?
      - Is the list of share subscription triggers paged with a skip token?
      instructions:
      - text: List triggers on share subscription {share_subscription} in account {account}, {resource_group}, subscription {subscription}.
        slots:
          share_subscription: path.shareSubscriptionName
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the next page of triggers on {share_subscription} using skip token {skip_token}.
        slots:
          share_subscription: path.shareSubscriptionName
          skip_token: query.$skipToken
      method: generated
      generated: '2026-09-26'