# 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 TimeSeriesInsightsClient Access Policies API
  version: 1.0.0
extends: openapi/microsoft-azure-access-policies-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies/{accessPolicyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Time Series Insights access policy
      effect: read
      questions:
      - How do I see who a Time Series Insights access policy grants access to?
      - What roles does a given environment access policy assign?
      instructions:
      - text: Get access policy {policy} in Time Series Insights environment {environment}, resource group {resource_group}, subscription {subscription}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the principal and roles on policy {policy} in environment {environment}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies/{accessPolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Time Series Insights access policy
      effect: write
      questions:
      - How do I give a user reader or contributor access to a Time Series Insights environment?
      - Can I replace an existing TSI access policy in one call?
      instructions:
      - text: Create access policy {policy} in Time Series Insights environment {environment}, group {resource_group}, subscription {subscription} with {properties}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Grant access through new policy {policy} on environment {environment} using {properties}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies/{accessPolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Time Series Insights access policy
      effect: destructive
      questions:
      - How do I revoke someone's access to a Time Series Insights environment?
      - Can I delete an environment access policy by name?
      instructions:
      - text: Delete access policy {policy} from Time Series Insights environment {environment}, resource group {resource_group}, subscription {subscription}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Revoke access by removing policy {policy} in environment {environment}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies/{accessPolicyName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify an existing Time Series Insights access policy
      effect: write
      questions:
      - How do I change the roles on an existing Time Series Insights access policy?
      - Can I patch a TSI policy's description without recreating it?
      instructions:
      - text: Patch access policy {policy} in Time Series Insights environment {environment}, group {resource_group}, subscription {subscription} with {properties}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Change the roles on existing policy {policy} in environment {environment} to {properties}.
        slots:
          policy: path.accessPolicyName
          environment: path.environmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List access policies for a Time Series Insights environment
      effect: read
      questions:
      - Who has access to my Time Series Insights environment?
      - Can I list every access policy on a TSI environment?
      instructions:
      - text: List access policies on Time Series Insights environment {environment}, resource group {resource_group}, subscription {subscription}.
        slots:
          environment: path.environmentName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show everyone granted access to environment {environment}.
        slots:
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'