# 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.Elastic Deployment Info API
  version: 1.0.0
extends: openapi/microsoft-azure-deployment-info-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: 2
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}/listDeploymentInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Elastic Cloud deployment info for a monitor
      effect: read
      questions:
      - Which Elastic Cloud deployment is behind my Azure Elastic monitor resource?
      - Can I see the version and health of the Elastic deployment my monitor uses?
      instructions:
      - text: Fetch the Elastic deployment information for monitor {monitor}.
        slots:
          monitor: path.monitorName
      - text: Show the Elastic Cloud deployment details linked to Elastic monitor {monitor}.
        slots:
          monitor: path.monitorName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}/createOrUpdateExternalUser'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update a user in an Elastic deployment
      effect: write
      questions:
      - How do I add a user inside the Elastic deployment tied to my Azure monitor?
      - Can I assign roles to an Elastic deployment user when creating it?
      instructions:
      - text: Create Elastic user {user_name} with email {email} on monitor {monitor}.
        slots:
          user_name: requestBody.userName
          email: requestBody.emailId
          monitor: path.monitorName
      - text: Give Elastic deployment user {user_name} the roles {roles} via monitor {monitor}.
        slots:
          user_name: requestBody.userName
          roles: requestBody.roles
          monitor: path.monitorName
      method: generated
      generated: '2026-10-01'