# 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.NetworkAnalytics Data Products API
  version: 1.0.0
extends: openapi/microsoft-azure-data-products-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetworkAnalytics/dataProducts'].get
  update:
    x-apievangelist-phrasing:
      intent: List data products in a subscription
      effect: read
      questions:
      - Which Network Analytics data products exist across my subscription?
      - Can I see every data product I own subscription-wide?
      instructions:
      - text: List all data products in my subscription.
      - text: Show every Network Analytics data product across the subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts'].get
  update:
    x-apievangelist-phrasing:
      intent: List data products in a resource group
      effect: read
      questions:
      - What data products are in this resource group?
      - Can I narrow data products down to one resource group?
      instructions:
      - text: List the data products in the current resource group.
      - text: Show Network Analytics data products scoped to my resource group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data product
      effect: read
      questions:
      - What are the settings of one of my data products?
      - Can I retrieve a single Network Analytics data product by name?
      instructions:
      - text: Get data product {product}.
        slots:
          product: path.dataProductName
      - text: Show the configuration of data product {product}.
        slots:
          product: path.dataProductName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a data product
      effect: write
      questions:
      - How do I create a new Network Analytics data product?
      - Can a data product be created with a managed identity?
      instructions:
      - text: Create data product {product} with properties {props}.
        slots:
          product: path.dataProductName
          props: requestBody.properties
      - text: Create data product {product} using managed identity {identity}.
        slots:
          product: path.dataProductName
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data product
      effect: destructive
      questions:
      - Can I delete a data product I no longer need?
      - What name do I need to tear down a Network Analytics data product?
      instructions:
      - text: Delete data product {product}.
        slots:
          product: path.dataProductName
      - text: Tear down the Network Analytics data product {product}.
        slots:
          product: path.dataProductName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a data product
      effect: write
      questions:
      - Can I change the tags or identity on an existing data product?
      - Which data product fields can be patched after creation?
      instructions:
      - text: Update tags on data product {product} to {tags}.
        slots:
          product: path.dataProductName
          tags: requestBody.tags
      - text: Patch existing data product {product} properties with {props}.
        slots:
          product: path.dataProductName
          props: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}/addUserRole'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a user role on a data product
      effect: write
      questions:
      - How do I grant a user a role on my data product?
      - What do I need to give someone reader access to a data product's data types?
      instructions:
      - text: Assign role {role} on data product {product} to principal {principal} ({type}), user {user}, role id {roleId}, scope {scope}.
        slots:
          role: requestBody.role
          product: path.dataProductName
          principal: requestBody.principalId
          type: requestBody.principalType
          user: requestBody.userName
          roleId: requestBody.roleId
          scope: requestBody.dataTypeScope
      - text: Grant {user} the {role} role on data product {product}.
        slots:
          user: requestBody.userName
          role: requestBody.role
          product: path.dataProductName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}/generateStorageAccountSasToken'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a SAS token for a data product's storage
      effect: read
      questions:
      - How do I get a SAS token to read a data product's storage account?
      - Can I restrict a data product storage SAS token to one IP address and time window?
      instructions:
      - text: Generate a storage SAS token for data product {product} from {start} to {expiry} for IP {ip}.
        slots:
          product: path.dataProductName
          start: requestBody.startTimeStamp
          expiry: requestBody.expiryTimeStamp
          ip: requestBody.ipAddress
      - text: Give me a storage account SAS for data product {product} expiring {expiry}.
        slots:
          product: path.dataProductName
          expiry: requestBody.expiryTimeStamp
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}/listRolesAssignments'].post
  update:
    x-apievangelist-phrasing:
      intent: List role assignments on a data product
      effect: read
      questions:
      - Who has been given roles on my data product?
      - Can I audit the user role assignments on a data product?
      instructions:
      - text: List role assignments on data product {product}.
        slots:
          product: path.dataProductName
      - text: Show which users hold roles on data product {product}.
        slots:
          product: path.dataProductName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}/removeUserRole'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a user role from a data product
      effect: destructive
      questions:
      - How do I revoke a user's role on a data product?
      - Which role assignment id do I need to take access away from a data product user?
      instructions:
      - text: Remove role assignment {assignment} ({role}) for principal {principal} ({type}), user {user}, role id {roleId}, scope {scope} from data product {product}.
        slots:
          assignment: requestBody.roleAssignmentId
          role: requestBody.role
          principal: requestBody.principalId
          type: requestBody.principalType
          user: requestBody.userName
          roleId: requestBody.roleId
          scope: requestBody.dataTypeScope
          product: path.dataProductName
      - text: Revoke {user}'s access on data product {product}.
        slots:
          user: requestBody.userName
          product: path.dataProductName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkAnalytics/dataProducts/{dataProductName}/rotateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate a data product's encryption key
      effect: write
      questions:
      - How do I rotate the key a data product uses?
      - Which Key Vault URL does data product key rotation need?
      instructions:
      - text: Rotate the key on data product {product} using Key Vault {vault}.
        slots:
          product: path.dataProductName
          vault: requestBody.keyVaultUrl
      - text: Start key rotation for data product {product} against {vault}.
        slots:
          product: path.dataProductName
          vault: requestBody.keyVaultUrl
      method: generated
      generated: '2026-10-01'